Вернуться к приложениям 
Интеграция с MAX: переписка с клиентами и подрядчиками в одном портале Битрикс24
Обращения из мессенджера MAX приходят в открытую линию, а рабочие чаты портала зеркалятся с чатами MAX в обе стороны. Сотрудник отвечает из Битрикс24, собеседник видит ответ в привычном мессенджере.
Установить из Маркета Битрикс24
Проблема
Переписка с клиентом или подрядчиком в MAX живёт отдельно от системы, в которой работает компания.
- Обращение приходит в личные сообщения конкретному сотруднику, а не в общую очередь.
- Диалог не попадает в CRM: руководитель не видит, что происходит в переписке.
- Сотрудник держит два окна и переносит информацию вручную.
- Сотрудник ушёл в отпуск или уволился — переписка ушла вместе с ним.
Приложение переносит эту переписку внутрь Битрикс24. Это не ещё один мессенджер в портале, а способ вести внешнее общение там же, где идёт остальная работа.
Как это работает: два канала под две задачи
Приложение соединяет MAX и Битрикс24 двумя независимыми каналами. Подключается только тот, который нужен, или оба сразу. На портале может быть несколько ботов MAX, линий и чат-ботов, связанных между собой.
Канал 1. Мессенджер MAX в открытых линиях
Для потока клиентских обращений.
Клиент пишет боту в MAX. Сообщение попадает в открытую линию Битрикс24 как обращение. Дальше работают правила самой линии: очередь, распределение по операторам, история. Оператор отвечает из портала, ответ приходит клиенту в MAX.
Один бот MAX может отдавать в линию все свои чаты: каждый станет отдельным обращением. Либо в линию направляется только конкретный чат.
Канал 2. Чат-бот MAX для Битрикс24: рабочая переписка внутри портала
Для постоянного общения с внешними участниками.
Чат-бот находится в конкретном чате Битрикс24 и зеркалит его с конкретным чатом MAX в обе стороны. Обсуждение с подрядчиком, заказчиком или партнёром идёт внутри портала, рядом с задачами и остальной работой команды.
Что умеет приложение
Групповые чаты с обеих сторон. Работают и групповые чаты MAX, и групповые чаты Битрикс24. В общей переписке имя автора подставляется в текст, поэтому всегда видно, кто написал. В открытой линии групповой чат MAX выступает одним собеседником: обращение создаётся на чат целиком, а не на каждого участника.
Файлы в обе стороны. Из MAX файлы приходят вложением к сообщению. Из Битрикс24 файлы передаются ссылкой на скачивание: картинки показываются в чате MAX, остальные файлы приходят ссылкой в тексте. Передачу вложений можно выключить на каждой связке.
Правки сообщений. Если сообщение отредактировали, изменение применяется к уже доставленной копии, а не приходит вторым сообщением. Можно показывать только новую редакцию или новую вместе с исходной. Правки переносятся только в канале чат-бота; в канале открытых линий они не передаются.
Форматирование и длинные сообщения. Разметка переносится между Битрикс24 и MAX. Длинные сообщения разбиваются на части, подпись автора повторяется в каждой.
Настройка каждой связки. Отдельно включаются направления передачи (можно оставить одно), вложения, перенос правок, подпись именем автора и пометка сообщений из MAX префиксом [MAX]. Связку можно временно выключить, не удаляя настройки.
Контроль для администратора. Видно состояние подключения каждого бота: «вебхук подключён», «ошибка» с текстом ошибки или «не проверялся». Разобрать конкретную доставку помогает журнал сообщений. Повторная доставка одного и того же сообщения отсекается, поэтому дублей и зацикливания между каналами не возникает.
Шифрование токена. Токен бота MAX хранится в зашифрованном виде и не показывается в интерфейсе.
Кому подходит
Поддержка, продажи, сервис. Есть поток входящих обращений, нужны очередь, распределение по операторам и история в CRM. Переписка с клиентами из MAX попадает в общую очередь открытых линий вместо личных сообщений конкретному менеджеру.
Команды с внешними участниками. Постоянная переписка с подрядчиками, партнёрами, заказчиками или филиалами, которую нужно держать внутри портала, а не в личном телефоне сотрудника.
Границы применения
- История переписки до настройки связки не переносится: передаются только новые сообщения.
- Бот MAX не может написать пользователю первым: в личном диалоге первое сообщение отправляет пользователь. Для групповых чатов такого ограничения нет.
- Один чат MAX обслуживается одной связкой.
- Правки сообщений переносятся только в канале чат-бота.
- Не передаются реакции, ответы на конкретное сообщение, удаление сообщений и статусы прочтения. Звонки, стикеры и опросы MAX не поддерживаются.
Установка и настройка
Для работы нужны права администратора Битрикс24, токен бота MAX из личного кабинета MAX и публичный HTTPS-адрес портала с доверенным сертификатом: MAX принимает события только так. Для коробочного Битрикс24 понадобятся обновления модулей «Мгновенные сообщения» 26.250.0 и «Чат-боты Битрикс24» 26.50.0.
Настройка занимает три шага:
- Установите приложение из Маркета Битрикс24 и добавьте бота MAX: укажите имя и вставьте токен. В списке должно появиться состояние «вебхук подключён».
- Подключите нужный канал. Для открытых линий: зарегистрируйте коннектор одной кнопкой, подключите линию и добавьте связку «бот MAX → линия». Для чат-бота: создайте бота, добавьте его в чат портала и добавьте связку с чатом MAX.
- Напишите тестовое сообщение с одной стороны и убедитесь, что оно пришло с другой.
Подробная инструкция — на вкладке «Установка».
Частые вопросы
Нужен ли коннектор, если мы используем только чат-бота? Нет. Коннектор нужен только каналу открытых линий и ставится вручную одной кнопкой. Для зеркалирования чата Битрикс24 с чатом MAX достаточно чат-бота.
Перенесётся ли переписка, которая уже была в MAX? Нет. История до настройки связки не переносится, передаются только новые сообщения.
Ходят ли файлы между Битрикс24 и MAX? Да, в обе стороны. Из MAX файлы приходят вложением к сообщению. Из Битрикс24 файлы передаются ссылкой на скачивание: картинки показываются в чате MAX, остальные файлы приходят ссылкой в тексте. Передачу вложений можно выключить на каждой связке.
Переносятся ли правки сообщений? В канале чат-бота — да: изменение применяется к уже доставленной копии, можно показывать только новую редакцию или новую вместе с исходной. В канале открытых линий правки не переносятся.
Может ли бот первым написать пользователю MAX? Нет, это ограничение самого мессенджера: в личном диалоге первым должен написать пользователь. Для групповых чатов такого ограничения нет.
Сколько ботов, линий и чатов можно подключить? Ограничения по количеству нет: на портале можно завести несколько ботов MAX, несколько открытых линий и несколько чат-ботов и связать их между собой. Один чат MAX при этом обслуживается одной связкой.
Передаются ли реакции и ответы на конкретное сообщение? Нет. Передаются текст, вложения и правки сообщений.
Попробуйте на своём портале
Установите приложение из Маркета Битрикс24, добавьте бота MAX и подключите нужный канал. Настройку администратор выполняет один раз.