Automatizar acciones con Webhooks en Hotelgest
Los webhooks de Hotelgest te permiten conectar tu PMS con otras aplicaciones y servicios, automatizando tareas y flujos de trabajo en tiempo real. Configurarlos para que tu sistema envíe notificaciones automáticas a programas externos cuando ocurran eventos específicos, como la creación de una reserva o la apertura de una puerta.
Descripción general
Un webhook es un método para que una aplicación envíe información a otra en tiempo real, actuando como un 'aviso' automático. En Hotelgest, los webhooks se configuran en la sección de Ajustes de tu cuenta y sirven para notificar a programas terceros sobre eventos que suceden en el PMS. Esto es útil para ejecutar acciones en programas externos basadas en estos eventos, como actualizar un CRM o activar un sistema de acceso, sin necesidad de intervención manual.
Acceder al Módulo de Webhooks
Cuándo usarlo
Cuando necesitas ver, crear o modificar webhooks con sistemas externos que se activan mediante eventos de Hotelgest.
Antes de empezar
Asegurate de que tu usuario cuenta con los permisos necesarios para el acceso a la configuración de cuenta de Hotelgest, específicamente el apartado de webhooks.
El primer paso para gestionar tus integraciones es navegar hasta la sección de Webhooks dentro de la Configuración de cuenta. Aquí encontrarás un listado de todos los webhooks activos y podrás iniciar la creación de nuevos.
Pasos
Haz clic en el icono de Ajustes en el menú principal en la esquina superior derecha de la pantalla.
Selecciona Configuración de cuenta en el menú desplegable.
En el menú lateral izquierdo de la pantalla de Ajustes, haz clic en Webhooks.
Verás la lista de webhooks existentes o el botón Crear webhook si aún no tienes ninguno configurado.
Crear un Webhook Nuevo
Cuándo usarlo
Cuándo quieres configurar un nuevo webhook para que Hotelgest envíe notificaciones a otra aplicación o servicio externo.
Antes de empezar
Es importante tener la URL de destino del webhook proporcionada por la aplicación externa para que Hotelgest pueda enviarle las notificaciones.
Pasos
En la pantalla de Webhooks, haz clic en el botón Crear webhook.
En el campo Nombre del webhook, introduce un nombre descriptivo que te ayude a identificar su propósito (ej: 'Notificaciones de reservas a CRM').
En el campo URL del webhook, pega la URL de destino que te ha proporcionado el programa externo al que quieres enviar la información.
El formulario mostrará los campos para la autenticación y selección de eventos, listos para que completes la configuración.
Más acciones
Cuándo usarlo
Cuándo quieres revisar los logs, probar, editar o eliminar un webhook.
Antes de empezar
Es importante tener un webhook creado, si ya existe un webhook en tu cuenta entonces lo verás en la pantalla y haciendo clic en los 3 puntos verticales podrás acceder al menú de más acciones.
Pasos
En la pantalla de Webhooks, haz clic en el botón con 3 puntos verticales para acceder al menú de más acciones, veras las siguientes opciones:
Logs - Te mostrará el detalle de la información enviada al destinatario del webhook, si no se ha usado aún este apartado veremos este apartado vacío con un texto de No hay registros disponibles.
Test - Te permite probar el webhook, al hacer clic verás un lista de las acciones configuradas para el webhook, al clicar sobre ella se generará un texto con la información que será enviada al tercero.
Editar - Para modificar los detalles de un webhook existente.
Eliminar - Eliminará el webhook sobre el cuál hemos clicado para realizar más acciones.
Preguntas frecuentes
¿Cómo puedo probar si mi webhook funciona correctamente?
Usando el botón de Test que encuentras en el menú de más acciones.
¿Qué tipo de información se envía en el webhook?
La información que enviamos dependerá del evento seleccionado, al utilizar la opción de Test verás un texto con todos los detalles de la información enviada.
¿Puedo editar un webhook después de crearlo?
Por supuesto, usando la opción de Editar dentro del menú de más acciones.
¿Qué hago si un webhook deja de funcionar o no se dispara?
Puedes usar el apartado de Logs y Test para probar y revisar exactamente que se está enviando. Si no llega la información correctamente al programa tercero por favor pide ayuda al soporte de ese programa para que lo puedan revisar.
¿Qué hago si el webhook no se dispara con los eventos esperados?
Revisa que los eventos correctos estén seleccionados en la configuración del webhook. También, verifica los logs del webhook (disponibles en el menú de tres puntos) para posibles errores de envío o respuestas del servidor externo.
¿Hay límites en el número de webhooks que puedo crear?
No, si cuentas con esta prestación en tu cuenta de Hotelgest puedes crear todos los webhooks que necesites.
¿Qué hago si tengo un error de autenticación al enviar el webhook?
Comprueba que el Usuario y la Contraseña introducidos en Hotelgest coinciden exactamente con los requeridos por tu aplicación externa. Un error tipográfico puede causar fallos.
Consejos
Usa nombres descriptivos para tus webhooks para identificarlos fácilmente, especialmente si tienes varios.
Siempre prueba tus webhooks después de configurarlos o realizar cambios importantes para asegurar que la conexión con tu aplicación externa funciona como esperas.
Revisa regularmente los logs de tus webhooks para detectar y depurar problemas de envío o errores en la comunicación con los sistemas externos.
Si tu aplicación externa lo permite, configura la autenticación básica para añadir una capa de seguridad a tus webhooks y proteger la información enviada.
Puedes seleccionar múltiples eventos para un mismo webhook. Cada evento seleccionado enviará una notificación a la URL configurada cuando ocurra, con los datos correspondientes al evento.