Skip to main content

Webhooks

Los webhooks te permiten recibir notificaciones HTTP en tiempo real cuando ocurren eventos en SalesOS. En lugar de consultar la API periódicamente, SalesOS envía los datos directamente a tu endpoint.

¿Cómo funcionan?

1

Registra tu endpoint

Configura la URL que recibirá las notificaciones.
2

Selecciona los eventos

Elige qué eventos deseas recibir.
3

Recibe las notificaciones

SalesOS envía una solicitud POST a tu endpoint cada vez que ocurre un evento suscrito.
4

Confirma la recepción

Tu endpoint debe responder con un código 200 para confirmar que recibió la notificación.

Eventos disponibles

Registro de un webhook

Formato del payload

Cada notificación de webhook tiene el siguiente formato:

Verificación de firma

Cada solicitud incluye un header X-SalesOS-Signature con una firma HMAC-SHA256 del payload. Verifica la firma para asegurar que la solicitud proviene de SalesOS:

Reintentos

Si tu endpoint no responde con un código 200, SalesOS reintentará la entrega:
Después de 5 intentos fallidos, el webhook se desactivará automáticamente. Revisa tus logs y reactívalo manualmente.
Procesa los webhooks de forma asíncrona. Responde con 200 inmediatamente y procesa los datos en segundo plano para evitar timeouts.

Próximos pasos

Integración n8n

Usa webhooks con SalesOS Connect.

Integraciones personalizadas

Construye integraciones a medida.