Подключите чат-бота ChatLab к вашей системе управления отелем KWHotel, чтобы посетители вашего сайта могли в реальном времени проверять доступность номеров, бронировать их и просматривать существующие бронирования. Интеграция использует модуль бронирования GuestSage booking engine для получения данных о номерах и наличии мест, а также KWHotel Integrations API для поиска бронирований.
Возможности интеграции
При включенной интеграции с KWHotel ваш чат-бот может:
- Показывать список категорий номеров с описаниями, вместимостью, площадью и фотографиями
- Находить доступные номера с ценами на указанный диапазон дат
- Проверять доступность конкретного номера на определенные даты
- Создавать новые бронирования с данными гостей
- Находить существующие бронирования
Предварительные требования
Перед настройкой интеграции убедитесь, что у вас есть:
- Аккаунт KWHotel с активированным модулем бронирования GuestSage
- Ваш Hotel ID (UUID) из модуля бронирования GuestSage
- Ваши числовой идентификатор Integrations Hotel ID и ключ Integrations API Key, выданные KWHotel
- Аккаунт ChatLab с тарифным планом STANDARD или PREMIUM либо с дополнением Travel Integrations
Как найти свой Hotel ID (UUID)
Hotel ID - это идентификатор UUID, присвоенный вашему объекту размещения в модуле бронирования GuestSage.
- Войдите в cloud.kwhotel.com
- Перейдите в Modules (Модули) > Booking Engine (Модуль бронирования)
- На вкладке General (Общие) найдите поле Booking engine link (Ссылка на модуль бронирования)
- Скопируйте UUID из URL-адреса
Например, в ссылке https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 идентификатором Hotel ID является 82b0085d-da1b-4443-8fde-d5d569a859e6.
Как найти учетные данные Integrations API
В KWHotel Integrations API используется другой идентификатор, отличный от UUID в GuestSage:
- Integrations Hotel ID - числовой идентификатор (например,
292) - Integrations API Key - секретный ключ, который вы создаете в KWHotel
Числовой Hotel ID
Числовой Hotel ID можно найти в правом верхнем углу панели администратора KWHotel.
Создание ключа API
Вы сами создаете ключ API внутри KWHotel:
- Войдите в KWHotel и откройте модуль Synchronization (Синхронизация)
- Нажмите кнопку Reset API key (Сбросить ключ API)
- Скопируйте созданный ключ и вставьте его в форму подключения в ChatLab
Нажатие на кнопку Reset API key удаляет предыдущий ключ (если он уже был создан) и генерирует новый. Любая другая система, использующая прежний ключ, перестанет работать, пока вы не обновите его на новое значение.
Настройка интеграции в ChatLab
Шаг 1: Перейдите на вкладку Connect
- Войдите в панель администратора ChatLab
- Выберите бота, которого хотите настроить
- Перейдите на вкладку Connect (Подключение)
- Найдите и выберите KWHotel в списке интеграций
Шаг 2: Введите данные для подключения
Заполните форму подключения:
- Hotel ID (UUID) - GUID вашего отеля в KWHotel из настроек модуля бронирования GuestSage
- Default Currency - валюта для отображения цен пользователям в чате (по умолчанию PLN)
- Default Language - язык описаний номеров и текстов предложений (по умолчанию польский)
- Integrations Hotel ID - числовой идентификатор отеля для KWHotel Integrations API (отличается от UUID выше)
- Integrations API Key - секретный ключ API, выданный KWHotel
- Discount bot channel - необязательно. Если указан, предложения загружаются для этого скидочного канала KWHotel и сортируются искусственным интеллектом. Оставьте пустым, чтобы использовать канал по умолчанию.
Шаг 3: Подключите
- После заполнения полей кнопка Connect (Подключить) станет активной
- Нажмите Connect, чтобы сохранить конфигурацию. ChatLab проверит подключение к GuestSage и Integrations API.
- В случае успеха появится всплывающее уведомление с подтверждением.
После успешного подключения кнопка Connect изменится на Update Chatbot (Обновить чат-бота), а рядом появится кнопка Disconnect (Отключить), чтобы вы могли отключить интеграцию позже.
Если проверка Integrations API завершится с ошибкой при сохранении, действие Get reservation будет автоматически отключено. Введите корректные учетные данные заново и нажмите Update Chatbot, чтобы включить его.
Настройка AI-действий
После подключения интеграции с KWHotel вы можете настроить, какие AI-действия сможет выполнять ваш чат-бот.
Доступные AI-действия
- KWHotel - get rooms - показывает категории номеров с описаниями, конфигурацией кроватей, площадью, вместимостью и фотографиями
- KWHotel - find available rooms - ищет доступные номера на указанный диапазон дат и возвращает предложения с ценами
- KWHotel - check room availability - проверяет доступность конкретной категории номера на указанные даты
- KWHotel - create reservation - создает новое бронирование с данными гостей и параметрами проживания
- KWHotel - get reservation - выполняет поиск существующих бронирований
Включение и настройка действий
- После подключения нажмите Configure AI Actions (Настроить AI-действия) в модальном окне успеха или перейдите в Bot Settings (Настройки бота) > Actions (Действия) и найдите категорию KWHotel
- Включите нужные действия с помощью переключателей
- Настройте при необходимости название действия (текст, который видят пользователи во время выполнения действия) и инструкции промпта
- Нажмите Save (Сохранить), чтобы применить изменения
Рекомендации
Оптимизация ответов чат-бота
- Обучите бота информации о вашем объекте - добавьте описания номеров и инфраструктуры отеля в базу знаний, включая удобства, расположение, ближайшие достопримечательности и правила заезда/выезда
- Настройте четкие сценарии диалога - настройте приветственные сообщения, побуждающие гостей узнать о наличии мест, и используйте подсказки вроде «Проверить наличие номеров» или «Посмотреть номера»
- Добавьте отдельные страницы для каждого номера - создайте на сайте выделенные страницы для каждой категории номеров и обучите чат-бота по их URL-адресам для более развернутых ответов
Интеграция с модулем бронирования
- Интеграция с KWHotel работает через модуль бронирования GuestSage для получения данных о наличии номеров и ценах
- Чтобы гости могли завершить бронирование напрямую вне чата, встройте виджет бронирования GuestSage на свой сайт рядом с чат-ботом ChatLab - бот сможет направить гостей на страницу бронирования, когда они будут готовы оформить заказ
Устранение неполадок
- Ошибка подключения - убедитесь, что в качестве Hotel ID указан именно UUID из GuestSage (а не числовой Integrations ID), и что ваш объект активен в модуле бронирования GuestSage
- Действие Get reservation остается выключенным - если проверка подключения к Integrations API не удалась при сохранении, действие отключается автоматически. Введите заново Integrations Hotel ID и Integrations API Key и нажмите Update Chatbot.
- Данные о номерах не возвращаются - убедитесь, что категории номеров правильно настроены в KWHotel с описаниями, а данные о доступности опубликованы в GuestSage
- Неверные цены или нет предложений - цены передаются из GuestSage. Обновите тарифы и параметры предложений в KWHotel, чтобы отображались актуальные цены. Если вы указали Discount bot channel, убедитесь, что для него есть активные предложения.
- Интеграция недоступна в панели администратора - для интеграции с KWHotel требуется план ChatLab STANDARD или PREMIUM либо дополнение Travel Integrations