Тема

Добавление бота ​

После регистрации и подтверждения email можно подключать бота. Поддерживаются два провайдера: Telegram и Max.

Telegram ​

1. Создайте бота в @BotFather ​

/newbot
> MyShop bot
> myshop_bot

@BotFather пришлёт сообщение с токеном вида:

123456789:AAH4xExampleTokenStringFromBotFather_ABC

Сохраните токен

Токен — это пароль бота. Никому его не передавайте, не публикуйте в репозитории. В MaxBotStat токен хранится зашифровано и никогда не возвращается через API.

2. Добавьте бота в кабинете ​

  1. На главной кабинета нажмите Добавить бота.
  2. Выберите провайдер Telegram.
  3. Введите название (для вас) и токен.
  4. Нажмите Сохранить.

MaxBotStat автоматически:

  • проверит токен через getMe;
  • запишет имя, username и аватарку бота;
  • сгенерирует proxy_secret (12 случайных байт);
  • покажет webhook-URL для подключения.

3. Установите webhook ​

bash
curl -X POST "https://api.telegram.org/bot<TOKEN>/setWebhook" \
     -d "url=https://capybara.maxbotstat.ru/proxy/<botId>/<secret>" \
     -d "allowed_updates=[\"message\",\"callback_query\",\"my_chat_member\"]"

<botId> и <secret> отображаются в карточке бота. Подробнее: Telegram: подключение.

Max ​

Max — мессенджер от VK. У ботов Max есть аналогичный механизм webhook'ов.

1. Получите access token ​

  1. Создайте бота в Max for developers.
  2. Скопируйте access_token.

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

То же самое, что для Telegram, но провайдер — Max. Webhook-URL формируется по тому же шаблону, и настраивается через платформу Max:

bash
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>"}'

Без токена ​

Бот можно добавить и без токена — тогда вы будете только принимать апдейты на прокси-URL, но не сможете:

  • отправлять рассылки и одиночные сообщения от имени бота;
  • получать аватарки контактов автоматически;
  • использовать /api/v1/.../send и /api/v1/.../broadcast.

Это сценарий «только webhook» — годится, если у вас уже есть собственный механизм отправки.

Целевой URL (target_url) ​

Если у вас есть собственный backend, укажите в карточке бота поле target_url — например, https://yourapp.com/tg-webhook. MaxBotStat будет проксировать туда каждый апдейт.

Если оставить значение polling (по умолчанию), бот не будет ничего никуда дальше пересылать — апдейты просто сохранятся в MaxBotStat.

Лимиты ​

  • Один пользователь — до 20 ботов одновременно.
  • На один токен Telegram/Max можно зарегистрировать только один бот в системе.
  • Лимит API-ключей на пользователя — 20 активных.

MaxBotStat

© 2026 MaxBotStat