Como conectar um formulário a um webhook
Form webhooks enviam dados de envio de um elemento Form para um endpoint HTTPS externo em tempo real — junto com armazenamento em Leads.
Configure o webhook no formulário no Page Builder. Use Form webhook delivery para monitorar e reenviar — não para adicionar a URL pela primeira vez.
Antes de começar
Confirme que você tem:
- Uma página com um elemento Form (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: Webhook API keys se seu receptor valida assinaturas Atomicat.
Veja Elemento Form — configurações de webhook e Form webhook delivery.
Passo 1: Abrir o Form no Page Builder
- Vá em Pages e clique em Edit na página desejada.
- Clique no elemento Form no canvas.
- Abra a gaveta de edição à direita.
Passo 2: Adicionar configurações de webhook
Na gaveta do formulário, encontre a configuração Webhook (quando disponível no seu workspace):
| Configuração | O que faz |
|---|---|
| Webhook name | Rótulo interno para sua equipe e logs de entrega. |
| Webhook URL | Endpoint HTTPS que recebe JSON de envio. |
| Description | Nota opcional sobre destino CRM/automação. |
| Send abandoned leads | Envia dados parciais quando visitante começa mas não termina. |
Preencha name e URL antes de testar. Use nomes descritivos (Meta lead – VSL page) para telas de entrega permanecerem pesquisáveis.
Passo 3: Opcional — Leads abandonados
Ative Send abandoned leads somente se:
- Seu processo de follow-up lida com envios incompletos, e
- Regras de compliance 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 Save no Page Builder.
- Publish a página no site/domínio ao vivo. Veja Publicar uma página.
Configuração de webhook em página somente 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 incognito.
- Envie o formulário com dados de teste realistas (todos os campos obrigatórios).
- Confirme:
- Lead aparece em Form leads
- 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 sejam enviados incorretamente.
Repita com comportamento abandoned se ativado (preenchimento parcial, sair da página — comportamento depende das regras do produto).
Passo 6: Monitorar e reenviar entregas
- Abra Form leads → atalho do cabeçalho Webhooks (ou navegue para Form webhook delivery).
- Revise cards de resumo: total, successful, failed, success rate.
- Filtre por status, form ou search de texto de URL.
- Clique em View details em uma linha para payload e corpo de resposta.
- Use Resend 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 Form no Page Builder para alterar URL, depois republique.
Opcional: Histórico de webhook no Form
Alguns workspaces expõem Webhook history na gaveta do elemento Form (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 API keys no receptor quando a 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 |
|---|---|
| Nenhum webhook 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 | Abandoned + submit 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 encontra configurações de webhook | Plano/workspace pode ocultar webhooks — consulte referência do elemento Form. |
Resultado
Seu formulário envia envios ao endpoint HTTPS na página ao vivo enquanto o Atomicat armazena leads em Form leads — com monitoramento e reenvio disponíveis em Form webhook delivery.
Documentação relacionada
- Referência do elemento Form
- Form webhook delivery
- Webhook API keys
- Como visualizar e exportar leads de formulário
- Solução de problemas de webhooks
Perguntas frequentes
Onde defino a URL do webhook?
No elemento Form no Page Builder — não na tela de monitoramento Form webhook delivery.
Envios ainda aparecem em Leads?
Sim quando o formulário está configurado corretamente. Webhooks são um canal adicional de entrega em tempo real.
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 em que sua stack confia. Siga mensagens de validação na gaveta do formulário.
Um formulário pode ter vários webhooks?
Depende da UI do workspace — se só uma linha for exibida, use middleware para fan-out ou contate suporte para padrões multi-destino.