Статистика бота

Вкладка «Статистика» на странице бота показывает, сколько людей пользуется ботом, как часто и когда: кто писал сегодня, за 7 и 30 дней, всего; сколько новых; сколько сообщений и сколько в среднем на человека; по каким часам пишут чаще всего. Период графика — 7, 30 или 90 дней.

Что считается у разных ботов

БотОткуда цифры
Из конструктора сценариевСчитает сама платформа: люди, сообщения, заявки, мессенджеры и шаги сценария — сколько людей дошло до каждого шага и где уходят.
Собранный ИИ в виде кодаСчитает встроенный в бота счётчик. У ботов, опубликованных до 12 октября 2026, он появится после следующей публикации.
Из GitHubСчитает платформенный счётчик, который подключается к боту при запуске контейнера. Если бот задеплоен до 20 октября 2026, задеплойте его заново.

Цифры по людям — это уникальные люди: если человек написал десять раз за день, в «Писали сегодня» он посчитан один раз, а в «Сообщения» — десять.

Как платформа считает бота из GitHub

При запуске контейнера платформа кладёт в него свой счётчик и подключает его к интерпретатору: в Python через PYTHONPATH, в Node.js через NODE_OPTIONS=--require. Счётчик перехватывает точку, через которую проходит каждое входящее обновление, и считает людей и сообщения. Код бота, его зависимости и Dockerfile не меняются; если счётчик не смог подключиться, бот просто работает без статистики.

Поддерживаемые библиотеки:

ЯзыкБиблиотеки
Pythonaiogram 2 и 3, pyTelegramBotAPI (telebot), python-telegram-bot 13 и 20+
Node.jsTelegraf, 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. Напишите в поддержку — пришлём пример для вашего языка.