Интеграция MAX и Битрикс24 обеспечивает двусторонний обмен сообщениями между мессенджером и CRM. Когда клиент пишет компании в MAX, сообщение передается в подключенный канал Битрикс24 и отображается в «Открытых линиях». Оператор отвечает из интерфейса портала — ответ возвращается пользователю в MAX.
С 1 сентября мессенджер MAX включен в перечень ПО для предустановки на мобильные устройства, а в октябре заработала «Платформа партнеров» — чат-боты, каналы и мини-приложения, через которые пользователи взаимодействуют с компаниями.
Условия подключения компании к платформе MAX
Партнерская платформа MAX доступна юридическим лицам и индивидуальным предпринимателям, прошедшим проверку. Для активации требуется подтвержденный ИНН и выполнение одного из критериев доступа: компания должна иметь опубликованное приложение в RuStore или подтвержденный профиль на МСП.РФ. Поддержка физлиц и самозанятых пока отсутствует.
Сторонние и кастомные решения для интеграции MAX
Помимо штатного коннектора MAX, в маркетплейсе Битрикс24 есть сторонние решения, также позволяющие подключить мессенджер. Они закрывают типовые сценарии обмена сообщениями и могут быть удобны, если в компании уже используется инфраструктура конкретного провайдера.
Однако и встроенный, и сторонние коннекторы работают в рамках стандартной логики «Открытых линий». Если бизнес-процесс требует нестандартной маршрутизации, специфических условий обработки обращений или интеграции с внутренними системами, эти сценарии могут оказаться недоступны. В таких случаях используется кастомная интеграция через API MAX и REST API Битрикс24.
Собственная интеграция позволяет:
-
строить расширенную бизнес-логику обработки обращений, недоступную в типовых настройках «Открытых линий»;
-
изменять структуру сообщений и вложений перед отправкой в Битрикс24 или обратно в MAX;
-
использовать те события и данные MAX, которые встроенный коннектор не умеет обрабатывать;
-
подключать мессенджер к нескольким порталам одновременно или распределять обращения по собственным правилам;
-
связывать переписку с внутренними сервисами компании — внутренними CRM-модулями, ERP, DWH, антифрод-системами;
-
формировать собственную аналитику и отчеты, когда существующих в Битрикс24 недостаточно.
Если стандартный коннектор полностью закрывает потребности — можно использовать его. Если нужны расширенные сценарии — кастомная интеграция.
Экосистема MAX развивается, поэтому доля готовых решений в Маркете будет увеличиваться, но собственная интеграция пока остается единственным способом реализовать все возможные требования без ограничений.
Настройка интеграции MAX и Битрикс24
В Битрикс24 интеграция MAX подключается через стандартный коннектор в «Контакт-центре». Этот вариант можно считать основным, так как он не требует разработки и следует типовой логике «Открытых линий».
Подготовка аккаунта MAX
Чтобы подключить мессенджер, компании нужно:
-
зарегистрировать организацию на business.max.ru;
-
пройти проверку (ИНН и один из критериев: RuStore или МСП.РФ);
-
создать чат-бота, указать имя, описание и дождаться прохождения модерации;
-
получить токен бота — он потребуется при подключении канала в Битрикс24.
Дополнительных API-настроек на стороне MAX для встроенного коннектора не требуется.
Подключение канала в Битрикс24
Дальнейшие действия выполняются на портале:
-
открыть Контакт-центр → MAX;
-
нажать «Подключить» и вставить токен бота;
-
выбрать существующую Открытую линию или создать новую;
-
при необходимости настроить параметры линии — очередь операторов, расписание, автоответы и другие правила обработки обращений.
После подключения все входящие сообщения из MAX автоматически передаются в выбранную линию, а ответы оператора возвращаются в тот же диалог в мессенджере.
Проверка
Для контроля корректности:
-
отправляют тестовое обращение в MAX → диалог должен появиться в Открытой линии;
-
проверяют создание CRM-элементов (лид/контакт/сделка);
-
отправляют ответ из портала → он должен вернуться в мессенджер;
-
тестируют вложения, длинные сообщения и переключение операторов.
Если компанию не устраивает стандартный коннектор
Когда бизнесу требуется логика, которую нельзя настроить во встроенной интеграции, используется собственная — через API MAX и API Битрикс24. Для нее нужен HTTPS-сервер или облачное приложение, подключенный бот MAX с доступом к его API, а на стороне Битрикс24 — входящий вебхук или приложение.
Упрощенный порядок действий:
-
запустить HTTPS-сервис, который будет принимать запросы от MAX;
-
настроить бота на платформе MAX и получить токен для доступа к API;
-
включить передачу событий MAX (webhook или long polling) на адрес этого сервиса;
-
в Битрикс24 создать входящий вебхук или приложение с нужными правами для CRM и «Открытых линий»;
-
в сервисе реализовать обработку событий MAX и вызовы REST API Битрикс24 для создания диалогов и сообщений, а также обратную отправку ответов операторов в MAX.
При разработке собственного решения важно учитывать технические требования MAX и Битрикс24. MAX отправляет события только по HTTPS и требует корректный SSL-сертификат, при недоступности сервера события переотправляются, поэтому обработчик должен быть идемпотентным, иначе появляются дубли сообщений. Сервис должен уметь обрабатывать весь набор событий MAX — текст, вложения, изменение чата, статусы.
Битрикс24 ограничивает частоту REST-запросов: при превышении лимитов портал временно отклоняет вызовы или задерживает обработку, что влияет на доставку сообщений в «Открытые линии». Могут возникнуть ситуации, когда входящее событие не успевает связаться с CRM-элементом — в интеграции требуется реализовывать проверку результата, повторные попытки и обработку ошибок.
Кастомная схема оправдана, когда требуется нестандартное поведение — например, особые правила создания CRM-объектов, собственная маршрутизация, интеграция с внешними системами или расширенная аналитика. Во всех остальных случаях задачи закрывает стандартный коннектор.
Правовые и организационные моменты
Помимо настройки API и коннектора в Битрикс24, компании стоит учитывать юридические требования и организационные ограничения, связанные с использованием мессенджера MAX.
Юридический статус компании — доступ к платформе
Функции платформы MAX для бизнеса доступны только организациям и ИП, прошедшим верификацию по ИНН и удовлетворяющим одному из условий доступа — опубликованному приложению в RuStore или подтвержденному профилю на МСП.РФ. Перед началом интеграции компании важно проверить, что она соответствует этим требованиям и сможет создавать ботов и подключать каналы от своего имени.
Персональные данные и 152-ФЗ
В переписке с клиентами почти всегда появляются персональные данные: имя, телефон, e-mail, детали заказов. Такая информация подпадает под требования 152-ФЗ: у компании должно быть законное основание для обработки (договор, согласие, оферта), актуальная политика конфиденциальности и базовый набор мер по защите данных. Битрикс24 и MAX выступают как сервисы, но ответственность за то, что и как передается через канал, несет сама компания.
Логи и аудит при кастомной интеграции
Если помимо штатного коннектора используется собственный сервис с webhook-уведомлениями, желательно сохранять журналы запросов и ответов. Логи помогают разбирать спорные ситуации с клиентами, искать ошибки и при необходимости показывать, что именно передавалось и возвращалось в каждую сторону.
Правила платформы MAX и модерация ботов
Боты и мини-приложения в MAX проходят модерацию и должны соответствовать правилам платформы: требованиям к содержанию, функциональности и обработке данных. Если бот нарушает эти правила, его могут ограничить или отключить, и тогда канал в Битрикс24 перестанет получать сообщения. Это важно учитывать, если через MAX проходят критичные для бизнеса коммуникации.
Что предлагает Integrator.Digital
Грамотная настройка интеграции MAX и Битрикс24 зависит от того, как устроены процессы внутри компании: какие обращения приходят, какие CRM-элементы нужно создавать, сколько линий задействовано и как распределяются запросы между отделами. Готовые коннекторы решают только базовые задачи, а все, что выходит за стандартную логику, требует индивидуальной настройки.
Специалисты Integrator.Digital запустят канал MAX в Битрикс24 под конкретную схему работы компании. В обычных случаях мы подключаем встроенный коннектор: создаем «Открытые линии», задаем правила обработки обращений, добавляем нужных роботов.
Если требуется логика, которой в штатном коннекторе нет, подключаем API MAX и API Битрикс24 — они позволяют задавать собственные правила создания CRM-элементов, расширять маршрутизацию, подключать внутренние системы, обрабатывать нестандартные события и гибко управлять структурой сообщений.
