Чат-бот в MAX: как создать бота, как работает Bot API и связка с CRM
Чат-бота в MAX создаёт организация, ИП или самозанятый: через кабинет business.max.ru или мини-приложение «MAX для бизнеса», после верификации профиля и модерации бота. Дальше бот работает через Bot API — бесплатно со стороны платформы, по вебхукам и только с теми, кто написал ему сам. Разбираем, как создать бота, как устроен API и что ломается при связке с CRM.
Как создать чат-бота в MAX: регистрация и модерация
Создать бота могут только организации, ИП и самозанятые — резиденты РФ. Сначала в кабинете business.max.ru или в мини-приложении «MAX для бизнеса» заводят профиль организации и проходят верификацию: владелец или сотрудник с правом подписи подтверждает данные через Госуслуги или банковский сервис вроде СберБизнес ID.
Затем в разделе «Чат-боты» создают бота. На один профиль организации или ИП — до пяти ботов, у самозанятого — до двух. Имя бота платформа пока присваивает сама по шаблону idИНН_bot, выбор своего имени заявлен как будущая возможность.
Каждый бот проходит модерацию: по документации она занимает до 48 часов в рабочие дни, статусы — «На модерации», «Опубликован» или «Нужны исправления». Токен для API берут в настройках бота: «Чат-боты» → «⋮» → «Настройки».
Если программиста нет, бота собирают в конструкторах партнёров платформы — без кода, по шаблонам. Полный доступ к логике и интеграциям даёт только Bot API.
Технологический стек и доставка событий через Webhooks
Программный интерфейс MAX Bot API унифицирован под стандарты современных веб-сервисов и размещен на эндпоинте platform-api2.max.ru. У платформы есть официальные клиенты для TypeScript и Go (max-bot-api-client-ts, max-bot-api-client-go), для Python и других языков — сторонние библиотеки. Интегрируя чат-бот в MAX, HTTPS-запросы к платформе необходимо снабжать токеном авторизации, который передается исключительно в заголовке Authorization, а не в параметрах URL.
Получение событий через Long Polling (/updates) документация прямо называет неподходящим для продакшена: оно ограничено по скорости и сроку хранения событий. Рабочий вариант — вебхуки, и они накладывают жёсткие рамки на сервер интегратора. При отправке вебхука эндпоинт вашей CRM-системы обязан вернуть ответ с HTTP-кодом 200 OK в течение интервала тайм-аута — 30 секунд. Возврат кодов ошибок или превышение временного порога считается платформой сбоем доставки. В таком случае мессенджер выполняет до 10 повторных запросов с экспоненциальной прогрессией задержки: первая попытка происходит через 60 секунд, вторая — через 150 секунд, третья — через 375 секунд и так далее. Если за 8 часов успешного ответа так и не пришло, бот автоматически отписывается от вебхука, и события перестают приходить совсем.
Чек-лист: 4 требования к инфраструктуре перед запуском
Планируя в MAX создание бота, передайте техническому отделу или интегратору этот список требований. Без их реализации стабильная работа API невозможна.
- Отправка файлов с повтором. Сразу после загрузки файла API несколько секунд отвечает attachment.not.ready — отправку сообщения с вложением нужно повторять с паузой (1, 2, 4 секунды), а не считать ошибкой.
- Ограничение частоты запросов. Лимит API — 30 запросов в секунду, поэтому исходящие сообщения идут через очередь, а не пачкой.
- Асинхронная обработка вебхуков. Эндпоинт обязан отдавать HTTP 200 OK мгновенно, а саму бизнес-логику (поиск клиента в базе, создание сделки) выносить в фоновую очередь (Redis/RabbitMQ), чтобы уложиться в 30-секундный лимит.
- Идентификация пользователей. Логика рассылок должна опираться на внутренние идентификаторы user_id, а не на номера телефонов.
Почему нельзя запустить холодную рассылку по номерам
Анализ практики внедрения выявил типовое заблуждение среди руководителей отделов продаж: компания рассчитывает загрузить купленную базу мобильных телефонов и запустить по ней исходящий прогрев. Интегрированные в мессенджер MAX чат-боты функционируют строго во входящем режиме.
Отправить сообщение абоненту первым по номеру телефона через официальный Bot API технически невозможно. Архитектура оперирует исключительно внутренними идентификаторами (user_id), требуя первичного триггера от самого пользователя — нажатия кнопки «Начать» или отправки текстового запроса.
Экономика внедрения и возможности Mini Apps
Официальный Bot API бесплатен со стороны оператора ООО «МАХ». Платформа не взимает абонентской платы за подключение, открытие диалоговых сессий или обработку неограниченного потока входящих текстовых пакетов. Бюджет коммерческого использования складывается из стоимости лицензий на коннекторы сторонних интеграторов (таких как Radist, Wazzup, Chat2Desk), расходов на техническое обслуживание серверов и бюджетов на таргетированную рекламу для привлечения пользователей.
Возможности API значительно расширены поддержкой интерактивных мини-приложений (Mini Apps) и веб-виджетов. Это позволяет разворачивать полноценные витрины интернет-магазинов и финансовые сервисы прямо внутри диалогового окна. Оплату внутри такого приложения подключают через платёжного провайдера, и клиент проходит путь от квалификации заявки до оплаты, не покидая мессенджер.
Таблица: что чаще всего идет не так при интеграции
| Симптом в отделе продаж | Техническая причина | Что делать интегратору |
|---|---|---|
| Бот отправляет одно и то же сообщение клиенту несколько раз подряд | CRM отвечает на вебхук дольше 30 секунд или возвращает ошибку. Срабатывает повтор платформы, а через 8 часов сбоев бот отписывается от вебхука | Настроить асинхронную обработку: мгновенно отдавать 200 OK, а формирование ответа выносить в фоновый процесс |
| Бот не может отправить клиенту файл: API отвечает ошибкой | Сообщение с вложением ушло сразу после загрузки, файл ещё в статусе attachment.not.ready | Повторять отправку с паузой 1, 2, 4 секунды, файл заново не загружать |
| Менеджер не может написать клиенту первым из интерфейса CRM | Попытка инициировать диалог по номеру телефона, что запрещено архитектурой Bot API | Запускать медийный трафик на ссылку бота или использовать веб-виджет на сайте для сбора первичных user_id |
| Часть сообщений не уходит в разгар рекламной кампании | Превышен лимит API — 30 запросов в секунду | Отправлять через очередь с ограничением частоты |
Что НЕ помогает: переключать рабочий сервер с вебхуков на Long Polling ради обхода 30-секундного тайм-аута: по документации этот способ ограничен по скорости и сроку хранения событий и для продакшена не подходит.
Что делать дальше
Сначала проверьте инфраструктуру: CRM должна мгновенно отвечать на вебхук и обрабатывать событие в фоне, отправлять сообщения через очередь и повторять отправку файлов при attachment.not.ready. Затем пройдите верификацию профиля на business.max.ru, создайте бота и заложите до 48 рабочих часов на модерацию. Первых собеседников бот получит только сам: ссылка на бота в рекламе, на сайте и в других каналах — единственный способ начать диалог.
Частые вопросы
Взимает ли мессенджер плату за каждое отправленное сообщение?
Нет, официальный Bot API мессенджера полностью бесплатен со стороны оператора ООО «МАХ». Вы платите только за сторонние сервисы интеграции и свои серверы.
Можно ли собрать бота для MAX без навыков программирования?
Да, у платформы есть конструкторы партнёров: бота собирают по шаблонам без кода. Для нестандартной логики и связки с CRM нужен Bot API.
Как принять оплату от клиента прямо в чате?
Через мини-приложение (Mini App): внутри мессенджера открывается веб-витрина, а оплату, в том числе по СБП, проводит подключённый платёжный провайдер.
Разрешено ли ботам автоматически добавлять пользователей в группы?
Нет. С 9 сентября 2026 года метод POST /chats/{chatId}/members ограничен, а с 30 сентября удаляется: готового способа добавлять участников в групповой чат через API больше нет.
Как отправить клиенту рассылку по базе номеров?
Через официальный Bot API — никак. Он работает только по внутренним идентификаторам (user_id) и требует, чтобы клиент первым нажал кнопку «Начать».