Nem toda integração precisa ser nativa. Quando o CRM ou a ferramenta de automação não tem conexão direta com o formulário, os webhooks resolvem: a cada novo lead, o formulário envia os dados para a URL que você definir.
Este guia, elaborado pelo Time Formlytics, mostra o que são webhooks, como configurar em formulários e quando eles são a melhor escolha. Serve para agências, gestores de tráfego, infoprodutores e qualquer operação que precisa levar leads a um sistema sem integração pronta.
O que é um webhook
Webhook é um mecanismo de comunicação entre sistemas: quando um evento acontece (alguém conclui o formulário), o sistema A envia os dados para o sistema B por HTTP POST.
Em uma API tradicional, o sistema B precisa “perguntar” se há dados novos. O webhook é push: o dado é enviado assim que o evento ocorre.
Fluxo típico:
Lead conclui o formulário → Formulário dispara o webhook → Sistema receptor processa os dados → Lead aparece no CRM ou no sistema de destinoO conceito completo está no glossário de webhooks. Os detalhes do recurso na Formlytics estão na página da integração por webhook.
Por que usar webhooks em formulários
1. Alcance amplo. Qualquer sistema capaz de receber uma requisição HTTP em uma URL pode receber um webhook. Quando o formato esperado é outro, uma ferramenta intermediária faz a tradução.
2. Tempo real. O dado segue para o destino assim que a resposta é enviada. Ninguém precisa buscar os dados de tempos em tempos.
3. Flexibilidade. O destino decide o que fazer com os dados: criar um lead, atualizar um cadastro, avisar alguém.
4. Mesma configuração para qualquer volume. O envio é feito resposta a resposta, com poucos ou muitos leads.
5. Fim do retrabalho. Sem webhook, alguém precisa exportar os leads do formulário e importar no outro sistema. Com webhook, isso acontece sozinho.
Como configurar um webhook no formulário
Passo 1: Obtenha a URL do webhook (endpoint)
O sistema de destino precisa fornecer uma URL que aceite requisições POST. Exemplos:
- CRM ou sistema próprio: um endpoint da sua API, como
https://meucrm.com/api/webhooks/leads - Ferramenta intermediária de automação (como n8n, Make ou Zapier): a URL de webhook gerada por ela
- Slack e similares: exigem um formato próprio de mensagem. Por isso, o envio passa por uma ferramenta intermediária, que monta a mensagem
Na Formlytics, o webhook é configurado na aba “Integrar” do formulário. Cada formulário tem um webhook.
Passo 2: Conheça o payload
O payload é o conjunto de dados enviado. Veja um exemplo genérico em JSON, só para ilustrar a ideia:
{
"nome": "João Silva",
"email": "joao@empresa.com",
"telefone": "51999999999",
"empresa": "Tech Ltda",
"utm_source": "google",
"utm_campaign": "lancamento",
"timestamp": "2026-06-08T14:30:00Z"
}O formato exato varia de plataforma para plataforma. Na Formlytics, o webhook envia um POST em JSON com o evento form.submission.created. Uma opção de dados avançados inclui UTMs, tracking, referrer e metadados. Envie uma resposta de teste e veja no destino os campos que chegam antes de montar o restante do fluxo.
Passo 3: Entenda as novas tentativas
Webhooks podem falhar: o destino pode estar fora do ar, demorar demais ou devolver um erro. A plataforma de formulários deve tentar de novo.
Na Formlytics, uma entrega com falha passa por até 4 tentativas automáticas, e a nova tentativa pode levar até cerca de 30 minutos. Se o erro continua, o card da integração mostra o status de erro com a mensagem.
Passo 4: Teste o fluxo
Envie algumas respostas de teste e confira se o destino recebe os dados corretamente. Valide os campos, o formato e o tempo de chegada.
Exemplos práticos de webhook
Webhook para CRM
A cada resposta concluída, o formulário envia os dados para o CRM. O lead aparece no funil com as respostas e a origem da campanha.
Atenção: o que segue no webhook são as respostas. Na Formlytics, a pontuação criada com variáveis fica dentro do formulário e não é enviada. Se você usa lead scoring, calcule a nota no destino a partir das respostas.
Aviso no Slack (com ferramenta intermediária)
O webhook aponta para uma ferramenta de automação. Ela recebe os dados, monta a mensagem e publica no canal de vendas:
Novo lead!
Empresa: Tech Ltda
Contato: João Silva - joao@empresa.com
Campanha: lancamento-jun-2026O time recebe o alerta e pode agir em seguida. O webhook não fala direto com o Slack: quem formata e envia a mensagem é a ferramenta intermediária.
Planilhas
Para quem usa planilha como apoio, vale primeiro checar se existe integração nativa. A Formlytics tem integração com o Google Planilhas, que dispensa o webhook. Para outras ferramentas de planilha, o webhook, com um intermediário, cria uma linha a cada lead.
Sistema próprio
Empresas com sistemas antigos ou ferramentas internas usam webhooks para receber os leads do formulário sem mudar o que já existe.
Webhook vs. integração nativa
| Aspecto | Integração nativa | Webhook |
|---|---|---|
| Configuração | Cliques, sem código | Requer uma URL de destino |
| Flexibilidade | Limitada ao que a plataforma oferece | Alta |
| Manutenção | Menor | Precisa de acompanhamento |
| Ideal para | Ferramentas com conexão pronta | Sistemas próprios e ferramentas sem conexão pronta |
| Velocidade | Envio na conclusão | Envio na conclusão |
As integrações nativas são o melhor caminho quando existem (na Formlytics: ActiveCampaign, Kommo e Google Planilhas). Webhooks são a solução para o que não tem conexão pronta. O guia de integrações de marketing mostra como escolher entre os dois.
Boas práticas de webhooks
1. Conte com novas tentativas. O destino pode falhar. Verifique se a plataforma tenta de novo e prepare o seu sistema para receber o mesmo envio mais de uma vez sem duplicar o lead.
2. Valide o payload. Confira se os dados chegam no formato que o destino espera. Acentos, caracteres especiais e quebras de linha são fontes comuns de erro.
3. Acompanhe as falhas. Olhe com frequência o status da integração e os registros do sistema de destino.
4. Documente os campos. Mantenha uma lista atualizada do que cada webhook envia. Isso facilita a manutenção e a conexão com novos sistemas.
5. Garanta a segurança. Use HTTPS e confirme a origem de cada envio. Na Formlytics, você pode definir um segredo de assinatura: cada envio leva uma assinatura HMAC SHA-256 no cabeçalho x-formlytics-signature, que o seu sistema confere antes de aceitar os dados.
Webhooks + follow-up
O webhook é o ponto de partida do que acontece depois da captura. Com o lead no sistema de destino, a automação de marketing assume:
- O webhook envia o lead para o CRM
- O CRM cria a tarefa de follow-up com um prazo curto
- Uma ferramenta intermediária avisa o time no Slack
- O lead entra em um fluxo de nutrição na ferramenta de e-mail
O webhook garante que o lead não fique parado entre a captura e o primeiro contato.
Perguntas frequentes
Webhook é seguro?
Sim, desde que use HTTPS e que o destino confira a origem dos envios. A assinatura HMAC serve para isso.
Quantos webhooks um formulário pode ter?
Depende da plataforma. Na Formlytics, é um webhook por formulário. Para mandar o mesmo lead a vários destinos, aponte o webhook para uma ferramenta intermediária e deixe que ela distribua.
Webhook funciona offline?
Não. O sistema de destino precisa estar no ar para receber os dados. Se estiver fora, a plataforma deve tentar de novo. Na Formlytics, são até 4 tentativas automáticas.
Preciso de programação para configurar webhooks?
Depende do destino. Com uma ferramenta intermediária de automação, basta colar a URL que ela fornece. Para um sistema próprio, é preciso conhecimento básico de API.
Qual a diferença entre webhook e API?
Na API, o sistema B consulta o sistema A. No webhook, o sistema A envia os dados para o sistema B por conta própria. Webhook é push; API é pull.
Webhook substitui integração nativa?
Depende do cenário. Integrações nativas são mais simples de configurar. Webhooks dão mais flexibilidade e atendem sistemas próprios.
Respostas incompletas disparam o webhook?
Na Formlytics, não. O webhook dispara só no envio final de uma resposta concluída.
Conclusão
Webhooks são a ponte entre o formulário e os sistemas que você usa. Eles eliminam o trabalho manual de exportar e importar leads e fazem os dados chegarem em tempo real.
Na Formlytics, o webhook está nos planos Pro e Business, junto com as demais integrações. Para começar, você pode criar formulário grátis.