Los webhooks se configuran en el panel en Settings -> Integrations -> Webhooks.
Los webhooks te permiten recibir notificaciones en tiempo real cuando ocurren eventos en Nexor. En lugar de consultar la API constantemente, Nexor envia un HTTP POST a tu endpoint cada vez que un lead cambia de estado, una reunion es agendada, cancelada o completada.
Como funciona
- Configura un webhook en el panel de Nexor con la URL de tu endpoint y los eventos que deseas recibir.
- Nexor detecta un evento (ej. el estado del lead cambia de
new a contacted).
- Nexor envia una solicitud POST firmada a tu URL con el payload del evento.
- Tu servidor responde con
2xx para confirmar la recepcion.
Si tu servidor no responde o retorna un error, Nexor reintenta hasta 3 veces con backoff exponencial (1 min, 5 min, 30 min).
Eventos soportados
| Tipo de evento | Se dispara cuando |
|---|
workflow_run.status_changed | El estado de un lead cambia dentro de un workflow (ej. new a contacted, contacted a qualified) |
meeting.scheduled | Se agenda una reunion con un lead |
meeting.confirmed | Un lead confirma asistencia a una reunion |
meeting.cancelled | Una reunion es cancelada |
meeting.completed | Una reunion se marca como completada |
meeting.no_show | Un lead es marcado como inasistente a una reunion |
Estructura del payload
Cada entrega de webhook sigue el mismo formato:
{
"event_type": "workflow_run.status_changed",
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"webhook_id": "your-webhook-uuid",
"delivery_id": "unique-delivery-uuid",
"timestamp": "2026-04-17T16:30:00.000Z",
"client_id": "your-client-uuid",
"test": false,
"data": {
// Payload especifico del evento (ver paginas de eventos)
}
}
| Campo | Tipo | Descripcion |
|---|
event_type | string | El evento que disparo la entrega |
event_id | string (uuid) | ID unico del evento |
webhook_id | string (uuid) | ID de tu configuracion de webhook |
delivery_id | string (uuid) | ID unico para este intento de entrega especifico |
timestamp | string (ISO 8601) | Cuando ocurrio el evento |
client_id | string (uuid) | Tu ID de cliente de Nexor |
test | boolean | true si fue enviado mediante el boton “Test” en el panel |
data | object | Payload especifico del evento |
| Header | Descripcion |
|---|
Content-Type | application/json |
X-Nexor-Event | Tipo de evento (ej. workflow_run.status_changed) |
X-Nexor-Delivery-ID | ID unico de entrega |
X-Nexor-Timestamp | Timestamp Unix (segundos) |
X-Nexor-Webhook-ID | Tu ID de webhook |
X-Nexor-Signature | Firma HMAC-SHA256 para verificacion |
Última modificación el 18 de junio de 2026
