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

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

Приклад розмови

Цей приклад ілюструє досвід клієнта. Доступні дії та надана інформація залежать від цієї інтеграції та ваших налаштувань.

Перш ніж почати

Спочатку створіть або виберіть чатбот. Вам потрібні права на керування його інтеграціями та доступ до налаштувань підключення зовнішнього акаунта. Якщо на картці Connect (Підключення) відображається пропозиція оновити тариф або зв'язатися з підтримкою, переконайтеся, що ваша підписка включає цю інтеграцію. Зберігайте облікові дані API в таємниці; ніколи не вставляйте їх у код віджета для сайту.

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

Коли інтеграцію з IdoBooking увімкнено, ваш чатбот може:

• показувати список доступних апартаментів і номерів з описами та фотографіями;
• перевіряти наявність місць на конкретні дати;
• знаходити доступні апартаменти на заданий діапазон дат із цінами;
• шукати наявні бронювання за ID, статусом або діапазоном дат;
• створювати нові бронювання з даними гостей.

Налаштувати цю інтеграцію можна двома способами - через IdoBooking Marketplace (рекомендовано) або вручну через панель керування ChatLab.

---

Варіант A: налаштування через IdoBooking Marketplace (рекомендовано)

Найшвидший спосіб підключити ChatLab до IdoBooking - через IdoBooking Marketplace. Цей метод автоматично обробляє облікові дані API та вмикає дії читання для вашого чатбота.

Крок 1: установіть ChatLab з IdoBooking Marketplace

1. Увійдіть у панель керування IdoBooking.
2. Перейдіть до розділу Marketplace.
3. Знайдіть ChatLab і натисніть Install.

IdoBooking надсилає ваші облікові дані API до ChatLab автоматично - не потрібно створювати окремого користувача API чи копіювати дані вручну.

Крок 2: створіть акаунт ChatLab або увійдіть до нього

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

Крок 3: оберіть тарифний план

Виберіть тарифний план, який відповідає вашим потребам. Функції інтеграції бронювання IdoBooking (пошук апартаментів, перевірка наявності, бронювання) вимагають наявності функції інтеграції з IdoBooking. Якщо ваша підписка її не включає, скористайтеся пропозицією оновити тариф або зв'язатися з підтримкою.

Крок 4: виберіть чатбот

Виберіть наявний чатбот для підключення до IdoBooking або створіть новий. Майстер може створити нового бота автоматично.

Крок 5: завершіть налаштування

Майстер автоматично:

• підключає ваші облікові дані IdoBooking до вибраного чатбота;
• вмикає пошук апартаментів, перевірку наявності та пошук бронювань (створення бронювань не вмикається автоматично);
• перенаправляє вас назад до IdoBooking або до панелі керування ChatLab.

Після завершення роботи майстра ваш чатбот готовий обробляти запити щодо бронювання. Ви можете точно налаштувати окремі дії AI у розділі Settings > Actions (Налаштування > Дії).

---

Варіант B: ручне налаштування

Якщо ви бажаєте налаштувати інтеграцію вручну, виконайте такі кроки.

Частина 1: створення користувача API в IdoBooking

Перед підключенням ChatLab до системи IdoBooking вам потрібно створити спеціального користувача з доступом до API в панелі IdoBooking.

Крок 1: перейдіть до керування користувачами

1. Увійдіть у панель керування IdoBooking.
2. Перейдіть до розділу Settings > Users.
3. Натисніть Add new user.

Крок 2: створіть обліковий запис користувача

1. Введіть login name (ім'я входу) для нового користувача (наприклад, «chatlab-api»).
2. Заповніть решту обов'язкових полів.
3. Установіть надійний password (пароль) для цього акаунта.

Крок 3: налаштуйте доступ до API

Налаштуйте такі параметри доступу для нового користувача:

1. Увімкніть опцію «Active API access» - це необхідно для роботи інтеграції.
2. Вимкніть опцію «Active panel access» - користувачеві не потрібен доступ до панелі керування.

Крок 4: установіть роль користувача та дозволи

У вас є два варіанти налаштування ролі користувача:

Варіант A: роль Administrator (простіший)

• Виберіть роль Administrator.
• Це надає широкі дозволи API, навіть коли доступ до панелі вимкнено. Використовуйте спеціальну роль, якщо інтеграції потрібні лише вибрані операції читання.

Варіант B: спеціальна роль Custom user (більш деталізована)

Якщо ви віддаєте перевагу точнішому контролю, виберіть Custom user і налаштуйте такі дозволи для модулів:

• Reservations - Read-only (якщо чатбот має лише отримувати інформацію про бронювання) або Full access (якщо чатбот створюватиме бронювання).
• Customers - Read-only.
• Offers - Read-only.

Для ролі Custom user також потрібно налаштувати дозволи на локації:

1. Прокрутіть до розділу Location and accommodation permissions.
2. Виберіть об'єкти нерухомості, які має обслуговувати цей чатбот; надавайте доступ до всіх об'єктів лише тоді, коли це відповідає вашому задуму.

Крок 5: вимкніть непотрібні сповіщення

Щоб користувач API не отримував робочі сповіщення, вимкніть такі опції:

• Notifications for property staff - вимкнути;
• Automatic email notifications - вимкнути.

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

1. Натисніть Save, щоб створити обліковий запис.
2. Занотуйте таку інформацію - вона знадобиться для налаштування ChatLab:

• Login - створене вами ім'я користувача (наприклад, chatlab-api);
• Password - установлений вами пароль;
• Subdomain - ваш піддомен IdoBooking (наприклад, client3760).

Як знайти свій піддомен: подивіться на URL-адресу вашої панелі IdoBooking. Наприклад, якщо ваша адреса https://client3760.idosell.com, ваш піддомен - client3760.

Частина 2: налаштування інтеграції в ChatLab

Крок 1: перейдіть на вкладку Connect

1. Увійдіть у панель керування ChatLab.
2. Виберіть бота, якого хочете налаштувати.
3. Перейдіть на вкладку Connect (Підключення).
4. Знайдіть і натисніть IdoBooking у списку інтеграцій.

Крок 2: укажіть параметри підключення

Заповніть форму підключення даними, отриманими з IdoBooking:

• Client Subdomain - укажіть ваш піддомен IdoBooking (без повної URL-адреси). Приклад: client3760 (не https://client3760.idosell.com).
• System Login - укажіть ім'я користувача API, створеного в IdoBooking.
• System Password - укажіть пароль користувача API.
• Default Currency - виберіть валюту для відображення цін.
• Default Language - виберіть мову для описів об'єктів.

Крок 3: виконайте підключення

1. Після заповнення всіх обов'язкових полів кнопка Connect (Підключити) стане активною.
2. Натисніть Connect, щоб установити з'єднання.
3. Зачекайте на повідомлення з підтвердженням.
4. Після підключення ви побачите сповіщення про успішне завершення.

Після успішного з'єднання напис на кнопці зміниться з «Connect» на «Update Chatbot», а також з'явиться кнопка «Disconnect», якщо вам знадобиться вимкнути інтеграцію пізніше.

---

Налаштування дій AI

Після підключення інтеграції з IdoBooking (будь-яким із методів) ви можете налаштувати, які дії AI зможе виконувати ваш чатбот. Перевірте активні дії після завершення налаштування будь-яким способом. Створення бронювань не вмикається автоматично.

Доступні дії AI

• Get Apartments - показує список доступних апартаментів і номерів з описами, конфігурацією ліжок і фотографіями.
• Find Available Apartments - шукає доступні апартаменти на заданий діапазон дат із зазначенням цін.
• Check Apartment Availability - перевіряє наявність місць для конкретних апартаментів на вибраний діапазон дат.
• Get Reservations - шукає наявні бронювання за ID, статусом або діапазоном дат.
• Create Reservation - створює нові бронювання з даними гостей та інформацією про заїзд.
• AI room search - підбирає номери відповідно до опису побажань гостя, аналізуючи описи ваших номерів, а не перевіряючи дати.

Функція AI room search та дія Get Apartments є взаємовиключними альтернативами, а не доповненням одна одної. Коли функцію AI room search увімкнено, вона замінює звичайний інструмент списку, а дія Get Apartments вилучається з чатбота, тому активним завжди залишається лише один інструмент показу номерів. На дії, що базуються на датах, це не впливає.

Увімкнення та кастомізація дій

1. Після підключення натисніть Configure AI Actions (Налаштувати дії AI) у модальному вікні успішного завершення або перейдіть до Settings > Actions (Налаштування > Дії) та знайдіть категорію IdoBooking.
2. Увімкніть перемикачами потрібні дії.
3. За потреби змініть мітку дії (текст, що відображається користувачам під час виконання дії) та інструкції.
4. У діалоговому вікні дії натисніть Enable (Увімкнути) для нової дії або Update (Оновити) для наявної.

Налаштування дії «Find available apartments»

Дія Find available apartments має два додаткові параметри, які визначають, скільки апартаментів чатбот показує гостю у відповідь на запит про наявність і які саме апартаменти потрапляють до вибірки. Щоб отримати доступ до них, відкрийте дію через Settings > Actions > IdoBooking - find available apartments.

Number of offers to show (Кількість пропозицій для показу)

Повзунок зі значеннями від 3 до 10 (за замовчуванням 6). Він регулює, скільки апартаментів чатбот повертає користувачеві в одній відповіді.

• Менші значення (3-4) роблять відповідь короткою та сфокусованою, що зручно, коли більшість гостей обирає серед кількох основних варіантів.
• Більші значення (8-10) дають гостям ширший вибір для порівняння, що корисно для об'єктів із великим номерним фондом.

Offer selection strategy (Стратегія відбору пропозицій)

Випадний список, який визначає, як саме вибираються апартаменти з повного переліку доступних результатів після фільтрації за датами та кількістю гостей. Доступні чотири варіанти:

• Cheapest offers (Найдешевші пропозиції, за замовчуванням) - повертає апартаменти з найнижчою мінімальною ціною, відсортовані від найдешевших до найдорожчих. Добре підходить, якщо гості чутливі до ціни або якщо ви бажаєте починати з найдоступніших варіантів.
• Evenly distributed by price (Рівномірно за ціною) - вибирає апартаменти, рівномірно розподілені за ціновим діапазоном. Наприклад, для 9 пропозицій це дасть приблизно 3 найдешевші, 3 середньої ціни та 3 найдорожчі. Корисно, коли ви хочете показати гостям весь спектр варіантів, а не лише бюджетний сегмент.
• Most expensive offers (Найдорожчі пропозиції) - повертає апартаменти з найвищою ціною, відсортовані від найдорожчих до найдешевших. Підходить для об'єктів преміум-класу або якщо ви хочете насамперед презентувати номери вищої категорії.
• Random selection (Випадковий вибір) - вибирає апартаменти випадковим чином із відфільтрованих результатів. Зручно, якщо ви хочете урізноманітнити пропозиції між різними розмовами й уникати постійного показу одних і тих самих номерів.

Обидва параметри зберігаються окремо для кожного бота разом із налаштованим промптом і міткою дії.

---

Перевірка завершеного налаштування

Відкрийте Overview (Огляд) і почніть нову тестову розмову. Запитайте про номери на майбутній діапазон дат для певної кількості гостей, після чого відкрийте отримане посилання на бронювання та порівняйте дати, валюту й ціну з даними в IdoBooking. Перевірте пошук бронювання на прикладі того замовлення, інформацію про яке ви маєте право переглядати. Вмикайте та тестуйте дію Create Reservation тільки тоді, коли ви дійсно маєте намір створити справжнє бронювання; тест у чаті може внести реальний запис до вашої системи бронювання.

Рекомендації

Безпека (у разі ручного налаштування)

• Використовуйте окремого користувача API - створіть окремого користувача виключно для інтеграції з ChatLab, а не використовуйте свій особистий обліковий запис адміністратора.
• Мінімальні дозволи - надавайте лише ті дозволи, які дійсно потрібні для ваших завдань. Якщо чатбот має тільки показувати дані, використовуйте доступ лише для читання.
• Регулярне оновлення облікових даних - періодично змінюйте пароль користувача API, після чого оновлюйте дані в ChatLab.

Оптимізація відповідей чатбота

• Навчайте бота інформації про об'єкт - додавайте описи ваших помешкань до бази знань, зокрема перелік зручностей, особливості номерів і деталі розташування.
• Налаштуйте зрозумілі сценарії спілкування - створюйте привітальні повідомлення, які підказують користувачам запитати про наявність місць, і додавайте рекомендовані запитання на кшталт «Перевірити наявність» або «Переглянути номери».

---

Усунення несправностей

• Помилка підключення - перевірте, чи ввімкнено опцію «Active API access» для користувача в IdoBooking.
• Помилки «Access denied» (Доступ заборонено) - перевірте правильність налаштування дозволів для модулів у цього користувача.
• Дані не повертаються - переконайтеся, що користувач має доступ до відповідних локацій та об'єктів нерухомості.
• Неправильний піддомен - перевірте URL-адресу вашої панелі IdoBooking і витягніть лише частину піддомену (наприклад, client3760 з адреси https://client3760.idosell.com).

---

Каталог номерів та огляд готелю

Якщо у вашому акаунті відображається вкладка Hotel (Готель), скористайтеся розділом Hotel > Rooms, щоб перевірити каталог номерів і статус навчання. Функція AI room search працює окремо від перевірки наявності за датами: вона порівнює описи номерів, тоді як дії перевірки наявності звіряють дати запитуваного проживання. Автоматична індексація номерів залежить від автоіндексації каталогу та виділеного ліміту номерів; в іншому разі скористайтеся кнопкою Train rooms (Навчити номери), якщо вона доступна. Перевірте увімкнені дії та дочекайтеся завершення навчання, перш ніж покладатися на AI room search.

Схожі статті

• Додавання чатбота на сайт
• Навчання чатбота: основи та ліміти
• Надсилання посилання на чатбот