修复“电话号码必须为 E.164 格式”错误
在提交 Telegram 注册检测前，请修复缺失的国家代码、加号及国内拨号前缀。
在提交 Telegram 注册检测前，请修复缺失的国家代码、加号及国内拨号前缀。
出现“电话号码必须为 E.164 格式”错误，意味着在进行 Telegram 注册检测前，提交的数值需要转换为国际电话号码格式。请以正确的国家代码和国内号码开头，添加前导加号，并移除显示用的标点符号以及任何不属于国际格式的国内拨号前缀。在重新提交之前，请根据原始记录验证转换后的数值；语法整洁但错误的号码依然是错误的输入。
E.164 要求检查的内容
E.164 是由国际电信联盟发布的国际编号计划。在日常应用输入中，其常见的表现形式以加号开头，后接国家代码和国内有效号码。加号代表国际拨号环境；空格、括号和连字符可能有助于阅读，但它们不是检测 API 所期望的紧凑数值的一部分。
格式错误发生在得出有意义的注册结果之前。它不应被记录为“在 Telegram 上未注册”。TG Validator 的实时单号码 Telegram 注册检测要求提交的电话号码必须符合 E.164 格式。一旦输入被接受，得出的结果将涉及该提交号码在检测时的 Telegram 账户状态。格式检查本身并不说明账户是否存在、身份、所有权或联系许可。
请结合原始来源数值和已知的国家信息。不要仅根据不完整号码的前几位数字或联系人地址中的国家来猜测国家代码。国内号码只有在具备编号背景时才有意义。当国家未知时，请保留该记录以进行数据审查，而不是盲目地创建一个看起来合理的国际号码。
诊断最常见的输入错误
首先检查发送给检测接口的准确字符串，而不仅仅是电子表格的显示方式。当字段被存储为数字时，经常会丢失前导加号。从人类可读的联系人卡片中复制的空格、括号和连字符也是常见问题。一些来源保留了国内长途前缀，在添加国家代码后应将其删除。其他来源已经包含了国家代码，因此再次添加会导致重复。
| 症状 | 可能的数据问题 | 审查操作 |
|---|---|---|
| 缺少前导加号 | 国内格式或被剥离的国际数值 | 确认国家，然后构建国际格式 |
| 包含括号或分隔符 | 将人类显示格式复制到 API 输入中 | 从提交的数值中移除显示字符 |
| 国家代码后出现多余的零 | 保留了国内拨号前缀 | 应用特定国家的国际拨号规则 |
| 重复的国家代码 | 在已是国际格式的号码上再次添加代码 | 与来源对比并移除重复项 |
| 数字位数异常 | 丢失数字、分机号或国家错误 | 重新检查原始记录和特定国家的编号计划 |
Twilio E.164 错误指南展示了对相同紧凑格式的常见服务侧要求。它并不定义 TG Validator 的注册结果。对于特定国家的转换，请参考权威的编号指南；通用的“移除所有零”规则是不安全的，因为零可能是国内有效号码的一部分。
在受控序列中进行标准化
首先将原始数值保存在单独的字段中。其次，从原始记录中分配一个可信的国家或编号区域。第三，仅剥离空格、连字符和括号等显示字符；不要仅仅因为数字看起来不寻常就将其丢弃。第四，确定该数值是否已经包含加号和国家代码。第五，如果是国内格式，应用相关的国内转国际规则，包括是否必须移除长途前缀。最后，检查输出是否以一个加号开头，包含预期的数字，且提交的数值中没有嵌入分机号。
例如，英国国内格式的号码在拨号时可能带有前导 0。在国际表示法中，英国国家代码为 +44，且该国内长途 0 通常会被删除。转换必须基于已验证的英国号码；这不是所有国家的通用规则。ITU 对国内长途前缀的定义解释了为什么国内拨号字符串和国际号码可能不同。请将原始数值和转换后的数值并排存放，以便审查人员能够发现意外的数字丢失。
不要仅将 Regex 匹配作为最终的质量关卡。Regex 可以捕获明显的标点符号或缺失的加号，但它无法确定国家是否正确，也无法确定是否正确应用了当地的编号规则。具备国家感知能力的解析器可以提供帮助，但在国家或所有权信息不确定时，团队的原始数据仍需要审查。
检查电子表格或 CRM 的实际存储内容
当列被视为数值类型时，Excel 和类似工具可能会静默更改电话号码。Microsoft 建议在输入前将单元格格式设置为文本，因为电话号码是标识符，而不是用于算术的量。视觉上正确的自定义格式可能只会改变显示效果，而保留不同的底层数值。如果单元格变为文本前丢失了前导数字，事后更改格式将无法恢复它。
在发送批量任务前，导出一小部分样本，并在纯文本查看器中检查原始 TXT 或 CSV 文件。确认第一行和最后一行、包含国内前缀的条目以及一些国际条目。计算这些样本中原始数值和转换后数值的位数。如果某行包含分机号，请将其保存在单独的 CRM 字段中；它不是 Telegram 注册检测所提交的电话号码。
如果来源是表单，请在可行时将国家和电话号码收集在不同且经过验证的字段中。如果是旧列表，请标记不确定的行进行审查，而不是应用可能导致数千个号码被错误转换的广泛转换。当列表中包含多个国家时，这一点尤为重要。
修复输入后重新提交正确的工作流
对于单个记录，请在标准化后使用 TG Validator 仪表板的“单号码检测”或其实时 REST 注册检测。REST 单号码检测是记录在案的 POST /api/v1/check 路径。已决定的检测会在同一请求会话中返回注册结果。未决定的检测是带有非零业务代码的独立结果；它不应被重新分类为格式错误或负面的注册结果。
对于小规模集合，实时批量路由可以通过 API 检测最多 100 个号码，仪表板的“实时批量检测”最多可接受 500 个粘贴的号码。规模更大的准备列表遵循单独的异步批量文件工作流，支持 TXT 或 CSV 输入、任务监控和结果下载。在选择路由或编码请求细节前，请查阅最新的 TG Validator API 文档。这些工作流各不相同，但每一种都受益于相同的原始数值保留标准化过程。
更正后，请记录哪些记录发生了更改以及原因。如果之前的检测使用了错误的号码，请勿编辑该历史结果，就好像它指的是更正后的号码一样。请对更正后的数值运行新的检测，并保留清晰的审计追踪。目标是获得关于预期号码的结果，而不仅仅是消除输入错误。
常见问题解答
团队如何修复 E.164 错误中缺失的加号？
确认原始号码和国家，然后构建带有前导加号和正确国家代码的国际数值。不要对不确定的记录添加猜测的代码。
团队应该移除电话号码中的所有前导零吗？
不应该。请应用特定国家的编号规则。国内长途前缀在国际拨号时可以省略，但其他零可能是有效的数字。
标准化后仍然失败的记录应该如何处理？
保留原始数值和转换后的数值，检查国家和原始数据，并将记录路由以进行审查。格式失败并不是 Telegram 注册结果。
了解更多
选择符合您工作流下一步的产品信息。