Integração N8N + Leavo

Integração via Webhook – n8n + Leavo

1. Visão Geral

O n8n é uma ferramenta de automação de workflows open-source e auto-hospedável. A integração com o Leavo permite criar automações flexíveis e customizáveis entre o sistema de qualificação de leads e 400+ outras ferramentas.

Casos de uso principais:

• Receber leads do Leavo e processar com lógica customizada
• Enviar leads de diversas fontes para qualificação no Leavo
• Criar automações complexas com código JavaScript quando necessário
• Auto-hospedar para máximo controle e privacidade de dados

Fluxos disponíveis:

• ✅ n8n → Leavo: Workflows enviam dados para qualificação
• ✅ Leavo → n8n: Webhook aciona workflows

Diferencial: Open-source, auto-hospedável, permite código customizado, sem limites de operações.

2. Documentação Oficial

n8n:

• Webhook Node Documentation
• API Reference
• Webhook URL Configuration

Leavo:

• Painel de Webhooks

3. Recursos disponíveis via Webhook

3.1 Como n8n trabalha com Webhooks

O n8n é extremamente flexível com webhooks:

4. Como configurar webhooks

4.1 FLUXO 1: Leavo enviando para n8n (Acionar Workflow)

Permite que o Leavo dispare workflows no n8n quando leads são qualificados.

Passo 1: Criar Workflow no n8n

1. Acesse sua instância n8n
2. Clique em "+ New workflow"
3. Nomeie: Leavo - Leads Qualificados

Passo 2: Adicionar Nó Webhook

2.1 Adicionar nó:

1. Clique em "+" no canvas
2. Busque "Webhook"
3. Selecione "Webhook" (trigger node)

2.2 Configurar:

2.3 URLs geradas:

O n8n mostra 2 URLs:

Test URL (para desenvolvimento):

Production URL (para produção):

⚠️ Use Production URL para integração final.

Passo 3: Configurar Webhook de Saída no Leavo

1. No Leavo, vá em Webhooks
2. Clique na aba "Saída"
3. Clique em "+ Criar Webhook"

Configurar:

Mapeamento Visual:

Selecione campos:

• ✅ Nome
• ✅ Email
• ✅ Telefone
• ✅ Empresa
• ✅ Status
• ✅ Tags

Passo 4: Testar Webhook

4.1 No n8n:

1. Clique em "Listen for Test Event"
2. Webhook entra em modo de escuta

4.2 No Leavo:

1. Crie lead de teste
2. Altere status para "Qualificado"

4.3 No n8n:

• Dados aparecem no nó Webhook
• Estrutura é mapeada automaticamente

Passo 5: Estrutura do Payload Recebido

{
  "headers": {
    "content-type": "application/json",
    "user-agent": "Leavo-Webhook/1.0"
  },
  "params": {},
  "query": {},
  "body": {
    "event": "lead.status_changed",
    "timestamp": "2025-12-11T18:00:00Z",
    "lead_id": "lead_abc123",
    "data": {
      "nome": "João Silva",
      "email": "joao@example.com",
      "telefone": "5511999999999",
      "empresa": "Empresa ABC",
      "status": "Qualificado",
      "tags": ["Hot-Lead", "B2B"]
    }
  }
}

Acessar dados:

• {{$json.body.data.nome}}
• {{$json.body.data.email}}

Passo 6: Adicionar Ações no Workflow

Exemplo 1: Salvar em Google Sheets

1. Adicione nó "Google Sheets"
2. Selecione "Append"
3. Configure:
   • Spreadsheet: Selecione planilha
   • Sheet: Nome da aba
   • Data to Send: Manual Mapping

Exemplo 2: Enviar Email

1. Adicione nó "Send Email" (SMTP)
2. Configure:
   • To: vendas@empresa.com
   • Subject: Novo Lead: {{$json.body.data.nome}}

Exemplo 3: Criar Deal no Pipedrive

1. Adicione nó "Pipedrive"
2. Selecione "Create" → "Deal"
3. Mapeie campos

Passo 7: Ativar Workflow

1. Clique em "Active" (toggle no topo)
2. Workflow fica ativo
3. Webhooks são processados automaticamente

4.2 FLUXO 2: n8n enviando para Leavo (Capturar Leads)

Permite que n8n capture leads de diversas fontes e envie para qualificação.

Passo 1: Criar Webhook de Entrada no Leavo

1. No Leavo, vá em Webhooks
2. Clique na aba "Entrada"
3. Clique em "+ Criar Webhook"

Configurar:

• Nome: Receber de n8n - Múltiplas Fontes
• Descrição: Recebe leads de workflows n8n
• Webhook ativo: LIGADO

Passo 2: Copiar URL do Leavo

Passo 3: Criar Workflow no n8n

3.1 Adicionar Trigger:

Escolha uma fonte (exemplos):

Opção A: Formulário Typeform

1. Nó "Typeform Trigger"
2. Configure webhook do Typeform
3. Mapeie respostas

Opção B: Google Forms

1. Nó "Google Sheets Trigger"
2. Selecione "On Row Added"
3. Configure planilha

Passo 4: Adicionar Nó HTTP Request

5. Testando a integração

✅ Checklist - Leavo → n8n

Leavo:

• Webhook de saída criado
• URL do n8n configurada (Production)
• Trigger configurado
• Campos mapeados

n8n:

• Workflow criado
• Webhook node configurado
• Production URL copiada
• Ações adicionadas
• Workflow ativado

✅ Checklist - n8n → Leavo

n8n:

• Workflow criado
• Trigger configurado
• HTTP Request adicionado
• URL do Leavo configurada
• Body mapeado
• Workflow ativado

Leavo:

• Webhook de entrada criado
• URL copiada
• Payload recebido
• Campos mapeados

6. Estrutura de Payloads

6.1 Leavo → n8n

{
  "headers": {...},
  "body": {
    "event": "lead.qualified",
    "timestamp": "2025-12-11T18:00:00Z",
    "lead_id": "lead_xyz",
    "data": {
      "nome": "Pedro Oliveira",
      "email": "pedro@example.com",
      "telefone": "5511977776666",
      "empresa": "Startup ABC",
      "status": "Qualificado",
      "tags": ["Hot", "B2B"],
      "score": 90
    }
  }
}

6.2 n8n → Leavo

{
  "name": "Ana Costa",
  "email": "ana@example.com",
  "phone": "5511955554444",
  "company": "Consultoria XYZ",
  "source": "n8n-typeform",
  "interest": "Produto Premium"
}

7. Observações e Limitações

7.1 Limitações do n8n

7.2 Vantagens do n8n

✅ Open-source: Código aberto, customizável ✅ Auto-hospedável: Controle total dos dados ✅ Sem limites: Execuções ilimitadas ✅ Código customizado: JavaScript em Function nodes

8. Boas Práticas

8.1 Estrutura de Workflows

✅ Use Error Workflows:

1. Crie workflow separado para erros
2. Configure em Settings → Error Workflow
3. Recebe todos os erros de outros workflows

8.2 Autenticação

✅ Header Auth para webhooks:

9. Troubleshooting

9.1 Webhook não responde

9.2 Dados não chegam

10. Casos de Uso

10.1 Leavo → CRM via n8n

Objetivo: Leads qualificados vão para Pipedrive

Fluxo:

10.2 Múltiplas Fontes → Leavo

Objetivo: Capturar leads de várias plataformas

Fluxo:

Referências

• n8n Webhook Node Documentation
• n8n API Reference
• Painel de Webhooks Leavo