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

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

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

Beds24 - це хмарна система управління об'єктами гостинності (PMS), менеджер каналів продажу (channel manager) та модуль бронювання, якими користуються готелі, гостьові будинки й апартаменти подобової оренди. Її підключення до ChatLab дозволяє вашому чатботу відповідати на запитання про номери, дати й ціни на основі актуальних даних із Beds24, а не зі статичного тексту, який доводиться постійно оновлювати вручну.

Зверніть увагу: Beds24 - це преміум-інтеграція, яка входить до групи інтеграцій для готельного бізнесу та подорожей. Якщо ваш тарифний план не передбачає таких інтеграцій, відкриття плитки Beds24 відобразить коротке повідомлення з посиланням на форму зв'язку з нами замість форми налаштування підключення.

Що надає ця інтеграція

Після підключення чатбот отримує три дії на основі ШІ (AI actions).

Beds24 - get properties - повертає список усіх номерів та категорій номерів у вашому об'єкті. Для кожного з них чатбот може надати назву, опис, фотографію, максимальну кількість дорослих і дітей, а також початкову ціну («від»).

Beds24 - find available rooms - відвідувач зазначає діапазон дат і кількість гостей, а чатбот повертає номери, вільні на цей період, разом із цінами та (якщо налаштовано) посиланням на бронювання для кожного номера.

Beds24 - check room availability - відвідувач запитує про конкретний номер. Чатбот знаходить відповідний номер за його ID в Beds24 або за назвою, після чого повертає інформацію про доступність і вартість на потрібні дати, а також посилання на бронювання.

Дати розпізнаються з природної мови, тому відвідувач може написати «наступні вихідні» або «12-15 червня», не використовуючи суворий формат дати.

Перед початком роботи

Вам потрібен чатбот, до якого підключатиметься інтеграція. Якщо ви ще його не створили, спершу прочитайте інструкцію Як створити свій перший чатбот у ChatLab.

Потім отримайте два значення з Beds24:

  1. Invite code (код запрошення) - у панелі керування Beds24 перейдіть до розділу Settings > API, згенеруйте invite code та виберіть області доступу read:properties і read:inventory. Цих двох прав достатньо для ChatLab; інтеграція лише зчитує дані й ніколи не записує інформацію до Beds24.
  2. Property ID (ідентифікатор об'єкта) - ідентифікатор об'єкта нерухомості, для якого чатбот має надавати відповіді.

За бажанням підготуйте третє значення:

  1. Booking URL format (формат URL бронювання) - адреса вашої власної сторінки бронювання з плейсхолдерами, які ChatLab підставлятиме в кожну відповідь:

    • {roomId} - ідентифікатор кімнати (room ID) у Beds24
    • {arrival} - дата заїзду
    • {departure} - дата виїзду

    Наприклад:

    https://yourdomain.com/book?room={roomId}&arrival={arrival}&departure={departure}
    

    Якщо залишити це поле порожнім, чатбот усе одно відповідатиме про доступність і ціни, але не додаватиме посилання на бронювання.

Крок 1: Підключіть Beds24

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

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

  1. Вставте свій Invite Code, введіть Property ID і, за бажанням, Booking URL format.

Форма інтеграції Beds24 із полями Invite Code, Property ID та Booking URL format

  1. Натисніть Connect (Підключити).

ChatLab обміняє код запрошення на токен доступу (access token) і токен оновлення (refresh token), збереже їх для цього бота й виконає тестовий запит до вашого об'єкта в Beds24. Якщо код запрошення недійсний або прострочений, або дані об'єкта не вдалося зчитати, інтеграція автоматично вимикається, а текст помилки з'являється у формі - це гарантує, що некоректно налаштоване з'єднання не залишиться напівувімкненим.

Код запрошення використовується лише на цьому кроці. Після успішного підключення це поле зникає з форми, і для редагування залишаються доступними лише Property ID та Booking URL format. ChatLab автоматично оновлює токен доступу за допомогою токена оновлення, тому інтеграція продовжує працювати без вашої участі.

Крок 2: Перегляньте дії Beds24

Після підключення всі три дії Beds24 активуються автоматично, тож чатбот одразу готовий відповідати на запити. Щоб перевірити або змінити їх, перейдіть до розділу Settings > Actions (Налаштування > Дії) та знайдіть групу Beds24 Actions. Ви також можете натиснути Beds24 у правій панелі Filter by Platform (Фільтр за платформою), щоб відобразити лише цю групу:

  • Beds24 - get properties - типовий напис дії (action label): «Loading rooms...»
  • Beds24 - find available rooms - типовий напис дії: «Checking availability...»
  • Beds24 - check room availability - типовий напис дії: «Checking room...»

Група Beds24 Actions у розділі Settings > Actions до підключення інтеграції

На скріншоті вище показано вигляд групи до завершення підключення: три дії вже є у списку, але мають статус Not connected (Не підключено) і недоступні боту. Вони ввімкнуться автоматично, щойно зв'язок буде встановлено.

Для кожної дії ви можете змінити:

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

Ви також можете вимкнути будь-яку з дій окремо, якщо вона не потрібна. Наприклад, можна залишити список номерів та пошук за датами, але відключити перевірку доступності одного номера.

Крок 3: Протестуйте роботу

Відкрийте свій чатбот і поставте йому запитання, які відповідають кожній дії:

  • «Які у вас є номери?» - запускає дію Beds24 - get properties
  • «Що є вільним з 12 по 15 червня для 2 дорослих?» - запускає дію Beds24 - find available rooms
  • «Чи вільний номер Люкс на наступні вихідні?» - запускає дію Beds24 - check room availability

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

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

Оновлення налаштувань - відкрийте плитку Beds24 на вкладці Connect, змініть Property ID або Booking URL format і збережіть зміни. Новий invite code для цього не потрібен.

Відключення - відкрийте плитку Beds24 та виконайте відключення. Три дії Beds24 перестануть бути доступними чатботу. Щоб підключити інтеграцію знову пізніше, згенеруйте в Beds24 новий invite code, оскільки попередній уже використано.

Корисні поради

  • Продовжуйте навчати бота на матеріалах свого вебсайту. Дії Beds24 відповідають за номери, дати й ціни; на всі інші запитання гостей (сніданок, паркінг, години заїзду, проживання з тваринами) бот відповідатиме з вашої бази знань. Див. Навчання чатбота - основи та обмеження.
  • Додавайте правила бронювання (наприклад, мінімальний термін перебування чи умови внесення завдатку) в інструкції користувача (User Instructions) для відповідної дії, щоб чатбот повідомляв про них одразу під час перевірки дат, а не залишав гостя дізнаватися про це на етапі оформлення.
  • Додайте підказки з питаннями (suggested questions), як-от «Перевірити доступність» або «Показати номери», щоб відвідувачі швидше дізнавалися про можливості чатбота.
  • Кожна відповідь, яка викликає дію Beds24, використовує кредити повідомлень (message credits) так само, як і будь-яка інша відповідь бота. Див. Що таке кредит повідомлення.

Схожі статті