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

WhatsApp Cloud API报An unknown error occurred及注册失败问题求助

问题原因

你遇到的两个报错是直接的因果关系,核心是测试WhatsApp Business Account(WABA)未通过Meta的基础合规校验,导致底层消息发送账号未在托管服务中激活:

  • 调用messages端点返回的子错误码2593006(Account Not Exist)是表层结果:当前访问令牌对应的发送账号未在服务端完成注册,自然无法调用消息发送能力
  • 调用/register端点返回的政策不满足提示是核心根因:即便是平台提供的测试WABA、测试号码,也需要通过最基础的WhatsApp商业政策准入校验,并非创建应用后就自动可用。
排查解决步骤
  • 第一步:先核对后台基础状态
    进入Meta开发者平台对应应用的WhatsApp配置页,首先确认应用本身没有处于开发受限状态、后台通知栏没有未处理的违规提醒;再进入测试号码页面,确认选中的测试号码没有被标记为异常。如果你的Meta个人账号、之前创建过的其他WABA有过违规记录(比如发送垃圾营销内容、使用非官方客户端被封禁),会连带新创建的测试资源触发政策拦截。
  • 第二步:处理注册环节的政策拦截
    不要反复调用/register接口,频繁触发校验失败会临时加重账号限制。如果应用是刚创建的,先等待1-2小时:新应用的合规校验是异步执行的,刚创建完立刻调用接口会因为校验流程未完成误报不通过。
    如果等待后报错依旧,直接在Meta Business Suite后台提交支持工单,选择「WhatsApp Cloud API」-「账号注册激活」分类,附上报错里的fbtrace_id,说明你是使用测试WABA和测试号码做开发调试、无正式商用发送行为,申请人工解除测试账号的注册限制。测试账号的这类申诉通过率很高,一般1-2个工作日会有反馈。
  • 第三步:快速绕过方案
    如果不想等待申诉,可以在同一个开发者账号下新建一个全新应用,重新开通WhatsApp Cloud API能力领取新的测试号码。新应用创建后不要立刻调用/register接口,先在测试号码配置页把你要接收测试消息的号码加到白名单,等页面显示测试号码状态为「活跃」后,直接用控制台生成的默认测试访问令牌调用messages接口即可——测试场景下不需要手动调用注册接口,系统会在你首次通过控制台发送测试消息时自动完成账号注册。

注意:测试号码仅能向提前加入白名单的号码发送消息,不要尝试给非白名单号码发内容,否则会立刻触发风控拦截。

内容的提问来源于stack exchange,提问作者Sören Etler

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.27 04:45:37