输入指南
如何将手机号规范为 E.164 格式
E.164 是 WA Lookup 请求使用的国际手机号格式。规范后的号码以 + 开头,包含国家或地区调用代码,之后只有数字,不包含空格、括号、连字符或仅供国内拨号使用的长途冠码。
审核日期:2026 年 7 月 21 日
有效的 E.164 输入是什么样?
使用 +、国家或地区调用代码和用户号码,且不包含空格或标点,例如 +14155552671。不要在未处理的本地号码前直接添加国家代码;应先按照该国家的编号规则移除展示符号和仅供国内使用的长途冠码。
验证前先单独完成号码规范化
保留原始输入用于审计,再生成一个统一值用于去重和 API 请求。
- 1
确定国家或地区
优先使用可信的国家字段或用户明确选择;来源包含多个国家时,不要只凭本地号码猜测。
- 2
移除展示符号
删除空格、连字符、括号和点号,这些符号只用于阅读。
- 3
应用当地编号规则
仅在该国家国际格式规则要求时移除国内长途冠码。
- 4
添加 + 与调用代码
生成唯一规范值,并在发起检测前完成格式校验。
常见输入与修正示例
正确转换依赖国家上下文;以下仅展示常见模式,不能替代持续更新的号码规则库。
| 原始输入 | 规范示例 | 原因 |
|---|---|---|
| +1 (415) 555-2671 | +14155552671 | 保留调用代码 1,移除展示标点。 |
| 415-555-2671,国家=US | +14155552671 | 先使用明确国家上下文,再添加调用代码。 |
| 0044 20 7946 0958 | +442079460958 | 把国际接入前缀 00 转换为 +。 |
| +44 (0)20 7946 0958 | +442079460958 | 国际格式不保留括号中的国内长途冠码 0。 |
| 14155552671 | 需要国家上下文 | 没有 + 的纯数字号码在未约定国家时存在歧义。 |
格式正确不代表号码已分配、可联系或已注册 WhatsApp。
拒绝有歧义的转换
规范化应统一已知信息,而不是补造缺失的国家或编号上下文。
- 没有国家规则时,不要随意删除开头数字。
- 不要认为 +、00 和本地开头的 0 在所有国家都能直接互换。
- 多个记录规范为同一个号码时应合并识别,但保留每条来源记录。
- 格式校验成功只表示可以检测,不表示 WhatsApp 注册成功。
API 输入检查清单
请求前确认号码具有唯一规范形式,并能追溯回原始数据。
- 号码以 + 开头,之后只有数字。
- 调用代码来自明确或可靠的国家上下文。
- 本地号码已按对应国家规则转换。
- 去重使用规范后的号码。
- 原始输入仍可用于纠错与审计。