如何解决WhatsApp Cloud API中Media file scrutiny失败（错误码131053）问题

问题描述 #

使用WhatsApp Cloud API发送音频消息时，按官方流程上传MP3音频并确认上传成功后，调用发送接口收到Webhook返回错误：

Media file scrutiny for the file failed with mediaEngineStatus: 0（错误码131053）

已尝试以下方案但均未解决：

• 用file --mime-type命令验证音频格式，查阅官方错误文档
• 改用WhatsApp默认的OGG格式音频
• 先发送模板消息并收到用户回复后再发送音频
• 用Insomnia替代自有代码测试
• 用ffmpeg重新编码音频文件

同时已确认：上传采用multipart/mime格式，音频文件本身无损坏。目前需先定位Insomnia环境下的问题原因，再同步到自有代码中。

Insomnia环境针对性排查步骤 #

1. 核对请求参数的准确性 #

• 确认发送请求中messaging_product字段值为whatsapp，recipient_type为individual
• 检查audio对象中的id是否为上传后返回的有效媒体ID，注意媒体ID默认有效期24小时，避免使用过期ID
• 验证请求头Authorization格式：Bearer <你的API令牌>，确保令牌无拼写错误、权限未缺失

2. 强制对齐音频文件的合规参数 #

即使已用ffmpeg编码，仍需确认参数完全符合WhatsApp要求：

• MP3格式：采样率≤48kHz，比特率建议64-128kbps，单/立体声均可
• OGG格式：采用Vorbis编码，采样率≤48kHz，比特率建议64kbps左右
• 用ffmpeg命令强制生成合规文件：

  # 转合规MP3
  ffmpeg -i input.mp3 -ar 44100 -ab 128k -ac 2 output.mp3
  # 转合规OGG
  ffmpeg -i input.ogg -c:a libvorbis -ar 44100 -b:a 64k output.ogg
  

3. 排查Insomnia工具配置问题 #

• 关闭Insomnia的自动编码、代理等附加设置，避免请求体被篡改
• 切换Insomnia的环境（测试/生产），验证是否为环境配置差异导致
• 将Insomnia中的请求导出为cURL命令，在终端执行，排除工具本身的问题

4. 检查账号与权限限制 #

• 确认WhatsApp Business账号已完成审核，无违规限制
• 验证测试号码在官方允许的测试列表内，避免非授权号码触发的媒体审核失败

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