批量结果中 Telegram 活跃天数的含义
了解 TG Validator 批量结果中 activedays 数值的含义、其近似原因，以及团队如何利用该数值对联系人列表进行优先级排序。
本文详细解释了 Telegram 批量检测结果中 activedays 数值的实际含义，以及如何将其作为优先级排序的信号。
Telegram 活跃天数（在部分批量结果中以 activedays 返回）是指账号自上次活跃以来经过的天数。由于 Telegram 并不总是公开确切的“最后在线时间”，因此该数值可能为近似值。团队使用该数值将已注册号码分为较活跃和较沉寂的组别，而非用于确认某人当前是否在线或是否会回复。
activedays 数值代表什么
在 TG Validator 中，activedays 属于批量活跃度与个人资料产品。它表示检测到的已注册账号自上次活跃以来的天数。数值较小表示近期活跃，数值较大则表示该账号已沉寂较长时间。
当 Telegram 隐藏了确切的最后在线时间时，该数值即为近似值。Telegram 官方帮助页面对此进行了解释：用户可以选择谁能看到其最后在线状态，而未被授权查看的用户只能看到“最近”、“一周内”、“一个月内”或“很久以前”等模糊范围（Telegram FAQ）。由于这种隐私模型模糊了底层信号，请将 activedays 视为一种粗略的排序输入，而非精确的时间戳。
以下两个边界条件有助于正确理解该数值：
- 它代表自上次活跃以来的天数，而非实时在线状态。
- 它不属于实时单号检测的一部分，实时检测仅返回 Telegram 注册状态。
哪些批量服务返回 activedays
活跃度数据来自特定的异步批量服务类型。请根据团队需要解决的问题选择相应的服务。
| 批量服务类型 | 输入 | 返回内容 |
|---|---|---|
| tg_batch | 电话号码 | 仅注册状态 |
| tg_active_batch | 电话号码 | 注册状态、uid、用户名和 activedays |
| tg_profile_batch | 电话号码 | 增加头像 URL 和基于头像的估算值 |
| tg_username_batch | 用户名 | 用户名对应的账号是否存在 |
| tg_username_profile_batch | 用户名 | 增加 uid、activedays 和头像 URL |
如果列表仅需区分是否已注册，使用 tg_batch 即可。如果团队还需要根据活跃程度对已注册联系人进行排序，请对电话号码使用 tg_active_batch，或对用户名使用 tg_username_profile_batch。result.csv 中的某些列取决于服务类型，对于特定行可能为空，因此请构建能够处理空值的下游逻辑。
如何在列表优先级排序中使用 activedays
最实用的模式是将原始数值转换为团队自定义的几个区间。下方的分界点仅为内部选择示例，而非产品规则。
- 近期活跃： 天数较小。将这些记录优先放入手动外呼队列。
- 中度沉寂： 中间范围。将其保留在普通队列中，并进行较轻度的触达。
- 长期不活跃： 天数较大。将其移至低优先级或重新激活列表。
- 空值： 保留记录，标记为未知，避免将其视为不活跃。
由于数值可能是近似的，宽泛的区间比严格的阈值效果更好。将 3 天和 4 天区分开来会暗示数据本身不具备的精确度。建议按周或月进行分组，并在应用于完整列表前先查看样本的分布情况。
此外，请将注册结果与活跃度分开处理。未注册的号码无需排序，因此应将其从活跃度分析中移除，并通过常规联系人数据工作流进行处理。
读取活跃度数据时的常见错误
大多数问题源于对该数值的期望超出了其能力范围。
- 将其解读为在线状态。 数值较小并不意味着该人现在在线或会回复消息。
- 将其解读为身份证明。
activedays和注册状态都无法确认账号的所有者是谁，也无法确认对方是否同意被联系。请通过您自己的流程处理合规性。 - 将空值视为零。 空单元格意味着该行未返回此数值。
- 与实时检测进行对比。 实时 Telegram 注册检测仅返回注册状态，因此不要在其中寻找活跃度信息。
- 过度设计阈值。 由于数值可能是近似的，简单的区间更易于维护和解释。
个人资料产品增加了基于头像的年龄、性别和肤色估算。
有关适用于批量任务的计费和使用规则，请阅读 当前定价页面 和 API 文档，不要依赖复制到其他文档中的数据。
从上传到决策的简单工作流
首先清理列表，确保 TXT 或 CSV 文件中的每一行包含一个电话号码或一个用户名。电话号码任务需要一个国家/地区代码及国际电话区号，而用户名任务无需国家/地区信息，且接受带或不带 @ 符号的名称。通过仪表板或批量任务端点提交文件，轮询任务的频率不超过每 30 秒一次，并在任务报告成功后下载 result.csv。
在电子表格或脚本中，首先筛选出已注册的行，然后按 activedays 区间进行分组。比较各组的大小，决定哪些组值得人工关注，并记录您的选择，以便后续列表能得到一致处理。通过这种方式，activedays 有助于为优先级排序提供参考，同时让所有使用结果的人都能清楚该信号的局限性。
常见问题解答
activedays 等同于当前在线吗？
不等同。它是已注册账号自上次活跃以来的天数，且可能为近似值。它不是实时在线状态指标。
哪些批量服务包含 activedays？
tg_active_batch 为电话号码返回该数值，tg_username_profile_batch 为用户名返回该数值。tg_batch 仅返回注册状态。
团队如何处理 activedays 为空的行？
保留该行，将活跃度标记为未知，并依赖注册结果。避免将空值视为不活跃的证据。
为什么 activedays 可能是近似值？
Telegram 允许每个用户限制谁能看到其确切的最后在线时间，因此底层信号可能是一个粗略的范围。请将记录归入宽泛的区间，而不是使用严格的阈值。
了解更多
选择符合您工作流下一步的产品信息。