Telegram 批量号码检测：如何检测大型列表的注册状态
了解如何运行 Telegram 批量号码检测：准备 TXT 或 CSV 文件，选择国家/地区，提交 tg_batch 任务，适度轮询并读取 result.csv。
本指南分步介绍了如何通过异步 tg_batch 任务检测大型电话号码列表的 Telegram 注册状态，内容涵盖从文件准备到读取 result.csv 的全过程。
Telegram 批量号码检测是一项异步任务：您需要上传一个每行包含一个电话号码的 TXT 或 CSV 文件，选择国家/地区和 tg_batch 服务，等待任务完成，然后下载一个 result.csv 文件。该服务会告知您每个号码在检测时是否已注册 Telegram，这有助于团队决定在 Telegram 外联列表中保留哪些记录。Telegram 官方不提供批量查询功能，因此大型列表需要专门的检测服务，而不是简单的粘贴式批量处理。
何时适合使用批量任务
实时检测会在同一会话中返回结果，适用于单个号码或少量粘贴的号码。当列表规模远超单次请求的承载能力时，异步任务是更合适的选择：您提交文件，系统在后台处理，随后您再获取输出结果。
| 情况 | 更合适的方案 |
|---|---|
| 在表单提交或支持聊天期间检测一个号码 | 实时单号检测 |
| 在屏幕上查看简短的粘贴列表 | 仪表板或批量接口中的实时批量检测 |
| 完整的 CRM 导出文件或购买的潜在客户文件 | 使用 tg_batch 的异步批量任务 |
每种路径的产品限制均列在当前的 API 文档中，因此在规划大规模运行前请务必查阅。
为 Telegram 批量号码检测准备文件
大多数任务失败或被拒绝的原因都源于输入文件。在上传之前，请注意：
- 使用每行包含一个电话号码的纯文本 TXT 或 CSV 文件。不支持 XLSX 等电子表格格式，请先导出为 CSV。
- 每个号码都必须包含国际国家代码。
- 为任务选择一个国家/地区。电话号码批量任务是基于单一选定国家/地区构建的，如果文件中包含大量其他国家代码的号码，可能会被拒绝。请按国家/地区拆分混合列表，并为每个国家/地区提交一个任务。
- 删除明显的重复项和空行，以免重复支付检测费用。
- 请勿在文件中包含中国大陆、香港和澳门的号码：异步批量任务不覆盖这些地区。
如果不确定格式，请在规范化列表之前阅读关于 ITU-T Recommendation E.164 电话号码格式的指南。
提交 tg_batch 任务并等待
仅针对注册状态的批量服务称为 tg_batch。在仪表板中，您可以选择“批量检测”选项，上传文件并选择国家/地区和服务。通过 API，可以使用 POST /api/v1/bulk-tasks 创建任务，并使用 GET /api/v1/bulk-tasks/{id} 读取其状态。
规划时应考虑以下三种行为：
- 提交时预扣余额。 平台会预先扣除整个文件的余额，针对返回结果的条目进行收费，并在任务完成时释放未使用的预扣余额。如果任务失败，将释放全部预扣余额。
- 没有单号进度报告。 任务仅报告处理中、成功或失败，因此请围绕这三种状态构建工作流，而不是依赖进度条。
- 适度轮询。 检查任务状态的频率不要超过每 30 秒一次。过快轮询会增加负载，且不会更快获得结果。
完成时间取决于文件内容，因此请避免向利益相关者承诺固定的周转时间。
读取 result.csv 并采取行动
任务完成后，您将获得一个可下载的 result.csv 文件。对于 tg_batch，该文件包含提交的号码以及显示其是否已注册的列。请将该列视为检测时的 Telegram 账户存在信号。
一种实用的使用方式：
- 已注册： 保留在外联列表的 Telegram 分组中。
- 未注册： 路由到其他渠道或从 Telegram 活动中剔除。
- 缺失或空行： 在稍后的较小任务中重新提交，或手动审查。
注册状态并不代表用户处于活跃状态、号码属于您预期的联系人，也不代表他们同意接收消息。如果您还需要近似的活跃度信号，可以使用另一种批量服务 tg_active_batch，它会返回额外的列；请保持每种服务输出的独立性，不要假设每个文件都包含相同的列。
大型列表检测中的常见错误
- 上传混合国家/地区的文件，并试图通过被拒绝来了解规则。
- 在去重之前提交，这会增加预扣余额。
- 在循环中每隔几秒轮询一次。
- 将注册状态视为同意或身份证明。
- 为了修复几行数据而重新运行整个文件，而不是仅提交剩余部分。
有关账单详情，请参阅 当前定价页面 和 API 文档，不要依赖文章中引用的数字。
常见问题解答
团队可以在没有 Telegram 账户的情况下检测 Telegram 列表吗？
可以。团队通过仪表板或 REST API 将文件提交给检测服务并下载 result.csv，因此检测过程无需个人 Telegram 登录。
团队如何处理包含多个国家的列表？
请按国家/地区拆分文件，并为每个国家/地区提交一个 tg_batch 任务，因为电话号码批量任务是与选定的国家/地区绑定的。
批量任务的余额是如何运作的？
余额在提交任务时预扣，针对返回结果的条目收费，并释放未使用的剩余部分。失败的任务会释放其全部预扣余额。
已注册的结果是否意味着联系人会回复？
不。
了解更多
选择符合您工作流下一步的产品信息。