注册并联系客服，免费领取 100 次检测。免费注册
TG Validator

Telegram 用户 ID 检查器：获取手机号或用户名列表的 uid 值

面向列表的 Telegram ID 检查器：了解哪些 TG Validator 批量服务会返回 uid 列，如何将其用作稳定键，以及它无法提供哪些信息。

TG Validator 编辑团队发布于 2026年10月22日6 分钟阅读
TG Validator 工作流示意图：Telegram 用户 ID 检查器：获取手机号或用户名列表的 uid 值
本文所述工作流的示意图（TG Validator）。

三种 TG Validator 批量服务会返回一个 uid 列，团队可以将其作为稳定键与手机号或用户名一起存储。

Telegram 用户 ID 是 Telegram 在内部用于标识账户的数字键。大多数关于“telegram id checker”的建议都指向通过读取单条转发消息来获取该 ID 的查询机器人。对于整个列表，TG Validator 在三种异步批量服务中会返回 uid 列：针对手机号文件的 tg_active_batch 和 tg_profile_batch，以及针对用户名文件的 tg_username_profile_batch。uid 可作为去重和核对您自身记录的稳定键。

什么是 Telegram 用户 ID 以及常见建议的来源

每个 Telegram 账户都有一个数字用户 ID。与所有者可以更改或删除的用户名不同，该数字始终附属于账户，这就是开发人员和 CRM 管理员喜欢存储它的原因。

关于“查找 telegram 用户 ID”的常见搜索建议分为三类：

  • 查询机器人。 您在 Telegram 内转发一条消息或打开一个个人资料，机器人会回复该数字。这适用于您已经在交谈的某个人。
  • 自托管脚本。 开源项目（例如 Telegram ID Finder Bot）运行您自己托管的机器人，并报告用户、群组和频道的 ID。
  • 手机号脚本。 类似于 Bellingcat 的 telegram-phone-number-checker 这类工具使用您自己的 Telegram API 凭据来查询号码，并在账户允许的情况下返回用户名和 ID。

这三者都是围绕着键盘前的个人或在个人 Telegram 账户下运行代码的开发人员构建的。它们都不是列表工作流：您无法将几千行数据交给它们并按顺序接收一个包含结果的文件。

哪些 TG Validator 服务返回 uid

面向列表的检查存在于批量服务中。五个异步类型中的三个包含 uid 列：

服务 输入文件 是否返回 uid 其他列
tg_batch 手机号 否 仅注册状态
tg_active_batch 手机号 是 注册状态、用户名、活跃天数
tg_profile_batch 手机号 是 注册状态、用户名、活跃天数、头像 URL 及基于头像的估算值
tg_username_batch 用户名 否 仅账户存在状态
tg_username_profile_batch 用户名 是 存在状态、活跃天数、头像 URL

实时 tg 服务（由单号码 API 检查和仪表板实时选项卡使用）仅报告注册状态，不返回 uid。如果您需要该键，请将列表移至批量任务中。

服务无法报告的行在文件中会保留其位置，可选列为空。请规划您的导入，使空的 uid 成为正常行，而非失败行。

分步获取列表的 uid

  1. 选择与您的输入相匹配的服务。 手机号使用 tg_active_batch 或 tg_profile_batch；用户名使用 tg_username_profile_batch。仅在您还需要基于头像的估算值时才选择 tg_profile_batch，因为较轻量的 tg_active_batch 已经返回了 uid。
  2. 准备文件。 使用 TXT 或 CSV 格式，每行一个条目。对于手机号，请使用国际格式，并将文件保持为基本属于同一个国家/地区，因为手机号批量任务需要一个国家/地区，且包含大量其他国家/地区代码的文件会被拒绝。批量任务不支持中国大陆、香港和澳门的号码。用户名不需要国家/地区，可以包含或省略 @。
  3. 提交任务。 通过仪表板的“批量检查”区域或 POST /api/v1/bulk-tasks 提交，使用您的 X-API-Key 标头进行身份验证，切勿将真实密钥粘贴到共享文档中。
  4. 轮询完成状态。 使用 GET /api/v1/bulk-tasks/{id}，轮询频率不得超过每 30 秒一次。状态为 processing（处理中）、success（成功）或 failed（失败）。
  5. 下载 result.csv。 并将其与您的源列表在标识符列上进行连接，该列会回显每个原始条目。

任务余额在提交时预留，对返回结果的条目进行扣费，未使用的预留额在完成时释放。失败的任务会释放其全部预留额。请查看当前的定价页面和 API 文档，了解适用于您所选服务的费率和每任务限制。

将 uid 用作稳定键

一旦该列进入您的 CRM 或仓库，uid 有助于数据清理，而不是用于了解有关个人的任何信息。

跨来源去重。 同一个账户可能以表单中的手机号、社区导出的用户名以及重命名后的用户名等多种形式出现。如果两行返回相同的 uid，则它们指向同一个账户，您可以将它们合并为一条记录。

应对用户名更改。 将 uid 存储在您收集的用户名旁边。当句柄稍后更改时，您仍然可以通过 uid 匹配记录，而不是创建重复项。

创建用于导出的连接列。 许多内部工具处理数字键的效果优于自由文本句柄。uid 列使在联系人表和营销活动表之间建立连接变得更加容易。

将其与身份字段分开。 不要将 uid 存储在标记为“已验证用户”的字段中，也不要用它来声称您知道联系人是谁。它是一个技术键，其背后的注册信号仅描述了检查时的账户存在状态。

简短的治理说明：提前决定谁可以看到该列、您保留它多久，以及您的隐私声明是否涵盖它。这些选择属于您的团队和您的管辖范围，而不属于检查器。

uid 无法为您提供什么

该列的工作范围很窄，限制有助于您避免在使用方式上犯错。

  • 除非相同的文件服务已经报告了它，否则它不会从用户名中揭示手机号，反之亦然。
  • 它不会暴露私人聊天、群组成员身份或联系人列表。
  • 它不会显示谁在线。批量结果中出现的活跃天数（activedays）是自上次活动以来的近似天数，并非实时在线状态。
  • tg_profile_batch 中基于头像的年龄、性别和肤色值是根据图片生成的估算值，而非关于个人的已验证事实。

如果您需要在与某人聊天时在 Telegram 内查找单个 ID，查询机器人更简单。如果您需要在数千行数据中保持一致的键，批量服务为您提供了一个文件和一个可记录的流程。

常见问题解答

哪些 TG Validator 服务返回 uid？

tg_active_batch 和 tg_profile_batch 为手机号文件返回 uid，tg_username_profile_batch 为用户名文件返回 uid。实时 tg 服务以及 tg_batch 和 tg_username_batch 不包含 uid。

团队如何在 CRM 中使用 uid？

团队将其存储在手机号或用户名旁边作为稳定键。它有助于合并重复记录并在用户名更改后保持匹配。

可以在没有手机号的情况下为用户名列表找到 uid 吗？

可以。tg_username_profile_batch 接受用户名（带或不带 @），不需要国家/地区，并返回 uid 以及活跃天数和头像 URL。

团队应如何处理空的 uid 单元格？

将空单元格视为可选列的正常结果。保留该行，根据您自己的审查规则对其进行标记，并避免将其视为导入失败。

实时检查会返回 uid 吗？

不会。实时 tg 服务仅返回 E.164 号码的注册状态。当需要 uid 时，请将列表移至批量服务。

了解更多

选择符合您工作流下一步的产品信息。

参考来源