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

# Recepción de leads (webhook)

> Envíe leads de formularios, RD Station, Meta Lead Ads, Make o Zapier a Notfy con un token y una solicitud POST. Vea URL, campos y ejemplos.

Con el **Webhook de Leads**, cualquier herramienta que envíe una solicitud HTTP puede crear leads en Notfy. Cada lead entra al embudo en la etapa inicial.

## Cuándo usar

* Recibir leads de formularios del sitio web sin digitación manual.
* Traer leads de RD Station o de Meta Lead Ads.
* Automatizar el envío con Make o Zapier.

## Configurar

**1. Cree la integración**

En **Ajustes**, **Integraciones**, cree una integración del tipo **Webhook de Leads**, asígnele un nombre y guarde.

**2. Abra la pestaña del webhook**

En la integración guardada, abra la pestaña **Webhook de Leads**. En **Conectividad** está el campo **Su URL de Webhook Personal**, con un botón para copiar.

**3. Genere un token**

En **Tokens de Seguridad**, haga clic en **Generar Nuevo Token de Seguridad** y confirme. El token aparece en una notificación: cópielo y guárdelo.

**4. Configure la herramienta de origen**

Apunte la herramienta a la URL y envíe el token en el encabezado `Authorization`, con el formato `Bearer SU_TOKEN`.

> [!WARNING]
>
> Trate el token como una contraseña: quien lo tenga puede crear leads en su empresa. No lo publique en capturas de pantalla ni mensajes. Si se filtra, genere uno nuevo y actualice las herramientas.

## Solicitud

`POST /api/webhooks/leads`, en el dominio de su Notfy, con cuerpo JSON y encabezado `Authorization: Bearer SU_TOKEN`.

| Campo | Tipo | Obligatorio | Descripción |
| :- | :- | :-: | :- |
| `name` | texto (hasta 255) | No | Nombre del lead. Sin nombre, el lead entra como "Novo Lead" |
| `phone` | texto (hasta 50) | Uno de los dos | Teléfono. Solo se conservan los números |
| `email` | correo electrónico (hasta 255) | Uno de los dos | Correo electrónico del lead |
| `source` | texto (hasta 100) | No | Origen del lead, por ejemplo `site` o `rd_station` |
| `notes` | texto | No | Observaciones |

Es obligatorio enviar `phone` o `email`. Los otros campos enviados se guardan junto con el lead como información adicional.

```bash curl theme={null}
curl -X POST "https://SU-DOMINIO/api/webhooks/leads" \
  -H "Authorization: Bearer SU_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": "Pidió contacto sobre el plan anual"
  }'
```

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

### Formatos reconocidos

Además del formato anterior, Notfy reconoce automáticamente:

* **RD Station:** cuerpo con la lista `leads`. Usa nombre, correo electrónico y teléfono personal o celular del primer elemento.
* **Meta Lead Ads:** cuerpo con `field_data`. Identifica nombre, correo electrónico y teléfono por los nombres de los campos.

### Respuestas

| Código | Significado |
| :- | :- |
| `202` | Lead aceptado. Se procesa a continuación y aparece en el embudo en instantes |
| `401` | Token ausente, inválido o sin permiso |
| `422` | Datos inválidos, por ejemplo sin teléfono ni correo electrónico, o correo mal formado |
| `429` | Demasiadas solicitudes. El límite es de 120 por minuto |

> [!NOTE]
>
> Si ya existe un lead de su empresa con el mismo correo electrónico y teléfono, se actualiza en lugar de duplicarse.

## Probar

**1. Envíe un lead de prueba**

Ejecute el ejemplo anterior con sus datos o complete el formulario del sitio web.

**2. Revise el embudo**

Abra el Pipeline y busque el lead en la etapa inicial.

> [accordion] Recibí 202 pero el lead no apareció
>
> Confirme que el envío tiene teléfono o correo electrónico. Un lead sin ninguno de los dos se descarta después de ser aceptado.

> [accordion] Recibí 401
>
> Verifique que el encabezado sea `Authorization: Bearer SU_TOKEN`, sin comillas, y que el token haya sido generado en esta empresa.

> [card] [Pipeline de ventas](https://docs.notfy.ai/es/atendimento/kanban.md)
>
> Vea dónde entran los leads.

> [card] [Parámetros generales](https://docs.notfy.ai/es/configuracoes/parametros-gerais.md)
>
> Configure las etapas del embudo.


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