Интеграция с МАКС (групповые чаты)

Интеграция с MAX — переписка из мессенджера в открытых линиях и чатах Битрикс24

Приложение переносит общение в мессенджере MAX внутрь Битрикс24. Обращения клиентов
попадают в открытую линию: встают в очередь, распределяются по операторам по правилам
самой линии и сохраняются в истории — вместо личных сообщений конкретному менеджеру.
Рабочую переписку с подрядчиком или партнёром можно вести иначе: чат Битрикс24
зеркалится с чатом MAX в обе стороны, и обсуждение идёт рядом с остальной работой
команды. Сотрудник отвечает из портала, собеседник видит ответ в привычном мессенджере.

Каналов два — открытая линия через коннектор контакт-центра и чат-бот в конкретном
чате портала. Они независимы: компания подключает только тот, который использует, или
оба сразу. На портале можно завести несколько ботов MAX, несколько линий и несколько
чат-ботов, а затем связать их между собой. Групповые чаты работают с обеих сторон:
в общей переписке имя автора подставляется в текст, поэтому видно, кто написал.
Вместе с текстом передаются вложения, а правка сообщения применяется к уже доставленной
копии, а не приходит вторым сообщением.

Каждая связка настраивается отдельно: можно оставить только одно направление передачи,
выключить вложения, временно отключить связку целиком или помечать сообщения из MAX
префиксом в чате Битрикс24. Администратор видит состояние подключения каждого бота
и текст ошибки, если события перестали приходить, а разобрать конкретную доставку
помогает журнал сообщений. Повторная доставка одного и того же сообщения отсекается,
поэтому дублей и зацикливания между каналами не возникает. Токен бота MAX хранится
в зашифрованном виде и не показывается в интерфейсе.

Для работы понадобится токен бота из личного кабинета MAX. Коннектор открытых
линий устанавливается вручную одной кнопкой и нужен только каналу открытых линий —
при работе через чат-бота он не требуется. Переписка, которая была до настройки,
не переносится: передаются новые сообщения.

FAQ

Нужен ли коннектор, если мы хотим использовать только чат-бота?
Нет. Коннектор нужен только каналу открытых линий. Для зеркалирования чата Битрикс24
с чатом MAX достаточно чат-бота.

Перенесётся ли переписка, которая уже была в MAX?
Нет. История до настройки связки не переносится, передаются только новые сообщения.

Можно ли обмениваться файлами?
Да, в обе стороны. Из MAX файлы приходят вложением к сообщению. Из Битрикс24 файлы
передаются ссылкой на скачивание: картинки показываются в чате MAX, остальные файлы
приходят ссылкой в тексте. Передачу вложений можно выключить на каждой связке.

Может ли бот первым написать пользователю MAX?
Нет, это ограничение самого мессенджера: диалог должен начать пользователь. Для
групповых чатов ограничения нет.

Что нужно для коробочного Битрикс24?
Обновления модулей «Мгновенные сообщения» до версии 26.250.0 и «Чат-боты Битрикс24»
до версии 26.50.0, а также публичный HTTPS-адрес портала.

Переносятся ли правки сообщений?
В канале чат-бота — да: изменение применяется к уже доставленной копии, причём можно
показывать только новую редакцию или новую вместе с исходной. В канале открытых линий
правки не переносятся.