Webhook (Zapier, Make, n8n, CRM)
Com um webhook você envia cada lead para praticamente qualquer sistema: n8n, Make, Zapier ou direto no seu CRM. Aqui estão a configuração e o formato exato do que o BRForms envia.
Configure o webhook
No editor, em Tracking & Integrações → Webhook, cole a URL do seu sistema (precisa ser pública e começar com http ou https). Com Enviar toda resposta concluída marcado, o webhook dispara em todo envio; desmarcado, dispara só quando uma regra da aba Lógica com a ação disparar webhook for atendida.
O que é enviado
A cada disparo, o BRForms faz um POST com Content-Type: application/json para a URL configurada. As respostas vão rotuladas pela pergunta (já com o texto da opção escolhida, não o código interno) e a atribuição completa do lead vai junto: UTMs, identificadores de clique, referenciador e página de origem. Exemplo:
{
"events": ["lead", "lead-qualificado"],
"form": { "id": "3f1c2a7e-...", "title": "Diagnóstico gratuito" },
"submission": {
"id": "9b8d4c21-...",
"created_at": "2026-08-25 14:32:10",
"answers": {
"Qual seu principal objetivo?": "Vender mais pelo WhatsApp",
"Faturamento mensal": "R$ 10 mil a R$ 50 mil por mês",
"Nome": "Ana Ribeiro",
"E-mail": "ana@empresa.com.br",
"WhatsApp": "11999136806"
},
"utm_source": "facebook",
"utm_medium": "cpc",
"utm_campaign": "frio-diagnostico",
"utm_content": "video-01",
"utm_term": null,
"fbclid": "IwAR2x...",
"gclid": null,
"referrer": "https://l.facebook.com/",
"landing_url": "https://brforms.com/sua-conta/diagnostico?utm_source=facebook&utm_medium=cpc&utm_campaign=frio-diagnostico",
"country": "BR"
}
}| Campo | O que é |
|---|---|
events | Lista de eventos que motivaram o disparo: lead quando "Enviar toda resposta concluída" está marcado, mais o nome de cada regra da Lógica com ação de webhook que foi atendida (ex: lead-qualificado). |
form.id / form.title | Identificador e título do formulário. Útil quando várias campanhas apontam para a mesma URL de webhook. |
submission.id | Identificador único da resposta. Use para deduplicar no destino (um reenvio manda o mesmo id). |
submission.created_at | Data e hora do envio em UTC, no formato AAAA-MM-DD HH:MM:SS. |
submission.answers | Objeto pergunta → resposta, com o rótulo de cada campo como chave. Seleção múltipla vira texto separado por vírgula; anexos viram o nome do arquivo. |
utm_source … utm_term | As cinco UTMs capturadas da URL do formulário (null quando ausentes). |
fbclid / gclid | Identificadores de clique da Meta e do Google, para conversões offline e atribuição no CRM. |
referrer / landing_url | Página que encaminhou o visitante e URL completa em que o formulário foi aberto. |
country | País do visitante (código de duas letras), estimado pela rede. |
Todo lead ou só o qualificado
Para mandar ao CRM apenas quem tem perfil, desmarque Enviar toda resposta concluída e crie na aba Lógica uma regra do tipo "se faturamento acima de X, disparar webhook com o evento lead-qualificado". A mesma URL recebe o disparo, e o nome do evento chega em events para o seu fluxo decidir o que fazer. Com a opção marcada e regras ativas, um lead qualificado gera um único envio com os dois eventos na lista.
Confiabilidade e segurança
- Tentativas automáticas: se o destino responder erro ou demorar mais de 10 segundos, o BRForms tenta de novo duas vezes em seguida e, se ainda falhar, reprocessa de hora em hora. No detalhe da resposta há um botão de reenvio manual.
- Sucesso = HTTP 2xx. Qualquer outro status é tratado como falha. Redirecionamentos não são seguidos.
- Sem assinatura por padrão. Para garantir que só o BRForms chama sua URL, inclua um token secreto na própria URL (ex:
https://seu-sistema.com/webhook?token=SEGREDO) e valide no destino. - User-Agent:
mpa-forms-webhook, caso queira filtrar no seu servidor. - Endereços privados são bloqueados (localhost, redes internas). A URL precisa ser acessível pela internet.
answers para o seu CRM uma única vez.Perguntas frequentes
Como conectar o webhook ao meu CRM?
Se o CRM tem um endpoint de entrada de leads (muitos têm, como RD Station, HubSpot, Pipedrive e Kommo), cole a URL diretamente. Se não tem, use um intermediário como n8n, Make ou Zapier: o gatilho de webhook recebe o JSON do BRForms e o próximo passo cria o contato ou o negócio no CRM, com as respostas e as UTMs nos campos certos.
O webhook envia os leads antigos?
Não. Ele dispara para as respostas que chegarem a partir da configuração. Para os leads anteriores, use Exportar CSV na tela de Respostas ou o botão de reenvio no detalhe de cada resposta.
Posso usar mais de uma URL de webhook?
Cada formulário tem uma URL. Para distribuir o lead em vários sistemas, aponte para um fluxo do n8n, Make ou Zapier e faça a distribuição a partir dele.