Центр допомоги
Інтеграції чатбота

Інтеграція з Hotres

Останнє оновлення:

Підключіть свій чатбот ChatLab до системи бронювання Hotres, щоб надавати інформацію про доступність апартаментів у реальному часі та посилання на бронювання безпосередньо в чаті.

Примітка: Інтеграція з Hotres доступна за запитом. Якщо ви не бачите опції Hotres на вкладці Connect, зверніться до служби підтримки, щоб її увімкнули для вашого облікового запису.

Що забезпечує інтеграція

Get Apartments - клієнти можуть запитувати про номери та апартаменти вашого об'єкта. Чатбот отримує повний список із Hotres, зокрема:

  • Назву та опис апартаментів/номера
  • Зображення та пряме посилання на сторінку апартаментів

Check Apartment Availability - клієнти можуть перевірити, чи доступні конкретні апартаменти на вибрані дати. Чатбот повертає:

  • Статус доступності та ціни
  • Індикатор спеціальної пропозиції, якщо тариф відрізняється від вашого основного прайс-листа
  • Альтернативні апартаменти із запропонованими діапазонами дат, якщо запитуваний варіант недоступний або має вимоги щодо мінімального терміну проживання
  • Посилання на бронювання із заздалегідь заповненими датами

Find Available Apartments - клієнти можуть шукати доступні апартаменти, вказавши діапазон дат і кількість гостей. Чатбот повертає:

  • Усі апартаменти, доступні на вказані дати, разом із цінами
  • Індикатор спеціальної пропозиції для знижених тарифів
  • Посилання на бронювання для кожного доступного апартамента
  • Якщо на точні дати немає вільних апартаментів - альтернативні варіанти із запропонованими діапазонами дат, які відповідають вимогам щодо мінімального терміну проживання

Попередні вимоги

Перш ніж розпочати, підготуйте такі дані зі свого облікового запису Hotres:

  1. API Key - ваш ключ автентифікації API Hotres

  2. Object ID - ідентифікатор вашого об'єкта нерухомості в Hotres

  3. Main Pricelist Name - точна назва вашого основного прайс-листа в Hotres

  4. Booking URL Format - шаблон URL-адреси для вашої сторінки бронювання з використанням таких плейсхолдерів:

    • {DATE_FROM} - дата заїзду
    • {DATE_TO} - дата виїзду
    • {TAG} - ідентифікатор апартаментів/номера

    Приклад формату:

    https://yourdomain.com/booking?checkin={DATE_FROM}&checkout={DATE_TO}&apt={TAG}
    

Крок 1: Підключення Hotres у ChatLab

  1. Увійдіть у ChatLab і виберіть свого бота
  2. Перейдіть на вкладку Connect (Підключення)

Вкладка Connect із плиткою інтеграції Hotres

  1. Натисніть Connect (Підключити) на плитці Hotres
  2. Заповніть чотири обов'язкові поля: API Key, Object ID, Main Pricelist Name та Booking URL format

Форма інтеграції Hotres із параметрами підключення

  1. Натисніть Connect

ChatLab автоматично перевірить підключення, надіславши запит до вашого об'єкта в Hotres. Якщо API key або Object ID вказано неправильно, ви побачите повідомлення про помилку. У разі успіху з'явиться вікно підтвердження з можливістю налаштувати дії ШІ.

Крок 2: Налаштування дій Hotres

Після підключення ввімкніть і налаштуйте окремі дії ШІ. Перейдіть до Settings > Actions (Налаштування > Дії) та відфільтруйте за платформою Hotres.

Дії Hotres у меню Settings із відображенням усіх трьох доступних дій

Доступні три дії:

  • Hotres - get apartments - виводить список усіх номерів та апартаментів у вашому об'єкті
  • Hotres - check apartment availability - перевіряє доступність конкретних апартаментів на вибрані дати
  • Hotres - find available apartments - шукає доступні апартаменти за діапазоном дат і кількістю гостей

Натисніть кнопку активації біля кожної дії, щоб увімкнути її. Ви можете налаштувати:

  • Action Label (Мітка дії) - повідомлення, яке показується користувачам під час виконання дії (наприклад, "Перевіряємо доступність...")
  • Instructions (Інструкції) - вказівки для ШІ щодо того, коли і як використовувати цю дію
  • User Instructions (Інструкції користувача) - додаткові бізнес-правила або побажання для ШІ

Тестування інтеграції

Після активації дій відкрийте віджет вашого чатбота та спробуйте такі запити:

  • "Які апартаменти у вас є?" (тестує Get Apartments)
  • "Чи доступні апартаменти 101 з 15 по 20 грудня?" (тестує Check Apartment Availability)
  • "Що є вільного з 15 по 20 грудня для 2 гостей?" (тестує Find Available Apartments)

Переконайтеся, що відповіді відповідають вашим даним у Hotres, а посилання на бронювання відкриваються коректно з попередньо заповненими датами.

Керування інтеграцією

Оновлення налаштувань - натисніть на плитку Hotres на вкладці Connect, змініть потрібні поля та натисніть Update Chatbot (Оновити чатбот).

Відключення - натисніть на плитку Hotres, а потім натисніть Disconnect (Відключити). Це вимкне всі дії ШІ для Hotres. Вашу конфігурацію буде збережено, і ви зможете підключити її знову пізніше.

Поради

  • Навчайте свого бота на детальних описах об'єкта, зручностей та інформації про розташування, щоб ШІ міг надавати контекст разом із даними про доступність.
  • Додайте запропоновані запитання, як-от "Перевірити доступність" або "Показати апартаменти", щоб спрямовувати відвідувачів.
  • Якщо у вас діють правила бронювання (мінімальний термін проживання, правила скасування), додайте їх до інструкцій дій, щоб ШІ згадував про них автоматично.