Configurar o webhook de relatório semanal (Automação)

Gere um token de webhook e use-o em ferramentas como n8n para receber automaticamente um resumo semanal das suas finanças.

Quando usar

Quando você quer integrar o Finanças.3js com uma ferramenta de automação (como n8n, Make ou Zapier) para receber um resumo financeiro semanal de forma automática — em e-mail, Telegram, Notion ou qualquer destino que a sua ferramenta suporte.

O que o webhook retorna

O resumo é sempre da sua conta padrão (normalmente a pessoa física). Lançamentos, faturas e investimentos de outras contas — como uma conta PJ — não entram no cálculo.

Ao chamar a URL do webhook, a resposta inclui:

  • Resumo da semana (receitas, despesas e saldo).
  • Top 5 categorias de despesas da semana.
  • Faturas com vencimento nos próximos 7 dias.
  • Valor total da carteira de investimentos.

Passo a passo

1. Obter o token e a URL do webhook

  1. No menu lateral, clique em "Automação".
  2. A tela exibe o seu Token de Webhook (oculto por padrão) e a URL do Webhook pronta para uso.
  3. Clique no ícone de cópia ao lado da URL do Webhook para copiá-la para a área de transferência.
    • Você também pode copiar apenas o token clicando no ícone de cópia ao lado do campo "Seu token de acesso".

2. Configurar na sua ferramenta de automação

Exemplo com n8n:

  1. Crie um nó "HTTP Request" no seu workflow.
  2. Configure:
    • Method: GET
    • URL: cole a URL copiada do Finanças (ex.: https://financas.3js.com.br/api/v1/webhooks/finance/weekly-report?token=SEU_TOKEN)
  3. Conecte a saída do nó ao destino que quiser (e-mail, Telegram, banco de dados, etc.).
  4. Dispare o workflow manualmente para testar — você deve receber o JSON com o resumo.

3. Regenerar o token (se necessário)

Se o token for comprometido ou você quiser invalidar integrações antigas:

  1. Na tela de Automação, clique em "Regenerar Token".
  2. Confirme no diálogo que aparece. O token anterior é invalidado imediatamente.
  3. Atualize a URL em todas as suas integrações com o novo token.

Atenção: regenerar o token derruba todas as integrações que usam o token antigo. Faça isso apenas quando necessário.

Erros comuns

  • A URL retorna 401 Unauthorized — o token expirou ou foi regenerado. Copie a URL atualizada na tela de Automação e atualize sua integração.
  • A URL retorna 404 — verifique se você está usando a URL exatamente como foi copiada da tela, sem remover nem modificar o parâmetro ?token=.
  • O relatório aparece com valores zerados — não há lançamentos registrados no mês atual na sua conta padrão. Lançamentos feitos em outra conta (ex.: PJ) não aparecem.
  • A URL parou de responder depois que pedi a exclusão da conta — é esperado: com a exclusão solicitada, as integrações deixam de devolver dados. Se você cancelar a exclusão, o webhook volta a funcionar.

Perguntas frequentes

O webhook é acionado automaticamente toda semana? Não. O webhook é uma URL que você chama quando quiser — normalmente agendada pela sua ferramenta de automação (ex.: agendador do n8n toda segunda-feira às 8h).

Quantos tokens posso ter? Um por usuário. Gerar outro invalida o anterior.

Consigo o relatório da minha conta PJ? Ainda não. O webhook sempre resume a conta padrão.

Posso restringir quem tem acesso ao token? Não há controle por membro no momento. Trate o token como uma senha: não compartilhe publicamente.

Artigos relacionados