Бот аналитики Telegram для модерации групп

Бот аналитики Telegram показывает, что обнаруживают его системы модерации: сколько нарушений получила группа, каких именно типов, как эти показатели меняются за неделю или месяц и насколько рискованным выглядит отдельный участник. Telegram Bot App — именно такой бот. Его аналитика описывает безопасность и применение правил, а не рост. Здесь вы не найдёте графиков числа подписчиков или поверхностных метрик объёма сообщений. Зато найдёте статистику нарушений по группам, отчёты о спам-риске отдельных пользователей, живую ленту действий модерации и публичный API для проверки спам-рейтинга любого пользователя по Telegram ID.

В этом руководстве объясняется, что охватывает аналитика, где её смотреть и где проходят её границы, чтобы вы точно понимали, что это за бот аналитики Telegram, прежде чем добавлять его.

Аналитика модерации, а не аналитика роста

Большинство инструментов, которые называют себя ботами аналитики Telegram, считают сообщения, отслеживают активные часы и строят графики вступлений и выходов участников. Telegram Bot App этого не делает. Каждое число, которое он показывает, появляется из модерации: сообщение должно быть просканировано, классифицировано и обработано, чтобы попасть в данные.

Поэтому метрики отвечают на другие вопросы. Вместо «сколько людей сегодня писали» панель отвечает: «сколько из этих публикаций нарушили правило, какое именно и насколько уверенным было обнаружение». Это делает данные полезными для одной задачи: аналитики групп Telegram в контексте безопасности и решений по правилам. Это правильный инструмент, если вы хотите понять, не слишком ли мягкий у вас порог спама, какой тип нарушений преобладает в группе или стоит ли банить конкретный аккаунт. И это неподходящий инструмент, если вам нужны отчёты вовлечённости для маркетингового канала.

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

Статистика нарушений и тренды по группам

Откройте группу в панели управления — и вы увидите сводную картину того, как модерация работала в этом сообществе.

Обзор включает статус группы, количество участников, количество администраторов и проверки настроек (наличие изображения профиля и пригласительной ссылки). Метрики активности показывают общее число увиденных сообщений, общее число обнаруженных нарушений и суммарное время применённых наказаний. На их основе панель рассчитывает частоту наказаний на 1 000 сообщений и среднюю длительность наказания, чтобы небольшие и крупные группы можно было сравнивать в едином масштабе.

Разбивка нарушений — центр аналитики модерации Telegram. Каждое обнаруженное нарушение сортируется по типу с точным количеством: порнографический контент, сексуальный контент, токсичная лексика, спам, языковые нарушения, ненормативная лексика, оскорбления, угрозы, пользовательские запрещённые слова, пересланные сообщения, запрещённые медиа, пригласительные ссылки и неавторизованные боты. Это показывает, с чем ваша группа реально сталкивается, а не с чем, как вам кажется, она сталкивается. Группе, где 80% нарушений — спам с пригласительными ссылками, нужны другие настройки, чем группе, где преобладает токсичность.

Временной анализ добавляет измерение времени. Панель показывает активность за последние 7 и 30 дней, чтобы вы могли видеть, растёт число нарушений или снижается. Линии тренда позволяют легко заметить всплеск после публичного упоминания или стабильное снижение после ужесточения порога. Полная разбивка этих панелей описана в руководстве Управление ботом через панель.

Отчёты о спам-риске отдельных пользователей

Общие показатели группы рассказывают о комнате. Отчёты пользовательской разведки рассказывают о человеке.

Найдите любого участника по имени, handle или Telegram ID — и бот вернёт профиль, построенный на истории модерации этого пользователя. Главный показатель — оценка спам-риска от 0.0 до 1.0, рассчитанная той же моделью AI Spam Intelligence, которую бот использует для автоматического кика аккаунтов с показателем 0.75 и выше. Оценка отражает частоту нарушений, уверенность прошлых обнаружений, характеристики профиля и поведенческие паттерны, а не одно неудачное сообщение.

Ниже оценки отчёт показывает статистику уверенности (среднее, медиану, 95-й перцентиль), долю нарушений с высокой уверенностью, а также самые частые типы и причины нарушений этого пользователя. Затем приводится полная история нарушений в хронологическом порядке: каждое нарушение с отметкой времени, типом, уровнем уверенности и причиной, которая его вызвала.

Именно в такой детализации и смысл. Вы видите не только то, что аккаунт нарушал правила, но и насколько уверенно было принято каждое решение. Это помогает отличить настоящего повторного нарушителя от участника, который один раз случайно задел фильтр. В статье Пользовательская разведка и групповая аналитика подробно объясняется, как читать такие отчёты.

Живая лента наказаний

В панели также есть поток применения мер в реальном времени. Живая лента наказаний использует WebSocket-подписку, чтобы показывать действия модерации по мере их появления, отображая последние 20 наказаний по всей системе — во всех группах, которые защищает бот, а не только в вашей.

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

Публичный API спам-рейтинга

Аналитика не заперта внутри веб-панели. Telegram Bot App предоставляет публичный API, который возвращает спам-рейтинг пользователя по Telegram ID. Вы отправляете ID и получаете оценку риска этого аккаунта — тот же показатель, который бот использует внутри.

Это нужно для того, чтобы другие инструменты могли повторно использовать рейтинг. Второй бот, регистрационная форма или внешний скрипт модерации могут проверить входящего пользователя по базе спама до того, как впустить его, вместо того чтобы ждать первого нарушения. Рейтинг опирается как на сопоставленные внешние базы спама, так и на собственную историю аккаунта, поэтому он несёт полезный сигнал даже для пользователя, который никогда не писал в вашей группе.

Что не входит в аналитику

Честные данные требуют назвать пробелы. Этот бот аналитики Telegram не предоставляет:

• Панели объёма сообщений, активных часов или вовлечённости. Здесь считаются нарушения, а не активность ради самой активности.
• Графики роста участников, удержания или воронки вступлений/выходов. Бот блокирует спам с пригласительными ссылками; он не добавляет и не приглашает участников и не строит графики роста аудитории.
• Аналитику текста или OCR. Сканирование изображений классифицирует изображения (показатели уверенности porn/racy/strict), не извлекая из них текст.
• Разговорные ответы или AI-чат. Бот модерирует; он не общается.
• Отчёты о настроении «атмосферы в комнате» как метрику роста. Анализ тональности и токсичности попадает в разбивку нарушений, а не в график настроения сообщества.

Если вам нужно именно это, данный бот для таких задач не подходит, и утверждать обратное означало бы только тратить ваше время.

Откуда берутся цифры

Каждый аналитический показатель восходит к системе обнаружения, и все они работают на бесплатном тарифе для базовой модерации:

• AI Spam Intelligence (байесовский риск 0.0–1.0, автоматический кик при 0.75) и Spamfinder (ML-классификатор контента с порогом 0–100%) формируют показатели спама и питают оценку риска по пользователям.
• NSFW-сканирование изображений в фотографиях, GIF, стикерах и изображениях профиля формирует показатели порнографического, сексуального и запрещённого медиа-контента.
• Обнаружение тональности и токсичности (токсичность, ненормативная лексика, оскорбления, угрозы) и пользовательские запрещённые слова формируют соответствующие категории нарушений. Контроль языков примерно по 33–43 языкам формирует языковые нарушения.
• Обработка ссылок (блокировка пригласительных ссылок t.me/ и пометка вредоносных URLs через Google Safe Browsing) формирует показатели пригласительных ссылок и ссылок.

Бесплатный тариф включает 500 сканирований изображений и 1 000 анализов тональности в месяц, а также всю базовую модерацию. Платные планы (Gold $4.99/mo, Platinum $9.99/mo, Ultimate $49.99/mo, около 20% скидки при оплате за год) увеличивают эти лимиты; они не добавляют отдельный класс аналитики. Полный антиспам-стек, стоящий за цифрами по спаму, описан в руководстве Защита от спама.

Часто задаваемые вопросы

Это бот аналитики роста для Telegram?

Нет. Это бот аналитики модерации. Его аналитика групп Telegram измеряет нарушения, применение мер и спам-риск отдельных пользователей. Он не сообщает объём сообщений, активные часы, рост участников или вовлечённость. Если вам нужны панели по подписчикам и активности, этот бот для этого не создан.

Что на самом деле могут сказать отчёты по отдельным пользователям?

Каждый отчёт даёт оценку спам-риска (0.0–1.0), статистику уверенности по прошлым обнаружениям этого пользователя, его самые частые типы и причины нарушений, а также историю каждого нарушения с отметкой времени и уровнем уверенности. Этого достаточно, чтобы перед действием оценить, является ли аккаунт повторным нарушителем или это разовое ложное срабатывание.

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

Она передаёт данные через WebSocket и показывает последние 20 действий модерации во всех группах, которые защищает бот, с пользователем, типом нарушения, причиной, уверенностью и отметкой времени в каждой записи. Новые наказания появляются по мере применения.

Для чего нужен публичный API спам-рейтинга?

Он возвращает спам-рейтинг любого пользователя по Telegram ID, чтобы внешние инструменты могли повторно использовать эту оценку. Например, вы можете проверять новых участников по базе спама из собственного бота или формы. Оценка опирается на историю аккаунта и сопоставленные внешние базы спама.

Нужен ли платный план, чтобы видеть аналитику?

Нет. Базовая модерация и её аналитика работают на бесплатном тарифе, который включает 500 сканирований изображений и 1 000 анализов тональности в месяц. Платные планы (Gold, Platinum, Ultimate; около 20% скидки при оплате за год) увеличивают лимиты сканирования, а не закрывают отдельный аналитический продукт.

Считает ли бот сообщения или отслеживает, кто самый активный?

Нет. Единственный показатель сообщений — это общий счётчик, который используется для масштабирования частоты нарушений (наказания на 1 000 сообщений). В функции нет рейтинга активности по участникам, графика активных часов или оценки вовлечённости.

Начать работу

Если вам нужна именно аналитика модерации (тренды нарушений, отчёты о спам-риске, живая лента применения мер и запрашиваемый спам-рейтинг), сначала добавьте бота в группу. Панель станет доступна, когда бот будет присутствовать в группе, а вы будете администратором. Руководство Как добавить бота в группу проведёт вас по шагам, либо начните с главной страницы Telegram Bot App.