Как создать бота в MAX: требования, API и перенос из Telegram

Создать бота в MAX как в Telegram — за пять минут с личного аккаунта — не получится. В MAX бот всегда принадлежит проверенному бизнесу: организации, ИП или самозанятому. Сначала профиль на платформе MAX для партнёров и верификация, потом карточка бота и модерация, и только после этого — токен, сценарии и интеграции. Ниже весь путь по официальной документации dev.max.ru на сентябрь 2026 года: требования, регистрация, Bot API, мини-приложения и перенос готового бота из Telegram.

Кто может создать бота в MAX

Подключение к платформе MAX для партнёров и её сервисам — чат-ботам, мини-приложениям, каналам — доступно юрлицам, ИП и самозанятым, которые являются резидентами РФ. Физическим лицам и нерезидентам верификация пока недоступна, а без неё бота не создать. Поэтому на запрос «как создать бота в макс физ лицу» честный ответ — никак: нужен как минимум статус самозанятого.

Верификацию от организации проходит только её владелец — единоличный исполнительный орган — или представитель с правом первой или единственной подписи.

Регистрация на платформе MAX для партнёров и верификация

Войти на платформу можно двумя способами: через веб-версию или через мини-приложение «MAX для бизнеса» внутри мессенджера. В веб-версии регистрация идёт по номеру телефона с кодом из SMS — лучше корпоративному: к одному номеру привязан один профиль со всеми ботами, мини-приложениями и каналами.

Верификация юрлица и ИП

Профиль подтверждают через Госуслуги или банковские сервисы T-Business ID и Alfa ID. Верификация через банки пока доступна только в веб-версии платформы. Для Госуслуг нужны три условия:

• создан личный кабинет организации или ИП на Госуслугах;
• вход выполнен в роли «Руководитель» — в роли сотрудника подтвердить организацию нельзя;
• данные из ЕГРЮЛ и ЕГРИП на Госуслугах актуальны.

Верификация самозанятого

После создания профиля платформа сразу перенаправляет на Госуслуги — нужен личный кабинет там. Если подтвердить профиль не получается, пишут в чат «Поддержка MAX для бизнеса» или на partner_support@max.ru.

Как создать бота в MAX: карточка, никнейм, модерация

Когда профиль подтверждён, создание самого бота занимает несколько минут:

1. Откройте профиль на платформе, раздел «Чат-боты», нажмите «Создать».
2. Заполните карточку: логотип, название, описание.
3. Нажмите «Создать» — бот уйдёт на модерацию.

В полях и логотипе запрещены ненормативная лексика, контент 18+ и данные других компаний, а описание должно соответствовать деятельности бизнеса. После проверки можно поменять всё, кроме никнейма. Публичная ссылка на бота имеет вид max.ru/idИНН_bot, к ней платформа сразу формирует QR-код.

Сколько длится модерация

Проверка занимает до 48 часов по рабочим дням. Статусы видны рядом с названием бота, уведомления приходят от бота «MAX для бизнеса»:

• «На модерации» — идёт проверка, менять настройки нельзя;
• «Опубликован» — бот доступен пользователям и находится поиском по никнейму;
• «Нужны исправления» — причина отказа указана в карточке, после правок бот отправляют повторно.

Сколько ботов можно создать и что открывается после модерации

Лимит зависит от типа профиля: организация или ИП — до 5 ботов, самозанятый — до 2. Каждый бот настраивается и проходит модерацию отдельно.

После публикации в настройках бота («Чат-боты» → ⋮ → «Настройки») становятся доступны:

• приватность: разрешить или запретить добавление в групповые чаты (по умолчанию запрещено), подключение мини-приложения и выбор кнопки его запуска;
• токен — ключ, через который бот подключают к конструктору, CRM, чат-платформе поддержки или собственному серверу.

Токен хранят как пароль: по нему кто угодно сможет управлять ботом.

Конструктор без кода или Bot API: как выбрать способ

Сам по себе опубликованный бот ничего не умеет — сценарий подключают отдельно. Документация MAX описывает два пути.

MAX рекомендует конструкторы из списка официальных партнёров; для обмена данными с учётной системой, статусов заказов и оплаты пишут собственный код. Разбор сценариев и форматов есть на странице о чат-ботах для бизнеса.

Как написать бота через MAX Bot API

Bot API MAX — это HTTPS-запросы к серверу platform-api2.max.ru с ответами в JSON. Документация даёт спецификацию OpenAPI в формате YAML (из неё генерируют клиент для Python, PHP, C#, Java, Kotlin, Swift) и официальные библиотеки для TypeScript/JavaScript и Go.

Токен и первые запросы

Токен передаётся только в заголовке Authorization: <access_token> — передача через query-параметры больше не поддерживается. Проверить подключение проще всего запросом GET /me: он вернёт имя и никнейм бота. Сообщения отправляют через POST /messages, файлы загружают через POST /uploads, команды меню задают через PATCH /me/commands.

Вебхук или Long Polling

События от пользователей бот получает одним из двух способов — одновременно использовать оба нельзя:

• Webhook — подписка через POST /subscriptions, MAX сам присылает события на ваш URL (только HTTPS, порт 443). Для боевого бота — только этот вариант.
• Long Polling — периодические запросы GET /updates. Ограничен по скорости и сроку хранения событий, подходит только для разработки и тестов.

Сообщения, кнопки и диплинки

Текст сообщения — до 4000 символов, разметка в формате markdown или html. К сообщению прикрепляют изображения, видео, аудио, файлы, стикеры, контакты, геолокацию и inline-клавиатуру. Клавиатура вмещает до 210 кнопок: до 30 рядов по 7 кнопок, а для кнопок link, open_app, request_geo_location и request_contact — до 3 в ряду. Типы кнопок по документации:

• callback — отправляет боту событие, например выбор товара или подтверждение;
• message — отправляет заранее заданный текст от имени пользователя;
• link — открывает ссылку длиной до 2048 символов;
• request_contact и request_geo_location — запрашивают телефон и местоположение;
• open_app — открывает мини-приложение;
• clipboard — копирует текст в буфер: промокод, трек-номер, адрес.

Диплинк вида https://max.ru/<botName>?start=<payload> запускает бота с параметром до 128 символов — бот получает событие bot_started. Так передают номер заказа с сайта, источник перехода или реферальный код.

Мини-приложение в MAX: что это и что нужно для запуска

Мини-приложение — это веб-приложение на HTML, CSS и JavaScript, которое открывается внутри чата с ботом. Отдельно от бота оно не существует: сначала публикуется бот, потом к нему в настройках подключается URL приложения и выбирается кнопка запуска.

• Файлы размещают на хостинге с HTTPS — документация упоминает VK Cloud и Yandex Cloud.
• Для доступа к возможностям MAX и устройства пользователя есть библиотека MAX Bridge, для интерфейса в стиле мессенджера — React-компоненты MAX UI.
• Прямая ссылка на приложение — https://max.ru/<botName>?startapp, после ключа можно передать стартовый параметр, например номер заказа.

Перенос бота из Telegram в MAX

Если бот уже работает в Telegram, логику можно переиспользовать, но переписать слой работы с API придётся: у MAX свой протокол, свои объекты событий и свои ограничения. Как устроен Telegram-бот, мы разбирали в статье как создать бота в Телеграм, здесь — только различия.

Что обычно приходится переделывать:

• Клиент API. Библиотеки для Telegram с MAX не работают — нужен официальный SDK MAX или клиент, сгенерированный из OpenAPI.
• Обработчики событий и кнопок. Структура событий другая: запуск по диплинку приходит как bot_started, нажатие callback-кнопки — как message_callback.
• Тексты. Сообщения длиннее 4000 символов нужно делить, разметку — проверять заново.
• Работу с группами. Метод POST /chats/{chatId}/members ограничен с 9 сентября и удаляется 30 сентября 2026 года, GET /chats не работает с июня. Список чатов теперь собирают сами из событий bot_added и bot_removed через подписку.
• Рассылки. Если Telegram-бот жил рассылками по базе, в MAX без договора так нельзя.
• Базу пользователей. Подписчики Telegram-бота в MAX не переезжают: их приглашают по ссылке или QR-коду на нового бота.

Удобная архитектура — общее ядро с бизнес-логикой и тонкие адаптеры под API каждого мессенджера. Про обмен данными с учётными системами — в разделе об интеграциях с CRM и 1С.

Можно ли создать бота в MAX бесплатно

Документация dev.max.ru не описывает плату за создание бота, верификацию или доступ к Bot API. Реальные расходы находятся в другом месте: подписка на конструктор, сервер для собственного кода, разработка сценариев и интеграций. Из чего складывается бюджет, подробно разобрано в статье сколько стоит чат-бот.

Типовые ошибки при запуске бота в MAX

• Размытое или «чужое» описание. Упоминание других брендов и несоответствие деятельности компании — повод вернуть бота на исправления.
• Ссылку публикуют до модерации. Пока бот не опубликован, пользователи его не найдут, а реклама будет сливать трафик впустую.
• Массовая рассылка через API. Без договора с MAX это нарушение Требований (п. 1.5). Для обычных ответов нужна очередь: больше 2 сообщений в секунду в один чат и 30 rps к API не пройдут, API вернёт 429.

Чек-лист запуска бота в MAX

• Есть статус юрлица, ИП или самозанятого, данные на Госуслугах актуальны
• Профиль на платформе MAX для партнёров создан и верифицирован руководителем
• Подготовлены логотип 500×500, название до 59 символов и описание до 200 символов без чужих брендов
• Бот прошёл модерацию, токен сохранён в защищённом месте
• Выбран способ настройки: конструктор-партнёр MAX или собственный код на Bot API
• Для собственного кода: вебхук на HTTPS с доверенным сертификатом, очередь сообщений под лимиты API
• Сценарий проверен по всем веткам, есть передача оператору
• При необходимости подключено мини-приложение и настроены диплинки для сайта и офлайн-точек
• Ссылка и QR-код размещены на сайте, в подписи писем и точках продаж

Итог

Создание бота в MAX начинается с верификации бизнеса и модерации, а технически похоже на Telegram, но со строгими требованиями к вебхукам, лимитам и рассылкам. Для типовых сценариев хватит конструктора, для интеграций с CRM, 1С и мини-приложениями нужна разработка чат-бота.