Integração via Webhook – GreatPages + Leavo
1. Visão Geral
A GreatPages é uma plataforma brasileira especializada na criação de landing pages e sites de alta performance. A integração com o Leavo transforma suas páginas de captura em máquinas de qualificação inteligente de leads.
Casos de uso principais:
- Capturar leads de landing pages e enviar para qualificação via IA
- Integrar campanhas de tráfego pago com follow-up automático
- Coletar informações em páginas de vendas e acionar agente inteligente
- Automatizar fluxo: Landing Page → Captura → Qualificação → CRM
Fluxo disponível:
- ✅ GreatPages → Leavo: Formulários enviam leads para qualificação automática
- ❌ Leavo → GreatPages: Não suportado (GreatPages não recebe webhooks)
Diferencial: Plataforma 100% brasileira com foco em conversão e performance.
2. Documentação Oficial
GreatPages:
Leavo:
3. Recursos disponíveis via Webhook
3.1 Evento da GreatPages
A GreatPages suporta apenas um evento: Envio de Formulário
| Funcionalidade | Suporte | Detalhes |
|---|---|---|
| Envia eventos | ✅ Sim | Envio via POST ou POST+JSON |
| Recebe eventos | ❌ Não | Não suporta webhooks de entrada |
| Formato | POST ou JSON | Configurável |
| Autenticação | ❌ Não | Sem validação nativa |
4. Como configurar webhooks
4.1 FLUXO: GreatPages enviando leads para o Leavo
Passo 1: Criar Webhook de Entrada no Leavo
- Acesse https://app.leavo.ai/pt-BR/ai-settings/webhooks
- Clique na aba "Entrada" (ícone: ⬇️)
- Clique em "+ Criar Webhook"
No modal:
- Nome:
Landing Page GreatPages - [Nome da Campanha] - Descrição:
Captura leads de landing pages GreatPages - Webhook ativo: LIGADO (toggle vermelho)
- Clique em "Criar Webhook"
Passo 2: Copiar URL do Webhook
O Leavo gera URL única:
https://api.leavo.ai/api/webhooks/g1h2i3j4-k5l6-7890-mnop-qr9876543210
⚠️ IMPORTANTE: Copie esta URL - será configurada na GreatPages.
Passo 3: Configurar Webhook na GreatPages
3.1 Acessar editor da página:
- No painel da GreatPages, acesse a página desejada
- Clique em "Editar"
- Selecione o formulário que deseja integrar
3.2 Configurar integração:
- No menu lateral, clique em "Configurar integrações"
- Selecione "Integração via Webhook"
3.3 Escolher tipo de envio:
| Tipo | Quando usar |
|---|---|
| POST | Integrações simples, formato form-urlencoded |
| POST + JSON | RECOMENDADO - Leavo e automações modernas |
✅ Selecione: POST + JSON
3.4 Configurar URL:
- No campo "URL do Webhook", cole a URL do Leavo
3.5 Mapear campos:
Mapeamento recomendado:
| Campo do Formulário | Nome da Variável | Envia para Leavo como |
|---|---|---|
| Nome | name | name |
email | ||
| Telefone | phone | phone |
| Empresa | company | company |
| Mensagem | message | message |
⚠️ CRÍTICO: Use nomes sem espaços e em minúsculo: name, email, phone
3.6 Salvar:
- Clique em "Salvar"
- Clique em "Publicar" para ativar a página
Passo 4: Estrutura do Payload da GreatPages
Formato POST + JSON (Recomendado):
{
"name": "Maria Santos",
"email": "maria.santos@example.com",
"phone": "5511988887777",
"company": "Empresa ABC",
"message": "Gostaria de mais informações sobre a consultoria"
}
Passo 5: Mapear Campos no Leavo
5.1 Mapeamento de Campos:
| Campo do Leavo | Campo do Payload | Preview |
|---|---|---|
| Nome * | name | "Maria Santos" |
email | "maria.santos@example.com" | |
| Telefone * | phone | "5511988887777" |
| Empresa | company | "Empresa ABC" |
5. Observações e Limitações
5.1 Limitações da GreatPages
| Aspecto | Limitação |
|---|---|
| Autenticação | Não possui validação de assinatura |
| Formato | POST ou POST+JSON |
| Retry | Não documentado |
| Webhook entrada | NÃO SUPORTA |
6. Troubleshooting
6.1 Formulário não envia dados
| Causa | Solução |
|---|---|
| URL incorreta | ✅ Recopie URL do Leavo |
| Página não publicada | ✅ Publique a página na GreatPages |
| Campos obrigatórios vazios | ✅ Preencha todos os campos |
6.2 Campos chegam vazios
| Causa | Solução |
|---|---|
| Mapeamento incorreto | ✅ Verifique nomes das variáveis na GreatPages |
| Nome com espaço | ✅ Use name não Nome ou nome completo |
| Case sensitive | ✅ Use minúsculas: name, email, phone |
7. Casos de Uso Práticos
7.1 Landing Page de Captura de Leads
Objetivo: Capturar leads de campanha de Google Ads
Configuração:
- Landing page focada em conversão
- Formulário simples: Nome, Email, Telefone
- Webhook POST + JSON para Leavo
- Agente IA: Qualificação BANT automática
7.2 Página de Inscrição para Webinar
Objetivo: Capturar inscritos e qualificar antes do evento
Configuração:
- Página de inscrição para webinar
- Campos: Nome, Email, Telefone, Empresa, Cargo
- Agente IA: Confirma presença e qualifica interesse
