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

Общие

Что делает MaxBotStat?

Аналитика и автоматизация для Telegram- и Max-ботов через прозрачное зеркало API. Подробно — Что такое MaxBotStat.

Сколько стоит начать?

MaxBotStat работает на нашем сервере. Бесплатный тариф позволяет привязать одного бота с лимитом сообщений; для большего — платные тарифы.

Подключение

Какие платформы поддерживаются?

Telegram и Max. Подключение разное по форме токена, но логика зеркала одинаковая.

Что делать, чтобы подключить бота?

Привязать бота в кабинете и поменять в коде бота базовый адрес API:

• Telegram: https://api.telegram.org → https://api-tg.app.maxbotstat.ru
• Max: https://platform-api.max.ru → https://api-max.app.maxbotstat.ru

Все методы (getMe, sendMessage, getUpdates, setWebhook) остаются прежними. Полные примеры на популярных библиотеках — в разделе Замена адреса API в коде бота.

Бот без токена — что теряется?

• Не работают рассылки и одиночные сообщения от имени бота из кабинета.
• Не загружаются изображения профиля контактов автоматически.
• POST /api/v1/.../send и POST /api/v1/.../broadcast возвращают 400 Personal send requires bot token.

Можно ли использовать MaxBotStat и свою аналитику одновременно?

Да. Замена адреса API ничего не ломает в логике вашего бота — он по-прежнему сам обрабатывает входящие сообщения и сам собирает свою статистику. MaxBotStat работает параллельно.

Как откатиться?

Верните в коде старый адрес https://api.telegram.org. Аналитика перестанет собираться, бот в кабинете останется. Когда понадобится — измените адрес обратно.

Аналитика

Какие данные сохраняются?

• Контакт (идентификатор, username, имя, признак Telegram Premium, телефон если поделился, время последнего сообщения).
• Сообщения (текст, направление, время).
• Источник /start (UTM).
• Исходное обновление (raw_json).

Команде доступны также изображения и медиа, отправленные через бот.

Что с GDPR и 152-ФЗ?

Платформа хранит персональные данные пользователей бота (идентификатор, имя, иногда телефон). По 152-ФЗ оператор данных — владелец бота (вы). MaxBotStat — обработчик. При удалении бота данные становятся недоступны через кабинет и открытый API; полное удаление по запросу пользователя — через поддержку.

Сколько данных хранится по умолчанию?

В текущем выпуске — без срока. Сообщения и контакты живут, пока вы не удалите бота или не попросите чистку явно.

Можно ли выгрузить данные?

Да, через открытый API: контакты, сообщения, статистика. Подробнее — Открытый API.

Рассылки

Как быстро отправляется рассылка?

Telegram ограничивает 30 сообщений в секунду. На 5000 контактов это около 3 минут. MaxBotStat не разгоняет искусственно, чтобы не получить блокировку Telegram.

Можно ли запланировать рассылку?

В текущем выпуске — нет. Запланированные рассылки в плане.

Можно ли отменить запущенную рассылку?

В кабинете — нет. Через закрытый API кабинета — есть кнопка остановки. Отправленные до этого момента сообщения остаются в базе.

Что если бот заблокирован пользователем?

Рассылка увеличит счётчик недоставленных. Контакт остаётся в базе, но при следующих рассылках снова окажется среди недоставленных.

Открытый API

Чем /api/... отличается от /api/v1/...?

/api/... — закрытый API кабинета, работает по сессионному ключу из логина (живёт 7 дней). /api/v1/... — открытый, работает по постоянному ключу (mbs_...).

Можно ли использовать ключ API в браузере?

Технически да, но не рекомендуется. Кто угодно увидит ключ в инструментах разработчика и сможет шлюзить рассылки от вашего имени. Делайте посредник на своём сервере.

Какой лимит частоты запросов?

В текущем выпуске — мягкий (около 60 запросов в минуту на ключ). Жёстких пределов нет, но злоупотребление будет ограничено индивидуально.

Как тестировать API локально?

Привяжите бота, замените адрес API в локальном коде на https://api-tg.app.maxbotstat.ru. Все запросы вашего бота попадут в нашу аналитику, а сам бот будет работать как раньше.

Деньги

Сколько стоит?

Зависит от тарифа. Открытый список — GET /api/plans. Бесплатный тариф — один бот и ограниченный объём сообщений.

Как оплатить?

Через Robokassa: карта, СБП, электронные деньги. После ответного запроса от Robokassa план активируется автоматически в течение минуты.

Возвраты?

В индивидуальном порядке через поддержку. Стандартный срок рассмотрения — 14 дней.

Можно ли работать командой?

Да, на тарифе Макс в одном аккаунте могут работать до 10 человек: владелец и до девяти приглашённых. Подробнее — в разделе Команда.

Безопасность

Где хранятся токены ботов?

В Postgres, в зашифрованном виде на уровне приложения. Через открытый API не возвращаются никогда — даже владельцу.

Что с TLS?

docs.maxbotstat.ru, app.maxbotstat.ru и поддомены — Let's Encrypt, автообновление. TLS 1.2 и 1.3.

Что делать, если ключ утёк?

В кабинете: Настройки → API → Отозвать. После этого старый ключ возвращает 401. Выпустите новый.

Как проверить, кто и когда использовал ключ?

В кабинете: Настройки → API — таблица показывает время последнего использования и адрес для каждого ключа.

Разное

Где живёт сервис?

Тестовый стенд — app.maxbotstat.ru. Для рабочего использования выпустим отдельный домен с SLA.

Можно ли получить счёт или договор?

Для юрлиц — через поддержку, тема Корпоративная подписка.

Где документация для языковых моделей?

См. /llms.txt и /llms-full.txt. Подробнее: llmstxt.org.