Integração Zapier + Leavo

Integração via Webhook – Zapier + Leavo

1. Visão Geral

O Zapier é a maior plataforma iPaaS do mundo, conectando 6.000+ aplicativos. A integração com o Leavo permite criar automações complexas entre o sistema de qualificação de leads e praticamente qualquer ferramenta existente.

Casos de uso principais:

• Enviar leads do Leavo para 6.000+ apps
• Receber leads de qualquer fonte para qualificação
• Criar workflows complexos multi-step
• Conectar sistemas legados e modernos

Fluxos disponíveis:

• ✅ Zapier → Leavo: Catch Hook recebe de qualquer fonte
• ✅ Leavo → Zapier: Webhooks disparam Zaps

Diferencial: Maior ecossistema (6000+ apps), interface no-code, middleware universal, rate limits robustos.

2. Documentação Oficial

Zapier:

• Webhooks by Zapier - Catch Hook
• Send Webhooks in Zaps
• Rate Limits

Leavo:

• Painel de Webhooks

3. Recursos disponíveis via Webhook

3.1 Webhooks by Zapier

O Zapier oferece webhooks bidirecionais:

3.2 Rate Limits

4. Como configurar webhooks

4.1 FLUXO 1: Leavo → Zapier (Acionar Zaps)

Permite que o Leavo dispare automações no Zapier quando leads são qualificados.

Passo 1: Criar Zap no Zapier

1. Acesse https://zapier.com
2. Clique em "Create Zap"
3. Nomeie: Leavo - Leads Qualificados

Passo 2: Configurar Trigger (Catch Hook)

2.1 Selecionar App:

• App: Webhooks by Zapier
• Trigger Event: Catch Hook
• Clique em Continue

2.2 URL Gerada:

Zapier gera URL exclusiva:

⚠️ IMPORTANTE: Esta URL é secreta. Copie para configurar no Leavo.

2.3 Teste o Hook:

• Zapier fica em modo "listening"
• Aguarde até enviar teste do Leavo

Passo 3: Configurar Webhook de Saída no Leavo

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

Configurar:

Mapeamento:

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

Passo 4: Testar Trigger no Zapier

4.1 No Leavo:

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

4.2 No Zapier:

• Zapier captura o payload automaticamente
• Campos aparecem para mapeamento

Passo 5: Adicionar Actions no Zap

Exemplo 1: Google Sheets

1. Clique em "+" (Add Step)
2. App: Google Sheets
3. Action: Create Spreadsheet Row
4. Mapeie campos do Catch Hook

Exemplo 2: Send Email (Gmail)

1. App: Gmail
2. Action: Send Email
3. Configure:
   • To: vendas@empresa.com
   • Subject: Novo Lead: {{nome}}

Exemplo 3: Slack

1. App: Slack
2. Action: Send Channel Message
3. Configure:
   • Channel: #vendas
   • Message: 🔥 Lead qualificado: {{nome}} - {{empresa}}

Passo 6: Testar e Ativar

1. Clique em "Test action" para cada step
2. Verifique se tudo funciona
3. Clique em "Publish"
4. Zap fica ativo

4.2 FLUXO 2: Zapier → Leavo (Enviar Leads)

Permite que qualquer app conectado ao Zapier envie leads para o Leavo.

Passo 1: Criar Webhook de Entrada no Leavo

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

Configurar:

• Nome: Receber de Zapier - Múltiplas Fontes
• Descrição: Recebe leads de apps via Zapier
• Webhook ativo: LIGADO

Passo 2: Copiar URL do Leavo

Passo 3: Criar Zap no Zapier

3.1 Selecionar Trigger:

Escolha qualquer app como trigger (exemplos):

• Google Forms (New Response)
• Typeform (New Entry)
• Facebook Lead Ads (New Lead)
• LinkedIn Lead Gen (New Lead)
• Calendly (Invitee Created)

Passo 4: Adicionar Webhooks Action

4.1 Add Action:

1. Clique em "+"
2. App: Webhooks by Zapier
3. Action Event: POST
4. Clique em Continue

4.2 Configurar POST:

4.3 Mapear Dados:

5. Testando a integração

✅ Checklist - Leavo → Zapier

Zapier:

• Zap criado
• Catch Hook configurado
• URL copiada
• Sample data capturada
• Actions adicionadas
• Zap publicado

Leavo:

• Webhook de saída criado
• URL do Zapier configurada
• Trigger configurado

✅ Checklist - Zapier → Leavo

Zapier:

• Zap criado
• Trigger configurado
• Webhooks Action adicionada
• URL do Leavo configurada
• Dados mapeados
• Zap publicado

Leavo:

• Webhook de entrada criado
• URL copiada
• Campos mapeados

6. Estrutura de Payloads

6.1 Leavo → Zapier (Catch Hook)

{
  "nome": "Maria Santos",
  "email": "maria@example.com",
  "telefone": "5511988887777",
  "empresa": "Tech Solutions",
  "status": "Qualificado",
  "tags": "Hot-Lead, B2B",
  "score": 85,
  "origem": "Google Ads"
}

6.2 Zapier → Leavo (POST Action)

{
  "name": "Pedro Oliveira",
  "email": "pedro@example.com",
  "phone": "5511977776666",
  "company": "Startup XYZ",
  "source": "Zapier - Typeform",
  "form_name": "Formulário Interesse B2B"
}

7. Observações e Limitações

7.1 Rate Limits do Zapier

⚠️ Importante: Se receber 429, implemente retry com exponential backoff.

7.2 Planos do Zapier

Task = 1 ação executada (cada action do Zap conta)

8. Boas Práticas

8.1 Usar Filters para Economizar Tasks

✅ Adicione Filters antes das Actions:

Economia: Evita gastar tasks com leads não qualificados

8.2 Paths para Lógica Condicional

✅ Use Paths para criar branches:

9. Troubleshooting

9.1 Zap não executa

9.2 Campos não mapeiam

9.3 Erro 429 Rate Limit

Sintoma: Zap para de executar

Solução:

1. Distribua execuções ao longo do tempo
2. Use Delay action entre steps
3. Considere upgrade de plano

10. Casos de Uso

10.1 Facebook Lead Ads → Leavo

Objetivo: Qualificar leads de anúncios

Fluxo:

10.2 Leavo → Multi-Destino

Objetivo: Lead qualificado vai para múltiplos lugares

Fluxo:

Referências

• Zapier Webhooks by Zapier - Catch Hook
• Zapier Send Webhooks in Zaps
• Painel de Webhooks Leavo