MAX Bot API: POST /subscriptions — Подписка на Webhook

Ответ: success, message.

Также есть GET /subscriptions (список подписок) и DELETE /subscriptions (отписка).

Параметр	Где	Тип	Обяз.	Описание
url	body	string	да	HTTPS-адрес, только порт 443 (порт в URL не указывается)
update_types	body	array	нет	Типы событий, например ["message_created", "bot_started"]
secret	body	string	нет	5–256 символов; приходит в заголовке X-Max-Bot-Api-Secret каждого вебхука

Базовые URL

• Боевой: https://platform-api2.max.ru
• Документация просит отправлять запросы на вместо старого .: platform-api2.max.ru

Авторизация

Тип: API-ключ

Токен бота передаётся в заголовке Authorization: <access_token> (без префикса). Передача токена в query-параметре access_token больше не поддерживается.

curl -X GET "https://platform-api2.max.ru/me" \
  -H "Authorization: {access_token}"

Нюансы

• Загрузка файла: POST /uploads?type=... → загрузить файл на url (multipart целиком или resumable частями) → передать токен в attachments[].payload.token в POST /messages или PUT /messages.
• Сразу после загрузки файл может быть не обработан — ошибка attachment.not.ready; повторяйте отправку с растущим интервалом.
• Вебхук: только HTTPS на порту 443, сертификат доверенного центра или Минцифры, полная цепочка сертификатов; самоподписанные сертификаты не поддерживаются. Проверяйте заголовок X-Max-Bot-Api-Secret.
• GET /chats не поддерживается с июня 2026; POST /chats/{chatId}/members удалён с 30 сентября 2026.
• Методы PUT/POST /subscriptions/POST /answers возвращают HTTP 200 и при неуспехе — проверяйте поле success.

Сценарии с этим методом

• Принимать сообщения через вебхук

---

Если этого недостаточно — официальная документация: https://dev.max.ru/docs-api Вся интеграция одним документом: https://mcp-everything.ru/integrations/max-bot-api.md