Как создать бота в MAX: платформа для разработчиков и первые шаги

Статья про техническую сторону: где платформа, что нужно для регистрации, как устроена модерация, что делать с токеном и где границы Bot API. Если вы ещё решаете, нужен ли бот, начните с разбора что такое чат-бот и зачем он бизнесу. Если нужен не свой бот, а готовый, смотрите обзор ботов в MAX и того, как их подключать к каналу.

Все детали ниже — из документации dev.max.ru и справки MAX на 13 сентября 2026 года; где документация молчит, об этом сказано прямо.

Где в MAX создают ботов: платформа для партнёров и dev.max.ru

Бота-создателя ботов вроде телеграмного BotFather в MAX нет. Есть два адреса, и путать их не надо.

• Платформа MAX для партнёров (business.max.ru) — кабинет: верификация профиля, карточка бота, модерация, токен, приватность, мини-приложение.
• dev.max.ru — документация: Bot API с методами и объектами, библиотеки, мини-приложения, правила размещения и FAQ. Создать там ничего нельзя, зато написано, что бот умеет.

То же доступно в мессенджере: мини-приложение «MAX для бизнеса» (max.ru/business_bot?startapp или «Настройки» → «MAX для бизнеса») и одноимённый бот. Шаги там совпадают с веб-версией, но верификация в мини-приложении идёт только через Госуслуги, а банковская — только в веб-версии. Канал компании создаётся в том же кабинете: порядок — в разборе как создать канал в MAX для бизнеса.

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

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

Самозанятых пустили на платформу в июне 2026 года — до этого порог был выше. Частному автору канала остаются два пути: оформить самозанятость (тогда доступны 2 бота) или пользоваться готовыми сервисами. И оговорка: подключение к Цифровому ID доступно только юрлицам и ИП.

Что нужно для регистрации и верификации профиля

Порядок один: вход на платформу → профиль организации, ИП или самозанятого → верификация. Пока верификация не пройдена, раздел с ботами не откроется.

Для входа нужен номер телефона с кодом из СМС: документация рекомендует корпоративный или рабочий номер ответственного представителя, потому что на него идут и коды, и важные уведомления. Вход по почте возможен, только если вы раньше регистрировались с ней. И деталь, о которую спотыкаются команды: одному номеру или почте соответствует один тип профиля со всеми привязанными сервисами — ботами, мини-приложениями, каналами, Цифровым ID.

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

Что проверить на Госуслугах заранее:

• Личный кабинет организации или ИП создан.
• Вход выполнен в роли «Руководитель» — в роли сотрудника подтвердить нельзя.
• Данные ЕГРЮЛ и ЕГРИП актуальны. Обновление запускается кнопкой в профиле организации и занимает от нескольких минут до часа, редко — до 24 часов.
• Выбрана нужная организация, если к аккаунту привязано несколько.

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

Как создать бота в MAX: пошагово

Последовательность короткая: время уходит не на клики, а на верификацию и модерацию.

1. Войдите на платформу MAX для партнёров — по номеру телефона с кодом из СМС или через мини-приложение «MAX для бизнеса».
2. Создайте профиль организации, ИП или самозанятого и пройдите верификацию.
3. Откройте раздел «Чат-боты» и нажмите «Создать».
4. Заполните карточку — логотип, название, описание. Никнейм подставится сам.
5. Нажмите «Создать» — бот уйдёт на модерацию, статус виден рядом с его названием.
6. Дождитесь проверки — до 48 часов по рабочим дням, уведомления приходят от бота «MAX для бизнеса».
7. Скопируйте токен в настройках бота и переходите к сценарию: конструктор или код по Bot API.

Требования к полям стоит прочитать до загрузки логотипа: ждать повторную модерацию дольше, чем сразу собрать файл правильно.

В полях и логотипе запрещены ненормативная лексика, контент 18+ и данные других компаний, а описание должно соответствовать деятельности организации. Документация советует потратить 200 знаков с толком — указать график работы оператора, контакты поддержки, телефон, адрес:

Записываем на приём, показываем свободное время и напоминаем о визите. Оператор на связи по будням с 9:00 до 19:00, в остальное время отвечает бот. Телефон: +7 900 000-00-00. Адрес: Москва, улица Примерная, 1.

Интерфейс этих разделов обновился в сентябре 2026 года — чужие инструкции со скриншотами сверяйте по дате.

Модерация бота: сроки, статусы и отказ

Модерация — проверка карточки бота платформой. Она обязательна и для первого бота, и для каждого следующего, и для любой правки уже работающего.

Три следствия. Любая правка — новая модерация, и до её конца люди видят прежнюю версию. Ждать не обязательно: документация предлагает удалить бота и создать нового, но удалённого не восстановить. В мессенджере данные бота не меняются — только на платформе. И сроки считаются в рабочих днях: проверка, запрошенная в пятницу вечером, закончится не в субботу.

Токен бота: где взять и что с ним нельзя делать

Токен — это уникальный идентификатор бота, с которым он обращается к API MAX. Формируется он после успешной модерации, и его наличие, как пишет документация, означает, что бот зарегистрирован на платформе.

Лежит он в настройках: «Чат-боты» → бот → ⋮ → «Настройки», справа от поля — значок копирования, рядом — обновления. Показан токен частично скрытым, поэтому его можно только скопировать. Если бота создавали в мини-приложении, токен выдаёт команда «Получить токен» в боте «MAX для бизнеса».

• Токен — прямой доступ к боту. Документация предупреждает: не храните его в открытых источниках и не передавайте посторонним — они смогут управлять ботом от вашего имени.
• Скомпрометирован — обновляйте. Рядом с полем есть значок обновления; после этого токен меняется, и все сервисы, которым вы его отдавали, придётся переподключить.
• В адресе запроса токен не передаётся — только заголовок Authorization: инструкция, подставляющая токен в URL, устарела.
• Токен могут отозвать за нарушение правил платформы — а они требуют действующего лицензионного договора с компанией.

Отдельных прав «только читать» у токена нет: отдавая его подрядчику, вы отдаёте бота целиком, поэтому после сдачи проекта токен обновляют.

Первые шаги после модерации: команды, приватность, мини-приложение

Бот опубликован, токен на руках — а в диалоге пусто: он не знает ни одной фразы. Команд по умолчанию платформа не задаёт: «разработчики могут самостоятельно задавать любые команды ботов».

Команды и оформление сообщений

Команды — подсказки, которые человек видит при вводе «/». Добавляет, меняет и удаляет их метод PATCH /me/commands: имя и описание, максимум 32 элемента, пустой список команды удаляет. Логику ответов задаёте вы, а само действие можно дублировать кнопкой типа callback. Текст бота форматируется разметкой Markdown или HTML через параметр format; в комментариях, по документации, гиперссылки и упоминания не работают.

Приватность: пускать ли бота в чаты

В настройках есть переключатель добавления бота в групповые чаты, и по умолчанию стоит запрет — это самая частая причина удивления «почему бот не добавляется в чат».

Мини-приложение

Мини-приложение — это веб-страница на обычных HTML, CSS и JavaScript, которая открывается внутри мессенджера. Само по себе оно существовать не может: без чат-бота мини-приложение не добавить, именно через бота оно работает с API. Подключают ссылкой в настройках бота, там же выбирают надпись на кнопке запуска: «Открыть», «Старт», «Играть» или без названия. Адрес — до 1024 символов, только https; файлы нужно где-то разместить, документация называет VK Cloud, GitHub Pages и Yandex Cloud.

Как добавить бота в канал и в группу и какие права дать

Сам по себе бот в канал не попадёт. Порядок: добавить участником, затем назначить администратором — в интерфейсе мессенджера или методом POST /chats/{chatId}/members/admins. В чат так же, но сначала снимите запрет на добавление в чаты.

Права в API называются иначе, чем подписи в интерфейсе, и между ними есть зависимости.

Вывод из таблицы: начинайте с read_all_messages. Без него edit, delete, write и pin_message вернут ошибку, а молчащий вебхук чаще всего объясняется его отсутствием. Убрать бота можно методом DELETE /chats/{chatId}/members/me, в мессенджере это доступно добавившему его администратору и владельцу чата; как убрать бота у себя в переписке — в разборе как удалить чат-бота в MAX.

И отдельно: чтобы бот видел новые комментарии к постам, опцию комментариев в канале нужно включить заранее — пока она выключена, он работает только со старыми (как включить комментарии).

Что бот умеет по Bot API и чего в нём нет

Bot API MAX — это HTTPS-запросы к домену platform-api2.max.ru с токеном в заголовке. Бот отправляет сообщения и посты с вложениями (изображение, видео, аудио, файл, стикер, контакт, локация, кнопки), редактирует и удаляет их, закрепляет сообщения, читает и чистит комментарии к постам, получает события о действиях людей.

Кнопок семь типов: callback (бот получает нажатие), link (ссылка), request_contact (контакт и номер), request_geo_location (местоположение), open_app (мини-приложение), message (заданный текст) и clipboard (скопировать промокод или реквизиты). Так под постом и появляются кнопки, которых у штатного поста не бывает — подробнее в разборе кнопок под постами.

Лимиты, которые лучше знать до проектирования

Почему бот не пишет первым

Метод отправки сообщения человеку по его идентификатору в API есть. Но сам идентификатор бот узнаёт только из события: человек нажал «Начать», написал боту или перешёл по диплинку — тогда приходит событие bot_started с данными пользователя. Значит, написать тому, кто к боту не обращался, нельзя, и рассылки по подписчикам канала из бота не выйдет — ссылку на бота приходится ставить в закреп, в описание канала и в кнопку под постом.

Чего в документации нет

• Платёжных кнопок и методов. Ни среди типов кнопок, ни среди методов API оплаты нет: продают ссылкой на свой платёжный сервис или внутри мини-приложения.
• Официальной библиотеки для Python. Документация называет библиотеки для JavaScript и TypeScript, для Go и Go-фреймворк (август 2026). Писать на Python обычными HTTP-запросами никто не запрещает, но библиотеки от платформы нет.
• Добавления участников в чат через API. Метод с 9 сентября 2026 года ограничен, а с 30 сентября удаляется.
• Непубличного бота и смены владельца. Любого бота находят по ссылке или никнейму, а передать права на управление пока нельзя.
• Данных о доставке. Настройки уведомлений пользователя разработчику недоступны.

Webhook или Long Polling

Способа два, и включить оба сразу нельзя. Long Polling — периодические запросы к платформе; он ограничен по скорости и сроку хранения событий, и документация прямо пишет, что для production не подходит. Webhook — платформа сама присылает событие на ваш адрес, нужен публичный сервер с HTTPS и статичным IP. Адрес должен отвечать HTTP 200: при неудаче попытки повторяются, а если ответа нет 8 часов — бот автоматически отписывается. С 25 мая 2026 года вебхуки по HTTP и самоподписанные сертификаты не поддерживаются: нужен сертификат доверенного центра, в том числе Минцифры.

Бот на API, конструктор или готовый сервис: что выбрать

Скажем прямо: большинству читателей этой статьи свой бот не нужен. По данным Tapbox на 19 сентября 2026 года в MAX 143 469 активных публичных каналов, и почти всем нужно одно и то же — комментарии, публикация по расписанию, розыгрыши, антиспам, приём сообщений от подписчиков. Это уже написано и прошло модерацию: достаточно добавить готового бота администратором. Обзор сервисов — в статье про ботов в MAX, про спам под постами — в разборе модерации комментариев, про рандомайзеры — в сравнении ботов для розыгрышей. А аналитика канала — не бот: семь метрик канала.

И про деньги: платы за создание бота в документации не описано — ни тарифов, ни подписки, ни цены за модерацию. Расходы появляются вокруг платформы: сервер с HTTPS под вебхук, хостинг мини-приложения, подписка на конструктор, работа разработчика. То есть регистрация бота бесплатна, а вот бесплатный бот — это либо пустая карточка без сценария, либо чужой готовый бот.

Свой бот нужен там, где он завязан на вашу систему: запись и расписание, заказы и статусы доставки, бонусные счета, заявки и согласования внутри компании. Тут три пути.

• Конструктор. Сценарий собирается блоками без кода, платформа рекомендует сервисы официальных партнёров. Хватает для «вопрос-ответ», заявки и простой воронки — обзор с ценами в статье про конструкторы ботов для MAX.
• Свой код. Нужен там, где есть интеграции и данные: вебхук на вашем сервере, библиотека на JavaScript или Go.
• Разработка на заказ. Когда своей команды нет, а задача сложнее чат-сценария — витрина с оплатой, запись, связка с CRM или 1С. У нас это разработка ботов и мини-приложений для MAX: от 150 000 ₽ и 2–4 недели.

Термины собраны в глоссарии MAX, а что мессенджер даёт компании помимо ботов — в гайде MAX для бизнеса.

Частые ошибки

• Начинать со сценария, а не с верификации. Воронка бесполезна, если платформа не пустит: физлицу и нерезиденту бота не создать.
• Верифицировать организацию с аккаунта сотрудника. Нужна роль «Руководитель» или представитель с правом подписи.
• Отправлять бота на модерацию в пятницу вечером. 48 часов считаются по рабочим дням.
• Выдать права без read_all_messages. Остальные вернут ошибку, а вебхук промолчит.
• Оставить Long Polling в рабочем боте. Документация допускает его только для разработки.
• Писать своего бота под задачу готового сервиса. Комментарии, отложка, розыгрыши и антиспам уже есть.

Чек-лист