﻿---
title: "MAX и Битрикс24: канал обращений и корпоративный бот"
description: "MAX как канал: клиент пишет первым, оператор отвечает из Битрикс24, а переписка сохраняется в CRM."
---

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

## Кратко

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

## Когда нужна интеграция

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

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

- **Клиенты пишут в Telegram или ВКонтакте** — для них есть отдельные каналы и страницы:
  [Битрикс24 и Telegram](https://wpcraft.ru/integrations/bitrix24/telegram.md), [Битрикс24 и ВКонтакте](https://wpcraft.ru/integrations/bitrix24/vk.md).
- **Нужен только чат на сайте** — используется виджет открытой линии Битрикс24, а не бот в MAX.
- **Нужны массовые рекламные рассылки** — это отдельный сценарий с правилами платформы MAX, а не
  обработка входящих обращений.

## Сценарии

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

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

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

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

### Ответ оператора → сообщение клиенту в MAX

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

## Источники

- [Битрикс24: как подключить мессенджер MAX](https://helpdesk.bitrix24.ru/open/26927832/)
- [MAX Bot API: методы и события](https://dev.max.ru/docs-api)