发送语音

向好友或群聊发送语音文件。

接口地址： POST /sendVoice

格式说明

• 仅支持 silk 和 amr 格式。如需将 mp3 转换为 silk 格式，可参考：silk-v3-decoder
• 也可通过 下载语音接口 获取 silk 格式语音文件

前置条件

• 微信实例已登录，并已获得可用的 wId。
• 接收方 wcId 可以是好友微信 ID，也可以是群 ID。
• content 需要是可访问的 silk/amr 语音文件 URL。
• length 为语音时长，单位为毫秒，可从回调消息的 voicelength 字段获取。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
wcId	是	string	接收方微信 ID 或群 ID
content	是	string	语音文件 URL（silk/amr 格式）
length	是	int	语音时长（毫秒），可从回调消息的 voicelength 字段获取

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data.type	int	类型
data.msgId	long	消息 ID
data.newMsgId	long	新消息 ID
data.createTime	long	发送时间戳（秒）
data.wcId	string	接收方 ID

请求示例

{
 "wId": "0000016f-a719-5b44-0003-a567f79011fc",
 "wcId": "jack_623555049",
 "content": "https://xc-1300726975.cos.ap-shanghai.myqcloud.com/msgVoice/e17dd0a9-5c59-4a54-a3cd-1a4817f5dd29-1579005558791.silk",
 "length": 1
}

成功响应

{
 "code": "1000",
 "message": "发送语音消息成功",
 "data": {
 "type": null,
 "msgId": 697760541,
 "newMsgId": 1375821081513076275,
 "createTime": 1641458029,
 "wcId": "jack_623555049"
 }
}

错误响应

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

使用建议

• 语音格式要求严格，建议先在测试微信实例验证文件能否正常播放。
• length 建议使用真实回调值，不要随意填写，否则微信端展示时长可能不准确。
• 批量发送同一语音时，建议复用稳定素材 URL，减少重复上传和转换成本。