You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

调用WhatsApp Cloud API发消息报账户不存在错误如何解决

触发原因
  • 错误子代码2593006是WhatsApp Cloud API的专属报错,核心原因是你请求路径里填的发送方号码ID(107858631967863),还没有在Meta官方托管的WhatsApp服务集群里完成注册激活,平台侧查不到这个号码对应的有效发信账户,所以直接拒绝了发消息请求。
  • 绝大多数出现这个问题的场景,都是用户在Meta商务管理平台刚创建完WhatsApp商业账户、拿到号码ID,跳过了号码注册步骤就直接调用消息发送接口。
  • 注意只有Meta官方托管的Cloud API需要走这个注册流程,如果你是自己服务器部署的On-Premise版WhatsApp Business API,不会触发这个报错,出现这个提示说明你应该用Cloud API的流程走配置,不要混用本地部署的接入文档。
解决步骤
  1. 先校验你使用的访问凭证(Access Token)有效性:需要是Meta商务管理平台下系统用户生成的Token,已经绑定对应WhatsApp账户,且开通了whatsapp_business_messaging权限,个人账号生成的Token没有注册接口的调用权限。
  2. 调用注册接口完成号码激活:
    • 请求方法: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账户管理页申请重置。

  3. 注册接口返回200状态码、空响应体,就代表注册请求提交成功。
  4. 等待1~5分钟让平台侧配置全局同步,之后再重新调用你之前的消息发送接口,就可以正常发出hello_world模板消息了。
常见踩坑提示
  • 注册接口调用如果返回权限错误,不要反复重试,先回到商务管理平台检查对应系统用户的权限,必须给系统用户分配目标WhatsApp账户的「管理员」或「开发者」权限,才能调用注册接口。
  • 刚注册完成的号码不要立刻高频发请求,同步未完成时可能出现偶发报错,等几分钟重试即可。
  • 测试号也需要走这个注册流程,哪怕是平台默认提供的测试号码,第一次用之前也要先调用一次register接口激活。

内容的提问来源于stack exchange,提问作者Sooraj Bathery

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 05:48:28