→ Abrir en la app — Accede directamente a esta sección desde tu cuenta.
Webhooks envían notificaciones HTTP a tu servidor cuando ocurren eventos en Hotelgest (ej. Reserva creada). Útil para sincronizar CRM, data warehouse o automatizaciones sin polling constante.
Dónde está
Configuración > Webhooks — /settings/webhooks
Antes de empezar
Addon API + administrador o permiso Settings-Api.
URL HTTPS pública que acepte POST JSON.
Firewall que permita IPs de salida de Hotelgest (consulta documentación API).
Tabla
Columnas: Nombre, URL, Autenticación, Eventos, Creado el, ActivoAcciones:
Crear webhook
Toggle Activo
Popover: Logs, Test, Editar, Eliminar
Crear webhook
Campo | Validación |
Nombre del webhook | Obligatorio |
URL del webhook | HTTPS; no se permiten URLs de red interna |
Proteger URL… autenticación básica | Opcional; si activo, Usuario y Contraseña obligatorios |
Eventos a enviar | Al menos uno; hoy: Reserva creada ( |
Probar y revisar
Test — elige evento de prueba; envía payload de ejemplo a tu URL
Logs — historial de entregas con Duración; No hay registros disponibles si aún no hubo envíos
Eventos disponibles hoy
Solo Reserva creada (BookingsAdded). Nuevos eventos se añaden por versión; revisa esta página tras actualizar el PMS.
¿Qué payload recibo en Reserva creada?
Consulta Documentación (botón junto a API keys) para el esquema JSON del evento. Incluye identificadores de reserva y propiedad para idempotencia en tu receptor.
Autenticación JWT o API key
La gestión de webhooks acepta sesión de usuario admin o API key con permisos equivalentes (ApiKeyOrJwt guard).
Reintentos y errores
Si tu endpoint devuelve error HTTP, el intento queda en Logs con duración y código. Revisa timeout (menos de 30 s recomendado) y respuesta 2xx.
Problemas frecuentes
Requiere addon API
Misma condición que API keys. Activa addon desde Subscripción.