Pular para o conteúdo principal

n8n

Disponível

Esta integração está ativa e pronta para uso em todos os planos Pro.

Conecte a Frihet ao n8n para automatizar fluxos de trabalho: lembretes automáticos, sincronização com CRM, notificações personalizadas e muito mais.

Para que serve?​

Com n8n integrado:

  • Lembretes automáticos — Envia e-mails quando uma fatura vence
  • Sincronização CRM — Novos clientes são criados no Salesforce, Pipedrive, etc.
  • Notificações personalizadas — Slack, e-mail, Telegram, webhook personalizado
  • Fluxos complexos — Condicionais, loops, ramificações lógicas
  • Webhook endpoints — Outros sistemas disparam ações na Frihet

Requisitos​

Obter credenciais da Frihet​

Na Frihet​

  1. Vá para Configurações → Integrações → n8n
  2. Clique em "Gerar Chave de API"
  3. Copie a chave (algo como: fh_live_XXXXXXXXXXXXXXXXX)
  4. Clique em "Criar Webhook"
  5. Copie a URL do webhook (para receber eventos)

Guarde ambos em um local seguro.

Conectar Frihet ao n8n​

Passo 1: Crie um workflow no n8n​

  1. Vá para n8n.io
  2. Novo workflow
  3. Adicione um nó: Frihet (pesquise por ele)

Passo 2: Configure as credenciais​

  1. No nó da Frihet, vá para Credenciais
  2. Clique em "Criar nova credencial"
  3. Cole a Chave de API da Frihet
  4. Salve

Passo 3: Escolha a ação​

No nó, escolha o que fazer:

  • Criar fatura
  • Criar despesa
  • Criar cliente
  • Obter listagem de clientes
  • Obter listagem de faturas
  • Marcar fatura como paga

Casos de uso comuns​

Lembrete de vencimento​

Quando: Toda manhã às 9h O que faz: Busca faturas vencidas e envia e-mail ao cliente

n8n workflow:
1. Trigger: Cada dia às 09:00
2. Nó Frihet: Obter faturas vencidas
3. Loop: Para cada fatura
4. Nó E-mail: Enviar e-mail de lembrete
5. Atualizar na Frihet: Marcar "Lembrete enviado"

Novo cliente → CRM​

Quando: Um cliente é criado na Frihet O que faz: Automaticamente o adiciona ao Salesforce/Pipedrive

n8n workflow:
1. Trigger: Webhook da Frihet (novo cliente)
2. Nó Frihet: Obter dados do cliente
3. Nó Salesforce: Criar contato
4. Nó E-mail: Notificar a equipe

Fatura paga → Notificação no Slack​

Quando: Uma fatura é marcada como paga O que faz: Envia notificação ao Slack com detalhes

n8n workflow:
1. Trigger: Webhook da Frihet (fatura paga)
2. Nó Frihet: Obter detalhes da fatura
3. Nó Slack: Enviar mensagem formatada
4. Nó Sheet: Registrar no Google Sheets (opcional)

Criar fatura a partir de formulário​

Quando: Alguém preenche um formulário O que faz: Automaticamente cria uma fatura na Frihet

n8n workflow:
1. Trigger: Webhook de formulário (TypeForm, Typebot, etc.)
2. Node: Processar dados do formulário
3. Nó Frihet: Criar fatura
4. Nó E-mail: Confirmar ao cliente

Templates pré-configurados​

n8n e Frihet oferecem templates prontos:

  1. No n8n, vá para Community → Templates
  2. Busque por "Frihet"
  3. Escolha um template
  4. Clique em "Usar este template"
  5. Apenas configure as credenciais

Templates disponíveis​

  • "Lembrete de faturas vencidas"
  • "Sincronizar clientes com Airtable"
  • "Notificações de pagamentos no Slack"
  • "Criar faturas a partir do Typeform"
  • "Backup diário para o Google Drive"

Use-os como base e personalize.

Webhook da Frihet​

A Frihet envia eventos automaticamente ao n8n. Consulte a documentação completa de webhooks para detalhes sobre assinatura HMAC-SHA256, tentativas de reenvio e todos os tipos de evento.

Eventos que disparam o webhook​

EventoDados enviados
Fatura criadaID, cliente, valor, vencimento
Fatura pagaID, cliente, valor, data pagamento
Fatura vencidaID, cliente, valor, dias vencidos
Cliente criadoID, nome, e-mail, telefone
Despesa criadaID, categoria, valor, data
Pagamento recebidoID fatura, cliente, valor

Configurar webhook na Frihet​

  1. Configurações → Integrações → n8n
  2. Clique em "Criar Webhook"
  3. Escolha quais eventos disparar (recomendado: todos)
  4. Copie a URL do webhook
  5. No n8n, configure um nó "Webhook" como trigger com essa URL

Ações disponíveis na Frihet​

Criar fatura​

Entrada:
- ID do Cliente (ou criar novo)
- Conceito
- Valor
- Vencimento
- IVA

Saída:
- ID da fatura criada
- Número do documento
- Status

Criar despesa​

Entrada:
- Categoria
- Valor
- Data
- Fornecedor (opcional)

Saída:
- ID da despesa
- Confirmação

Obter listagem​

Entrada:
- Filtro (data, cliente, status)
- Limite de resultados

Saída:
- Array de faturas/despesas/clientes

Marcar como paga​

Entrada:
- ID da fatura
- Valor (opcional)
- Método de pagamento (opcional)

Saída:
- Confirmação
- Data de atualização

Exemplo completo: Lembrete diário​

Objetivo​

Toda manhã às 8h, se houver faturas vencidas, envia um e-mail ao cliente.

Workflow no n8n​

Passo 1: Trigger

Scheduler: Todos os dias às 08:00
Timezone: Europe/Madrid

Passo 2: Obter faturas vencidas

Nó: Frihet
Ação: Get Invoices
Filtro: State = "unpaid" AND Due Date < Today

Passo 3: Loop sobre cada fatura

Nó Loop: Para cada fatura no resultado
  - Obter e-mail do cliente
  - Calcular dias vencidos

Passo 4: Enviar e-mail

Nó: Gmail / SendGrid
Para: e-mail do cliente
Assunto: "Fatura #{{$node.Frihet.data.number}} a cobrar"
Corpo:
  "Sua fatura {{id}} de {{monto}} euros
   está vencida há {{dias_vencida}} dias.
   Por favor, realize o pagamento o mais rápido possível.
   [Link de pagamento]"

Passo 5: Atualizar na Frihet

Nó: Frihet
Ação: Update Invoice
Atualizar: reminder_sent = true
Atualizar: reminder_date = today

Sincronização bidirecional com CRM​

Criar cliente na Frihet → Salesforce​

1. Trigger: Webhook Frihet (cliente criado)
2. Frihet: Obter dados do cliente
3. Salesforce: Criar Account
4. Salesforce: Criar Contact
5. Frihet: Salvar Salesforce ID no cliente

Criar deal no Salesforce → Fatura na Frihet​

1. Trigger: Webhook Salesforce (deal ganho)
2. Salesforce: Obter dados do deal
3. Frihet: Criar cliente (se for novo)
4. Frihet: Criar fatura com valor do deal
5. Salesforce: Atualizar deal com link para Frihet

Notificações personalizadas​

Opção 1: E-mail​

Nó: Gmail / SendGrid
Template personalizado com:
  - Logo da sua empresa
  - Detalhes da fatura
  - Link de pagamento

Opção 2: Slack​

Nó: Slack
Mensagem:
  ":moneybag: Fatura paga
   Cliente: {{cliente}}
   Valor: €{{monto}}
   Status: Paga ✅"

Opção 3: WhatsApp/Telegram​

Nó: Telegram / WhatsApp (via Twilio)
Mensagem:
  "Olá {{nome}},
   Sua fatura #{{id}} vence em 3 dias.
   [Pague aqui]"

Opção 4: Webhook personalizado​

Se você tem seu próprio sistema:

Nó: HTTP POST
URL: https://seu-sistema.com/frihet-webhook
Body:
  {
    "event": "invoice_paid",
    "invoice_id": "...",
    "amount": 1200,
    "client": "..."
  }

Seu sistema processa conforme necessário.

Condições e lógica​

Você pode adicionar condições:

SE fatura vencida HÁ MAIS DE 7 DIAS
  ENTÃO enviar e-mail + criar tarefa
SE NÃO SE vencida HÁ MENOS DE 7 DIAS
  ENTÃO apenas enviar e-mail
SE NÃO
  ENTÃO não fazer nada

Ou ramificações mais complexas:

SE cliente for "Premium"
  ENTÃO ligar por telefone
SE NÃO SE cliente for "Regular"
  ENTÃO enviar e-mail
SE NÃO
  ENTÃO ignorar

Testes e depuração​

Executar workflow manualmente​

  1. No n8n, clique em "Executar"
  2. Você verá os resultados passo a passo
  3. Se houver erro, ele o mostrará com detalhes
  4. Ajuste e execute novamente

Logs e histórico​

  1. Vá para Executions no seu workflow
  2. Você verá cada execução:
    • Quando foi executado
    • Se foi bem-sucedida
    • Tempo de execução
    • Resultados de cada nó

Teste com dados de teste​

Antes de ativar (agendamento), teste:

  1. Edite o trigger para Manual
  2. Clique em "Executar" várias vezes
  3. Verifique se cada nó funciona
  4. Em seguida, mude para Trigger automático (scheduler)

Limites e custos​

No n8n​

  • Workflows automáticos: Depende do seu plano
  • Execuções: Gratuito até certo limite
  • Nós: Ilimitados
  • Integrações: Centenas disponíveis

Na Frihet​

  • Chamadas de API: Incluídas no Pro (não há limite adicional)
  • Webhooks: Ilimitados
  • Dados: Sem limite especial para n8n

Solução de problemas​

"Webhook não dispara"​

  • Verifique se o webhook está ativo na Frihet
  • O evento deve corresponder à configuração
  • Verifique os logs do n8n: Executions → histórico
  • Se houver erro HTTP, revise o status do webhook

"Erro: Nenhuma credencial encontrada"​

  • No n8n, verifique se as credenciais estão salvas
  • Copie novamente a Chave de API da Frihet
  • Recrie a credencial

"Como depurar se algo não funciona?"​

  1. Adicione um nó "Log" entre os passos para ver dados intermediários
  2. Execute manualmente passo a passo
  3. Vá para Executions → histórico completo
  4. Procure o erro nos logs

"Posso usar múltiplos workflows?"​

Sim. Você pode ter:

  • Workflow 1: Lembretes diários
  • Workflow 2: Sincronização CRM
  • Workflow 3: Backups automáticos
  • Todos rodando em paralelo

Próximos passos​

Anterior: Revolut Business