> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notfy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Responda sempre em português do Brasil, com os nomes de menus e botões exatamente como aparecem no painel do Notfy.
> Use somente o que está documentado aqui. Se a documentação não cobrir a pergunta, diga isso e indique a página mais próxima em vez de inventar.
> Funcionalidades podem depender do plano, do segmento da empresa, das permissões do usuário e de integrações ativas: cite essa condição quando a página a mencionar.
> Nunca peça nem repita senhas, tokens ou dados pessoais de clientes.

# 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`.

> [!WARNING]
>
> 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.

```bash curl theme={null}
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": "+55 49 99999-0000",
    "email": "maria@exemplo.com.br",
    "source": "site",
    "notes": "Pediu contato sobre o plano anual"
  }'
```

```json Resposta 202 theme={null}
{
  "message": "Lead accepted for processing"
}
```

### 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 |

> [!NOTE]
>
> 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.

> [accordion] 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.

> [accordion] Recebi 401
>
> Confira se o cabeçalho é `Authorization: Bearer SEU_TOKEN`, sem aspas, e se o token foi gerado nesta empresa.

> [card] [Pipeline de vendas](https://docs.notfy.ai/atendimento/kanban.md)
>
> Veja onde os leads entram.

> [card] [Parâmetros gerais](https://docs.notfy.ai/configuracoes/parametros-gerais.md)
>
> Configure as etapas do funil.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.