Conecta tu chatbot de ChatLab con tu sistema de gestión de propiedades KWHotel para ofrecer a los visitantes de tu sitio web disponibilidad de habitaciones en tiempo real, reservas y consulta de reservas existentes. La integración utiliza el motor de reservas GuestSage booking engine para los datos de habitaciones y disponibilidad, y la KWHotel Integrations API para la consulta de reservas.
Qué ofrece la integración
Con la integración de KWHotel activada, tu chatbot puede:
- Mostrar los tipos de habitación con descripciones, capacidad, superficie y fotos
- Buscar habitaciones disponibles para un rango de fechas determinado con precios
- Comprobar la disponibilidad de una habitación específica y un rango de fechas
- Crear nuevas reservas con los datos del huésped
- Consultar reservas existentes
Requisitos previos
Antes de configurar la integración, asegúrate de contar con:
- Una cuenta de KWHotel con el motor de reservas GuestSage activado
- Tu Hotel ID (UUID) del motor de reservas GuestSage
- Tu Integrations Hotel ID (numérico) y la Integrations API Key emitidos por KWHotel
- Una cuenta de ChatLab en un plan STANDARD o PREMIUM, o con el complemento Travel Integrations
Cómo encontrar tu Hotel ID (UUID)
El Hotel ID es un UUID asignado a tu propiedad en el motor de reservas GuestSage.
- Inicia sesión en cloud.kwhotel.com
- Ve a Modules (Módulos) > Booking Engine (Motor de reservas)
- En la pestaña General, localiza el campo Booking engine link (Enlace del motor de reservas)
- Copia el UUID de la URL
Por ejemplo, en el enlace https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6, el Hotel ID es 82b0085d-da1b-4443-8fde-d5d569a859e6.
Cómo encontrar tus credenciales de Integrations API
La Integrations API de KWHotel utiliza un identificador diferente al UUID de GuestSage:
- Integrations Hotel ID - un ID numérico (por ejemplo
292) - Integrations API Key - una clave secreta que generas en KWHotel
Hotel ID numérico
Puedes encontrar el Hotel ID numérico en la esquina superior derecha del panel de administración de KWHotel.
Generar la clave API
Tú mismo generas la clave API dentro de KWHotel:
- Inicia sesión en KWHotel y abre el módulo Synchronization (Sincronización)
- Haz clic en el botón Reset API key (Restablecer clave API)
- Copia la clave generada y pégala en el formulario de conexión de ChatLab
Al hacer clic en Reset API key, se elimina la clave anterior (si ya se había generado una) y se crea una nueva. Cualquier otro sistema que use la clave anterior dejará de funcionar hasta que lo actualices con el nuevo valor.
Cómo configurar la integración en ChatLab
Paso 1: Ve a la pestaña Connect
- Inicia sesión en tu panel de administración de ChatLab
- Selecciona el bot que deseas configurar
- Ve a la pestaña Connect (Conectar)
- Busca y haz clic en KWHotel en la lista de integraciones
Paso 2: Introduce los datos de conexión
Completa el formulario de conexión:
- Hotel ID (UUID) - el GUID de tu hotel en KWHotel procedente de la configuración del motor de reservas GuestSage
- Default Currency (Moneda predeterminada) - la moneda utilizada para los precios que se muestran a los usuarios del chat (por defecto es PLN)
- Default Language (Idioma predeterminado) - el idioma utilizado para las descripciones de las habitaciones y el texto de las ofertas (por defecto es polaco)
- Integrations Hotel ID - el ID numérico del hotel para la Integrations API de KWHotel (diferente del UUID anterior)
- Integrations API Key - la clave secreta de API emitida por KWHotel
- Discount bot channel (Canal de descuentos para el bot) - opcional. Cuando se define, las ofertas se obtienen para este canal de descuento de KWHotel y la IA las ordena. Déjalo vacío para usar el canal predeterminado.
Paso 3: Conectar
- Una vez completados los campos, el botón Connect (Conectar) se activará
- Haz clic en Connect para guardar la configuración. ChatLab comprobará la conexión con GuestSage y con la Integrations API.
- Si la conexión se realiza con éxito, verás una notificación de confirmación.
Tras una conexión correcta, el botón Connect cambiará a Update Chatbot (Actualizar chatbot), y aparecerá un botón Disconnect (Desconectar) para que puedas desactivar la integración más adelante.
Si la comprobación de la Integrations API falla al guardar, la acción Get reservation se desactivará automáticamente. Vuelve a introducir las credenciales correctas y haz clic en Update Chatbot para activarla.
Configuración de acciones de IA
Una vez conectada tu integración de KWHotel, puedes configurar qué acciones de IA puede realizar tu chatbot.
Acciones de IA disponibles
- KWHotel - get rooms - Muestra los tipos de habitación con descripciones, configuración de camas, superficie, capacidad y fotos
- KWHotel - find available rooms - Busca habitaciones disponibles para un rango de fechas determinado y devuelve ofertas con precios
- KWHotel - check room availability - Comprueba la disponibilidad para un tipo de habitación y rango de fechas específicos
- KWHotel - create reservation - Crea una nueva reserva con los datos del huésped y la información de la reserva
- KWHotel - get reservation - Consulta reservas existentes
Cómo activar y personalizar acciones
- Tras conectar, haz clic en Configure AI Actions (Configurar acciones de IA) en el modal de confirmación, o ve a Bot Settings (Ajustes del bot) > Actions (Acciones) y localiza la categoría KWHotel
- Activa o desactiva las acciones que quieras habilitar
- Personaliza la etiqueta de la acción (el texto que ven los usuarios mientras se ejecuta la acción) y las instrucciones del prompt según lo necesites
- Haz clic en Save (Guardar) para aplicar los cambios
Prácticas recomendadas
Cómo optimizar las respuestas del chatbot
- Entrena tu bot con información sobre el alojamiento - Añade descripciones de tus habitaciones e instalaciones a la base de conocimiento, incluidos los servicios, la ubicación, las atracciones cercanas y las políticas de check-in/check-out
- Define flujos de conversación claros - Configura mensajes de bienvenida que orienten a los huéspedes a preguntar por la disponibilidad y utiliza preguntas sugeridas como "Comprobar disponibilidad de habitaciones" o "Ver habitaciones"
- Añade páginas específicas para cada habitación - Crea páginas dedicadas a cada tipo de habitación en tu sitio web y entrena al chatbot con sus URL para obtener respuestas más completas
Integración con el motor de reservas
- La integración de KWHotel funciona mediante el motor de reservas GuestSage para la gestión de disponibilidad y precios
- Para completar reservas directamente fuera del chat, inserta el widget de reservas de GuestSage en tu sitio web junto al chatbot de ChatLab; el chatbot puede guiar a los huéspedes a la página de reservas cuando estén listos para reservar
Solución de problemas
- Fallo de conexión - Verifica que tu Hotel ID sea el UUID de GuestSage (no el ID numérico de integraciones) y que tu propiedad esté activa en el motor de reservas GuestSage
- La acción Get reservation permanece desactivada - Si la prueba de conexión con la Integrations API falla al guardar, la acción se desactiva automáticamente. Vuelve a introducir el Integrations Hotel ID y la Integrations API Key, y haz clic en Update Chatbot.
- No se devuelven datos de habitaciones - Comprueba que tus tipos de habitación estén configurados correctamente en KWHotel con descripciones y que la disponibilidad esté publicada en GuestSage
- Precios incorrectos o sin ofertas - Los precios proceden de GuestSage. Actualiza las tarifas y la configuración de ofertas en KWHotel para reflejar los precios vigentes. Si configuraste un canal de descuentos para el bot (Discount bot channel), asegúrate de que contenga ofertas activas.
- La integración no aparece en el panel de administración - La integración con KWHotel requiere un plan STANDARD o PREMIUM de ChatLab, o el complemento Travel Integrations