Enviar un lead

Recibe un lead y lo coloca en la etapa inicial del embudo. Es obligatorio informar teléfono o correo electrónico. El lead se procesa inmediatamente después de ser aceptado. Si ya existe un lead con el mismo correo y teléfono, se actualiza. Límite de 120 solicitudes por minuto.

POST /api/webhooks/leads

cURL

formulario

curl --request POST \
  --url https://seu-dominio/api/webhooks/leads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Maria Souza",
  "phone": "[phone]",
  "email": "[e-mail]",
  "source": "site",
  "notes": "Pidió contacto sobre el plan anual"
}
'

202

{
  "message": "Lead accepted for processing"
}

Autorizaciones

Authorization · string · header · requerido

Token generado en Ajustes, Integraciones, pestaña Webhook de Leads, botón Generar Nuevo Token de Seguridad. Envíelo como Authorization: Bearer SU_TOKEN.

Cuerpo

application/json

Informe al menos phone o email.

name · string

Nombre del lead. Sin nombre, el lead se crea como Novo Lead.

Maximum string length: 255

phone · string

Teléfono. Solo se conservan los números.

Maximum string length: 50

email · string<email>

Correo electrónico del lead.

Maximum string length: 255

source · string

Origen del lead, por ejemplo site o rd_station.

Maximum string length: 100

notes · string

Observaciones sobre el lead.

Respuesta

202

application/json

Lead aceptado para procesamiento.

message · string

Ejemplo:

"Lead accepted for processing"