Установка и настройка

Установите приложение из Маркетплейса Битрикс24 в нужных порталах: у партнера и у клиента.

Требования

• Для облачных порталов — достаточно установки из Маркетплейса.
• Для коробочного Битрикс24 — модуль «Мгновенные сообщения» не ниже 26.250.0, модуль «Чат-боты Битрикс24» не ниже 26.50.0.
• Необходим выделенный сервер для работы приложения (настраивается администратором).

Как открыть настройки

Откройте приложение на каждом из порталов:

• на портале партнера — «Партнерский раздел»;
• на портале клиента — «Клиентский раздел».

Права доступа

При установке приложение запрашивает доступ к модулям: imbot, imconnector, im, tasks, task. Убедитесь, что все права выданы — иначе часть функций не заработает. Проверить можно в карточке приложения в админке Битрикс24.

Сценарий 1: «Чат → Открытая линия»

Настройка на стороне партнера:

1. Откройте Контакт-центр → найдите «Межпортальные чаты 2.0» → настройки.
2. Подключите существующую Открытую линию или настройте новую.
3. Настройте очередь операторов для открытой линии (зона ответственности администратора портала).
4. Скопируйте автоматически созданный ключ подключения.

Настройка на стороне клиента:

5. В «Клиентском разделе» создайте и настройте бота.
6. Введите ключ открытой линии, полученный от партнера.
7. Создайте групповой чат и пригласите в него настроенного бота.
8. Укажите название группового чата в настройках приложения.

Проверка:

9. Отправьте тестовое сообщение в групповой чат на портале клиента.
10. Убедитесь, что сообщение появилось в открытой линии партнера.
11. Ответьте из открытой линии — ответ должен вернуться в клиентский чат.

Сценарий 2: «Чат ↔ Чат» (бот ↔ бот)

Настройка на стороне партнера:

1. В «Партнерском разделе» создайте бота.
2. Скопируйте автоматически созданный ключ партнерского бота.

Настройка на стороне клиента:

3. В «Клиентском разделе» создайте бота.
4. Введите ключ партнерского бота.

Настройка чатов на обеих сторонах:

5. Создайте групповые чаты на каждом портале (минимум два участника в каждом).
6. Пригласите соответствующего бота в каждый чат.

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

7. Вернитесь в настройки приложения и выберите связанные чаты для клиента и партнера.

Проверка:

8. Отправьте тестовое сообщение с каждой стороны — синхронизация должна работать в обе стороны.
9. Проверьте пересылку файлов в обоих направлениях.

Сценарий 3: «Коллаба как получатель»

1. В настройках связки ботов выберите тип получателя «collab».
2. Выберите конкретную коллабу на принимающей стороне.
3. Вручную добавьте бота в коллабу через интерфейс Битрикс24 — автоматическое добавление не поддерживается.
4. Проверьте прохождение сообщений.

Настройка перехостинга файлов

В карточке связки ботов доступны два флага:

• Сохранять файлы на стороне партнера
• Сохранять файлы на стороне клиента

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

Создание задач из чата

1. В настройках связки ботов на партнерском портале включите тумблер задач.
2. Выберите группу, в которой будут создаваться задачи.
3. Назначьте ответственного за задачи.

После настройки: откройте placement «создать задачу из чата», заполните форму (название, описание, срок) — задача будет создана на портале партнера.

Синхронизация задач (Task Sync)

Связка порталов:

1. В партнерском разделе нажмите «Создать приглашение» — сгенерируется ключ с ограниченным сроком действия.
2. Передайте ключ клиенту.
3. Клиент вводит ключ в своем интерфейсе — связка порталов активирована.

Сопоставление групп:

4. Партнер задает пары «группа партнера → группа клиента».
5. Для каждой пары включите флаги: «Синхронизировать задачи» и «Синхронизировать чат задачи».

Синхронизация запустится автоматически (интервал по умолчанию — 2 минуты). При конфликтах применяется правило «последнее изменение побеждает».

Диагностика

Если сообщение не дошло:

1. Откройте логи приложения (доступны администратору сервера).
2. Найдите трассировку сообщения по ID чата или бота.
3. Проверьте цепочку: входящий вебхук → маршрутизация → исходящий вызов → подтверждение доставки.
4. Убедитесь, что бот добавлен в целевой чат или коллабу.
5. Проверьте, что все права доступа активны в карточке приложения.

Изменение настроек или удаление

Настройки можно изменить в интерфейсе приложения в любой момент. Для удаления связи — отключите или удалите соответствующую конфигурацию в разделах «Клиентский» или «Партнерский».