E.164手机号格式：转换与校验方法

为什么短信和WhatsApp API需要E.164？

因为路由取决于无歧义的号码。没有国家代码的号码可能属于许多国家，平台就可能发往错误的市场、套用错误的发件人ID规则并按错误的费率计费。费率、发件人ID注册和营销发送时段都是按目的地国家应用的，而国家代码就是识别目的地的方式。

Meta对WhatsApp号码有什么说明？

Meta关于WhatsApp用户手机号格式的文档称，发送消息请求支持加号、连字符、括号和空格，并强烈建议包含加号和国家拨号代码。如果缺少加号，发送方的国家拨号代码会被加到号码前，可能导致消息发到错误的号码。Meta的示例：对于印度（代码91）的发送方，(631) 555-1234会被投递到+916315551234，而+1 (631) 555-1234则能正确投递。Meta还指出，对于巴西和墨西哥，Cloud API可能修改某些号码中出现的额外前缀，并称这是标准行为。

稳妥的做法是：保存干净的E.164，并原样发送。

短信呢？

短信API同样期望完整的国际号码。有些要求不带加号的数字；格式因API和协议而异，所以请查看您所用API的文档，并用自己的号码测试。工作示例请参阅通过API发送短信和通过API发送WhatsApp消息。

如何在代码中校验并规范化号码？

用正则表达式做快速的形态检查，用号码库做真正的校验。

一个常见的E.164形态检查：

// Plus, a non-zero first digit, then 1 to 14 more digits: 15 digits at most
const E164 = /^\+[1-9]\d{1,14}$/;

function looksLikeE164(value) {
  return E164.test(value);
}

looksLikeE164("+971501234567"); // true
looksLikeE164("0501234567");    // false: no plus or country code
looksLikeE164("+0501234567");   // false: country codes do not start with 0

正则表达式只检查长度和字符。它会接受+99999999999，尽管并不存在这样的号码。要做真正的校验，请使用Google的开源libphonenumber，这是一个用于解析、格式化和校验国际电话号码的库，提供Java、C++和JavaScript版本，其他语言有社区移植版。它的README把isValidNumber描述为利用长度和前缀信息对某个地区进行的完整校验，并展示了如何把解析后的号码格式化为E.164。

# pip install phonenumbers  (a Python port of libphonenumber)
import phonenumbers

def to_e164(raw, default_region):
    try:
        number = phonenumbers.parse(raw, default_region)  # e.g. "AE", "SA", "GB"
    except phonenumbers.NumberParseException:
        return None
    if not phonenumbers.is_valid_number(number):
        return None
    return phonenumbers.format_number(number, phonenumbers.PhoneNumberFormat.E164)

print(to_e164("050 123 4567", "AE"))   # +971501234567 if the number is valid for the UAE
print(to_e164("+44 7700 900123", "GB"))

移植版由外部开发者编写，所以请检查您所选版本的质量。解析时使用取自客户所在国家的默认地区，然后保存E.164结果。同时保留原始输入，这样规则变化时可以重新解析。

请在录入环节规范化，也就是在注册表单、CRM导入或API中，而不是在发送时。同一个号码有两种写法，就会变成两个联系人，各自收到同一次活动。

如何修复电子表格中的手机号？

在输入或粘贴号码之前，把手机号列设为文本格式。常见问题如下：

Microsoft的文档说明，Excel会去掉前导零并把大数字转换为科学记数法，而在应用文本格式之前输入的号码必须重新输入。直接打开CSV文件时，Excel会对每一列应用默认格式，所以请使用文本导入向导或“从文本/CSV”，把手机号列标记为文本。

对于以050 123 4567形式存放在A列的阿联酋手机号列表，下面的公式会把E.164构建为文本：

="+971"&RIGHT(SUBSTITUTE(A2," ",""),9)

它在删除空格后保留最后九位数字，所以只适用于这种形态的号码。保存为CSV之前，请复制结果并粘贴为值。手机号格式化工具无需公式即可转换号码，我们的用Excel或CSV群发短信指南介绍了完整的上传流程。

示例：清理客户名单

“Souq Rafiq”（虚构）是迪拜的一家零售商，从三个系统导出了8,000个联系人，号码形如0501234567、971 50 123 4567、+971-50-123-4567和00971501234567。

1. 分析师根据每位客户的账单国家添加国家列。
2. 脚本以该国家为默认地区解析每一行，于是四种格式都变成+971501234567。
3. 校验未通过的行进入审核表，而不是被发送。
4. 规范化之后再去重，四种格式就合并成了一个联系人。
5. 活动前，用HLR查询标出不活跃的号码。请参阅HLR查询详解。
6. 干净的列存为文本并上传。

先规范化才使重复检查得以生效；在此之前，同一位客户看起来像四个人。

常见错误有哪些？

• **一律去掉开头的零。**有些国家（如意大利）没有长途前缀。
• **保留零又加上国家代码，**得到+9710501234567。
• **向WhatsApp发送时不带加号，**导致被加上发送方的国家代码。
• **把正则表达式当作校验。**它检查的是形态，而不是有效性。
• **让Excel把手机号当作数字，**丢失零或变成科学记数法。
• **在发送时才规范化，**而不是在录入时。
• **以为格式有效就意味着号码可达。**已携号转网或已停机的号码仍会失败。
• **相信静态表格。**编号方案会变化；请使用持续维护的号码库。

OmniChannels.ai如何提供帮助

OmniChannels.ai通过一个REST API接受用于短信和WhatsApp的国际号码，其营销活动支持Excel和CSV上传，并带有预览和重复项过滤。BroadNet提供HLR和号码查询，因此您可以核实格式正确的号码是否在用。请阅读短信API文档和WhatsApp API文档了解确切的请求字段，或就开通事宜联系我们的团队。