WhatsApp Business API调用/messages接口返回200但本人收不到测试消息
WhatsApp Business API向本人手机号发测试消息投递失败解决方案
核心问题原因
- HTTP 200返回但终端收不到消息、webhook报131000内部错误的核心诱因是测试手机号与当前WhatsApp Business(WABA)资产存在后台关联冲突:Meta测试环境有未公开的限制规则——如果目标手机号绑定了当前Meta企业账号的管理员/运营角色、曾注册过同主体下的WhatsApp Business个人号、或之前绑定过同企业下其他WABA资产,系统会直接拦截消息投递,接口层仅返回通用200成功状态,最终通过webhook抛出131000内部错误。同事手机号可正常收发,就是因为其号码未和当前企业资产产生过任何绑定关联,不受该规则限制。
/contacts接口提示whatsapp_business_api_data is required和token权限无关,本质是调用的API版本过旧:v14及更早版本的接口已逐步下线,未做兼容跳转才会返回不存在的参数要求,权限配置列表中本身就没有该选项,反复调整权限没有意义。- 添加本人手机号返回
Reason: VERIFIED无法重复添加,是因为该号码已经在Meta后台标记为和当前企业资产关联,前台删除操作不会同步清除后台关联标记,因此重复添加会触发校验拦截。 - 网传「测试前需要目标号码先给企业号发消息才能收信」是老版本地部署API的规则,当前云API版本已取消该限制,无需执行该操作,重装应用、重新绑定个人WhatsApp账号也不会解决后台关联的问题。
分步解决操作
- 清除关联标记
将你的手机号从当前Meta企业账号的所有人员角色列表中移除,同时进入业务设置的WhatsApp账号管理页,检查所有已关联号码条目,把你的手机号从所有关联项中彻底删除,操作完成后等待24小时待全局缓存同步。如果不想等待缓存同步,也可以直接注册一个全新的、和你个人Meta账号无任何绑定关系的企业账号重新配置WABA,可直接绕过关联限制。 - 修正API调用版本
所有接口请求的路径前缀统一替换为https://graph.facebook.com/v19.0/<你的PHONE_NUMBER_ID>/,禁止使用v14及更早版本的接口路径。调用/contacts接口校验号码时,请求体仅传以下内容即可,无需额外添加其他参数:{ "blocking": "wait", "contacts": ["+国家码+手机号"] } - 功能验证
缓存同步完成后,优先使用商业设置面板内置的测试消息发送功能向你的手机号发消息,不要一开始就用Postman构造请求,面板发送成功后再用接口调用验证。 - 人工兜底处理
如果以上操作完成后仍然返回131000错误,直接通过Meta商务支持中心提交工单,选择WhatsApp Cloud API分类下的消息投递失败问题,附上webhook收到的错误信息和对应请求的fbtrace_id,申请后台清除手机号的风控拦截标记即可,该类人工处理一般15分钟内即可生效。
内容的提问来源于stack exchange,提问作者jacobytes
相关产品推荐
相关产品推荐

