Підключіть свій чатбот ChatLab до системи управління готелем KWHotel, щоб надавати відвідувачам вашого сайту інформацію про наявність номерів, бронювання та пошук резервацій у реальному часі. Інтеграція використовує модуль бронювання GuestSage для отримання даних про номери й доступність, а також 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 - числовий 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 - числовий 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, щоб увімкнути її.
Налаштування дій ШІ
Коли інтеграцію з KWHotel підключено, ви можете налаштувати, які дії ШІ зможе виконувати ваш чатбот.
Доступні дії ШІ
- KWHotel - get rooms - показує список категорій номерів з описами, конфігурацією ліжок, площею, місткістю та фотографіями
- KWHotel - find available rooms - шукає доступні номери на вказаний діапазон дат і повертає пропозиції з цінами
- KWHotel - check room availability - перевіряє доступність для конкретної категорії номера та діапазону дат
- KWHotel - create reservation - створює нове бронювання з даними гостей та інформацією про замовлення
- KWHotel - get reservation - виконує пошук наявних бронювань
Увімкнення та налаштування дій
- Після підключення натисніть Configure AI Actions (Налаштувати дії ШІ) у модальному вікні успішного завершення або перейдіть до 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