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

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

Пример диалога

Этот пример демонстрирует опыт взаимодействия с клиентом. Доступные действия и возвращаемая информация зависят от этой интеграции и ваших настроек.

Перед началом работы

Сначала создайте или выберите чат-бота. Вам потребуются права на управление его интеграциями и доступ к настройкам подключения во внешней учетной записи. Если на карточке Connect (Подключить) отображается предложение сменить тариф или связаться с поддержкой, проверьте, входит ли эта интеграция в вашу подписку. Храните учетные данные API в секрете; никогда не вставляйте их в код виджета для сайта.

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

При включенной интеграции с IdoBooking ваш чат-бот может:

• Показывать список доступных апартаментов и вариантов размещения с описаниями и фотографиями
• Проверять доступность на определенные даты
• Находить свободные апартаменты на указанный диапазон дат с ценами
• Искать существующие бронирования по идентификатору, статусу или диапазону дат
• Создавать новые бронирования с данными гостей

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

---

Вариант А: Настройка через IdoBooking Marketplace (рекомендуется)

Самый быстрый способ связать ChatLab с IdoBooking - через IdoBooking Marketplace. При этом учетные данные API передаются автоматически, а действия чат-бота на чтение включаются сразу.

Шаг 1: Установите ChatLab из IdoBooking Marketplace

1. Войдите в панель управления IdoBooking
2. Перейдите в раздел Marketplace (Маркетплейс)
3. Найдите ChatLab и нажмите Install (Установить)

IdoBooking автоматически передаст учетные данные API в ChatLab - создавать отдельного пользователя API или копировать данные вручную не требуется.

Шаг 2: Создайте аккаунт ChatLab или войдите в него

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

Шаг 3: Выберите тарифный план

Выберите подходящий тарифный план. Возможности интеграции с IdoBooking (поиск апартаментов, проверка доступности, бронирование) требуют наличия соответствующей функции интеграции. Если ваш тариф ее не включает, воспользуйтесь предложением повысить план или свяжитесь с поддержкой.

Шаг 4: Выберите чат-бота

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

Шаг 5: Завершите настройку

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

• Подключит ваши учетные данные IdoBooking к выбранному чат-боту
• Включит поиск апартаментов, проверку доступности и просмотр бронирований. Создание бронирований автоматически не включается.
• Перенаправит вас обратно в IdoBooking или в панель управления ChatLab

После завершения работы мастера ваш чат-бот готов обрабатывать запросы на бронирование. Вы можете детально настроить отдельные действия ИИ в Settings > Actions (Настройки > Действия).

---

Вариант Б: Ручная настройка

Если вы предпочитаете настроить интеграцию вручную, выполните следующие действия.

Часть 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" (Активный доступ к API) - это необходимо для работы интеграции
2. Отключите "Active panel access" (Активный доступ к панели) - пользователю не нужен доступ к панели управления

Шаг 4: Задайте роль и права пользователя

Настроить роль пользователя можно двумя способами:

Вариант А: Роль администратора (проще)

• Выберите роль Administrator (Администратор)
• Это дает широкие права API, даже если доступ к панели отключен. Используйте настраиваемую роль, если интеграции требуются только определенные операции чтения.

Вариант Б: Настраиваемая роль пользователя (более детальная)

Если вам нужен более точный контроль, выберите Custom user (Настраиваемый пользователь) и настройте следующие права доступа к модулям:

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

Для настраиваемых пользователей также необходимо указать права на локации:

1. Прокрутите страницу до раздела Location and accommodation permissions (Права на локации и объекты размещения)
2. Выберите объекты, с которыми должен работать этот чат-бот; предоставляйте доступ ко всем объектам только в том случае, если это действительно необходимо.

Шаг 5: Отключите ненужные уведомления

Чтобы пользователь API не получал операционные оповещения, отключите следующие параметры:

• Notifications for property staff (Уведомления для персонала объекта) - отключить
• Automatic email notifications (Автоматические email-уведомления) - отключить

Шаг 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" (Отключить), если позже вам потребуется отключить интеграцию.

---

Настройка действий ИИ

После подключения интеграции с IdoBooking (любым из способов) вы можете выбрать, какие действия ИИ сможет выполнять ваш чат-бот. Проверьте список активных действий после завершения настройки. Создание бронирований автоматически не включается.

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

• Get Apartments - показывает доступные апартаменты и варианты размещения с описаниями, конфигурацией спальных мест и фотографиями
• Find Available Apartments - ищет доступные апартаменты на указанный диапазон дат с информацией о ценах
• Check Apartment Availability - проверяет доступность конкретных апартаментов на выбранные даты
• Get Reservations - находит существующие бронирования по идентификатору, статусу или диапазону дат
• Create Reservation - создает новые бронирования с данными гостей и деталями заказа
• AI room search - подбирает номера по описанию пожеланий гостя, а не путем проверки дат

Функция AI room search и действие Get Apartments исключают друг друга. При включении AI room search заменяет собой стандартный инструмент выдачи списка, и действие Get Apartments отключается у бота, благодаря чему активен только один инструмент вывода комнат. На действия с проверкой дат это не влияет.

Включение и настройка действий

1. После подключения нажмите Configure AI Actions (Настроить действия ИИ) в модальном окне успеха или перейдите в Settings > Actions (Настройки > Действия) и найдите категорию IdoBooking
2. Включите нужные действия
3. При необходимости настройте название действия (текст, который видят пользователи во время его выполнения) и инструкции
4. В диалоговом окне действия нажмите Enable (Включить) для нового действия или Update (Обновить) для существующего.

Настройка действия "Find available apartments"

Действие Find available apartments имеет два дополнительных параметра, определяющих, сколько апартаментов чат-бот покажет при запросе о наличии мест и по какому принципу они будут отобраны. Откройте действие в 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 (Случайный выбор) - выбирает апартаменты случайным образом из отфильтрованных результатов. Полезно, если вы хотите разнообразить выдачу в диалогах и не предлагать все время одни и те же варианты.

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

---

Проверка готовой настройки

Откройте Overview (Обзор) и начните новый тестовый диалог. Запросите номера на определенные будущие даты для указанного числа гостей, затем перейдите по полученной ссылке на бронирование и сверьте даты, валюту и цену с данными в IdoBooking. Проверьте поиск бронирований на том заказе, данные которого вам разрешено просматривать. Включайте и тестируйте действие Create Reservation только тогда, когда вы действительно намерены создать реальное бронирование; тест в чате может внести запись в вашу систему бронирования.

Рекомендации

Рекомендации по безопасности (ручная настройка)

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

Оптимизация ответов чат-бота

• Обучите бота информации об объекте - добавьте в базу знаний описания вашего жилья, включая удобства, особенности номеров и сведения о расположении
• Настройте понятные сценарии диалога - задайте приветственные сообщения, которые побуждают пользователей узнавать о наличии мест, и используйте подсказки с вопросами вроде "Проверить свободные даты" или "Посмотреть номера"

---

Устранение неполадок

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

---

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

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

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

• Добавление чат-бота на сайт
• Обучение чат-бота: основы и ограничения
• Отправка ссылки на чат-бота