使用Twilio开发WhatsApp聊天Bot时发送OGG音频文件失败问题

可能的原因及解决方法 #

• 文件服务器的Content-Type响应头错误
  Twilio依赖文件服务器返回的Content-Type识别媒体类型，即便文件后缀是.ogg或.mpeg，若服务器返回application/octet-stream这类通用二进制类型，Twilio无法正确解析。需配置服务器为.ogg返回audio/ogg，为.mpeg/mp3返回audio/mpeg。

• 音频文件超出大小限制
  WhatsApp对音频文件的大小限制通常为16MB，若文件超过该阈值会被拦截。检查文件大小，压缩或分割后再尝试发送。

• 文件链接不可公开访问
  确认media_url指向的文件无访问限制（如IP白名单、登录验证），Twilio服务器需要能直接获取文件内容。可通过浏览器或curl工具测试链接是否能直接下载。

• 音频编码不符合WhatsApp规范
  即便MIME类型正确，WhatsApp对音频编码有具体要求：

  • ogg文件需采用Vorbis编码
  • mpeg文件需为标准MP3编码
    编码不匹配时，WhatsApp无法识别该音频文件。

代码示例 #

to_num = request.values.get('From', '')
from_num = request.values.get('To', '')
message = client.messages.create(
                              from_= from_num,
                              body= "test", 
                              media_url= "https://the_file_link.ogg",
                              to= to_num
                          )

内容的提问来源于stack exchange，提问作者Ken Kezhi Li