Recebimento de leads (webhook)

Envie leads de formulários, RD Station, Meta Lead Ads, Make ou Zapier para o Notfy com um token e uma requisição POST. Veja URL, campos e exemplos.

Com o Webhook de Leads, qualquer ferramenta que envie uma requisição HTTP pode criar leads no Notfy. Cada lead entra no funil na etapa inicial.

​

Quando usar

• Receber leads de formulários do site sem digitação manual.
• Trazer leads do RD Station ou do Meta Lead Ads.
• Automatizar o envio com Make ou Zapier.

​

Configurar

1. Crie a integração

   Em Ajustes, Integrações, crie uma integração do tipo Webhook de Leads, dê um nome e salve.

2. Abra a aba do webhook

   Na integração salva, abra a aba Webhook de Leads. Em Conectividade está o campo Sua URL de Webhook Pessoal, com botão para copiar.

3. Gere um token

   Em Tokens de Segurança, clique em Gerar Novo Token de Segurança e confirme. O token aparece em uma notificação: copie e guarde.

4. Configure a ferramenta de origem

   Aponte a ferramenta para a URL e envie o token no cabeçalho Authorization, no formato Bearer SEU_TOKEN.

Trate o token como uma senha: quem o tem pode criar leads na sua empresa. Não o publique em prints ou mensagens. Se ele vazar, gere um novo e atualize as ferramentas.

​

Requisição

POST /api/webhooks/leads, no domínio do seu Notfy, com corpo JSON e cabeçalho Authorization: Bearer SEU_TOKEN.

Campo	Tipo	Obrigatório	Descrição
name	texto (até 255)	Não	Nome do lead. Sem nome, o lead entra como “Novo Lead”
phone	texto (até 50)	Um dos dois	Telefone. Apenas os números são mantidos
email	e-mail (até 255)	Um dos dois	E-mail do lead
source	texto (até 100)	Não	Origem do lead, por exemplo site ou rd_station
notes	texto	Não	Observações

É obrigatório enviar phone ou email. Outros campos enviados são guardados junto ao lead como informações adicionais.

curl

curl -X POST "https://SEU-DOMINIO/api/webhooks/leads" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Maria Souza",
    "phone": "[phone]",
    "email": "[e-mail]",
    "source": "site",
    "notes": "Pediu contato sobre o plano anual"
  }'

​

Formatos reconhecidos

Além do formato acima, o Notfy reconhece automaticamente:

• RD Station: corpo com a lista leads. Usa nome, e-mail e telefone pessoal ou celular do primeiro item.
• Meta Lead Ads: corpo com field_data. Identifica nome, e-mail e telefone pelos nomes dos campos.

​

Respostas

Código	Significado
202	Lead aceito. Ele é processado em seguida e aparece no funil em instantes
401	Token ausente, inválido ou sem permissão
422	Dados inválidos, por exemplo sem telefone e e-mail, ou e-mail mal formado
429	Muitas requisições. O limite é de 120 por minuto

Se já existir um lead da sua empresa com o mesmo e-mail e telefone, ele é atualizado em vez de duplicado.

​

Testar

1. Envie um lead de teste

   Rode o exemplo acima com seus dados ou preencha o formulário do site.

2. Confira o funil

   Abra o Pipeline e procure o lead na etapa inicial.

Recebi 202 mas o lead não apareceu

Confirme que o envio tem telefone ou e-mail. Um lead sem nenhum dos dois é descartado depois de aceito.

Recebi 401

Confira se o cabeçalho é Authorization: Bearer SEU_TOKEN, sem aspas, e se o token foi gerado nesta empresa.

Pipeline de vendas

Veja onde os leads entram.

Parâmetros gerais

Configure as etapas do funil.