Como Conectar um Formulário a um Webhook
Webhooks de formulário enviam dados de envio de um elemento Formulário para um endpoint HTTPS externo em tempo real — junto com armazenamento em Leads.
Configure o webhook no formulário no Page Builder. Use Entrega de webhooks de formulário para monitorar e reenviar — não para adicionar a URL pela primeira vez.
Antes de Começar
Certifique-se de ter:
- Uma página com elemento Formulário (ou siga Como adicionar um formulário a uma página primeiro).
- Um endpoint HTTPS pronto para aceitar payloads POST.
- Permissão para publicar a página após salvar configurações de webhook.
- Opcional: Chaves de API de webhook se seu receptor valida assinaturas Atomicat.
Veja Entrega de webhooks de formulário.
Passo 1: Abrir o Formulário no Page Builder
- Vá para Pages e clique em Edit na página de destino.
- Clique no elemento Formulário no canvas.
- Abra o drawer de edição à direita.
Passo 2: Adicionar Configurações de Webhook
No drawer do formulário, encontre a configuração de Webhook (quando disponível no seu workspace):
| Configuração | O que faz |
|---|---|
| Nome do webhook | Rótulo interno para sua equipe e logs de entrega. |
| URL do webhook | Endpoint HTTPS que recebe JSON de envio. |
| Descrição | Nota opcional sobre destino CRM/automação. |
| Enviar leads abandonados | Envia dados parciais quando visitante começa mas não termina. |
Preencha nome e URL antes de testar. Use nomes descritivos (Lead Meta – página VSL) para telas de entrega pesquisáveis.
Passo 3: Opcional — Leads Abandonados
Habilite Enviar leads abandonados apenas se:
- Seu processo de follow-up lida com envios incompletos, e
- Regras de conformidade permitem exportação de dados parciais.
Tráfego abandonado pode aumentar volume de webhook — confirme que seu endpoint deduplica ou marca leads parciais.
Passo 4: Salvar e Publicar a Página
- Clique em Salvar no Page Builder.
- Publique a página no site/domínio ao vivo. Veja Publicar uma página.
Configuração de webhook em página apenas rascunho não envia tráfego de produção ao seu endpoint.
Passo 5: Testar na URL Publicada
- Abra a URL HTTPS ao vivo em anônimo.
- Envie o formulário com dados de teste realistas (todos os campos obrigatórios).
- Confirme:
- Lead aparece em Leads de formulário
- Seu endpoint registrou o payload com campos esperados
- Teste falhas de validação (campos obrigatórios vazios) para garantir que envios inválidos não são enviados incorretamente.
Repita com comportamento abandonado se habilitado (preenchimento parcial, sair da página — comportamento depende das regras do produto).
Passo 6: Monitorar e Reenviar Entregas
- Abra Leads de formulário → atalho Webhooks no cabeçalho (ou navegue para Entrega de webhooks de formulário).
- Revise cards de resumo: total, bem-sucedidos, falhas, taxa de sucesso.
- Filtre por status, formulário ou pesquisa por texto de URL.
- Clique em Ver detalhes em uma linha para payload e corpo de resposta.
- Use Reenviar em linhas com falha quando o destino esteve temporariamente indisponível.
Você não pode editar a URL do webhook nesta tela — volte às configurações do elemento Formulário no Page Builder para alterar URL e republicar.
Opcional: Histórico de Webhook no Formulário
Alguns workspaces expõem Histórico de webhook no drawer do elemento Formulário (status de entrega, tentativas, estado de retry). Use para verificações rápidas enquanto edita a mesma página.
Boas Práticas
- Teste cada mapeamento de campo implicitamente — seu endpoint deve esperar chaves de campo Atomicat.
- Use Chaves de API no receptor quando política de segurança exigir.
- Republique após alterações de URL antes de rodar tráfego pago novamente.
- Mantenha um webhook por destino quando payloads diferem; use nomes claros.
Solução de Problemas
| Problema | O que tentar |
|---|---|
| Webhook não recebido | Página publicada? Teste URL ao vivo, não preview do builder. |
| 4xx/5xx no receptor | Inspecione detalhes de entrega; valide auth e schema. |
| Payloads duplicados | Abandonado + envio podem disparar separadamente — trate no servidor. |
| Alteração de URL não ao vivo | Salve formulário, republique página, limpe CDN/cache se aplicável. |
| Não encontro configurações de webhook | Plano/workspace pode ocultar webhooks — verifique referência do elemento Formulário. |
Resultado
Seu formulário envia envios ao seu endpoint HTTPS na página ao vivo enquanto o Atomicat armazena leads em Leads de formulário — com monitoramento e reenvio disponíveis em Entrega de webhooks de formulário.
Documentação Relacionada
- Leads de formulário
- Entrega de webhooks de formulário
- Chaves de API de webhook
- Como visualizar e exportar leads de formulário
- Solução de problemas de webhooks
FAQ
Onde configuro a URL do webhook?
No elemento Formulário no Page Builder — não na tela de monitoramento Entrega de webhooks de formulário.
Envios ainda aparecem em Leads?
Sim quando o formulário está configurado corretamente. Webhooks são um canal de entrega em tempo real adicional.
Preciso publicar após alterar a URL do webhook?
Sim. Visitantes ao vivo usam a configuração da página publicada.
HTTP vs HTTPS?
Use endpoints HTTPS que sua stack confia. Siga mensagens de validação no drawer do formulário.
Um formulário pode ter vários webhooks?
Depende da UI do workspace — se apenas uma linha for exibida, use middleware para distribuir ou contate suporte para padrões multi-destino.