Что такое чат-бот для MAX
MAX — мессенджер с партнёрской платформой для бизнеса: чат-боты, мини-приложения, каналы и Цифровой ID. Бот там — программа, которая получает события от пользователей по HTTPS API и отвечает сообщениями, кнопками и файлами. В документации сценарии описаны так: автоответы, справочные сценарии, приём заказов.
Создать бота можно тремя путями. Конструкторы партнёров без кода работают по готовым шаблонам. Официальный Bot API подходит для своей логики: в документации есть библиотеки для JavaScript и Go и OpenAPI-схема. Если бот должен работать с вашей базой, оплатой или CRM, реалистичен именно путь через API.
Мини-приложения — отдельный продукт: веб-приложения на HTML, JavaScript и CSS, которые общаются с клиентом MAX через библиотеку MAX Bridge. Бот и мини-приложение часто работают вместе, как Telegram-бот и Telegram Mini App.
Для разработчика важно, что платформа задаёт рамки. Правила размещения ботов и требования к приложениям вынесены в отдельные юридические разделы документации, и их стоит прочитать до начала работы. Описание бота должно соответствовать деятельности вашей организации, а нецензурная лексика, контент 18+ и данные других компаний в карточке и логотипе запрещены.
Кто может создать бота для MAX и что требует платформа
Здесь главное отличие от Telegram, где бота создают за минуту без юрлица. В MAX сначала подключаются к платформе. По документации, она открыта для юрлиц, ИП и самозанятых — резидентов РФ. Физлица, которые не самозанятые, и нерезиденты верификацию пока пройти не могут.
Верификация идёт через Госуслуги или банковский ID, подтверждать должен руководитель или администратор, а не обычный сотрудник. Только после этого выбирают сервис «чат-боты» и создают бота. Сколько ботов можно создать, зависит от типа профиля, актуальный лимит смотрите в кабинете.
- Создайте профиль (организация, ИП или самозанятый) в мини-приложении «MAX для бизнеса» или на веб-платформе.
- Пройдите верификацию через Госуслуги или банковский ID.
- В разделе «Чат-боты» заполните карточку: логотип, название и описание. Актуальные требования к размеру и длине смотрите в документации платформы.
- Правила никнейма задаёт платформа; уточните их, прежде чем печатать никнейм где-либо.
- Бот уходит на модерацию; заложите на неё время до даты запуска; статус виден рядом с названием бота.
- После публикации бота можно найти по никнейму. Правка опубликованного бота снова отправляет его на модерацию.
Бот для MAX и Telegram-бот: чем они отличаются
Принцип тот же: токен, HTTP API, входящие события и исходящие сообщения. Различия в правилах и деталях, и на план проекта они влияют сильнее, чем на код.
Главное — доступ. Telegram-боту не нужна компания за спиной. Боту MAX нужен верифицированный российский профиль и модерация, а правка карточки запускает её снова. Учитывайте это до того, как назовёте бизнесу дату запуска.
Есть и мелочи, которые всплывают на интеграции. Ник бота в MAX формируется автоматически, поэтому красивый адрес, как в Telegram, пока не получится. Кроме того, группы и каналы, куда добавлен бот, документация предлагает получать через подписки, а не через список чатов, так что код получения чатов лучше сверять с актуальным разделом API.
- Кто публикует: в Telegram — любой. В MAX — верифицированные российские организации, ИП и самозанятые.
- Модерация: у обычного Telegram-бота её нет. В MAX карточку проверяют перед публикацией.
- Транспорт в проде: в Telegram можно вебхук или long polling. В MAX документация рекомендует вебхук на всех этапах, а long polling называет инструментом для разработки.
- Вебхук: MAX принимает только HTTPS на порту 443 и не поддерживает самоподписанные сертификаты. Telegram разрешает самоподписанный, если загрузить его.
- Текст сообщения: в MAX до 4000 символов, в Telegram до 4096.
- Кнопки: в inline-клавиатуре MAX есть callback, link, open_app, request_geo_location, request_contact, message и clipboard; до 7 кнопок в ряду и 30 рядов.
Как Bot API доставляет события: вебхук и long polling
API работает на platform-api2.max.ru, токен передаётся в заголовке Authorization; передача в query-параметре больше не поддерживается. У API есть лимит запросов, при превышении приходит 429, поэтому отправляйте через очередь с ограничителем скорости. События приходят двумя способами, одновременно их использовать нельзя.
Long polling — это GET /updates. В документации сказано, что он ограничен по скорости и сроку хранения событий и предназначен только для разработки и тестов. В проде нужен вебхук: POST /subscriptions с HTTPS-адресом, необязательным списком типов событий и необязательным секретом. MAX возвращает секрет в заголовке X-Max-Bot-Api-Secret, и запросы с другим значением нужно отклонять.
Правила доставки влияют на архитектуру. Эндпоинт должен ответить 200 в течение 30 секунд. Сбои повторяются до 10 раз с растущим интервалом, а если 8 часов нет успешного ответа, бот автоматически отписывается. Поэтому тяжёлую работу выносят в очередь: приняли событие, сохранили, обработали воркером. Та же логика, что в нашем разборе вебхука и long polling в Telegram, плюс проверка подписи вебхука.
Что переиспользуется из Telegram-бота
Если Telegram-бот написан аккуратно, большая часть его кода не про Telegram. Бизнес-правила, база, интеграции с CRM и оплатой, уведомления и админка стоят за интерфейсом. Специфична для канала только тонкая граница: разбор входящих событий и вызовы API отправки.
Это паттерн адаптера канала. Адаптер превращает нативное событие во внутреннее (пользователь, текст, нажатие кнопки, вложение) и внутренний ответ — в нативный вызов. Ядро не импортирует клиенты Telegram или MAX. Добавить MAX тогда значит написать адаптер, обработчик вебхука и сопоставление идентификаторов, а не второго бота.
- Переиспользуется как есть: сценарии и состояние, интеграции с CRM и 1С, логика платежей, фоновые задачи, админка, аналитика.
- Нужен адаптер: разбор входящих событий, отправка сообщений, клавиатуры, загрузка файлов, регистрация команд.
- Решение по каждому каналу: формат разметки, лимиты кнопок, что делать, если функция есть только в одном мессенджере.
- Хранить отдельно по каналу: внешний id пользователя, id чата, согласие и статус отписки.
Как вести два канала без дублирования логики
Заведите одну запись пользователя с несколькими идентичностями каналов и состояние диалога, не зависящее от мессенджера. Наш разбор состояния диалога бота подходит напрямую: автомат должен опираться на внутренний id пользователя, а не на chat id Telegram.
Делайте обработчики идемпотентными. Обе платформы повторяют недоставленные вебхуки, поэтому одно событие может прийти дважды. Сохраняйте id события или хеш и пропускайте повторы, как описано в материале про идемпотентность API и повторы. Исходящие сообщения отправляйте через очередь с лимитером на канал: лимиты у площадок разные.
Практичный порядок такой: сначала вынесите ядро из Telegram-бота и покройте его тестами, потом добавьте адаптер MAX и подключите вебхук в тестовой среде, затем отправьте карточку на модерацию. Пока бот на модерации, настройки менять нельзя, поэтому всё нужное должно быть готово заранее. Токен и секрет вебхука храните в переменных окружения, а не в репозитории.
Тесты пишите на внутреннее событие, а не на сырые payload. Тогда новому каналу нужны только тесты адаптера. И заранее фиксируйте разрыв по функциям: если сценарий зависит от возможности, которая есть в одном мессенджере, определите запасной вариант, а не находите проблему в проде.
Когда бот для MAX вам не нужен
Не стоит делать бота только потому, что канал существует. Если ваша аудитория за пределами России или клиенты не пользуются MAX, отдачи не будет. Со стороны бизнеса платформа открыта резидентам РФ, поэтому иностранная компания сейчас опубликовать бота там не может.
Разработка тоже не нужна, если сценарий закрывает конструктор без кода: простой FAQ, меню, форма заявки. Начните с шаблона и переходите к коду, когда нужны своя база, сложное состояние или интеграции. А если вы не знаете, сколько ваших клиентов сидит в MAX, спросите их или проведите пилот: в просмотренной нами официальной документации данных об аудитории нет.
Когда нужен подрядчик
Подрядчик оправдан, когда бот — часть системы и от него зависят процессы компании: читает заказы из CRM, пишет платежи, работает с очередями и не должен падать при деплое. Ещё один случай — у вас уже есть Telegram-бот и нужен второй канал без переписывания: тогда основная работа — рефакторинг под адаптеры.
Своими силами остаются профиль, верификация и владение аккаунтом. Бот принадлежит вашей организации на платформе, поэтому доступ и токен храните у себя, а разработчику давайте только то, что нужно для интеграции. Как мы подходим к задаче — на странице разработки Telegram-ботов и ботов для мессенджеров, а что влияет на бюджет — в статье о стоимости бота.