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

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

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

Подключите чат-бота ChatLab к системе бронирования Hotres, чтобы предоставлять информацию о доступности апартаментов в реальном времени и прямые ссылки на бронирование прямо в чате.

Примечание: интеграция с Hotres доступна по запросу. Если вы не видите вариант Hotres на вкладке Connect, обратитесь в службу поддержки для ее активации для вашей учетной записи.

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

Get Apartments - клиенты могут спрашивать о номерах и апартаментах вашего объекта. Чат-бот получает полный список из Hotres, включая:

  • Название и описание апартаментов/номеров
  • Изображение и прямую ссылку на страницу апартаментов

Check Apartment Availability - клиенты могут проверять доступность конкретных апартаментов на выбранные даты. Чат-бот возвращает:

  • Статус доступности и цены
  • Отметку о специальном предложении, если тариф отличается от основного прейскуранта
  • Альтернативные апартаменты с предложенными диапазонами дат, если запрошенный вариант недоступен или действуют требования к минимальному сроку проживания
  • Ссылку на бронирование с предварительно заполненными датами

Find Available Apartments - клиенты могут искать свободные апартаменты, указав диапазон дат и количество гостей. Чат-бот возвращает:

  • Все апартаменты, доступные на указанные даты, с ценами
  • Отметку о специальном предложении для тарифов со скидкой
  • Ссылки на бронирование для каждого доступного варианта
  • Если на точные даты свободных апартаментов нет - альтернативные варианты с предложенными диапазонами дат, соответствующими требованиям к минимальному сроку проживания

Предварительные требования

Перед началом подготовьте следующие данные из вашей учетной записи Hotres:

  1. API Key - ключ аутентификации API Hotres

  2. Object ID - идентификатор вашего объекта в Hotres

  3. Main Pricelist Name - точное название вашего основного прейскуранта в Hotres

  4. Booking URL Format - шаблон URL для страницы бронирования с использованием следующих плейсхолдеров:

    • {DATE_FROM} - дата заезда
    • {DATE_TO} - дата выезда
    • {TAG} - идентификатор апартаментов/номера

    Пример формата:

    https://yourdomain.com/booking?checkin={DATE_FROM}&checkout={DATE_TO}&apt={TAG}
    

Шаг 1: Подключение Hotres в ChatLab

  1. Войдите в ChatLab и выберите вашего бота
  2. Перейдите на вкладку Connect (Подключение)

Вкладка Connect с карточкой интеграции Hotres

  1. Нажмите кнопку Connect (Подключить) на карточке Hotres
  2. Заполните четыре обязательных поля: API Key, Object ID, Main Pricelist Name и Booking URL format

Форма интеграции Hotres с данными подключения

  1. Нажмите Connect (Подключить)

ChatLab автоматически проверит подключение, выполнив запрос к вашему объекту в Hotres. Если API Key или Object ID указаны неверно, появится сообщение об ошибке. При успешном подключении откроется окно подтверждения с предложением настроить действия ИИ.

Шаг 2: Настройка действий Hotres

После подключения включите и настройте отдельные действия ИИ. Перейдите в раздел Settings > Actions (Настройки > Действия) и отфильтруйте список по платформе Hotres.

Действия Hotres в разделе Settings со всеми тремя доступными действиями

Доступны три действия:

  • Hotres - get apartments - выводит список всех номеров и апартаментов вашего объекта
  • Hotres - check apartment availability - проверяет конкретные апартаменты на указанные даты
  • Hotres - find available apartments - ищет доступные апартаменты по диапазону дат и количеству гостей

Нажмите кнопку активации напротив каждого действия, чтобы включить его. Вы можете настроить следующие параметры:

  • Action Label (Метка действия) - сообщение, отображаемое пользователю во время выполнения действия (например, "Проверяем доступность...")
  • Instructions (Инструкции) - подсказки для ИИ о том, когда и как использовать действие
  • User Instructions (Пользовательские инструкции) - дополнительные бизнес-правила или предпочтения для работы ИИ

Тестирование интеграции

После активации действий откройте виджет чат-бота и попробуйте отправить запросы:

  • "Какие у вас есть апартаменты?" (проверяет Get Apartments)
  • "Свободны ли апартаменты 101 с 15 по 20 декабря?" (проверяет Check Apartment Availability)
  • "Что есть свободного с 15 по 20 декабря на 2 гостей?" (проверяет Find Available Apartments)

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

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

Обновление настроек - нажмите на карточку Hotres на вкладке Connect, измените нужные поля и нажмите Update Chatbot (Обновить чат-бота).

Отключение - нажмите на карточку Hotres, а затем выберите Disconnect (Отключить). Это отключит все действия Hotres для ИИ. Ваши настройки сохранятся, и интеграцию можно будет подключить повторно позже.

Советы

  • Обучите бота подробным описаниям объекта, удобствам и информации о расположении, чтобы ИИ мог предоставлять дополнительный контекст вместе с данными о доступности.
  • Добавьте подсказки к вопросам, такие как "Проверить доступность" или "Показать апартаменты", чтобы направить посетителей.
  • Если у вас есть правила бронирования (минимальный срок проживания, условия отмены), добавьте их в инструкции к действию, чтобы ИИ упоминал их автоматически.