Recepción de leads (webhook)

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

Cree la integración

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

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.

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.

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.

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.

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"
  }'

{
  "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

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

Probar

Envíe un lead de prueba

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

Revise el embudo

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

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.

Recibí 401

Verifique que el encabezado sea Authorization: Bearer SU_TOKEN, sin comillas, y que el token haya sido generado en esta empresa.

Pipeline de ventas

Vea dónde entran los leads.

Parámetros generales

Configure las etapas del embudo.

Resumen

Integraciones

Usuarios y permisos

Dispositivos

Recepción de leads (webhook)

Cuándo usar

Configurar

Solicitud

Formatos reconocidos

Respuestas

Probar

Pipeline de ventas

Parámetros generales

​Cuándo usar

​Configurar

​Solicitud

​Formatos reconocidos

​Respuestas

​Probar

Pipeline de ventas

Parámetros generales

Cuándo usar

Configurar

Solicitud

Formatos reconocidos

Respuestas

Probar