下载消息中的语音

根据语音消息回调中的字段下载语音文件，返回通常为 silk 格式的语音地址。

接口地址： POST /getMsgVoice

格式说明

下载成功后，如需将 silk 格式转换成 MP3 等格式，可参考 silk-v3-decoder。

前置条件

• 当前 wId 对应的微信实例在线。
• msgId、length、bufId、fromUser 来自语音消息回调。
• fromUser 应传发送者 ID。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
msgId	是	number	消息 ID
length	是	int	语音长度，对应 XML 中的 length 字段
bufId	是	string	XML 中返回的 bufId 字段
fromUser	是	string	发送者

请求示例

{
  "wId": "{{wId}}",
  "msgId": 1114311129,
  "fromUser": "wxid_6tn88z16x6ou12",
  "bufId": "289139440622895483",
  "length": 3227
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	下载结果
data.url	string	语音文件地址，通常为 silk 文件

成功响应

{
  "code": "1000",
  "message": "成功",
  "data": {
    "url": "https://cdn.e-yun.example/msgVoice/e2045467-b1ac-4b3c-89f8-62ab2b3a2284.silk"
  }
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• 下载语音后如需播放，通常需要先做 silk 转码。
• 语音下载参数建议从回调原始字段提取，不要手动猜测 bufId。
• 返回地址可能有有效期，业务侧需要及时转存或消费。