Вернуться к статьям Интеграция с MAX: связка порталов Битрикс24 и корпоративного мессенджера в одном окне
Введение: зачем мессенджеру MAX понадобилась интеграция с порталами Битрикс24
Российские компании всё чаще строят коммуникации на стеке «Битрикс24 плюс MAX». Битрикс24 — для сделок, задач, воронок. MAX — для быстрых чатов, групповых обсуждений и переписки с внешними контактами, которые не заводят в CRM. Проблема появляется, когда эти два мира не пересекаются: обсуждение сделки в чате MAX не видно в задаче Битрикс24, а сообщение из воронки не доходит до коллеги, который работает только в MAX.
Приложение «Межпортальные чаты» (ChatB24toB24) решало похожую задачу на уровне двух порталов Битрикс24 — партнёрского и клиентского. Сообщение, написанное в чате на портале партнёра, мгновенно появлялось в чате клиента, и наоборот. Два портала работали как один. Но оставался пробел: а что если часть команды сидит в MAX, а не в Битрикс24? Что если заказчик общается только в MAX, а интегратор ведёт проект в CRM?
Интеграция с MAX закрывает этот разрыв. Сообщения из связки «партнёр ↔ клиент» выводятся в чат MAX, ответы из MAX доставляются обратно в порталы Битрикс24. MAX становится ещё одним каналом в связке — равноправным с порталом партнёра или клиента.
Как устроена пересылка сообщений между Битрикс24 и MAX
Интеграция построена на Bot API платформы MAX. В приложении «Межпортальные чаты» заводятся MAX-боты — по одному на каждый токен, выданный в MAX. Каждый бот подписывается на вебхук приложения и ждёт событий: новое сообщение, бота добавили в чат, чат переименовали.
Бот привязывается к конкретной связке порталов (той самой, где настроен обмен между партнёрским и клиентским Битрикс24). В настройках привязки выбирается чат в MAX — групповой или диалог, — и указывается направление пересылки:
- Из Битрикс24 в MAX (от партнёра, от клиента, или от обоих)
- Из MAX в Битрикс24 (партнёру, клиенту, или обоим)
Каждое направление включается независимо. Если вы хотите только читать переписку порталов в MAX, не отвечая — включите «из Битрикс24 в MAX» и отключите обратное направление. Если нужен полноценный чат с участниками из MAX — включите оба.
Сообщения конвертируются на лету: BB-код Битрикс24 превращается в Markdown MAX и наоборот. Жирный текст, курсив, ссылки, цитаты — всё сохраняется. Длинные сообщения (свыше 4000 символов, это лимит MAX) автоматически режутся на части с повторением подписи автора в каждой — чтобы продолжение не выглядело анонимным.
Под капотом:
- Токены MAX-ботов шифруются в базе и никогда не отдаются в интерфейс
- Повторно пришедшие сообщения отсеиваются по идентификатору — дублей в чате не будет
- Собственные сообщения бота не ретранслируются обратно — эхо-петля исключена
- Для проверки TLS используется сертификат Минцифры, которым подписан домен *.max.ru
Автоматизация пересылки между Битрикс24 и MAX: настройка один раз — работает без участия человека
Ручной работы после настройки нет. Весь поток событий идёт через вебхуки:
- Сообщение приходит в чат портала Битрикс24
- Приложение «Межпортальные чаты» доставляет его на второй портал (штатная логика связки)
- Если для этой связки настроена интеграция с MAX — сообщение дублируется в выбранный чат MAX с подписью автора
- Ответ из MAX приходит вебхуком на приложение
- Приложение находит связку по боту и чату, проверяет направление «MAX → Битрикс24», конвертирует Markdown в BB-код и отправляет в нужные порталы
Никаких кнопок «обновить», ручного копирования вкладок или переключения между приложениями. Сообщение пришло в MAX — через секунду оно в чате Битрикс24. Написали в Битрикс24 — через секунду оно в MAX.
Единственное, о чём стоит помнить: бот MAX не может написать пользователю первым. Диалог в MAX должен начать сам пользователь — после этого бот сможет отвечать. Для групповых чатов такого ограничения нет: бота достаточно добавить в чат, и он сразу начнёт пересылку.
Кейсы внедрения: четыре сценария, где MAX-интеграция окупается сразу
Кейс 1. Интегратор и заказчик: CRM у одних, MAX у других
Компания-интегратор ведёт внедрение Битрикс24 для заказчика. У интегратора все коммуникации по проекту идут в чате на своём портале. Заказчик живёт в MAX — это его основной мессенджер, и заходить в чужую CRM каждый раз, чтобы ответить на вопрос, он не готов.
До интеграции: интегратор пишет в чате на портале → копирует в MAX вручную → ждёт ответа → копирует ответ обратно в чат портала. 5-7 лишних действий на каждое сообщение. При 20-30 сообщениях в день это час рутины.
После интеграции: настроена связка порталов + бот MAX в чате проекта. Интегратор пишет на своём портале — сообщение приходит заказчику в MAX. Заказчик отвечает в MAX — ответ появляется в чате портала интегратора. Обе стороны работают в привычной среде. Время на коммуникацию сократилось с часа до нуля.
Кейс 2. Внутренняя команда: отдел продаж в Битрикс24, разработка в MAX
Отдел продаж работает в Битрикс24: сделки, звонки, задачи. Отдел разработки сидит в MAX: там все техчаты, ревью, обсуждения архитектуры. Когда продажнику нужно уточнить срок по проекту, он пишет в чат сделки — но разработчик этого не видит, потому что он в MAX.
Настройка: чат сделки в Битрикс24 привязывается к техчату проекта в MAX. Сообщение продажника «Когда будет готова интеграция с API?» приходит разработчику в MAX с подписью «Иван (Продажи)». Разработчик отвечает «К вечеру вторника» — ответ возвращается в карточку сделки. История переписки сохраняется в обоих инструментах, каждый видит её в своём интерфейсе.
До: продажник ждал ответа часами, пока разработчик заглянет в Битрикс24. После: ответ приходит за минуты, потому что разработчик видит сообщение там, где работает.
Кейс 3. Проектный чат в MAX с внешними подрядчиками
Маркетинговое агентство ведёт 15 клиентских проектов. С каждым клиентом — отдельная связка порталов через «Межпортальные чаты». Но часть подрядчиков (дизайнеры, копирайтеры, таргетологи) не имеют доступа к порталам клиентов и работают только в MAX.
Менеджер агентства настраивает для каждой связки отдельный чат в MAX: «Проект Альфа», «Проект Бета» и так далее. Подрядчики добавляются в соответствующие чаты MAX. Теперь сообщение клиента из его портала автоматически попадает в чат MAX с подрядчиками. Ответ подрядчика видит и менеджер в CRM, и клиент на своём портале.
До интеграции: менеджер работал ретранслятором — копировал вопросы клиента подрядчикам и ответы подрядчиков клиенту. После: он исключён из цепочки как бутылочное горлышко. 15 проектов × 10 сообщений в день = 150 ручных ретрансляций, которые теперь происходят автоматически.
Кейс 4. Руководитель в MAX следит за коммуникацией в CRM
Руководитель компании использует MAX как основной мессенджер. Битрикс24 открывает раз в день — проверить воронку. Но оперативные вопросы от менеджеров приходят в чаты сделок, и руководитель их пропускает.
Настройка: чаты сделок в CRM привязываются к личному чату руководителя в MAX. Когда менеджер пишет в чат сделки вопрос «Клиент просит скидку 15%, утверждаем?», сообщение дублируется руководителю в MAX. Он отвечает «Ок, но не больше 10%» прямо из MAX — ответ падает в чат сделки, и менеджер видит его в CRM.
До: согласование растягивалось на часы, потому что руководитель не видел сообщений в CRM. После: скорость согласования выросла с 3-4 часов до 15-20 минут.
Типичные ошибки при настройке интеграции с MAX
Ошибка 1. Бот не добавлен в чат MAX
Токен бота получен, вебхук работает, но сообщения не идут. Причина: бота забыли добавить в нужный чат MAX. Бот видит только те чаты, участником которых он состоит. Решение: добавьте бота в чат через интерфейс MAX, после этого чат появится в списке доступных для привязки.
Ошибка 2. Выбрано направление «оба портала»
Классическая ловушка: из MAX сообщение уходит и партнёру, и клиенту. При этом оба портала настроены на отправку в MAX. Получается петля: сообщение из MAX → портал A → MAX → портал B → MAX → портал A... Встроенная защита отсекает собственные сообщения бота, но если сообщение пришло от пользователя — защита не сработает. Решение: либо включите пересылку в MAX только с одной стороны, либо отключите зеркалирование входящих из MAX на оба портала.
Ошибка 3. Слишком длинное сообщение молча обрезается в MAX
Лимит MAX — 4000 символов на одно сообщение. Приложение честно режет длинные сообщения на части, но если в настройках привязки отключена подпись автора, вторая и последующие части могут прийти без контекста. Решение: если в чатах часто обсуждают длинные тексты (описания задач, требования), включите опцию «Подписывать источник портала» в настройках привязки.
Сравнение с альтернативами MAX-интеграции: ручная пересылка, email, Telegram и самописные боты
Ручное копирование между Битрикс24 и MAX
Было стандартной практикой до интеграции: открыты две вкладки — Битрикс24 и MAX, сообщения копируются руками. Плюсы: не требует настройки. Минусы: медленно, пропускаются сообщения при высокой нагрузке, нет истории в одном месте, человеческий фактор. Подходит для 2-3 сообщений в день — дальше начинается деградация.
Email-уведомления из Битрикс24
Битрикс24 умеет слать уведомления о новых сообщениях на почту. Но это именно уведомления, а не сам текст. Чтобы прочитать сообщение, нужно открыть ссылку и залогиниться в портал. Ответить из почты нельзя. Решение годится только для пассивного мониторинга — «меня что-то спросили, надо зайти в CRM».
Telegram-боты vs MAX: разные уровни интеграции с Битрикс24
«Межпортальные чаты» уже работают через Открытые линии Битрикс24, принимая сообщения из Telegram, WhatsApp, Viber. Но это канал «клиент → интегратор». MAX-интеграция работает на другом уровне: она связывает полноценные рабочие пространства, а не обслуживает входящие обращения. В Telegram можно написать в поддержку. В MAX ведётся проект, обсуждается архитектура, согласовываются правки. Это инструмент для команды, а не для приёма заявок.
Самописный бот на REST API Битрикс24
Технически можно написать своего бота, который через REST API читает сообщения из чатов и пересылает их в MAX. На практике: нужно решить идемпотентность (чтобы не было дублей), гонку состояний (два бота читают один чат), хранение маппинга чатов, шифрование токенов, ротацию ключей, мониторинг отвалов вебхуков. Интеграция в «Межпортальных чатах» уже прошла эти грабли на десятках инсталляций и содержит готовые решения.
FAQ: частые вопросы по интеграции MAX и Битрикс24
Нужен ли отдельный бот MAX для каждой связки порталов?
Нет. Один бот MAX можно переиспользовать в нескольких связках — достаточно выбрать разные чаты MAX при настройке каждой привязки. Бот создаётся один раз и живёт в общем списке.
Что делать, если токен бота MAX скомпрометирован?
Замените токен в интерфейсе (слайдер редактирования бота) и переподпишите бота на вебхук. Старый токен шифруется в базе и при замене перезаписывается.
Работает ли интеграция с диалогами один-на-один в MAX?
Да. При настройке привязки можно выбрать «контакт MAX» вместо «чат MAX». Но важно: бот не может написать пользователю первым. Диалог должен начать пользователь, нажав «Начать» в интерфейсе MAX. Для групповых чатов такого ограничения нет.
Передаются ли файлы между MAX и Битрикс24?
Да. Файлы, прикреплённые к сообщению в Битрикс24, доставляются в чат MAX. Аналогично, файл из MAX приходит в чат портала Битрикс24. Файловый обмен работает в обе стороны и не требует отдельной настройки — достаточно включённой пересылки сообщений.
Упадёт ли пересылка, если сервер MAX недоступен?
Нет. Сбой MAX не влияет на основной обмен между порталами Битрикс24 — сообщения продолжат доставляться. Недоставленное в MAX сообщение логируется и теряется (MAX не предоставляет гарантированной доставки через вебхуки). Это осознанное архитектурное решение: связка порталов важнее внешнего канала.
Как узнать, что интеграция работает?
В интерфейсе бота MAX есть состояние подписки: «подключена», «ошибка» или «не проверялась». Кнопка «Проверить» делает GET /me в MAX API и сверяет список подписок. Если вебхук приложения есть в подписках бота — всё работает.
Какие порталы Битрикс24 поддерживаются?
Любые: облачные и коробочные, при условии что установлено приложение «Межпортальные чаты». Для коробки важен доступ к FastAPI-бэкенду приложения из интернета (вебхук MAX должен достучаться до сервера).
Title: Интеграция Битрикс24 с MAX: связка порталов и корпоративного мессенджера Description: Как подключить мессенджер MAX к межпортальным чатам Битрикс24: настройка бота, пересылка сообщений, кейсы внедрения. Пошаговое руководство для интеграторов.
Высокочастотные:
- интеграция Битрикс24 с MAX
- межпортальные чаты Битрикс24
- подключить MAX к Битрикс24
- мессенджер MAX интеграция
Среднечастотные:
- бот MAX в Битрикс24
- пересылка сообщений из Битрикс24 в MAX
- MAX и Битрикс24 связка
- интегратор Битрикс24 MAX чат
- настройка вебхука MAX
- корпоративный мессенджер MAX Битрикс24
Низкочастотные:
- как связать портал Битрикс24 с MAX
- BB-код в Markdown MAX
- межпортальные чаты с внешним мессенджером
- автоматическая пересылка сообщений Битрикс24 MAX
- мессенджер MAX для интегратора Битрикс24
- внедрение MAX Битрикс24 под ключ
- цена настройки интеграции MAX Битрикс24
Выводы: кому ставить интеграцию с MAX и с чего начать
Интеграция с MAX — не для всех. Если ваша команда на 100% сидит в Битрикс24 и внешними мессенджерами не пользуется — вы ничего не потеряете, пропустив эту настройку. Если же часть коммуникаций ушла в MAX — с руководителями, подрядчиками или заказчиками — интеграция может окупиться в первую же неделю: вы перестаёте быть ретранслятором между двумя окнами.
Начать просто: получите токен бота у @MasterBot в MAX, зайдите в раздел «MAX-боты» в настройках приложения «Межпортальные чаты», добавьте бота. Затем в настройках связки порталов выберите вкладку MAX, укажите чат и направления. Первое сообщение пойдёт сразу после сохранения.
Результат не «когда-нибудь потом», а сразу: написали в чат Битрикс24 — через секунду сообщение в MAX. Ответили в MAX — через секунду в Битрикс24. Без задержек, без ручного копирования, без переключения контекста.