Перейти к содержимому

MAX и Битрикс24: канал обращений и корпоративный бот

Кратко: В этой связке MAX — канал, через который клиент пишет компании первым, а Битрикс24 принимает обращение и хранит переписку.

  • Задача: принимать обращения из MAX в том же рабочем окне, что и остальные каналы, и не терять историю переписки.
  • Что проверено: создание корпоративного чат-бота в MAX, подключение канала через контакт-центр Битрикс24, сохранение переписки и имени клиента в CRM, отключение канала, форматы ответов API.
  • Уровень: documented — официальная справка Битрикс24 и документация MAX Bot API.
  • Что не проверено: поведение конкретных роботов и правил распределения на вашем портале.

Интеграция нужна, когда клиенты уже пишут в MAX, а компания ведёт продажи и поддержку в Битрикс24: без канала сообщения остаются в мессенджере, а история не попадает в CRM и не видна руководителю.

Обратные случаи:

  • Клиенты пишут в Telegram или ВКонтакте — для них есть отдельные каналы и страницы: Битрикс24 и Telegram, Битрикс24 и ВКонтакте.
  • Нужен только чат на сайте — используется виджет открытой линии Битрикс24, а не бот в MAX.
  • Нужны массовые рекламные рассылки — это отдельный сценарий с правилами платформы MAX, а не обработка входящих обращений.

Клиент пишет боту → диалог в открытой линии

Заголовок раздела «Клиент пишет боту → диалог в открытой линии»
  • Событие: клиент отправляет сообщение корпоративному чат-боту MAX.
  • Направление: MAX → Битрикс24.
  • Сущности: сообщение, диалог, клиент, открытая линия, оператор.
  • Результат: в Битрикс24 появляется диалог в открытой линии, обращение распределяется на оператора по настройкам линии, переписка и имя клиента сохраняются в CRM.

Новое обращение → карточка клиента и заявка

Заголовок раздела «Новое обращение → карточка клиента и заявка»
  • Событие: сообщение приходит от клиента, которого ещё нет в CRM.
  • Направление: MAX → Битрикс24.
  • Сущности: контакт, лид или сделка, источник «MAX», ответственный.
  • Результат: оператор видит новое обращение и заводит заявку по правилам портала; источник фиксируется, чтобы маркетинг отличал MAX от других каналов.
  • Событие: оператор отвечает в диалоге Битрикс24.
  • Направление: Битрикс24 → MAX.
  • Сущности: сообщение, диалог, chat_id, токен бота.
  • Результат: клиент получает ответ в MAX, а в CRM остаётся полная история переписки.
  • Событие: сделка перешла на стадию, заказ оплачен или задача просрочена.
  • Направление: Битрикс24 → MAX.
  • Сущности: сообщение, получатель, user_id, событие CRM.
  • Результат: клиент или сотрудник получает уведомление в MAX; это уже собственная интеграция на MAX Bot API, а не штатный канал.
Событие в MAX Действие в Битрикс24 Примечание
Новое сообщение клиента боту Диалог в открытой линии Начать общение может только клиент
Сообщение от неизвестного клиента Создание контакта или заявки Правила задаются настройками линии и роботами
Повторное сообщение в том же чате Продолжение существующего диалога История хранится в CRM
Отключение канала Новые сообщения не поступают Диалоги, контакты и сделки остаются
Событие в Битрикс24 Действие в MAX Примечание
Ответ оператора в диалоге Сообщение клиенту через бота Нужен действующий токен канала
Смена стадии сделки Уведомление через собственный бот Только при интеграции на Bot API
Закрытие диалога Завершение переписки Клиент может начать новый диалог
  • Штатный канал MAX в Битрикс24 — администратор создаёт корпоративного бота в MAX для бизнеса, копирует токен и подключает канал к открытой линии. Кода нет; набор возможностей ограничен тем, что даёт контакт-центр.
  • Приложение из Маркетплейса — расширяет сценарии, но добавляет вендора, подписку и собственные ограничения; перед выбором проверяются права, тариф и поддержка.
  • iPaaS (Make, n8n, Albato) — связывает события MAX и CRM без серверного кода; подходит для уведомлений, но логика и секреты живут вне вашего репозитория.
  • Custom-интеграция на MAX Bot API — свой сервис принимает webhook или long polling, ведёт журнал и вызывает методы Битрикс24. Даёт контроль над идемпотентностью и повторами; требует сопровождения.

Критерий простой: если нужна только переписка в CRM — хватает штатного канала; если нужны собственные правила, несколько порталов и гарантированная доставка — нужна отдельная интеграция на API.

Данные в MAX Куда попадают в Битрикс24 Ключ соответствия Примечание
user_id Контакт или профиль клиента Внешний идентификатор Хранится, чтобы узнавать клиента
chat_id Диалог открытой линии Идентификатор чата Без него не отправить ответ
Имя клиента Имя контакта — MAX передаёт имя вместе с обращением
Текст сообщения Сообщение диалога Время и автор Вложения передаются отдельно
Канал «MAX» Источник обращения — Нужен для отчётов по каналам

Владелец данных: MAX владеет идентичностью клиента в мессенджере и доставкой сообщений; Битрикс24 — карточкой клиента, сделкой и историей работы оператора. Дублировать воронку в MAX не нужно.

  • Зарегистрировать компанию в MAX для бизнеса и пройти верификацию.
  • Создать корпоративного чат-бота, заполнить карточку и получить токен.
  • Создать открытую линию и настроить очередь операторов.
  • Подключить канал MAX в разделе CRM → Клиенты → Контакт-центр и вставить токен.
  • Зафиксировать, какие роботы создают лид или сделку и как заполняется источник.
  • Прогнать на staging: первое сообщение, повторное обращение, ответ оператора, отключение канала.
  • Верификация. Корпоративный бот доступен только российским юридическим лицам, а решение о верификации принимает MAX: это внешний срок, который нельзя обойти настройкой портала.
  • Инициатива клиента. В штатном канале диалог начинает клиент; если нужна исходящая рассылка, она проектируется отдельно и подчиняется правилам платформы.
  • Токен и доступ. Токен равен доступу к боту: он хранится в защищённой конфигурации, при утечке отзывается и выпускается заново.
  • Лимиты API. Ответ 429 означает превышение частоты: массовые уведомления идут порциями, с задержкой и повторной попыткой.
  • Ошибки в теле. Часть методов MAX возвращает HTTP 200 с success: false; интеграция обязана разбирать тело ответа, иначе сбой выглядит как успех.
  • Сверка. Раз в сутки полезно сверять число новых диалогов в MAX и обращений в CRM: расхождение означает потерянные события.

Нужно ли писать код? Для переписки в CRM — нет: достаточно корпоративного бота и канала в контакт-центре. Код нужен для собственных уведомлений и нестандартной маршрутизации.

Можно ли подключить MAX к нескольким порталам? Канал подключается к конкретному порталу и открытой линии; для нескольких порталов проектируется собственная интеграция с отдельными ботами и токенами.

Что произойдёт при отключении канала? Новые сообщения перестанут поступать, но диалоги, контакты и сделки останутся в Битрикс24.

Как проверить, что интеграция не врёт? Отправить сообщение боту с нового аккаунта, ответить из Битрикс24 и сверить имя, текст и время в карточке клиента.