调用WhatsApp Cloud API发消息报账户不存在错误如何解决
触发原因
- 错误子代码2593006是WhatsApp Cloud API的专属报错,核心原因是你请求路径里填的发送方号码ID(
107858631967863),还没有在Meta官方托管的WhatsApp服务集群里完成注册激活,平台侧查不到这个号码对应的有效发信账户,所以直接拒绝了发消息请求。 - 绝大多数出现这个问题的场景,都是用户在Meta商务管理平台刚创建完WhatsApp商业账户、拿到号码ID,跳过了号码注册步骤就直接调用消息发送接口。
- 注意只有Meta官方托管的Cloud API需要走这个注册流程,如果你是自己服务器部署的On-Premise版WhatsApp Business API,不会触发这个报错,出现这个提示说明你应该用Cloud API的流程走配置,不要混用本地部署的接入文档。
解决步骤
- 先校验你使用的访问凭证(Access Token)有效性:需要是Meta商务管理平台下系统用户生成的Token,已经绑定对应WhatsApp账户,且开通了
whatsapp_business_messaging权限,个人账号生成的Token没有注册接口的调用权限。 - 调用注册接口完成号码激活:
- 请求方法:
POST - 请求地址:
https://graph.facebook.com/v13.0/<你的发送方号码ID>/register,这里的号码ID就是你之前发消息用的107858631967863 - 请求头添加:
Authorization: Bearer <你的有效Access Token>,Content-Type: application/json - 请求体参考:
{ "messaging_product": "whatsapp", "pin": "6位数字的号码验证PIN" }这个PIN是你在商务平台提交WhatsApp号码入驻时设置的验证码,如果是新申请号码,PIN会通过短信/语音发送到你绑定的手机号上;如果遗忘PIN,可以在商务管理平台的WhatsApp账户管理页申请重置。
- 请求方法:
- 注册接口返回200状态码、空响应体,就代表注册请求提交成功。
- 等待1~5分钟让平台侧配置全局同步,之后再重新调用你之前的消息发送接口,就可以正常发出hello_world模板消息了。
常见踩坑提示
- 注册接口调用如果返回权限错误,不要反复重试,先回到商务管理平台检查对应系统用户的权限,必须给系统用户分配目标WhatsApp账户的「管理员」或「开发者」权限,才能调用注册接口。
- 刚注册完成的号码不要立刻高频发请求,同步未完成时可能出现偶发报错,等几分钟重试即可。
- 测试号也需要走这个注册流程,哪怕是平台默认提供的测试号码,第一次用之前也要先调用一次register接口激活。
内容的提问来源于stack exchange,提问作者Sooraj Bathery
相关产品推荐
相关产品推荐

