Propósito da automação
O projeto consiste em uma automação que entrega, semanalmente e sem intervenção manual, um raio-x financeiro de cada cliente ativo diretamente em seu WhatsApp. O processo segue três etapas:
Busca dos dados financeiros atualizados do cliente, diretamente na financeiro-api
Geração de diagnóstico e plano de ação por inteligência artificial, em português e com linguagem direta
Envio do relatório, já formatado, ao WhatsApp do cliente
O fluxo no n8n
Captura real do workflow em produção — do gatilho semanal até o alerta de falha.
Disparo Semanal
Cron que inicia o processo automaticamente toda segunda, às 8h.
Configurações
Centraliza URLs, instância do WhatsApp e telefone do admin num único lugar.
Buscar Clientes (Google Sheets)
Lê a planilha de clientes: nome, telefone, token de acesso e status.
Somente Clientes Ativos
Filtra e segue só com quem está marcado como ativo na planilha.
Loop Clientes
Processa um cliente por vez, evitando sobrecarregar a API e o WhatsApp.
GET Dashboard Financeiro
Consulta os dados financeiros do cliente na financeiro-api, em tempo real.
Basic LLM Chain
A Open AI analisa os números e escreve o diagnóstico e o plano de ação.
Aguardar 5s
Pausa entre envios pra não disparar o bloqueio antispam do WhatsApp.
Enviar WhatsApp
Envia a mensagem final, já formatada, pro número do cliente.
Envio OK?
Confere se a mensagem foi mesmo entregue.
Alertar Admin
Se algo falhar, avisa o admin no WhatsApp — ninguém fica sem saber.
Fim do Envio
Encerra o ciclo daquele cliente e volta pro Loop, até acabar a lista.
O que já foi executado
Entrega prevista para agosto de 2026Clique em cada fase pra ver o detalhe.
- Relatório financeiro semanal automático, toda segunda às 8h, via WhatsApp
- N8N escolhido como motor de automação — low-code e flexível
- Cloudfy escolhida pra hospedar N8N e Evolution API juntos
- Fluxo de dados definido: Google Sheets → financeiro-api → Open AI → WhatsApp
- Autenticação por syncToken — um token único por cliente
- Conta N8N e instância Evolution API criadas na Cloudfy
- Chave OpenAI configurada
- Planilha de clientes estruturada — nome, telefone, token, status
- Credenciais migradas pro sistema de Credentials do N8N: antes ficavam visíveis no histórico de execuções, o que era um risco real de segurança
- Os 13 nós do workflow montados e conectados, do disparo semanal ao alerta de falha
- Detalhe completo de cada nó na seção "Como Funciona", acima
- Endpoint corrigido de POST para GET
- Backend exposto publicamente — antes só existia em localhost, inacessível pra nuvem
- Parâmetro desnecessário removido: o token já identifica o cliente
- Endpoint final fechado e funcionando: /api/v1/sync/dashboard
- Configuração da planilha corrigida — estava buscando pelo ID errado
- Filtro de clientes ativos corrigido — a planilha tinha um espaço extra no campo "sim"
- Nome da instância do WhatsApp corrigido
- Instabilidade de conexão resolvida recriando a instância na Cloudfy
- Nós de código que travavam com timeout foram trocados por nós nativos do N8N
- Fluxo ficou mais estável e parou de depender do task runner, que era o ponto fraco
- Formato do envio ao WhatsApp corrigido
- Verificação de sucesso do envio corrigida
- Primeira mensagem real entregue com sucesso, com KPIs e diagnóstico da Open AI
Funcionando
- Busca de clientes no Google Sheets
- Consulta de dados financeiros na API
- Diagnóstico e plano de ação gerado por Open AI
- Envio da mensagem formatada via WhatsApp
- Notificação de falhas para o admin
Pendente para o go-live
- Ativar o workflow (toggle no N8N)
- Instância de WhatsApp de produção (número da empresa)
- Validar dados de todos os clientes na planilha
Como o relatório chega no WhatsApp
Os dois cenários planejados pro projeto — um já em testes, outro ainda no papel.
Cenário 1 — Texto
Em testesA versão mais simples e já funcionando: KPIs + diagnóstico da Open AI, direto em texto.
Loja da Julia
💰 Faturamento: R$ 125.470,00
📤 Contas a Pagar: R$ 4.320,00
📥 Contas a Receber: R$ 18.940,00
🏦 Saldo nas Contas: R$ 41.230,00
📈 Diagnóstico: o faturamento segue em crescimento nos últimos meses, com margem acima de 50%. As despesas cresceram em ritmo controlado, sem comprometer o caixa.
✅ Plano de Ação:
1. Negociar prazo das contas a pagar mais próximas do vencimento
2. Acelerar a cobrança das contas a receber em aberto
3. Reinvestir parte da margem em estoque pra sustentar o crescimento
Relatório automático · ProGestão BI 08:00
O que vai nessa mensagem
- 4 KPIs direto da financeiro-api: faturamento, contas a pagar, contas a receber, saldo
- Diagnóstico de até 4 linhas, escrito pela Open AI com base nesses números
- Plano de ação com 3 recomendações priorizadas pra semana
- Assinatura automática no fim, identificando o serviço
* Exemplo ilustrativo, com dados fictícios para fins de demonstração.
Cenário 2 — Texto + Print do Painel
PlanejadoMesma ideia, mas com o print do dashboard anexado e a mensagem mais curta — o plano de ação acompanha a imagem.
Loja da Julia
✅ Plano de Ação:
1. Negociar prazo das contas a pagar
2. Acelerar cobrança das contas a receber
3. Reinvestir margem em estoque
Relatório automático · ProGestão BI
O que falta construir pra esse cenário existir
- Endpoint novo no backend pra gerar a imagem do dashboard (PNG, gerada no servidor)
- N8N lendo e tratando esse arquivo binário — hoje o fluxo só lida com texto/JSON
- Endpoint diferente na Evolution API pra mandar mídia (sendMedia, não sendText)
* Print real do painel (Loja da Julia). Mensagem é exemplo ilustrativo.