WhatsApp嵌入式注册后Webhook配置及代发消息报错咨询

1. Webhook配置与消息客户识别 #

• 无需为每个客户配置独立Webhook，共用现有Webhook完全可行。
• 识别消息对应客户的核心方式：
  • Webhook事件payload中会携带phone_number_id和waba_id，这两个是客户WhatsApp账号的唯一稳定标识，你只需在CRM系统中提前将这两个ID与客户信息绑定，收到事件后通过匹配ID即可定位对应客户。
  • 部分事件包含from字段（客户手机号），但优先用phone_number_id，避免手机号变更导致的匹配错误。

2. 客户端配置操作说明 #

• 产品配置：作为ISV通过Embedded Signup流程接入的话，无需客户手动在Meta应用面板配置产品，你可通过ISV权限在后台自动为客户关联WhatsApp Business产品。
• 签名配置：消息签名需客户提供，但你可以在自己的集成界面中嵌入签名提交入口，引导客户完成后通过API提交到Meta后台，不需要客户直接操作Meta面板。
• Webhook配置：不需要客户手动配置，客户完成Embedded Signup后，你通过Meta API自动将其phone_number_id和waba_id关联到你的共用Webhook即可。

3. "The account is not registered" 错误排查 #

这个错误的常见原因及解决方向：

• 确认使用的phone_number_id对应的手机号已完成WhatsApp Business账号的注册与激活，Embedded Signup流程完成后需确保账号状态正常。
• 检查请求所用的access token是否属于该客户的waba_id，每个WABA的token独立，不能跨WABA复用。
• 验证你的应用已获得whatsapp_business_messaging权限，且该权限已关联到客户的WABA账号。
• 确认发送消息的API端点格式正确：https://graph.facebook.com/v<稳定版本号>/<phone_number_id>/messages，建议使用Meta当前支持的稳定版本（如v18.0）。

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