Webhooks

Los webhooks permiten a Shifton enviar notificaciones en tiempo real a sistemas externos cuando ocurren eventos en su empresa.

Instrucciones paso a paso

Acceso a la pestaña Webhooks

En el panel lateral izquierdo, haga clic en Integraciones.

Vaya a la página Desarrollador → pestaña Webhooks.

Crear un nuevo webhook

Haga clic en «Nuevo webhook».

Complete la configuración:

Campo	Descripción
URL	Endpoint para recibir los datos de eventos
Eventos	Eventos de Shifton que activan el webhook
Activo	Interruptor de activación/desactivación

Guarde. Shifton enviará solicitudes HTTP POST a la URL indicada.

Gestión de webhooks

Haga clic en un webhook para editar la URL, actualizar los eventos o cambiar el estado de actividad.

Prueba de un webhook

Activo el evento correspondiente en Shifton (por ejemplo, cree un turno de prueba).

Verifique los registros del servidor — los datos deberían llegar.

Preguntas frecuentes

P: ¿En qué Formararato envía capaon los datos?
HTTP POST con cuerpo en formato JSON. La estructura de datos para cada tipo de evento se encuentra en la documentación de la API.

P: ¿Se pueden crear varios webhooks para un mismo evento?
Sí, con diferentes URLs.

P: ¿Qué pasa si el servidor no está disponible cuando se dispara el webhook?
La entrega puede fallar. Los detalles sobre la política de reintentos están en la documentación de la API.

P: El webhook no se dispara, ¿por qué?
Asegúrese de que el interruptor Activo esté habilitado y la URL sea públicamente accesible.

P: ¿Cómo verificar que el webhook recibe datos?
Cree un evento de prueba en Shifton (por ejemplo, agregue un turno) y verifique los registros de su servidor para la solicitud POST entrante.

P: ¿Puedo configurar la autenticación del webhook?
Sí. Agregue una clave secreta o token en la URL o los encabezados del webhook. Los detalles están en la documentación de la API.

P: ¿Cómo es el cuerpo de la solicitud del webhook?
Un objeto JSON con los datos del evento. La estructura depende del tipo de evento — consulte la documentación de la API para ejemplos.

P: ¿Un webhook puede rastrear varios eventos?
Sí. Al crear el webhook, seleccione varios eventos — una URL recibirá notificaciones de todos los seleccionados.

P: ¿Qué es la «política de reintentos» para webhooks?
Si el servidor devuelve un error (no 200), Shifton puede reintentar la solicitud. Los detalles dependen de la configuración de la plataforma.

P: ¿Hay un límite en la cantidad de webhooks?
No se indican limitaciones en la documentación, pero se recomienda crear solo los necesarios.

P: ¿Es necesario usar HTTPS para la URL del webhook?
Se recomienda. Las direcciones HTTP pueden funcionar, pero HTTPS asegura la transmisión segura de datos.

P: ¿Se pueden recibir notificaciones de webhook por cada cambio de horario?
Sí. Agregue eventos del tipo «Capa creada» o «schedule updated» al configurar el webhook.

P: ¿Quién tiene acceso a la creación de webhooks?
Solo el Owner. Los gerentes y empleados no ven la sección Developer.

P: ¿Se puede desactivar un webhook sin eliminarlo?
Sí. Desactive el interruptor Activo en la configuración del webhook — dejará de dispararse pero conservará la configuración.

P: ¿Se registran los disparos de webhooks en capaon?
No se proporcionan registros detallados de entrega de webhooks en la interfaz. El seguimiento es del lado de su servidor.

P: ¿Se pueden filtrar webhooks por proyecto u horario?
No. El webhook se dispara para todos los eventos del tipo seleccionado en toda la empresa. El filtrado es del lado del servidor receptor.

P: ¿Qué sucede con los webhooks al eliminar la empresa?
Todos los webhooks se eliminan junto con la empresa.