FAQ

Общие

Что делает MaxBotStat?

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

Это закрытый или открытый сервис?

MaxBotStat работает на нашем сервере (capybara.maxbotstat.ru). Бесплатный тариф позволяет завести 1 бота с лимитом сообщений; для большего — платные тарифы. Исходный код проекта — в репозитории команды (закрытый MVP-релиз).

Можно ли развернуть у себя?

В текущем релизе self-hosted режим не задокументирован, но технически возможен — нужны Docker, Postgres, домен, Let's Encrypt. Если интересно — пишите в поддержку.

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

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

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

Что такое proxy_secret?

12 случайных байт (24 hex-символа), которые подмешиваются в URL прокси. Защищают от подбора: даже зная botId, без secret нельзя слать апдейты в вашу базу.

Можно ли поменять proxy_secret?

Через UI — пока нельзя. Workaround: удалить бота и подключить заново — proxy_secret сгенерируется новый. Все исторические данные при этом сохраняются (привязаны к бэкенд-id).

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

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

Я уже использую setWebhook для своего backend. Как подключить и MaxBotStat, и backend?

Установите webhook бота на MaxBotStat, в карточке бота укажите ваш backend в поле target_url. MaxBotStat будет проксировать апдейты на ваш URL без изменений. См. Прокси-вебхук.

Аналитика

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

• Контакт (id, username, имя, premium, телефон если поделился, last_seen).
• Сообщения (текст, направление, время).
• Источник /start (UTM).
• Сырая нагрузка апдейта (raw_json).

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

Что с GDPR / 152-ФЗ?

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

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

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

Можно ли экспортировать данные?

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

Рассылки

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

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

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

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

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

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

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

Рассылка вернёт failed_count++ для этого пользователя. Контакт остаётся в БД, но при следующих рассылках снова окажется среди «недоставленных».

REST API

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

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

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

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

Какой rate limit?

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

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

Поставьте webhook на локальный туннель (ngrok, cloudflared tunnel, localtunnel) и пропишите его как target_url. Все апдейты упадут к вам в localhost, аналитика останется в MaxBotStat.

Деньги

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

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

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

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

Возвраты?

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

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

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

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

Что с TLS?

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

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

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

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

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

Разное

Где хостится сервис?

Тестовый стенд — capybara.maxbotstat.ru. Для продакшена выпустим отдельный домен с SLA.

Кто за ним стоит?

MVP-команда из независимых разработчиков. Контакты и юр. данные — на странице maxbotstat.ru.

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

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

Где документация для LLM?

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