Webhooks: automatización de eventos en tiempo real
Los webhooks son una de las funcionalidades más valoradas por los equipos de TI en entornos empresariales. Permiten que Sesame HR notifique automáticamente a sistemas externos cuando ocurren eventos relevantes dentro de la plataforma.
Un webhook es una notificación HTTP automática (POST) que Sesame HR envía a una URL configurada por el administrador cuando ocurre un evento específico. A diferencia de las consultas periódicas a la API (polling), los webhooks permiten reaccionar en tiempo real, sin necesidad de realizar consultas constantes.
|
⚡ Polling vs. Webhooks: Polling: Tu sistema consulta periódicamente a Sesame → Mayor consumo de recursos y posible retraso en la información. Webhooks: Sesame notifica a tu sistema cuando ocurre un evento → Tiempo real, mayor eficiencia y sin consultas innecesarias. |
Eventos soportados
Sesame HR puede enviar notificaciones mediante webhooks para los siguientes eventos:
Evento |
Descripción |
Alta de empleado |
Se crea un nuevo perfil de empleado en Sesame HR. |
Baja de empleado |
Un empleado es desactivado o eliminado del sistema. |
Cambio de departamento |
Un empleado es reasignado a otro departamento u oficina. |
Solicitud de ausencia |
Un empleado solicita vacaciones o una ausencia. |
Aprobación de ausencia |
Un mánager aprueba o rechaza una solicitud. |
Registro de asistencia |
Se registra una entrada o salida (clock in/clock out). |
Cambio contractual |
Se crea o modifica un contrato, salario o compensación. |
Proceso de incorporación |
Se inicia o finaliza el proceso de incorporación de un empleado. |
Cómo funcionan
El flujo de un webhook en Sesame HR sigue estos pasos:
1. Configuración: el administrador registra una URL de destino y selecciona los eventos que desea recibir desde el panel de Sesame HR.
2. Evento: cuando ocurre un evento (por ejemplo, la creación de un empleado), Sesame genera un payload en formato JSON con los datos correspondientes.
3. Notificación: Sesame envía una solicitud HTTP POST a la URL configurada con la información del evento.
4. Procesamiento: el sistema receptor procesa la notificación y ejecuta las acciones necesarias (por ejemplo, crear un usuario en Active Directory o actualizar el ERP).
Ejemplo de payload de un webhook de alta de empleado:
|
POST https://tu-sistema.com/webhooks/sesame Content-Type: application/json
{ "event": "employee.created", "timestamp": "2026-03-11T10:30:00Z", "data": { "employeeId": "uuid-del-empleado", "firstName": "Carlos", "lastName": "Martínez", "email": "carlos.martinez@empresa.com", "departmentId": "uuid-departamento", "startDate": "2026-04-01" } } |
Casos de uso empresariales
Los webhooks de Sesame HR permiten automatizar procesos clave en organizaciones grandes. Estos son algunos de los casos más comunes:
Provisionamiento automático de TI
Cuando se da de alta un nuevo empleado, el webhook notifica al sistema de TI para crear automáticamente sus accesos: correo electrónico, licencias de software, credenciales de VPN y equipo asignado. Esto reduce los tiempos de incorporación de días a minutos.
Actualización de ERP en tiempo real
Cada vez que cambia la estructura organizacional (nuevo departamento, cambio de oficina o reasignación de empleado), el webhook actualiza automáticamente el ERP, manteniendo la coherencia de datos entre sistemas.
Automatización con Zapier o Make
Conecta los webhooks de Sesame HR con herramientas como Zapier o Make para automatizar flujos de trabajo. Por ejemplo: cuando se aprueba una solicitud de vacaciones, enviar una notificación al equipo, actualizar el calendario compartido y ajustar la planificación de turnos.
Alertas de cumplimiento
Configura webhooks para notificar al equipo de cumplimiento cuando se detecten incidencias en el control de asistencia, cambios contractuales fuera de lo habitual o ausencias no justificadas.
