Skip to content

README.md

Latest commit

 

History

History
100 lines (64 loc) · 3.99 KB

README.md

File metadata and controls

100 lines (64 loc) · 3.99 KB
Raw

n8n-assistente-financeiro

Guia dos Arquivos — n8n + Telegram + IA Financeira + Dashboard

Este repositório contém os arquivos necessários para rodar dois workflows no n8n que formam um assistente financeiro completo via Telegram, com registro inteligente de gastos, geração de relatórios e um dashboard web interativo.

workflow_assistente_financeiro.json

Arquivo principal do agente financeiro. Como usar:

Abra o n8n → importe o conteúdo do JSON.

Este fluxo recebe mensagens no Telegram (texto, áudio ou imagem) e usa um agente de IA para interpretar e executar ações financeiras automaticamente.

Ajuste as credenciais do Telegram Bot, OpenAI e Redis antes de rodar.

O que este workflow faz:

  • Recepção de mensagens: Escuta mensagens via Telegram Trigger e normaliza texto, áudio e imagens
  • Análise de mídia: Transcreve áudios (Whisper), analisa imagens de notas fiscais (GPT-4o) e extrai dados automaticamente
  • Agente financeiro (Brain): Um agente LLM com três tools disponíveis:
    • registrar_gasto — registra entradas e saídas financeiras na data table do n8n
    • gerar_relatorio — consulta registros filtrados por período e/ou categoria
    • calcular — executa operações matemáticas para cálculos financeiros
  • Memória de contexto: Usa Redis para manter o histórico da conversa por usuário
  • Resposta ao usuário: Envia a resposta formatada de volta ao Telegram

Categorias suportadas:

Saídas: Alimentação, Transporte, Moradia, Saúde, Lazer, Educação, Vestuário, Tecnologia, Financeiro, Outros

Entradas: Salário, Freelance, Investimento, Venda, Outros

Exemplos de uso:

"R$45 mercado hoje pix"         → registra saída em Alimentação
"Aluguel R$800 dia 05/03 pix"   → registra saída em Moradia/Fixo
"Recebi meu salário R$5000"     → registra entrada em Salário
"gastos de fevereiro"           → gera relatório do mês
"quanto gastei com transporte?" → filtra por categoria

Credenciais necessárias:

  • Telegram Bot (token do BotFather)
  • OpenAI API (para o agente, transcrição e análise de imagem)
  • Redis (para memória de contexto entre mensagens)
  • n8n Data Table configurada com as colunas: IdConversa, Mes, Data, Categoria, Valor, Tipo, Metodo, Descricao

dashboard_workflow.json

Workflow do dashboard web financeiro. Como usar:

Abra o n8n → importe o conteúdo do JSON.

Este fluxo expõe dois endpoints webhook:

  • GET /webhook/dashboard-financeiro — serve o dashboard como página HTML
  • POST /webhook/dashboard-data — recebe filtros de data e retorna os registros da data table em JSON

Ajuste o IdConversa fixo no nó Get row(s) para o ID do seu usuário do Telegram antes de rodar.

O que este workflow faz:

  • Serve o dashboard: Renderiza uma página HTML completa com gráficos interativos usando Chart.js
  • Fornece os dados: Consulta a data table do n8n com filtros de período e retorna os registros em JSON para o frontend

Funcionalidades do dashboard:

  • Cards de métricas: Receita total, Despesas totais e Saldo do período
  • Gráfico de linha: Evolução de gastos vs. faturamento agrupado por dia, semana ou mês
  • Gráfico de barras horizontal: Benchmark visual entre receita e despesa
  • Gráfico de rosca: Distribuição de gastos por categoria
  • Tabela de extrato: Lista completa de lançamentos com data, categoria, descrição e valor

Credenciais necessárias:

  • n8n Data Table (mesma tabela usada pelo workflow do assistente)

Estrutura do Repositório

n8n-assistente-financeiro/
├── workflow_assistente_financeiro.json   # Workflow do agente financeiro via Telegram
├── dashboard_workflow.json               # Workflow do dashboard web
└── README.md

Sobre

Este projeto foi desenvolvido para automatizar o controle financeiro pessoal via Telegram, usando IA para interpretar mensagens em linguagem natural e registrar transações automaticamente, sem necessidade de preencher formulários.