WhatsApp Webhook payload中wa_id非客户手机号的场景及技术问询

示例Webhook Payload #

"value": {
  "messaging_product": "whatsapp",
  "metadata": {
    "display_phone_number": "000000000",
    "phone_number_id": "00000000000000"
  },
  "contacts": [
    {
      "profile": {
        "name": "Test"
      },
      "wa_id": "300000000000"
    }
  ],
  "messages": [
    {
      "from": "300000000000",
      "id": "wamid.freferfrefrefrefrefregfrefrefrefer",
      "timestamp": "1695917563",
      "text": {
        "body": "Test"
      },
      "type": "text"
    }
  ]
}

根据Facebook开发者文档说明，Webhook payload中的wa_id（即上述payload内的wa_id与from字段）并非始终匹配客户手机号，针对此的技术疑问及解答如下：

疑问1：除手机号外，wa_id还可能是什么内容？对应哪些场景？测试账号中仅能获取到手机号。 #

• wa_id还可能是WhatsApp平台分配的字母数字唯一标识符，对应这些场景：
  • 客户使用的是WhatsApp企业版账号（非个人手机号注册的普通账号），这类账号的身份标识由平台统一分配，而非手机号
  • 客户开启了WhatsApp的隐私保护设置，或所在地区有严格隐私法规限制，平台会用替代ID返回以保护用户手机号隐私
  • 客户通过第三方内嵌的WhatsApp聊天插件/入口发起会话，这类场景下也会返回非手机号形式的wa_id

疑问2：若wa_id为非手机号内容（如字母数字标识符），能否通过该值获取客户的真实手机号？ #

• 不能。WhatsApp的隐私机制严格限制用户手机号的外露，除非客户主动在会话中提供手机号，或者你之前已经通过合规的业务流程获取并关联了该wa_id对应的手机号，否则无法通过这个标识符直接获取到客户的真实手机号。

内容的提问来源于stack exchange，提问作者Hopeless