O que é um webhook em formulários
Webhook é um mecanismo simples: você cadastra uma URL na plataforma de formulários e, a cada novo envio, a plataforma dispara uma requisição HTTP POST para essa URL com os dados do lead no corpo (geralmente em JSON). Sua aplicação recebe a notificação em segundos, processa os dados e dispara o próximo passo — criar um card no CRM, mandar um e-mail, registrar no banco, chamar uma API de validação.
A diferença central entre webhook e integração nativa é que o nativo tem UI pronta e o webhook é programável: você decide o que fazer com cada campo. É a forma mais flexível de conectar formulários a qualquer sistema.
Quando usar webhook em vez de integração nativa
- O destino não tem integração nativa com a Formlytics (sistema interno, ERP legado, ferramenta custom).
- Você precisa de lógica condicional no destino — webhook pode disparar fluxos diferentes no Zapier, Make ou n8n baseando-se nos dados do lead.
- Você quer evitar limite de volume de APIs nativas — webhook é direto, sem rate limit intermediário.
- Você precisa de payload customizado — você controla o que vai no body do POST.
Como configurar webhook na Formlytics
- Em Integrações do formulário, escolha Webhook.
- Cole a URL de destino (ex:
https://seudominio.com/api/leads). - Selecione o método (POST é o padrão).
- Defina headers opcionais (ex:
Authorization: Bearer seu-token). - Teste o envio com dados de exemplo.
- Acompanhe o log de chamadas no painel para reprocessar falhas.
Boas práticas
- Use HTTPS — webhook em HTTP exposto vira vetor de ataque.
- Valide o secret — toda chamada deve carregar um token que sua aplicação valida antes de processar.
- Responda 200 rápido — sua aplicação deve retornar sucesso em menos de 5 segundos. Processos longos vão para fila (worker).
- Implemente idempotência — webhooks podem repetir; seu sistema precisa tolerar o mesmo lead chegando duas vezes.
- Monitore falhas — webhook com retorno 500 vira lead perdido se você não tiver retry.