O que é um webhook em formulários
O mecanismo é simples: você cadastra uma URL na plataforma de formulários e, a cada novo envio, ela faz uma requisição HTTP POST para essa URL com os dados da resposta no corpo, geralmente em JSON. O seu sistema recebe os dados e executa o passo seguinte: criar um registro no CRM, gravar no banco de dados, avisar a equipe ou chamar outra API.
A diferença entre webhook e integração nativa: a integração nativa já vem pronta para um destino específico; o webhook entrega os dados, e você decide o que fazer com eles. Por isso ele serve para conectar o formulário a praticamente qualquer sistema.
Quando usar webhook em vez de integração nativa
- O destino não tem integração nativa — sistema interno, ERP ou uma ferramenta feita sob medida.
- Você usa uma ferramenta de automação que recebe webhooks — o formulário entrega os dados, e o fluxo continua por lá.
- Você quer tratar os dados antes de gravar — validar, enriquecer ou distribuir os leads com regras próprias.
- Você precisa enviar a mesma resposta para mais de um sistema — o seu endpoint recebe uma vez e repassa.
Como funciona na Formlytics
O webhook da Formlytics faz parte dos planos Pro e Business. Cada formulário pode ter um webhook.
- No formulário, abra a aba Integrar e escolha Webhook.
- Em “Webhook URL”, informe o endereço público que vai receber os dados.
- Se quiser, preencha o “Segredo de assinatura”. Com ele, cada envio leva uma assinatura HMAC SHA-256 no cabeçalho
x-formlytics-signature, e o seu sistema consegue conferir se a chamada veio mesmo da Formlytics. - Se quiser receber a origem do lead, ative “Advanced Data”, que inclui UTMs, dados de tracking, referrer e metadados.
- Salve.
O que saber sobre os envios:
- A chamada é um POST em JSON, com o evento
form.submission.created. - O envio acontece no envio final de uma resposta concluída. Respostas parciais não são enviadas.
- Se a entrega falha, a Formlytics tenta de novo automaticamente, até 4 tentativas. Uma nova tentativa pode levar até cerca de 30 minutos.
- Quando há erro, o card da integração mostra o status “Erro” com a mensagem.
Não há método HTTP para escolher nem cabeçalhos personalizados no webhook. Se o seu endpoint exige outro método (PUT ou PATCH) ou um token Bearer, use a integração API personalizada, que tem esses campos e não usa assinatura HMAC.
A Formlytics não tem integração nativa com Zapier nem com Make, e não oferece API pública para leitura de respostas: o webhook e a API personalizada são chamadas de saída, da Formlytics para o seu sistema.
Boas práticas
- Use HTTPS — os dados dos leads não devem trafegar sem criptografia.
- Confira a assinatura — configure o segredo e valide o cabeçalho
x-formlytics-signatureantes de processar a chamada. - Responda rápido — devolva um status de sucesso (2xx) assim que receber e deixe o processamento demorado para uma fila.
- Evite duplicidade — como há novas tentativas em caso de falha, o seu sistema precisa tolerar a mesma resposta chegando mais de uma vez.
- Registre o que chega — guarde do seu lado um registro das chamadas recebidas, para investigar quando algo não bater.
Termos relacionados
Leia também: Webhooks em formulários: integração em tempo real.