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

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

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

Після ввімкнення інтеграції з IdoBooking ваш чатбот зможе:

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

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

---

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

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

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

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

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

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

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

Крок 3: Оберіть план підписки

Виберіть план підписки, який відповідає вашим потребам. Для роботи функцій інтеграції бронювання IdoBooking (пошук апартаментів, перевірка наявності, бронювання) потрібен план STANDARD або PREMIUM.

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

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

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

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

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

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

---

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

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

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

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

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

1. Увійдіть у свою панель адміністратора IdoBooking
2. Перейдіть до Settings (Налаштування) > Users (Користувачі)
3. Натисніть Add new user (Додати нового користувача)

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

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

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

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

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

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

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

Варіант А: Роль адміністратора (простіший)

• Оберіть роль Administrator
• Оскільки користувач не матиме доступу до панелі, це безпечний варіант, який надає повні права API

Варіант B: Власна роль користувача (більш гнучкий)

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

• Reservations (Бронювання) - Read-only (Лише читання, якщо чатбот має лише отримувати інформацію про бронювання) або Full access (Повний доступ, якщо чатбот створюватиме бронювання)
• Customers (Клієнти) - Read-only (Лише читання)
• Offers (Пропозиції) - Read-only (Лише читання)

Для користувачів із власною роллю також необхідно налаштувати дозволи для локацій:

1. Прокрутіть до розділу Location and accommodation permissions
2. Ми рекомендуємо вибрати Select all, щоб надати доступ до всіх об'єктів

Крок 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 - створює нові бронювання з даними гостей та інформацією про заїзд

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

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

Налаштування "Find available apartments"

Дія Find available apartments має два додаткові параметри, які визначають, скільки апартаментів чатбот показує гостю під час запиту про наявність і які саме апартаменти потрапляють до вибірки. Щоб відкрити їх, перейдіть до Bot 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 - вибирає випадкові апартаменти з відфільтрованих результатів. Корисно, якщо ви хочете варіювати пропозиції в різних розмовах і не рекомендувати щоразу одні й ті самі варіанти.

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

---

Рекомендації щодо використання

Поради з безпеки (ручне налаштування)

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

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

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

---

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

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

---