用于群组管理的 Telegram Analytics Bot
telegram analytics bot 会报告其管理系统检测到的内容：一个群组收到多少次违规、违规类型是什么、这些数字在一周或一个月内如何变化，以及某个成员看起来有多高风险。Telegram Bot App 就是这类 bot。它的分析数据描述的是安全与执法，而不是增长。你在这里找不到订阅人数图表，也看不到消息量这类虚荣指标。你会看到按群组统计的违规数据、单个用户的垃圾信息风险报告、实时管理操作动态，以及一个可通过 Telegram ID 查询任意用户垃圾信息评分的公开 API。
本指南会说明这些分析涵盖哪些内容、在哪里查看，以及它们的边界在哪里，让你在添加它之前，清楚知道这到底是哪一种 telegram analytics bot。
管理分析，而不是增长分析
大多数自称 telegram analytics bot 的工具都会统计消息、追踪活跃时段，并绘制成员加入和离开的图表。Telegram Bot App 不做这些。它展示的每一个数字都来自管理流程：一条消息必须经过扫描、分类并触发处理，才会出现在数据中。
所以这些指标回答的是不同的问题。仪表盘回答的不是“今天有多少人发言”，而是“这些发言中有多少违反了规则、违反了哪条规则，以及检测有多高把握”。这让数据适用于一个明确用途：用于安全和策略决策的 telegram group analytics。如果你想知道自己的垃圾信息阈值是否太宽松、群组里最主要的违规类型是什么，或者某个账号是否值得封禁，这就是合适的工具。如果你想要的是营销频道的互动报告，那它就不是合适的工具。
说清楚这一点很重要，因为无论你是否查看仪表盘，底层检测都会运行。分析数据只是一个窗口，让你看到 bot 已经在每条消息上执行的工作。
按群组统计的违规数据与趋势
在仪表盘中打开一个群组，你会看到该社区中管理情况的汇总图景。
概览包含群组状态、成员数量、管理员数量，以及配置检查（是否有头像和邀请链接）。活动指标会显示已查看的消息总数、检测到的违规总数，以及累计执行的处罚时长。基于这些数据，仪表盘会计算每 1,000 条消息的处罚率和平均处罚时长，因此小群和大群也能在同一尺度上进行比较。
违规细分是 telegram moderation analytics 的核心。每个检测到的违规都会按类型分类并给出精确数量：色情内容、性暗示内容、有毒语言、垃圾信息、语言违规、粗俗用语、侮辱、威胁、自定义禁词、转发消息、禁止媒体、邀请链接，以及未经授权的 bot。这能告诉你群组真正面临的问题，而不是你以为的问题。一个 80% 违规都来自邀请链接垃圾信息的群组，需要的设置显然不同于一个主要问题是有毒言论的群组。
时间分析加入了时间维度。仪表盘会显示最近 7 天和最近 30 天的活动情况，因此你可以看到违规是在上升还是下降。无论是公开曝光后出现的峰值，还是你收紧阈值后持续下降的趋势线，都能轻松看出来。这些仪表盘的完整说明可在 通过仪表盘管理你的 Bot 指南中查看。
单个用户的垃圾信息风险报告
群组汇总数据告诉你这个房间的情况。用户情报报告则告诉你某个人的情况。
按姓名、用户名或 Telegram ID 搜索任意成员，bot 会返回一份基于该用户管理历史生成的资料。最醒目的指标是 0.0 到 1.0 的垃圾信息风险分数，它由 bot 用于在 0.75 及以上自动踢出账号的同一个 AI Spam Intelligence 模型计算得出。这个分数反映的是违规率、过往检测的置信度、资料特征和行为模式，而不是某一条糟糕消息。
在分数下方，报告会细分置信度统计数据（平均值、中位数、第 95 百分位）、高置信度违规率，以及该用户最常见的违规类型和原因。随后，它会按时间顺序列出完整的违规历史：每次违规的时间戳、类型、置信度水平，以及触发它的原因。
这些细节正是重点。你不仅可以看到某个账号违反了规则，还能看到每一次判断的把握有多大，从而区分真正的屡犯者和只是误触一次过滤器的成员。用户情报与群组分析 文章会完整讲解如何阅读这些报告。
实时处罚动态
仪表盘还提供实时的执法动态流。实时处罚动态通过 WebSocket 订阅展示正在发生的管理操作，显示整个系统中最近 20 条处罚记录——也就是 bot 所保护的所有群组，而不只是你的群组。
每条记录都会显示被处罚用户、违规类型、详细原因、置信度分数和时间戳。这几乎就是在观看 bot 实时工作。对于正在判断检测是否过于激进或过于宽松的新管理员来说，花几分钟看看这个动态，比看设置页面更有参考价值。该动态反映的正是 自动处罚系统 指南中记录的同一套执法逻辑。
公开垃圾信息评分 API
分析数据并不只锁在网页仪表盘里。Telegram Bot App 提供一个公开 API，可通过 Telegram ID 返回用户的垃圾信息评分。你查询一个 ID，就会得到该账号的风险评估——也就是 bot 内部使用的同一个分数。
它的用途是让其他工具复用这个评分。第二个 bot、注册表单或外部管理脚本都可以在允许新用户进入之前，先对照垃圾信息数据库检查该用户，而不是等他们先制造麻烦。这个评分不仅基于账号自身历史，也会参考交叉验证的外部垃圾信息数据库，因此即使某个用户从未在你的群组发过言，它仍然能提供有用信号。
分析数据不包含什么
诚实的数据意味着也要说明缺口。这个 telegram analytics bot 不提供：
- 消息量、活跃时段或互动仪表盘。这里的计数是违规计数，而不是为了统计活动而统计活动。
- 成员增长、留存或加入/离开漏斗图。bot 会阻止邀请链接垃圾信息；它不会添加或邀请成员，也不会绘制成员增长图。
- 文本或 OCR 分析。图片扫描会对图片进行分类（色情/挑逗/严格置信度分数），但不会从图片中提取任何文字。
- 对话或 AI 聊天回复。bot 负责管理；它不会聊天。
- 作为增长指标的情绪“房间氛围”报告。情绪和有毒内容检测会进入违规细分，而不是生成社区氛围图。
如果你需要这些功能，那这个 bot 并不适合；假装它适合只会浪费你的时间。
这些数字从哪里来
每项分析都可以追溯到某个检测系统，而所有核心管理检测都在免费层运行：
- AI Spam Intelligence（贝叶斯风险 0.0–1.0，0.75 自动踢出）和 Spamfinder（阈值为 0–100% 的 ML 内容分类器）会生成垃圾信息计数，并为每个用户的风险分数提供数据。
- 覆盖照片、GIF、贴纸和头像的 NSFW 图片扫描会生成色情、性暗示和禁止媒体计数。
- 情绪与有毒内容检测（有毒、粗俗用语、侮辱、威胁）以及自定义禁词会生成这些违规类别。覆盖约 33–43 种语言的语言执行机制会生成语言违规。
- 链接处理（屏蔽
t.me/邀请链接，并通过 Google Safe Browsing 标记恶意 URL）会生成邀请链接和链接计数。
免费层每月包含 500 次图片扫描和 1,000 次情绪分析，并包含所有核心管理功能。付费方案（Gold $4.99/mo、Platinum $9.99/mo、Ultimate $49.99/mo，年付约八折）会提高这些配额；它们不会增加另一类不同的分析功能。垃圾信息数字背后的完整反垃圾信息体系可在 反垃圾信息保护 指南中了解。
常见问题
这是用于 Telegram 的增长分析 bot 吗？
不是。它是一个管理分析 bot。它的 telegram group analytics 衡量的是违规、执法和每个用户的垃圾信息风险。它不会报告消息量、活跃时段、成员增长或互动情况。如果你想要订阅者和活动仪表盘，这个 bot 不是为此而构建的。
单个用户报告究竟能告诉我什么？
每份报告都会提供一个垃圾信息风险分数（0.0–1.0）、该用户过往检测的置信度统计、他们最常见的违规类型和原因，以及带时间戳的完整违规历史，并包含每次违规的置信度水平。这足以让你在采取行动前判断某个账号是屡犯者，还是一次性的误报。
处罚动态有多实时？
它通过 WebSocket 流式传输，并显示 bot 所保护的所有群组中最近 20 条管理操作；每条都包含用户、违规类型、原因、置信度和时间戳。新的处罚会在发生时出现。
公开垃圾信息评分 API 是做什么用的？
它会通过 Telegram ID 返回任意用户的垃圾信息评分，让外部工具可以复用这项评估。例如，你可以通过自己的 bot 或表单，在新成员加入前对照垃圾信息数据库进行筛查。它会参考该账号的历史记录以及交叉验证的外部垃圾信息数据库。
我需要付费方案才能查看分析数据吗？
不需要。核心管理及其分析运行在免费层，免费层每月包含 500 次图片扫描和 1,000 次情绪分析。付费方案（Gold、Platinum、Ultimate；年付约八折）提高的是扫描配额，而不是把单独的分析产品作为付费门槛。
bot 会统计消息或追踪谁最活跃吗？
不会。唯一的消息数字是用于缩放违规率的总数（每 1,000 条消息的处罚次数）。它没有按成员的活跃排名，没有活跃时段图表，也没有作为功能提供的互动评分。
开始使用
如果你想要的正是管理分析（违规趋势、垃圾信息风险报告、实时执法动态，以及可查询的垃圾信息评分），请先将 bot 添加到一个群组。只要它在群组中且你是管理员，仪表盘就会可用。如何将 Bot 添加到你的群组 指南会带你完成操作，或者从 Telegram Bot App 主页 开始。