Ir para o conteúdo
Converto Ajuda
Integrações

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.

Avançado2 min de leitura
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:

CampoDescrição
WebhookURL de destino. As informações do formulário são enviadas para esse endereço após a captura.
Adicionar como contatoSe 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:

json
{
  "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, email e phone (somente dígitos) ficam na raiz.
  • fields conté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

SintomaSolução
Formulário mostra erroO 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çoSó o Webhook recebe os campos personalizados.

Este artigo foi útil?

Artigos relacionados