Ir al contenido principal

Webhooks

Escrito por Jordi

Abrir en la app — Accede directamente a esta sección desde tu cuenta.

Vista de Webhooks en Hotelgest PMS

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 (BookingsAdded)

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

La gestión de webhooks requiere sesión de usuario administrador o una API key con los permisos correspondientes.

Reintentos y errores

Si tu endpoint devuelve error HTTP, el intento queda en Logs con duración y código. Asegúrate de que tu servidor responde con HTTP 2xx en un tiempo razonable para que el envío se registre como correcto.

Problemas frecuentes

Requiere addon API

Misma condición que API keys. Activa addon desde Subscripción.

¿Ha quedado contestada tu pregunta?