调用WhatsApp API发送音频返回成功，手机未收到音频问题求助

以下是针对你遇到的「上传媒体和发送接口均返回成功，但目标手机未收到音频」问题的排查步骤：

1. 确认接收号码格式与有效性 #

• 接收号码必须使用国际标准格式：以+开头，包含国家代码，无空格、括号或特殊字符（例如+8613xxxxxxxxx）
• 确保该号码已注册WhatsApp并处于正常使用状态，未被封禁或限制

2. 检查媒体文件合规性 #

• 验证本地音频文件完整性：直接播放/Users/2_1687628467.mp3，确认无损坏、能正常播放
• 核对WhatsApp API音频规范：
  • 支持格式：MP3、OGG（优先MP3）
  • 文件大小上限：16MB
  • 编码要求：标准MP3编码（避免非标准压缩或损坏的文件）

3. 核实环境权限与范围 #

• 若使用Sandbox测试环境：接收号码必须已添加到你的WhatsApp Business Platform沙箱联系人列表中，否则无法接收测试消息
• 若使用生产环境：确认消息发送在「24小时会话窗口」内（用户主动发起对话后的24小时内），超出窗口需使用官方认证的消息模板（音频需嵌入模板）

4. 查询消息实际状态 #

利用发送接口返回的wamid（即wamid.HBgMNTU2NTkyNjY1MDYwFQI==）调用状态查询接口，确认消息真实投递状态：

curl --request GET \
  --url https://graph.facebook.com/v17.0/wamid.HBgMNTU2NTkyNjY1MDYwFQI== \
  --header 'Authorization: Bearer EAAD...'

返回结果中的status字段会明确消息状态：

• sent：已发送到WhatsApp服务器
• delivered：已投递到用户设备
• read：已被用户查看
• failed：投递失败，会附带错误码与原因说明

5. 排查接收端设备问题 #

• 确认接收方WhatsApp为最新版本，旧版本可能存在兼容性问题
• 检查接收设备网络状态，确保能正常连接WhatsApp服务器
• 查看接收方的「企业消息」文件夹或垃圾消息栏，部分设备会自动归类商家消息
• 确认接收方未开启免打扰模式或屏蔽你的业务账户

内容的提问来源于stack exchange，提问作者Nagi