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

Я подключал MAX в рабочем проекте — бот присылает напоминания и сообщения в групповые чаты. Ниже — что нужно для старта и какие изменения API 2026 года ломают старый код. Чем MAX отличается от Telegram и нужен ли он вам вообще, разобрано в отдельной статье.

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

• Подключение к платформе MAX для партнёров доступно юрлицам, ИП и самозанятым — резидентам России.
• Нужно создать профиль организации, ИП или самозанятого и пройти верификацию.
• Бот проходит модерацию перед запуском.

Обычное физлицо без статуса создать бота не может — в этом главное отличие от Telegram, где бот заводится за минуту через BotFather.

Где взять токен

После создания бота на платформе для партнёров токен находится в разделе «Чат-боты». Храните его в переменных окружения сервера, не в коде и не в переписке.

Главные правила API в 2026 году

По документации dev.max.ru на 7 октября 2026 года. API активно меняется — перед разработкой перечитайте раздел изменений.

Отправка сообщения на Python

import requests

API = "https://platform-api2.max.ru"
HEADERS = {"Authorization": MAX_TOKEN, "Content-Type": "application/json"}

def send(chat_id: int, text: str):
    r = requests.post(f"{API}/messages", params={"chat_id": chat_id},
                      json={"text": text}, headers=HEADERS, timeout=20)
    r.raise_for_status()
    return r.json()

Для личного сообщения пользователю вместо chat_id передаётся user_id. Есть официальные библиотеки для TypeScript, JavaScript и Go и OpenAPI-спецификация, по которой генерируют клиент для других языков.

Грабли из реального проекта

• Бот не знает, в каких он чатах. Раньше список брали через GET /chats; после его отключения бот, написанный по старым примерам, перестаёт находить группы. Решение — POST /subscriptions и сохранение ID чатов из входящих событий (бот добавлен в чат, новое сообщение).
• Бот не видит сообщения в группе, если у него нет нужных прав. Проверьте, что бот добавлен администратором там, где это требуется.
• Вебхук требует HTTPS с корректным сертификатом и быстрого ответа. Обработку события выносите в фон, а на вебхук отвечайте сразу.
• Старый домен. Если в коде platform-api.max.ru, переведите его на новый домен из документации заранее, не дожидаясь отключения.

Частые вопросы