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 от других каналов.
Ответ оператора → сообщение клиенту в MAX
Заголовок раздела «Ответ оператора → сообщение клиенту в MAX»- Событие: оператор отвечает в диалоге Битрикс24.
- Направление: Битрикс24 → MAX.
- Сущности: сообщение, диалог,
chat_id, токен бота. - Результат: клиент получает ответ в MAX, а в CRM остаётся полная история переписки.
Событие в CRM → уведомление через свой бот
Заголовок раздела «Событие в 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 и сверить имя, текст и время в карточке клиента.