heyoo无法发送消息求助:调用API无报错但未收到消息
可能的原因及排查方向
- 模板消息限制:WhatsApp Cloud API对消息发送有严格规则。正式环境下,发送给未主动发起对话的用户必须使用已审核通过的消息模板;沙盒测试阶段,仅添加到「测试号码列表」的联系人才能接收普通非模板消息。你的代码发送的是普通文本,若接收方不在测试列表或未触发对话,消息会被拦截。
- 号码有效性问题:尽管API返回了
wa_id,仍需确认接收号码格式是否正确(必须包含完整国家码,无空格/特殊符号),以及该号码是否真实注册并正常使用WhatsApp。 - 消息状态未实际送达:API返回的响应仅代表消息已提交到Meta服务器,不代表已成功送达接收方。需配置Webhook监听
message_delivered或message_read事件,才能确认消息的最终状态。 - 账号权限/模式问题:检查你的WhatsApp Business账号是否处于沙盒模式,或是否有足够权限发送消息到目标号码。沙盒模式下仅允许向测试号码发送消息。
- 接收方端问题:接收方可能开启了免打扰、屏蔽了你的发送号码,或者设备网络异常导致消息未被推送。
内容的提问来源于stack exchange,提问作者gtomer
相关产品推荐
相关产品推荐

