Как зарегистрировать бота в MAX: верификация, токен и подключение к API

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

Кто может зарегистрировать бота в MAX

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

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

Правила платформы меняются, поэтому актуальные требования сверяйте с документацией для разработчиков на dev.max.ru.

Регистрация по шагам

Шаг 1. Профиль организации

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

Шаг 2. Верификация

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

Шаг 3. Карточка бота

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

Шаг 4. Модерация

Бот проходит модерацию на соответствие правилам платформы и только после неё становится доступен пользователям. Заложите на неё время в план запуска и не приурочивайте публикацию к дате впритык.

Шаг 5. Токен

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

Токен — это ключ от бота

Кто владеет токеном, тот управляет ботом. Храните его в переменных окружения или секретах сервера, не коммитьте в репозиторий и не пересылайте в чатах. Платформа может отозвать токен за нарушение правил — тогда бот перестанет отвечать.

Первое подключение к API

Бот работает через HTTP-запросы к Bot API. Токен передаётся в заголовке Authorization: передача через параметр в адресе запроса больше не поддерживается — на этом спотыкаются те, кто копирует старые примеры из интернета.

Проверить токен проще всего запросом GET /me — он возвращает информацию о боте. Пришли имя и идентификатор — токен рабочий. Сообщения бот отправляет методом POST /messages.

Входящие события бот получает одним из двух способов. Long polling: бот сам периодически запрашивает обновления методом GET /updates — удобно для разработки и тестов, публичный адрес сервера не нужен. Webhook: платформа сама присылает события на ваш адрес, подписка оформляется методом POST /subscriptions — этот вариант обычно выбирают для рабочего бота.

ЗадачаМетод
Проверить токен и получить данные ботаGET /me
Отправить сообщениеPOST /messages
Получать события через long pollingGET /updates
Подписаться на webhookPOST /subscriptions

Для JavaScript/TypeScript и Go есть официальные клиентские библиотеки — ссылки на них в документации на dev.max.ru. На других языках запросы пишутся напрямую: подойдёт любой HTTP-клиент.

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

  • Токен передан параметром в адресе, а не в заголовке Authorization, — запросы не проходят.
  • Запросы к API падают с ошибкой сертификата. В документации отдельно указано: сертификат Минцифры нужно добавить в список доверенных на сервере.
  • Ошибка 429 — слишком много запросов. Делайте повтор с паузой и не отправляйте массовую рассылку одним циклом без ограничения скорости.
  • Бота не находят в поиске: он ещё на модерации или карточка заполнена не полностью.

Как спроектировать сценарий и что делать после регистрации, мы описали в пошаговой инструкции по созданию бота. Если бот раньше жил в Telegram, логика и backend переиспользуются — меняется только слой работы с API.

Сделать самим или заказать

Своими силами

Подходит, если в команде есть разработчик. Вы контролируете всё, но сценарии, сервер, поддержку и изменения API берёте на себя.

Конструктор

Токен вставляется в конструктор, сценарий собирается без кода. Хватит для визитки и простых ответов, но интеграции и сложная логика ограничены.

Под ключ

Мы берём регистрацию в вашем профиле, сценарии, разработку, сервер и публикацию. Вы получаете бота с админ-панелью и статистикой.

Сколько стоит

Разработка под ключ — от 85 000 ₽ за бота на готовой базе с админ-панелью. Бот с мини-приложением и интеграцией с CRM — от 250 000 ₽. Проекты сразу для MAX, Telegram и VK — от 600 000 ₽. Составы работ — на странице разработки для MAX.

Услуга Letary

Бот в MAX под ключ

Регистрация в вашем профиле, сценарии, разработка через официальный Bot API, сервер и публикация. Перенос бота из Telegram — за недели. От 85 000 ₽.

Обсудить проект
Кейс: «Тарум» для ТВ-3
Бот в MAX под ключ

Читайте также

FAQ

Частые вопросы о регистрации бота в MAX

  • Может ли физлицо зарегистрировать бота в MAX?

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

  • Где взять токен бота в MAX?

    В веб-интерфейсе платформы: «Чат-боты» → «⋮» → «Настройки». Или в боте «MAX для бизнеса» командой «Получить токен».

  • Как передавать токен в запросах к API?

    В заголовке Authorization. Передача токена через параметр в адресе запроса больше не поддерживается.

  • Что выбрать: webhook или long polling?

    Long polling удобен для разработки и тестов — не нужен публичный адрес. Для рабочего бота обычно настраивают webhook, чтобы платформа сама присылала события.

  • На каком языке писать бота для MAX?

    На любом, который умеет отправлять HTTP-запросы. Для JavaScript/TypeScript и Go есть официальные библиотеки.

Готовые решения

Инструменты для создания собственных проектов

Платформа для создания
AR & WebAR

Позволяет создавать AR-проекты для маркетинга, мероприятий, образования и туризма без сложной разработки.

Платформа создания мобильных приложений

Платформа для разработки приложений iOS и Android на JavaScript и TypeScript с быстрым запуском и удобной поддержкой.