Установка: Межпортальные чаты и задачи 2.0

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

Установите приложение из Маркетплейса Битрикс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. Проверьте прохождение сообщений.

Подключение мессенджера MAX

Создание бота в MAX:

1. Напишите @MasterBot в мессенджере MAX и создайте бота — в ответ он выдаст токен.
2. Скопируйте токен. В приложении он сохраняется в зашифрованном виде и больше не показывается — остается только отпечаток.

Добавление бота в приложение:

3. В «Партнерском разделе» найдите блок «Боты мессенджера MAX» и нажмите «Добавить бота MAX».
4. Укажите имя бота — оно используется только в интерфейсе приложения и на имя в MAX не влияет.
5. Вставьте токен и сохраните. В карточке появятся состояние подписки «вебхук подключён», ID бота в MAX и отпечаток токена.
6. Кнопка «Проверить» опрашивает MAX заново, «Переподписать» — регистрирует адрес вебхука повторно. Пригодятся, если состояние подписки не «подключена».

Добавление бота в чат MAX:

7. Пригласите бота в групповой чат MAX.
8. Выдайте боту права администратора этой группы. Без прав администратора MAX не присылает боту сообщения участников, и переписка в Битрикс24 не пойдет.
9. Напишите в чат любое сообщение — после этого чат попадет в список, доступный приложению.

Связывание чата MAX со связкой ботов:

10. Откройте настройки связки ботов и включите «Передавать сообщения в MAX».
11. Выберите бота MAX и тип получателя: «Чат» — групповой чат MAX, «Контакт» — личный диалог с пользователем.
12. Нажмите «Обновить» и выберите чат из списка. Если нужного чата в списке нет — введите его ID вручную и нажмите «Применить».
13. В блоке «Передавать в MAX» отметьте, из каких чатов Битрикс24 сообщения дублируются в MAX: из чата партнера, из чата клиента или из обоих.
14. В блоке «Сообщения из MAX отправлять» выберите получателя: «Клиенту», «Партнёру», «В обе стороны» или «Никуда».
15. При необходимости включите пометки источника — префикс [MAX] в Битрикс24 и указание стороны в MAX.

Проверка:

16. Напишите в чат MAX — сообщение должно появиться в выбранных чатах Битрикс24.
17. Напишите в чат Битрикс24 — сообщение должно уйти в MAX.

Учтите при настройке:

• Если оба портала пишут в MAX и входящее из MAX уходит в оба портала, сообщения задвоятся. Приложение предупреждает об этой комбинации при сохранении.
• Для типа получателя «Контакт» первым должен написать пользователь: бот MAX не может начать личный диалог сам.
• Если сообщения из MAX не приходят, проверьте права администратора у бота в группе MAX и состояние подписки в карточке бота.

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

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

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

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

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

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

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

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

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

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

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

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

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

Диагностика

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

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

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

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