Как получить токен MAX-бота
Верификация в MAX для партнёров, создание бота, модерация и копирование токена.
Токен MAX-бота выдаётся на платформе MAX для партнёров после создания бота и успешной модерации. Без токена сервис не сможет ходить в API MAX от имени бота. Токен передаётся в заголовке Authorization — храните его в секрете.
Кто может создать бота
- Нужен верифицированный профиль организации, ИП или самозанятого — резидента РФ.
- Без верификации создать бота и получить токен нельзя.
- Лимит ботов зависит от типа профиля на платформе партнёров.
Шаг 1. Верификация профиля
- Зарегистрируйтесь на business.max.ru и создайте профиль организации, ИП или самозанятого.
- Дождитесь проверки данных — статус отображается в кабинете партнёра.
- Альтернатива: мини-приложение «MAX для бизнеса» в мессенджере (Настройки → MAX для бизнеса) или бот @business_bot.
Шаг 2. Создайте чат-бота
- В кабинете партнёра откройте раздел «Чат-боты».
- Нажмите «Создать» и заполните карточку: имя, описание, аватар.
- Отправьте бота на модерацию и дождитесь одобрения — статус модерации виден рядом с названием.
Пользователи смогут пользоваться ботом только после успешной модерации.
Шаг 3. Скопируйте токен
- Веб: Чат-боты → выберите бота → Расширенные настройки → Настроить — поле «Токен».
- В мессенджере: бот «MAX для бизнеса» → команда «Получить токен» (после модерации).
Наличие токена означает, что бот зарегистрирован на платформе. Если токен скомпрометирован — перевыпустите его в кабинете партнёров и обновите в сервисе.
Шаг 4. Добавьте бота в сервис
- Откройте Кабинет → Боты → Добавить бота.
- Выберите систему MAX.
- Вставьте токен и сохраните — сервис проверит его через GET /me.
- После добавления бот получит webhook (если доступен HTTPS) и базу «Подписчики».
API и уведомления
- Базовый адрес API: https://platform-api2.max.ru (старый platform-api.max.ru для новой работы не используйте).
- Токен передаётся в заголовке Authorization, не в query-параметрах.
- Лимит платформы: до 30 запросов в секунду на API; в диалог — не чаще 2 сообщений в секунду.
- Для production предпочтителен Webhook по HTTPS; Long Polling — в основном для разработки.