Tutorial completo (e51) de automação N8N para geração de faturas…
INEMA
11. Resultado final⌗
- Você manda uma mensagem no Telegram: “Gere uma fatura para Maria no valor de 350€, com IVA.”
- Em menos de 30 segundos:
- O Gemini interpreta o pedido.
- O N8N gera o HTML.
- O PDF é criado e enviado por e-mail.
- A fatura é salva no Drive.
- Os dados são registrados.
12. Bônus⌗
- O criador mostra que o mesmo fluxo gera também relatórios automáticos mensais com análise de entradas e saídas.
- Tudo é feito sem gastar tokens, sem API externa e 100% com código local e prompts bem estruturados.
- Ele enfatiza: “O segredo não é o nó, é como você pede para a IA. Se você der o papel certo, ela entende e entrega o resultado perfeito.”
Abaixo está o passo a passo explicado , com a lógica, a fala prática e a sequência real da automação funcionando dentro do N8N, usando Telegram, Gemini e PDF.co — exatamente como o criador mostrou.
1. Criar o bot do Telegram⌗
- Abre o Telegram e procura o @BotFather.
- Digita o comando
/newbot. - Escolhe o nome do bot (exemplo:
faturador_inema_bot). - Depois cria o username (exemplo:
faturador_inema_bot). - O BotFather vai te devolver o token de API, que é o que vamos colar no N8N.
2. Conectar o bot no N8N⌗
- No N8N, cria um novo workflow.
- Adiciona o nó Telegram Trigger.
- Coloca o token que o BotFather deu.
- Esse nó é o que vai escutar as mensagens que chegam no Telegram (tanto texto quanto áudio).
- Salva e ativa o gatilho para testar.
3. Receber mensagens e normalizar o input⌗
- Adiciona um nó Switch para detectar o tipo da mensagem.
- Se for texto, o fluxo segue direto.
- Se for áudio, usa o nó de Transcrição (pode ser o Whisper ou outro) para transformar o áudio em texto.
- Depois, tudo é unificado em uma variável única chamada text, assim tudo funciona igual. Exemplo:
text = "Gerar fatura para João da Silva, valor 500€, sem IVA"
4. Interpretar o texto com nó de código (sem usar API externa)⌗
- Adiciona um nó de código (Node Function).
- Dentro dele, pede ao Gemini (via prompt local) para estruturar os dados da mensagem.
- O criador chama isso de “dar um papel à IA”: Ele diz — “Gemini, imagina que você é um forno. Eu te dou uma pizza fria (os dados crus) e quero que você me devolva uma pizza quente (os dados formatados)”.
- Isso faz o modelo devolver os dados limpos e organizados, prontos para gerar o HTML.
- A saída desse nó deve conter algo como:
{
"cliente": "João da Silva",
"valor": "500",
"iva": "0",
"descricao": "Serviço de suporte técnico",
"data": "2025-10-08"
}
5. Gerar o HTML da fatura⌗
- Adiciona outro nó de código.
- Pede ao Gemini para gerar o HTML completo da fatura com base nos dados anteriores.
- Ele cria dois modelos: um com IVA e outro sem IVA.
- É aqui que entra o design: você pode personalizar com seu logotipo, cores e layout.
- Atenção: todas as imagens devem ser URLs públicas, nada de arquivos locais.
6. Converter HTML em PDF⌗
- Adiciona o nó PDF.co.
- Seleciona a ação HTML to PDF.
- Cola o HTML vindo do Gemini e gera o arquivo PDF profissional.
- Dá um nome dinâmico, por exemplo:
Fatura_{{cliente}}_{{data}}.pdf
7. Enviar o PDF por e-mail⌗
- Adiciona o nó Email Send.
- No corpo do e-mail, coloca um HTML bonito, gerado pelo Gemini também.
- Anexa o PDF gerado.
- Exemplo de corpo do e-mail:
Olá {{cliente}},
Segue em anexo a sua fatura de {{data}} no valor de {{valor}}€.
Obrigado pela preferência.
* Observação:
Desative nas opções do N8N a mensagem “enviado via N8N”, que aparece no rodapé.
8. Salvar no Google Drive⌗
- Adiciona o nó Google Drive.
- Define a pasta destino, por exemplo:
/Faturas/2025/Outubro/ - O arquivo é salvo automaticamente com o nome da fatura.
- Assim tudo fica organizado por ano e mês.
9. Registrar no banco de dados⌗
- Adiciona um nó Supabase ou Google Sheets.
- Cria uma tabela com as colunas: cliente, data, valor, IVA, link da fatura.
- Cada nova fatura é adicionada automaticamente.
10. Criar relatório financeiro mensal⌗
- Adiciona um nó Cron para rodar no dia 1º de cada mês.
- Ele executa uma consulta SQL (PostgreSQL ou Supabase) filtrando os dados do mês anterior.
- Passa os resultados para o Gemini, que gera um HTML analítico com gráficos e totais.
- O HTML pode ser convertido para PDF e enviado por e-mail ou salvo no Drive.
- Exemplo: “Relatório financeiro de setembro: total faturado 14.300€, IVA 1.500€, despesas 2.000€, lucro líquido 12.300€”
Passo a passo direto da automação de faturas e relatórios financeiros
- Criar o bot no Telegram
- Buscar no Telegram: BotFather
- Enviar o comando: /newbot
- Dar um nome e criar o token de API
- Copiar o token para usar no N8N
- Configurar o N8N
- Criar um novo workflow
- Adicionar o nó Telegram Trigger
- Colar o token do bot para conectar
- O fluxo será iniciado sempre que o bot receber mensagem (texto ou áudio)
- Normalizar o input
- Adicionar um nó Switch para detectar se a mensagem é texto ou áudio
- Converter áudio em texto (se necessário)
- Unificar ambos em uma variável chamada text
- Interpretar os dados da fatura
- Adicionar um nó de código
-
Pedir ao Gemini (por prompt interno) para transformar o texto em dados estruturados:
-
Nome do cliente
- Endereço
- Valor
- Descrição
- IVA (sim/não)
- Gerar HTML da fatura
- Adicionar outro nó de código
- Criar o HTML profissional da fatura usando Gemini
- Definir dois templates: com e sem IVA
- Converter HTML em PDF
- Adicionar o nó PDF.co
- Selecionar a opção HTML to PDF
- Gerar o PDF da fatura
- Enviar e-mail ao cliente
- Adicionar o nó Email Send
- Corpo do e-mail em HTML
- Anexar o PDF gerado
- Salvar no Google Drive
- Adicionar o nó Google Drive
- Criar estrutura automática:
/Faturas/2025/Outubro/ - Fazer upload do PDF com nome do cliente e data
- Registrar dados
- Adicionar o nó Supabase ou Google Sheets
- Inserir as informações da fatura (cliente, valor, data, IVA)
- Gerar relatório financeiro mensal
- Adicionar um nó Cron (agendado para todo dia 1º de cada mês)
- Buscar dados do mês anterior via SQL (no Supabase ou Sheets)
- Usar um nó de código com Gemini para gerar o HTML analítico do relatório
- Converter para PDF (opcional) e enviar por e-mail ou salvar no Drive
- Dicas finais
- Usar apenas URLs públicas para imagens no HTML
- Desativar a mensagem “enviado via N8N” nas opções avançadas
- Manter variáveis padronizadas (ex: “text”) para evitar erros
- Definir papéis metafóricos no prompt (ex: “você é um forno que transforma pizza fria em quente”) para melhorar a resposta do Gemini
Resultado Em menos de 30 segundos o sistema: • Recebe o pedido via Telegram • Cria a fatura • Envia por e-mail • Salva no Drive • Atualiza a base de dados • E gera o relatório mensal automaticamente.
Passo a Passo - Visão Geral
Resumo completo e estruturado
Tema central Criação de uma automação completa para geração de faturas e relatórios financeiros usando Telegram, N8N e Gemini, sem depender de APIs externas nem consumir tokens de IA. O foco é ajudar empresas a automatizar faturamento, reduzir custos e gerar relatórios mensais de forma profissional.
-
Objetivo da automação • Permitir que qualquer pessoa envie uma mensagem (texto ou áudio) pelo Telegram solicitando uma fatura. • O sistema gera automaticamente uma fatura profissional (com ou sem IVA), converte para PDF e a envia por e-mail. • A fatura também é armazenada automaticamente no Google Drive, organizada por mês e ano. • Os dados podem ser salvos em Supabase ou Google Sheets para histórico e relatórios financeiros mensais.
-
Estrutura técnica do fluxo • Entrada no Telegram: o usuário envia um comando de voz ou texto. • Normalização: o fluxo identifica o tipo de mensagem e converte tudo em texto padronizado. • Interpretação: em vez de usar uma API de IA, um nó de código transforma o texto em dados estruturados. • Geração de HTML: Gemini cria o layout visual da fatura (com design e estrutura definidos). • Conversão para PDF: feita com PDF.co, sem marcas d’água. • Envio por e-mail: o sistema envia automaticamente o PDF com corpo HTML profissional. • Armazenamento: o arquivo é salvo no Google Drive e os dados vão para Supabase/Sheets. • Relatórios financeiros: mensalmente, um trigger coleta as faturas do mês anterior, faz uma consulta SQL, agrega os dados e gera um relatório HTML analítico.
-
Principais ferramentas usadas • N8N como orquestrador do fluxo. • Bot do Telegram para entrada do usuário. • Gemini para gerar HTML e estrutura de fatura. • PDF.co para converter HTML em PDF. • Google Drive para armazenamento. • Supabase ou Google Sheets para banco de dados.
-
Estratégias e boas práticas • Dar “funções metafóricas” à IA (como “você é um forno”) melhora os resultados. • Manter nomes de variáveis consistentes (“text”) evita erros entre caminhos diferentes. • Usar apenas imagens com URLs públicas no HTML. • Desativar a mensagem “enviado via N8N” no Telegram. • Pedir com clareza à IA o que se espera de cada parte do processo, definindo o papel e o formato do output.
-
Parte avançada: geração de relatório financeiro • O sistema roda no início de cada mês, pega os movimentos do mês anterior e gera um relatório completo. • Usa SQL para buscar e filtrar dados automaticamente. • Gemini gera o HTML do relatório, que pode ser exibido diretamente ou convertido em PDF. • O relatório inclui análise automática dos cinco principais indicadores e resumo visual das receitas e despesas.
-
Conclusão e aprendizado • A automação mostra que é possível criar fluxos potentes sem depender de APIs caras. • Tudo funciona com prompts bem estruturados e nós de código dentro do N8N. • O segredo é aprender a pedir corretamente à IA o resultado desejado. • A execução total de uma fatura leva cerca de 10 a 15 segundos, oferecendo grande economia de tempo para empresas.
Exemplo de uso prático Um cliente envia no Telegram: “Gere uma fatura para João da Silva no valor de 500€, sem IVA.” Em segundos, o sistema gera o PDF, envia por e-mail, salva no Google Drive e registra no banco de dados.
Resultado Uma automação empresarial completa, eficiente e sem custo recorrente de APIs, capaz de gerar faturas e relatórios financeiros em segundos, 100% integrada com Telegram, N8N, Gemini e Google Drive.
e51 - Faturas e relatório financeiro em 1 clique
Você vai aprender a montar uma automação completa que permite gerar e enviar faturas profissionais a partir de mensagens no Telegram (texto ou áudio), sem depender de agentes de IA externos nem consumir APIs. Essa solução é extremamente útil para qualquer empresa que trabalhe com faturamento recorrente, permitindo economizar tempo, reduzir erros e oferecer uma experiência mais profissional aos clientes.
🛠️ O que conseguimos com essa automação • Gerar faturas automaticamente a partir do Telegram, por voz ou texto. • Criar PDFs profissionais em segundos sem consumir APIs. • Enviar a fatura por e-mail com design HTML personalizado. • Salvar automaticamente as faturas no Google Drive, organizadas por mês e ano. • Adaptar facilmente o fluxo para faturas com ou sem IVA. • Reduzir custos a longo prazo ao não usar agentes de IA externos. • Aplicar o mesmo conceito a relatórios financeiros pessoais ou empresariais.
🧩 Estrutura do fluxo automatizado Entrada via Telegram O usuário envia uma mensagem (voz ou texto) ao bot solicitando a geração de uma fatura com os dados relevantes.
Recepção e normalização da entrada Detecta-se se a mensagem é de voz ou texto. Ambos os tipos são normalizados para serem processados da mesma forma.
Interpretação da mensagem (sem API) Em vez de usar um agente de IA, utiliza-se um nó de código que transforma a entrada em uma estrutura de dados limpa.
Geração de HTML personalizado Com ajuda do Gemini, é criado um HTML profissional para a fatura, adaptado com design visual.
Conversão para PDF O HTML é convertido em PDF usando o PDF.co, sem marcas d’água nem limitações rígidas.
Envio da fatura O sistema envia automaticamente o e-mail ao cliente, com corpo em HTML visual e o PDF anexado.
Armazenamento no Drive O arquivo PDF é enviado para a pasta correspondente (exemplo: /Faturas/2025/Outubro).
Geração de relatórios financeiros (opcional) Mensalmente, são extraídos os movimentos do mês anterior e criado um relatório visual e analítico.
🧰 Ferramentas utilizadas • N8N • Bot do Telegram • Gemini (para prompts estruturados) • PDF.co • Google Drive • Supabase / Google Sheets (opcional para base de dados)
🧠 Dicas importantes que aprendemos • Nem sempre é necessário consumir APIs: com um bom prompt, o Gemini pode gerar diretamente o HTML ou a estrutura desejada. • Atribuir papéis metafóricos à IA (exemplo: “você é um forno”) melhora a resposta do modelo. • Normalizar variáveis e nomes nos nós (como “text”) evita erros entre ramificações. • O design HTML da fatura ou do e-mail deve conter apenas imagens públicas (URLs), nunca arquivos locais. • Desative a atribuição do N8N para que o Telegram não exiba a mensagem “enviado via N8N”.
Recursos • Geração de faturas • Geração de relatórios
O SISTEMA
Faturas e Finanças no piloto automático 🧾🔥
Apresento uma automação que, sinceramente, pode ser vendida para qualquer empresa que emita faturas. E não só isso… também cria relatórios financeiros mensais totalmente automáticos.
Imagina um cliente te mandar uma mensagem no Telegram dizendo: – "Gera uma fatura para X no valor de 500€" – e em menos de 30 segundos receber o PDF profissional, arquivado e enviado por e-mail?
Pois é, foi exatamente isso que foi montamos. E foi além:
- 🔥 O que essa automação faz exatamente?
- ✅ Recebe mensagens no Telegram (texto ou áudio) para criar faturas.
- ✅ Interpreta o conteúdo com IA sem usar APIs externas.
- ✅ Gera HTMLs profissionais para as faturas (com ou sem IVA).
- ✅ Converte o HTML em PDF com design de alto nível.
- ✅ Envia o PDF por e-mail com corpo em HTML visual + arquivo anexo.
- ✅ Salva automaticamente a fatura no Google Drive (organizada por mês e ano).
- ✅ Insere os dados no Supabase ou Google Sheets, se quiser manter histórico.
- ✅ E o melhor… cria um relatório financeiro mensal visual e analítico em HTML, sem precisar mover um dedo.
💡 O mais impressionante de tudo: Não usa agentes externos. Não consome tokens da OpenAI. Não há custos ocultos. TUDO é feito por meio de nós de código bem estruturados, e 100% do poder vem do prompt dado ao Gemini para estruturar e gerar o HTML.
Você pode vender isso como serviço se for:
- 🚀 Agência que gerencia faturamento de clientes.
- 📦 SaaS ou consultoria com pagamentos recorrentes.
- 🧠 Profissional independente que precisa de relatórios mensais.
- 💼 Qualquer negócio que queira deixar para trás as planilhas de Excel.
Segue um exemplo da fatura e do relatório para você ver como isso está incrível!
e51 - Faturas e Relatório Financeiro em 1 Clique
1