Un webhook es un procedimiento no estandarizado para la comunicación automática entre servicios web. Técnicamente, un webhook es una solicitud HTTP POST que se envía automáticamente a una URL predefinida en cuanto se produce un evento determinado.
Funcionamiento
- El proveedor configura una URL de destino (por ejemplo, un sistema propio o Zapier/Make)
- Cuando se produce un evento de reserva (nueva reserva, modificación, cancelación), el sistema de reservas de citas envía automáticamente una solicitud POST con los datos de la reserva (normalmente en formato JSON)
- El sistema receptor procesa los datos y puede reaccionar a ellos
Tipos de eventos admitidos
- Nueva reserva (
new_appointment) - Reserva cancelada (
cancelled_appointment) - Reserva cambiada/modificada (
rescheduled_appointment)
Seguridad
- Clave secreta opcional (Secret Key), que se envía en la cabecera HTTP
X-Schedule-Organizer-Secret - El tipo de evento se transmite en la cabecera
X-Schedule-Organizer-Event - El endpoint receptor debe responder con HTTP 200
Casos de uso
- Traspaso automático de reservas a un sistema CRM
- Disparador de automatizaciones en Zapier, Make (antes Integromat) o n8n
- Sincronización en tiempo real con sistemas backend propios
- Notificaciones en Slack o Teams