Webhook
Envie os leads do formulário para qualquer sistema por uma URL — formato do envio, retorno esperado e o envio adicional existente no código.
Nesta página
O Webhook é o serviço mais flexível: ele faz um POST com os dados do lead para a URL que você informar. Funciona com Zapier, Make, n8n ou um endpoint próprio.
Configuração
No formulário, em Captura → Serviço, escolha Webhook e preencha:
| Campo | Descrição |
|---|---|
| Webhook | URL de destino. As informações do formulário são enviadas para esse endereço após a captura. |
| Adicionar como contato | Se ligado, o lead também é criado em Contatos (apenas se o e-mail ainda não existir). |
O que é enviado
Requisição POST, com Content-Type: application/json e tempo limite de 15 segundos. O corpo tem esta forma:
{
"name": "Maria Silva",
"email": "maria@exemplo.com",
"phone": "11999999999",
"tags": [],
"fields": {
"name": "Maria Silva",
"email": "maria@exemplo.com",
"phone": "(11) 99999-9999",
"utm_source": "instagram"
}
}name,emailephone(somente dígitos) ficam na raiz.fieldscontém tudo o que o formulário enviou: campos padrão, campos personalizados, parâmetros de rastreio e identificadores internos do formulário.
Retorno esperado
O Converto considera o envio bem-sucedido quando o endpoint responde com status menor que 400. Falha de conexão, URL vazia ou status 400 ou superior contam como falha, e o visitante vê "Algo deu errado, tente novamente."
Envio adicional
Adicionar como contato
Quando ligado, o Converto cria o contato com as tags webhook e Importado. Se o e-mail já existir em Contatos, nada é alterado. Veja Contatos.
Boas práticas
- Use HTTPS no endpoint e valide a origem (por exemplo, com um token na própria URL).
- Responda rápido (menos de 15 s) e com 200.
- Registre o corpo recebido em um ambiente de teste antes de ligar ao sistema real.
Problemas comuns
| Sintoma | Solução |
|---|---|
| Formulário mostra erro | O endpoint respondeu 4xx/5xx ou não respondeu: teste a URL com uma ferramenta de requisições. |
| Chegam dois envios por lead | É o envio adicional descrito acima. Deduplique por e-mail. |
| Respostas personalizadas ausentes em outro serviço | Só o Webhook recebe os campos personalizados. |