Integração via Webhook – Elementor + Leavo
1. Visão Geral
O Elementor é o construtor de páginas mais popular para WordPress, permitindo a criação de sites profissionais de forma visual. A integração com o Leavo transforma formulários de captura em máquinas de qualificação inteligente.
Casos de uso principais:
- Capturar leads de landing pages e enviar para qualificação automática
- Coletar informações em formulários de contato e acionar agente de IA
- Integrar campanhas de marketing digital com follow-up inteligente
- Automatizar o fluxo: Site → Captura → Qualificação → CRM
Fluxo disponível:
- ✅ Elementor → Leavo: Formulários enviam leads para qualificação via IA
- ❌ Leavo → Elementor: Não suportado (Elementor não recebe webhooks)
Diferencial: Integração simples e direta - ideal para captura de leads em sites WordPress.
2. Documentação Oficial
Elementor:
- Forms FAQ - Elementor
- Actions After Submit - Elementor
- Elementor Forms Hooks - Developers
- Website oficial
Leavo:
3. Recursos disponíveis via Webhook
3.1 Evento do Elementor
O Elementor Forms suporta apenas um evento: Envio de Formulário (Form Submission)
| Funcionalidade | Suporte | Detalhes |
|---|---|---|
| Envia eventos | ✅ Sim | Envio de formulário via HTTP POST |
| Recebe eventos | ❌ Não | Elementor não suporta webhooks de entrada |
| Formato | JSON ou form-urlencoded | Configurável |
| Autenticação | ❌ Não | Sem validação de assinatura nativa |
4. Como configurar webhooks
4.1 FLUXO: Elementor enviando leads para o Leavo
Este é o fluxo principal da integração: visitantes do site preenchem formulário → dados são enviados ao Leavo → agente IA qualifica o lead.
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 "Criar Novo Webhook":
- Nome:
Formulário Site - [Nome da Página]- Exemplo: "Formulário Site - Landing Page Consultoria"
- Descrição:
Captura leads do site WordPress via Elementor - Webhook ativo: LIGADO (toggle vermelho)
- Clique em "Criar Webhook"
Passo 2: Copiar URL do Webhook
O Leavo gera uma URL única:
https://api.leavo.ai/api/webhooks/f1e2d3c4-b5a6-7890-abcd-ef9876543210
⚠️ IMPORTANTE: Copie esta URL - você vai configurá-la no Elementor.
Passo 3: Configurar Webhook no Elementor
3.1 Editar Formulário:
- No WordPress, acesse a página com o formulário Elementor
- Clique em "Editar com Elementor"
- Selecione o widget Formulário
3.2 Adicionar Ação de Webhook:
- No painel esquerdo, clique na aba "Conteúdo" (Content)
- Expanda a seção "Ações Após Envio" (Actions After Submit)
- No campo de ações, clique e selecione "Webhook"
- Uma nova seção "Webhook" aparecerá abaixo
3.3 Configurar URL:
- No campo "Webhook URL", cole a URL do Leavo
3.4 Salvar:
- Clique em "Atualizar" (Update) no painel do Elementor
- Publique a página
Passo 4: Estrutura do Payload do Elementor
Exemplo de payload enviado pelo Elementor Forms:
{
"form_id": "abc123",
"form_name": "Formulário de Contato - Landing Page",
"fields": {
"name": "João Silva",
"email": "joao.silva@example.com",
"phone": "+5511999999999",
"company": "Empresa XYZ",
"message": "Gostaria de saber mais sobre a consultoria",
"interesse": "Consultoria Empresarial"
},
"page_url": "https://seusite.com/consultoria",
"referrer": "https://google.com/search?q=consultoria"
}
Passo 5: Mapear Campos no Leavo
5.1 Mapeamento de Campos do Lead:
| Campo do Leavo | Campo do Payload Elementor | Preview |
|---|---|---|
| Nome * | fields.name | "João Silva" |
fields.email | "joao.silva@example.com" | |
| Telefone * | fields.phone | "+5511999999999" |
| Empresa | fields.company | "Empresa XYZ" |
5.2 Campos Personalizados (Recomendado):
| Campo Personalizado | Campo do Payload | Preview |
|---|---|---|
Mensagem | fields.message | "Gostaria de saber mais..." |
Interesse | fields.interesse | "Consultoria Empresarial" |
URL_Origem | page_url | "https://seusite.com/consultoria" |
💡 Dica: Use notação de ponto: fields.name, fields.email, page_url
Passo 6: Configurar IDs dos Campos no Elementor
Para garantir mapeamento correto, defina IDs customizados nos campos do formulário:
No Elementor:
- Selecione o campo do formulário (ex: campo "Nome")
- No painel esquerdo, vá na aba "Avançado" (Advanced)
- No campo "ID", digite o nome sem espaços:
- Campo "Nome" → ID:
name - Campo "E-mail" → ID:
email - Campo "Telefone" → ID:
phone - Campo "Empresa" → ID:
company
- Campo "Nome" → ID:
5. Observações e Limitações
5.1 Limitações do Elementor
| Aspecto | Limitação |
|---|---|
| Elementor Pro | Webhook requer versão Pro (paga) |
| Autenticação | Não suporta validação de assinatura |
| Retry | Não possui retry automático |
| Webhook de entrada | NÃO SUPORTA |
6. Troubleshooting
6.1 Formulário não envia dados
| Causa | Solução |
|---|---|
| URL do webhook incorreta | ✅ Recopie URL do Leavo e cole no Elementor |
| Campos obrigatórios vazios | ✅ Preencha todos os campos obrigatórios |
| JavaScript com erro | ✅ Verifique console do navegador (F12) |
| Cache ativo | ✅ Limpe cache do WordPress e do navegador |
6.2 Dados chegam mas campos vazios
| Causa | Solução |
|---|---|
| Mapeamento incorreto | ✅ Use fields.name não name |
| IDs dos campos não definidos | ✅ Configure IDs customizados no Elementor |
| Notação de ponto errada | ✅ Sempre use: fields.[CAMPO] |
7. Casos de Uso Práticos
7.1 Landing Page de Captura
Objetivo: Capturar leads de campanha de anúncios
Configuração:
- Landing page com formulário simples: Nome, Email, Telefone, Interesse
- Tags:
Landing-Page,Campanha-Q4,Google-Ads - Status inicial:
Novo Lead - Agente IA: Qualificação BANT
7.2 Formulário de Contato Inteligente
Objetivo: Todo contato do site vira lead qualificado
Configuração:
- Página "Contato" com formulário expandido
- Campos: Nome, Email, Telefone, Empresa, Cargo, Mensagem
- Agente IA: Prioriza leads com urgência alta


