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.

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

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": "[phone]",
    "email": "[e-mail]",
    "source": "site",
    "notes": "Pidió contacto sobre el plan anual"
  }'

​

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

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.

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.