Статистика бота
Вкладка «Статистика» на странице бота показывает, сколько людей пользуется ботом, как часто и когда: кто писал сегодня, за 7 и 30 дней, всего; сколько новых; сколько сообщений и сколько в среднем на человека; по каким часам пишут чаще всего. Период графика — 7, 30 или 90 дней.
Что считается у разных ботов
| Бот | Откуда цифры |
|---|---|
| Из конструктора сценариев | Считает сама платформа: люди, сообщения, заявки, мессенджеры и шаги сценария — сколько людей дошло до каждого шага и где уходят. |
| Собранный ИИ в виде кода | Считает встроенный в бота счётчик. У ботов, опубликованных до 12 октября 2026, он появится после следующей публикации. |
| Из GitHub | Считает платформенный счётчик, который подключается к боту при запуске контейнера. Если бот задеплоен до 20 октября 2026, задеплойте его заново. |
Цифры по людям — это уникальные люди: если человек написал десять раз за день, в «Писали сегодня» он посчитан один раз, а в «Сообщения» — десять.
Как платформа считает бота из GitHub
При запуске контейнера платформа кладёт в него свой счётчик и подключает его к интерпретатору: в Python через PYTHONPATH, в Node.js через NODE_OPTIONS=--require. Счётчик перехватывает точку, через которую проходит каждое входящее обновление, и считает людей и сообщения. Код бота, его зависимости и Dockerfile не меняются; если счётчик не смог подключиться, бот просто работает без статистики.
Поддерживаемые библиотеки:
| Язык | Библиотеки |
|---|---|
| Python | aiogram 2 и 3, pyTelegramBotAPI (telebot), python-telegram-bot 13 и 20+ |
| Node.js | Telegraf, grammY, node-telegram-bot-api |
Счётчик не вмешивается, если бот уже считает себя сам: ИИ-ботам со встроенным bot/platform/usage.py и ботам с файлом autohoster_usage.py из раздела ниже он не мешает. Свой PYTHONPATH или NODE_OPTIONS в переменных окружения бота сохраняются — платформа дописывает к ним своё значение.
Счётчик для другой библиотеки (Python)
Если бот написан на другой библиотеке, добавьте счётчик сами. Бот сам раз в минуту пишет сводку в файл /app/data/.autohoster/usage.json, платформа забирает её каждые 5 минут. Имена, номера и тексты сообщений никуда не передаются: людей счётчик различает только по хешу id.
1. Добавьте в репозиторий файл autohoster_usage.py:
"""Счётчик для вкладки «Статистика» в AutoHoster. Без зависимостей, работает с любой библиотекой."""
import hashlib, json, os, threading
from datetime import datetime, timedelta, timezone
_DIR = os.path.join(os.environ.get("DATA_DIR", "/app/data"), ".autohoster")
_lock = threading.Lock()
_days, _users, _dirty = None, None, False
def _read(name):
try:
with open(os.path.join(_DIR, name), encoding="utf-8") as f:
return json.load(f)
except (OSError, ValueError):
return {}
def _write(name, data):
os.makedirs(_DIR, exist_ok=True)
tmp = os.path.join(_DIR, name + ".tmp")
with open(tmp, "w", encoding="utf-8") as f:
json.dump(data, f)
os.replace(tmp, os.path.join(_DIR, name))
def track(user_id):
"""Вызывайте на каждое сообщение или нажатие кнопки от человека."""
global _days, _users, _dirty
now = datetime.now(timezone.utc)
day = now.strftime("%Y-%m-%d")
key = hashlib.sha256(f"autohoster:{user_id}".encode()).hexdigest()[:16]
with _lock:
if _days is None:
_days = _read("usage.json").get("days") or {}
_users = _read("users.json").get("users") or {}
d = _days.setdefault(day, {"messages": 0, "users": 0, "new_users": 0, "hours": [0] * 24})
d["messages"] += 1
d["hours"][now.hour] += 1
if key not in _users:
d["new_users"] += 1
if _users.get(key) != day:
d["users"] += 1
_users[key] = day
_dirty = True
def flush():
"""Записывает сводку в файл; раз в минуту это делает фоновый поток."""
global _days, _dirty
with _lock:
if not _dirty:
return
now = datetime.now(timezone.utc)
keep = (now - timedelta(days=90)).strftime("%Y-%m-%d")
week = (now - timedelta(days=6)).strftime("%Y-%m-%d")
month = (now - timedelta(days=29)).strftime("%Y-%m-%d")
_days = {k: v for k, v in _days.items() if k >= keep}
_write("users.json", {"users": _users})
_write("usage.json", {"v": 1, "users_total": len(_users),
"users_7d": sum(1 for v in _users.values() if v >= week),
"users_30d": sum(1 for v in _users.values() if v >= month),
"days": _days})
_dirty = False
def _loop():
while True:
threading.Event().wait(60)
flush()
threading.Thread(target=_loop, daemon=True).start()
2. Вызовите track там, где бот получает сообщения.
aiogram 3 — одна строка после создания диспетчера, считает всё сразу:
from autohoster_usage import track
@dp.update.outer_middleware()
async def count(handler, event, data):
user = data.get("event_from_user")
if user and not user.is_bot:
track(user.id)
return await handler(event, data)
python-telegram-bot 20+ — обработчик в группе −1, он срабатывает раньше остальных и ничего не перехватывает:
from telegram import Update
from telegram.ext import TypeHandler
from autohoster_usage import track
async def count(update, context):
if update.effective_user and not update.effective_user.is_bot:
track(update.effective_user.id)
app.add_handler(TypeHandler(Update, count), group=-1)
pyTelegramBotAPI — в начале каждого обработчика: track(message.from_user.id).
3. Опубликуйте новую версию. Через 5–10 минут после первых сообщений на вкладке «Статистика» появятся цифры, а надпись «Счётчик включится после следующего деплоя» исчезнет.
Частые вопросы
- Цифры за прошлые дни не появились. Счётчик считает с момента подключения: историю до этого платформа не видела.
- Данные пропадут при обновлении бота? Нет: файл лежит в
/app/data, а эта папка переживает обновления и перезапуски. - Бот на Node.js. Telegraf, grammY и node-telegram-bot-api платформа считает сама. Для другой библиотеки формат файла простой:
days— по дням (UTC)messages,users,new_users,hours(24 числа); плюсusers_total,users_7d,users_30d. Напишите в поддержку — пришлём пример для вашего языка.