Интеграция с Hostfully

Hostfully - это платформа управления объектами размещения (PMS) для сферы краткосрочной аренды и агентств по аренде жилья для отдыха. Подключение ее к 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 - чатбот собирает данные об объекте, датах, количестве взрослых и детей, а также имя, адрес электронной почты и номер телефона гостя, подтверждает их с гостем и создает новый лид в вашем аккаунте 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 key или Agency UID указаны неверно, интеграция отключится обратно, а в форме появится сообщение об ошибке, что исключает сохранение полурабочего подключения. В случае успеха ChatLab сохранит ваши объекты вместе с описаниями и фотографиями в свой кэш для быстрой выдачи ответов в дальнейшем.

Параметр Default content language определяет, на каком языке ChatLab будет считывать названия и описания объектов, если в Hostfully они представлены на нескольких языках. Доступны английский, польский, немецкий, испанский, французский и итальянский языки; по умолчанию выбран английский.

Шаг 2: Проверьте действия Hostfully

После подключения автоматически активируются четыре действия: получение объектов, проверка доступности, поиск свободных объектов и проверка статуса бронирования. Действие 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..."

На скриншоте выше показана группа до подключения интеграции: действия и опциональный поиск номеров через ИИ отображаются в списке, но имеют статус Not connected (Не подключено) и недоступны для чатбота. Функция поиска номеров через ИИ зависит от настроенной емкости комнат и автоматической индексации каталога; ее активация не гарантируется при каждом подключении. Когда включен поиск номеров через ИИ, он берет на себя подбор вариантов, а базовое действие get properties уступает ему место.

Для каждого действия можно настроить:

• Action Label - короткое сообщение, которое гость видит в чате во время выполнения действия.
• Instructions - описание задачи действия, на основе которого искусственный интеллект принимает решение о его вызове.
• 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 key, Agency UID, язык контента или Booking URL format и нажмите Update Chatbot (Обновить чатбота). ChatLab снова выполнит тестовый запрос и обновит кэш объектов.

Отключение - откройте карточку Hostfully и нажмите Disconnect (Отключить). Действия Hostfully перестанут быть доступны чатботу, а кэшированные данные об объектах будут удалены. Ваши настройки сохранятся в форме, поэтому для повторного подключения в будущем потребуется всего один клик.

Полезные советы

• Продолжайте обучать бота на материалах вашего сайта. Действия Hostfully отвечают за объекты, даты и цены; обо всем остальном, что может спросить гость (время заезда, парковка, правила проживания, размещение с животными), бот узнает из вашей базы знаний. См. Обучение чатбота: основы и ограничения.
• Добавьте правила бронирования (например, минимальный срок проживания или условия внесения залога) в поле пользовательских инструкций (User Instructions) соответствующего действия, чтобы чатбот сообщал о них сразу вместе с информацией о доступности, а не оставлял это на потом.
• Добавьте подсказки с частыми вопросами, например "Проверить доступность" или "Показать апартаменты", чтобы гости сразу видели возможности чатбота.
• Заявка на бронирование создается в Hostfully только после того, как чатбот получит имя, e-mail и номер телефона гостя, а гость подтвердит эти данные. Если у вас также настроена форма сбора контактов, согласуйте их между собой, чтобы гостю не приходилось вводить одну и ту же информацию дважды. См. раздел Сбор лидов.
• Каждый ответ бота, вызывающий действие Hostfully, расходует кредиты сообщений так же, как и любое другое сообщение чатбота. См. Что такое кредит сообщений.

Связанные статьи

• Интеграция с Beds24
• Интеграция с Hotres
• Интеграция с IdoBooking
• Интеграция с KWHotel
• Интеграция с Mews
• Обучение чатбота: основы и ограничения
• Что такое кредит сообщений

Каталог номеров и обзор отеля

Если в вашем аккаунте отображается вкладка Hotel, перейдите в Hotel > Rooms, чтобы проверить каталог номеров и статус обучения. Функция AI room search работает отдельно от проверки доступности по датам: она подбирает варианты по описанию объектов, тогда как действия доступности проверяют конкретный период проживания. Автоматическая индексация объектов зависит от автоиндексации каталога и выделенной емкости номеров; в остальных случаях используйте кнопку Train rooms (Обучить номера), когда она доступна. Проверьте включенные действия и дождитесь завершения процесса обучения, прежде чем полагаться на поиск номеров с помощью ИИ.