Conecta tu chatbot de ChatLab con tu sistema de reservas IdoBooking para ofrecer información de disponibilidad en tiempo real y asistencia con las reservas a los visitantes de tu sitio web.
Conversación de ejemplo
De las fechas de viaje a las ofertas de habitaciones
Requiere una integración de alojamiento compatible y la acción de disponibilidad activada. Una oferta o consulta no confirma una reserva.
Visitante: Una habitación para dos adultos, del 14 al 16 de agosto.
Reproduce el ejemplo o léelo abajo. No se utilizan datos reales de clientes.Recopila los requisitos de la estancia.
La reproducción se pausa cuando este ejemplo sale de la pantalla. Esto es una simulación, no un chat en vivo. Los controles del widget dentro de la reproducción no son interactivos.Leer el ejemplo completo
- Recopila los requisitos de la estancia.
Visitante: Una habitación para dos adultos, del 14 al 16 de agosto.
- Pide los datos de fecha que falten antes de buscar.
Asistente: ¿En qué año te gustaría alojarte?
- El huésped indica el año.
Visitante: 2027.
- Consulta el sistema de alojamiento conectado.
Comprobando la disponibilidad de habitaciones...
- Presenta las ofertas obtenidas para esa estancia.
Doble con vistas al mar, €280 / stay. Oferta de ejemplo para dos adultos, dos noches.
- Continúa usando la vía de reserva compatible con tu integración.
Asistente: Revisa la página de reserva para ver el precio final y las condiciones. No se ha realizado ninguna reserva en esta demostración.
El ejemplo ilustra la experiencia del cliente. Las acciones disponibles y la información devuelta dependen de esta integración y de tu configuración.
Antes de empezar
Crea o selecciona primero un chatbot. Necesitas permisos para gestionar sus integraciones y acceso a los ajustes de conexión de la cuenta externa. Si la tarjeta Connect (Conectar) muestra un aviso de actualización o de contacto, comprueba que tu suscripción incluya esta integración. Mantén la privacidad de las credenciales de la API; nunca las pegues en el código de inserción del sitio web.
Qué ofrece la integración
Con la integración de IdoBooking activada, tu chatbot puede:
- Mostrar apartamentos y alojamientos disponibles con descripciones y fotos
- Comprobar la disponibilidad para fechas específicas
- Encontrar apartamentos disponibles para un rango de fechas determinado con precios
- Buscar reservas existentes por ID, estado o rango de fechas
- Crear nuevas reservas con los datos de los huéspedes
Hay dos formas de configurar esta integración: a través del Marketplace de IdoBooking (recomendado) o manualmente a través del panel de administración de ChatLab.
Opción A: Configuración a través del Marketplace de IdoBooking (Recomendado)
La forma más rápida de conectar ChatLab con IdoBooking es a través del Marketplace de IdoBooking. Este método gestiona las credenciales de la API automáticamente y activa las acciones de lectura para tu chatbot.
Paso 1: Instala ChatLab desde el Marketplace de IdoBooking
- Inicia sesión en tu panel de administración de IdoBooking
- Ve a la sección Marketplace
- Busca ChatLab y haz clic en Install (Instalar)
IdoBooking envía tus credenciales de la API a ChatLab automáticamente; no hace falta crear un usuario de API independiente ni copiar credenciales manualmente.
Paso 2: Crea o inicia sesión en tu cuenta de ChatLab
Tras activar ChatLab en el marketplace, se te redirigirá a un asistente de configuración guiada. Si ya tienes una cuenta de ChatLab, inicia sesión. En caso contrario, crea una cuenta nueva.
Paso 3: Elige un plan de suscripción
Selecciona un plan de suscripción que se adapte a tus necesidades. Las funciones de integración de reservas de IdoBooking (búsqueda de apartamentos, comprobación de disponibilidad, reservas) requieren la función de integración con IdoBooking. Si tu suscripción no la incluye, sigue el aviso de actualización o de contacto.
Paso 4: Selecciona un chatbot
Elige un chatbot existente para conectarlo con IdoBooking o crea uno nuevo. El asistente puede crear un nuevo bot automáticamente por ti.
Paso 5: Completa la configuración
El asistente automáticamente:
- Conecta tus credenciales de IdoBooking al chatbot seleccionado
- Activa la búsqueda de apartamentos, las comprobaciones de disponibilidad y la consulta de reservas. La creación de reservas no se activa automáticamente.
- Te redirige de vuelta a IdoBooking o al panel de administración de ChatLab
Tras completar el asistente, tu chatbot estará listo para gestionar consultas de reservas. Puedes ajustar con precisión las acciones individuales de IA en Settings > Actions (Ajustes > Acciones).
Opción B: Configuración manual
Si prefieres configurar la integración manualmente, sigue estos pasos.
Parte 1: Crear un usuario de API en IdoBooking
Antes de conectar ChatLab a tu sistema IdoBooking, necesitas crear un usuario dedicado con acceso a la API en tu panel de IdoBooking.
Paso 1: Navega a la gestión de usuarios
- Inicia sesión en tu panel de administración de IdoBooking
- Ve a Settings > Users (Ajustes > Usuarios)
- Haz clic en Add new user (Añadir nuevo usuario)
Paso 2: Crea la cuenta de usuario
- Introduce un nombre de inicio de sesión para el nuevo usuario (por ejemplo, "chatlab-api")
- Rellena el resto de la información requerida
- Establece una contraseña segura para esta cuenta
Paso 3: Configura el acceso a la API
Configura los siguientes ajustes de acceso para el nuevo usuario:
- Activa "Active API access" (Acceso activo a la API); esto es obligatorio para que la integración funcione
- Desactiva "Active panel access" (Acceso activo al panel); el usuario no necesita acceso al panel de administración
Paso 4: Establece el rol de usuario y los permisos
Tienes dos opciones para configurar el rol de usuario:
Opción A: Rol de Administrador (Más sencilla)
- Selecciona Administrator (Administrador) como rol
- Esto otorga amplios permisos de API incluso cuando el acceso al panel está desactivado. Utiliza un rol personalizado si la integración solo necesita operaciones de lectura seleccionadas.
Opción B: Rol de usuario personalizado (Más detallado)
Si prefieres un control más exhaustivo, selecciona Custom user (Usuario personalizado) y configura los siguientes permisos de módulo:
- Reservations (Reservas) - Read-only (Solo lectura, si el chatbot solo debe obtener información de reservas) o Full access (Acceso completo, si el chatbot creará reservas)
- Customers (Clientes) - Read-only (Solo lectura)
- Offers (Ofertas) - Read-only (Solo lectura)
Para los usuarios personalizados, también debes configurar los permisos de ubicación:
- Desplázate hasta la sección Location and accommodation permissions (Permisos de ubicación y alojamiento)
- Selecciona las propiedades que debe cubrir este chatbot; concede acceso a todas únicamente si ese es el alcance que deseas.
Paso 5: Desactiva las notificaciones innecesarias
Para evitar que el usuario de la API reciba notificaciones operativas, desactiva las siguientes opciones:
- Notifications for property staff (Notificaciones para el personal del establecimiento) - Desactivar
- Automatic email notifications (Notificaciones automáticas por correo electrónico) - Desactivar
Paso 6: Guarda y reúne los datos de conexión
- Haz clic en Save (Guardar) para crear la cuenta de usuario
- Anota la siguiente información; la necesitarás para configurar ChatLab:
- Login (Usuario) - El nombre de usuario que has creado (por ejemplo, chatlab-api)
- Password (Contraseña) - La contraseña que has establecido
- Subdomain (Subdominio) - Tu subdominio de IdoBooking (por ejemplo, client3760)
Cómo encontrar tu subdominio: Mira la URL del panel de IdoBooking. Por ejemplo, si tu URL es https://client3760.idosell.com, tu subdominio es client3760.
Parte 2: Configuración de la integración en ChatLab
Paso 1: Navega a la pestaña Connect
- Inicia sesión en tu panel de administración de ChatLab
- Selecciona el bot que quieres configurar
- Ve a la pestaña Connect (Conectar)
- Busca y haz clic en IdoBooking en la lista de integraciones
Paso 2: Introduce los datos de conexión
Rellena el formulario de conexión con la información recopilada de IdoBooking:
- Client Subdomain (Subdominio de cliente) - Introduce tu subdominio de IdoBooking (sin la URL completa). Ejemplo:
client3760(nohttps://client3760.idosell.com) - System Login (Inicio de sesión en el sistema) - Introduce el nombre del usuario de la API que creaste en IdoBooking
- System Password (Contraseña del sistema) - Introduce la contraseña del usuario de la API
- Default Currency (Moneda predeterminada) - Selecciona la moneda para la información de precios
- Default Language (Idioma predeterminado) - Selecciona el idioma para las descripciones de las propiedades
Paso 3: Conectar
- Tras rellenar todos los campos obligatorios, el botón Connect (Conectar) se activará
- Haz clic en Connect para establecer la conexión
- Espera al mensaje de confirmación
- Una vez conectado, verás una notificación de confirmación
Tras realizar la conexión con éxito, el botón cambiará de "Connect" a "Update Chatbot" (Actualizar chatbot), y aparecerá un botón "Disconnect" (Desconectar) por si necesitas desactivar la integración más adelante.
Configuración de las acciones de IA
Una vez conectada la integración de IdoBooking (mediante cualquiera de los dos métodos), puedes configurar qué acciones de IA puede realizar tu chatbot. Revisa las acciones activas después de utilizar cualquier método de configuración. La creación de reservas no se activa automáticamente.
Acciones de IA disponibles
- Get Apartments (Obtener apartamentos) - Muestra apartamentos y alojamientos disponibles con descripciones, configuraciones de camas y fotos
- Find Available Apartments (Buscar apartamentos disponibles) - Busca apartamentos disponibles para un rango de fechas determinado con información de precios
- Check Apartment Availability (Comprobar disponibilidad de apartamento) - Comprueba la disponibilidad de un apartamento específico y un rango de fechas
- Get Reservations (Obtener reservas) - Busca reservas existentes por ID, estado o rango de fechas
- Create Reservation (Crear reserva) - Crea nuevas reservas con los datos del huésped y la información de la reserva
- AI room search (Búsqueda de habitaciones por IA) - Compara la descripción de lo que busca el huésped con las descripciones de tus habitaciones, en lugar de consultar fechas
AI room search y Get Apartments son alternativas, no complementos. Cuando AI room search está activado, sustituye a la herramienta básica de listado y Get Apartments se retira del chatbot, de modo que solo queda activa una única herramienta de listado de habitaciones. Las acciones basadas en fechas no se ven afectadas.
Activar y personalizar acciones
- Tras conectar, haz clic en Configure AI Actions (Configurar acciones de IA) en el modal de confirmación, o navega hasta Settings > Actions y busca la categoría IdoBooking
- Activa o desactiva las acciones que quieras habilitar
- Personaliza la etiqueta de la acción (el texto que se muestra a los usuarios mientras la acción se ejecuta) y las instrucciones según sea necesario
- En el cuadro de diálogo de la acción, haz clic en Enable (Activar) para una acción nueva o en Update (Actualizar) para una acción existente.
Configurar "Find available apartments"
La acción Find available apartments cuenta con dos controles adicionales que determinan cuántos apartamentos muestra el chatbot cuando un huésped pregunta por la disponibilidad y cuáles son los apartamentos seleccionados. Ábrela desde Settings > Actions > IdoBooking - find available apartments para acceder a ellos.
Number of offers to show (Número de ofertas para mostrar)
Un control deslizante que va de 3 a 10 (predeterminado 6). Controla cuántos apartamentos devuelve el chatbot al usuario en una sola respuesta.
- Los valores más bajos (3-4) mantienen la respuesta corta y concisa, útil cuando la mayoría de los huéspedes deciden entre unas pocas opciones favoritas.
- Los valores más altos (8-10) ofrecen a los huéspedes más variedad para comparar, lo que resulta útil para propiedades con un catálogo más amplio.
Offer selection strategy (Estrategia de selección de ofertas)
Un menú desplegable que decide qué apartamentos se eligen de la lista completa de resultados disponibles tras filtrar por fecha y número de huéspedes. Hay cuatro opciones disponibles:
- Cheapest offers (predeterminado) - devuelve los apartamentos con el precio mínimo más bajo, ordenados de menor a mayor precio. Adecuado cuando los huéspedes son sensibles al precio o quieres priorizar las opciones más accesibles.
- Evenly distributed by price - selecciona apartamentos distribuidos de forma uniforme a lo largo del rango de precios. Por ejemplo, con 9 ofertas esto proporciona aproximadamente 3 de las más baratas, 3 de precio medio y 3 de las más caras. Resulta útil cuando quieres que los huéspedes vean toda la variedad disponible y no solo las opciones más económicas.
- Most expensive offers - devuelve los apartamentos de mayor precio, ordenados de más caro a menos caro. Adecuado para propiedades prémium o si quieres destacar tu inventario de gama más alta.
- Random selection - selecciona apartamentos al azar de los resultados filtrados. Útil cuando quieres variar los apartamentos que se destacan entre diferentes conversaciones y evitar recomendar siempre los mismos.
Ambos ajustes se guardan por bot, junto con el prompt personalizado y la etiqueta de la acción ya existentes.
Probar la configuración completada
Abre Overview (Resumen) e inicia una nueva conversación de prueba. Pide habitaciones para un rango de fechas futuro y un número de huéspedes específico; luego abre el enlace de reserva devuelto y compara las fechas, la moneda y el precio con IdoBooking. Prueba la búsqueda de reservas con una reserva que tengas autorización para consultar. Activa y prueba Create Reservation solo cuando tengas la intención de crear una reserva real; una prueba en el chat puede escribir datos en tu sistema de reservas.
Prácticas recomendadas
Recomendaciones de seguridad (Configuración manual)
- Usa un usuario de API dedicado - Crea un usuario independiente específicamente para la integración con ChatLab en lugar de usar tu cuenta personal de administrador
- Permisos mínimos - Concede solo los permisos necesarios para tu caso de uso. Utiliza el acceso de solo lectura si el chatbot solo necesita consultar información
- Rotación regular de credenciales - Actualiza periódicamente la contraseña del usuario de la API y luego actualiza las credenciales en ChatLab
Optimizar las respuestas del chatbot
- Entrena a tu bot con información sobre el alojamiento - Añade descripciones de tus alojamientos a la base de conocimiento, incluidos los servicios, las características de las habitaciones y los detalles de ubicación
- Establece flujos de conversación claros - Configura mensajes de bienvenida que orienten a los usuarios a preguntar por la disponibilidad y utiliza sugerencias de preguntas como "Consultar disponibilidad" o "Ver habitaciones"
Resolución de problemas
- Error de conexión - Verifica que "Active API access" esté activado para el usuario en IdoBooking
- Errores de "Access denied" (Acceso denegado) - Comprueba que el usuario tenga los permisos de módulo correctos
- No se devuelven datos - Asegúrate de que el usuario tenga acceso a las ubicaciones y propiedades pertinentes
- Subdominio incorrecto - Revisa la URL de tu IdoBooking y extrae solo la parte correspondiente al subdominio (por ejemplo,
client3760a partir dehttps://client3760.idosell.com)
Catálogo de habitaciones y resumen del hotel
Si tu cuenta muestra la pestaña Hotel, usa Hotel > Rooms (Hotel > Habitaciones) para revisar el catálogo de habitaciones y el estado del entrenamiento. AI room search es independiente de las comprobaciones de disponibilidad basadas en fechas: hace coincidir descripciones de habitaciones, mientras que las acciones de disponibilidad comprueban una estancia solicitada. La indexación automática de habitaciones depende de la autoindexación del catálogo y de la capacidad asignada al catálogo de habitaciones; de lo contrario, usa Train rooms (Entrenar habitaciones) cuando esté disponible. Revisa las acciones activadas y espera a que termine el entrenamiento antes de confiar en AI room search.