Saltar al contenido principal

Webhooks Salientes

Los Webhooks Salientes envían datos de leads desde LeadHub a una URL externa cuando ocurre un evento de lead.


Crear un Webhook Saliente

  1. Vaya a Integraciones → Webhooks Salientes.
  2. Haga clic en Nuevo Webhook Saliente.
  3. Configure Nombre, URL, Eventos, Secreto (opcional) y estado Activo.
  4. Haga clic en Guardar.

Eventos Disponibles

EventoCuándo se dispara
lead.createdSe crea un nuevo registro de lead
lead.updatedSe modifica un lead
lead.deletedSe elimina un lead
lead.stage_changedUn lead pasa a una nueva etapa del embudo
lead.assignedSe asigna un lead a un usuario
form.submittedSe recibe un envío de formulario

Formato de la Carga

{
"event": "lead.created",
"occurred_at": "2026-04-29T10:30:00Z",
"lead": {
"id": 123,
"first_name": "Jane",
"last_name": "Smith",
"email": "[email protected]",
"phone": "+1-555-000-0000",
"source": "web_form",
"status": "new",
"lead_score": 45,
"pipeline": "Sales Pipeline",
"stage": "New Lead",
"assigned_to": "[email protected]",
"tags": ["vip", "from-webinar"],
"created_at": "2026-04-29T10:30:00Z"
}
}

Verificación de Firma HMAC

Si establece un Secreto, LeadHub firma cada solicitud con HMAC-SHA256 en la cabecera X-LeadHub-Signature.


Entrega y Reintentos

LeadHub entrega webhooks de forma asíncrona mediante la cola. En caso de respuesta no 2xx, se reintenta hasta 3 veces con retroceso exponencial.


Deshabilitar vs Eliminar

  • Deshabilitar: Desactive Activo — el webhook se conserva pero no envía eventos.
  • Eliminar: Elimina permanentemente la configuración.