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

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

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

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

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

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

Після підключення чатбот отримує п'ять дій Hostfully. Окрема дія AI room search доступна тоді, коли чатбот має відповідний ліміт місткості для пошуку номерів.

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

Hostfully - find available properties - гість зазначає діапазон дат і кількість гостей, а чатбот повертає список вільних на ці дати об'єктів із ціною за перебування та посиланням на бронювання для кожного об'єкта.

Hostfully - check availability - гість запитує про один конкретний об'єкт. Чатбот перевіряє календар об'єкта на потрібні дати, повідомляє, чи він вільний, які дати зайняті, якщо об'єкт недоступний, а також ціну для вказаної кількості гостей разом із посиланням на бронювання.

Hostfully - get reservation status - гість, який уже зробив бронювання, надає номер броні, а чатбот зчитує з Hostfully статус, об'єкт, ім'я гостя, а також дати заїзду та виїзду.

Hostfully - create booking request - чатбот збирає інформацію про об'єкт, дати, кількість дорослих і дітей, ім'я, e-mail і номер телефону гостя, підтверджує ці дані з гостем і створює новий лід у вашому обліковому записі Hostfully. Гість отримує номер заявки, а ваша команда продовжує роботу з нею безпосередньо в Hostfully.

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

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

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

Потім скопіюйте два значення з Hostfully. Обидва знаходяться на одній сторінці: увійдіть у Hostfully, натисніть назву своєї компанії в головному меню навігації та виберіть Agency Settings (Налаштування агентства).

1. API Key - у розділі API Key на сторінці Agency Settings. Доступ до API є функцією облікового запису Hostfully; якщо цей розділ відсутній у вашому акаунті, зверніться до служби підтримки Hostfully, щоб вони увімкнули його. Дивіться Hostfully API authentication.
2. Agency UID - у самому низу сторінки Agency Settings.

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

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

   • {web_link} - посилання на сторінку об'єкта в Hostfully
   • {property_uid} - ідентифікатор об'єкта в Hostfully
   • {date_from} - дата заїзду
   • {date_to} - дата виїзду
   • {guests} - кількість гостей

   Наприклад:

   {web_link}?checkIn={date_from}&checkOut={date_to}&guests={guests}
   

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

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

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

3. Вставте свій API Key та Agency UID, виберіть Default content language (Мова контенту за замовчуванням) і за потреби заповніть Booking URL format.

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

ChatLab збереже налаштування та відразу виконає тестовий запит для отримання списку об'єктів вашого агентства. Якщо ключ API або Agency UID вказано неправильно, інтеграція знову вимикається, а у формі з'являється повідомлення про помилку, завдяки чому некоректне підключення ніколи не залишається напівувімкненим. У разі успішного підключення ChatLab завантажує ваші об'єкти з їхніми описами та фотографіями у свій кеш, що забезпечує швидкі відповіді в майбутньому.

Параметр Default content language визначає, якою мовою ChatLab зчитує назви та описи об'єктів, якщо в Hostfully вони доступні кількома мовами. Можна вибрати англійську, польську, німецьку, іспанську, французьку та італійську; за замовчуванням використовується англійська.

Крок 2: Перевірте дії Hostfully

Під час підключення автоматично вмикаються чотири дії: get properties, check availability, find available properties та get reservation status. Дія Create booking request залишається вимкненою, оскільки вона створює новий лід у вашому обліковому записі Hostfully; увімкніть її, коли захочете, щоб гості могли надсилати запити на бронювання прямо з чату.

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

• Hostfully - get properties - мітка дії за замовчуванням: "Getting properties..."
• Hostfully - check availability - мітка дії за замовчуванням: "Checking availability..."
• Hostfully - find available properties - мітка дії за замовчуванням: "Searching available properties..."
• Hostfully - get reservation status - мітка дії за замовчуванням: "Checking reservation..."
• Hostfully - create booking request - мітка дії за замовчуванням: "Submitting request..."

На скриншоті вище показано групу до підключення інтеграції: дії та додатковий пошук номерів за допомогою AI відображаються у списку, але мають позначку Not connected (Не підключено) і недоступні для чатбота. Функція пошуку номерів за допомогою AI залежить від ліміту номерів та автоматичної індексації каталогу; її активація не гарантується для кожного підключення. Коли AI room search активний, він бере на себе пошук об'єктів, а звичайна дія get properties відходить на другий план.

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

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

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

Дія find available properties також має налаштування кількості результатів: від 1 до 10 об'єктів (за замовчуванням - 5). Вона обмежує список у відповіді, тому відповідь не обов'язково є повним списком усіх доступних об'єктів.

Крок 3: Протестуйте інтеграцію

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

• "Які апартаменти у вас є?" - запускає Hostfully - get properties
• "Що є вільне з 12 по 15 червня наступного року для 2 дорослих?" - запускає Hostfully - find available properties
• "Чи вільний Seaside Loft на наступні вихідні?" - запускає Hostfully - check availability
• "Який статус мого бронювання ABC123?" - запускає Hostfully - get reservation status
• "Я хочу забронювати Seaside Loft на ці дати" - запускає Hostfully - create booking request, якщо ви увімкнули цю дію

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

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

Оновлення налаштувань - відкрийте картку Hostfully на вкладці Connect, змініть ключ API, Agency UID, мову контенту або Booking URL format і натисніть Update Chatbot (Оновити чатбот). ChatLab знову виконає тестовий запит та оновить кеш об'єктів.

Відключення - відкрийте картку Hostfully та натисніть Disconnect (Відключити). Дії Hostfully перестануть бути доступними для чатбота, а збережені в кеші дані про об'єкти буде видалено. Ваші налаштування залишаться у формі, тому повторне підключення згодом займе всього один клік.

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

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

Схожі статті

• Інтеграція з Beds24
• Інтеграція з Hotres
• Інтеграція з IdoBooking
• Інтеграція з KWHotel
• Інтеграція з Mews
• Навчання чатбота - основи та обмеження
• Що таке кредит повідомлень

Room Catalog і Hotel Overview

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