Max: подключение через прокси

Max — мессенджер VK с собственной платформой ботов. MaxBotStat работает с Max аналогично Telegram: вы устанавливаете подписку на наш URL, мы сохраняем апдейты и передаём их на target_url, если он указан.

Получение access token

1. Создайте бота в Max for developers.
2. Скопируйте access_token. Это длинная строка, которая используется как Authorization-заголовок при обращении к API.

Подключение в кабинете

1. Добавить бота → провайдер Max → название → access_token.
2. MaxBotStat проверит токен через GET /me и подтянет имя/аватарку.
3. Скопируйте webhook-URL.

Регистрация подписки в Max

curl -X POST "https://platform-api.max.ru/subscriptions" \
     -H "Authorization: <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://capybara.maxbotstat.ru/proxy/<botId>/<secret>",
       "update_types": ["message_created", "message_edited", "bot_added", "bot_removed"],
       "version": "0.0.1"
     }'

update_types — фильтр типов апдейтов на стороне Max.

Проверка подписок

curl "https://platform-api.max.ru/subscriptions" \
     -H "Authorization: <ACCESS_TOKEN>"

Ответ — массив активных подписок. Должна быть запись с вашим прокси-URL.

Удаление подписки

curl -X DELETE "https://platform-api.max.ru/subscriptions?url=https://capybara.maxbotstat.ru/proxy/<botId>/<secret>" \
     -H "Authorization: <ACCESS_TOKEN>"

Что MaxBotStat сохраняет из апдейтов Max

Те же поля, что и для Telegram:

• контакт (external_user_id — id пользователя Max);
• сообщение (direction='in', text, raw_json);
• источник (если в команде /start есть utm_source).

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

MaxBotStat умеет отправлять сообщения от имени бота через REST API v1:

curl -X POST "https://capybara.maxbotstat.ru/api/v1/bots/<botId>/send" \
     -H "X-API-Key: mbs_..." \
     -H "Content-Type: application/json" \
     -d '{"userId":"123456","text":"Привет!"}'

Под капотом мы вызовем POST https://platform-api.max.ru/messages?chat_id=<userId> с заголовком Authorization: <ACCESS_TOKEN>.

Особенности Max vs Telegram

Параметр	Telegram	Max
Базовый URL API	https://api.telegram.org/bot<TOKEN>	https://platform-api.max.ru
Авторизация	токен в URL	заголовок Authorization: <TOKEN>
Способ установки webhook	setWebhook	POST /subscriptions
Тип апдейта	message, callback_query и т.д.	message_created, bot_added и т.д.
Лимит размера апдейта	50 MB	50 MB

Диагностика

Симптом	Причина	Что делать
401 Unauthorized при подключении	Неверный access_token	Перевыпустите в Max for developers
Подписка регистрируется, но контактов нет	Не выбран message_created в update_types	Перерегистрируйте подписку с нужными типами
502 Bad Gateway от MaxBotStat	Платформа Max недоступна или отвечает медленнее 30 с	Проверьте статус Max