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

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

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

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

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

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

---

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

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

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

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

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

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

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

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

Выберите план подписки, соответствующий вашим потребностям. Для работы функций интеграции с бронированием IdoBooking (поиск апартаментов, проверка доступности, бронирование) требуется план STANDARD или PREMIUM.

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

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

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

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

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

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

---

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

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

Часть 1: Создание пользователя API в IdoBooking

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

Шаг 1: Переход к управлению пользователями

1. Войдите в панель управления IdoBooking
2. Перейдите в раздел Settings > Users (Настройки > Пользователи)
3. Нажмите Add new user (Добавить нового пользователя)

Шаг 2: Создание учетной записи пользователя

1. Введите login name (имя пользователя) для нового пользователя (например, "chatlab-api")
2. Заполните остальные обязательные поля
3. Задайте надежный password (пароль) для этой учетной записи

Шаг 3: Настройка доступа к API

Задайте следующие параметры доступа для нового пользователя:

1. Enable (Включите) "Active API access" - это необходимо для работы интеграции
2. Disable (Отключите) "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. Мы рекомендуем выбрать Select all (Выбрать все), чтобы предоставить доступ ко всем объектам

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

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

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

Шаг 6: Сохранение и сбор данных для подключения

1. Нажмите Save (Сохранить), чтобы создать учетную запись пользователя
2. Запишите следующую информацию - она понадобится вам для настройки ChatLab:

• Login - созданное вами имя пользователя (например, chatlab-api)
• Password - заданный пароль
• Subdomain - ваш поддомен IdoBooking (например, client3760)

Как найти свой поддомен: посмотрите на URL вашей панели IdoBooking. Например, если ваш URL - 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", если вам потребуется отключить интеграцию позже.

---

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

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

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

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

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

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

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

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

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

---

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

Советы по безопасности (ручная настройка)

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

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

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

---

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

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

---