Центр помощи
Интеграции чат-бота

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

Последнее обновление:

Beds24 - это облачная система управления недвижимостью (PMS), менеджер каналов и модуль бронирования, используемый отелями, гостевыми домами и объектами посуточной аренды. Подключение ее к ChatLab позволяет вашему чат-боту отвечать на вопросы о номерах, датах и ценах на основе актуальных данных из Beds24, а не из статического текста, который приходится постоянно обновлять.

Примечание: Beds24 - это премиум-интеграция, входящая в пакет интеграций для отелей и туризма. Если ваш тарифный план не включает их, при нажатии на карточку Beds24 вместо формы подключения появится короткое уведомление со ссылкой для связи с нами.

Что дает интеграция

После подключения чат-бот получает три действия ИИ.

Beds24 - get properties - выводит список всех номеров и категорий номеров в вашем объекте. Для каждого из них чат-бот может показать название номера, описание, фотографию, максимальное количество взрослых и детей, а также начальную цену.

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

Beds24 - check room availability - посетитель спрашивает о конкретном номере. Чат-бот находит номер по его идентификатору в 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} - идентификатор номера в 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 - стандартная подпись действия "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 июня на двоих взрослых?" - вызывает Beds24 - find available rooms
  • "Свободен ли номер Deluxe Suite в следующие выходные?" - вызывает Beds24 - check room availability

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

Управление интеграцией

Обновление настроек - откройте карточку Beds24 на вкладке Connect, измените Property ID или Booking URL format и сохраните изменения. Для этого не требуется новый код приглашения.

Отключение - откройте карточку Beds24 и отключите интеграцию. Три действия Beds24 перестанут быть доступны чат-боту. Чтобы подключить интеграцию повторно позже, сгенерируйте новый invite code в Beds24, так как исходный уже был использован.

Советы

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

Похожие статьи