发送语音消息

POST

http://manager.wecomapi.com/wecom/finder/api

接口提示

发送语音消息。通常需要先上传语音文件。

该接口会产生实际业务动作，正式环境建议做好权限校验、频率控制和操作日志。

发送语音前通常需要先通过本地文件上传获取语音文件参数。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

请求成功时返回统一响应结构，具体字段以 data 内容为准。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'http://manager.wecomapi.com/wecom/finder/api' \
--header 'WECOM-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/msg/sendVoice",
  "params": {
    "guid": "",
    "fileAesKey": "{{fileAesKey}}",
    "fileId": "{{fileId}}",
    "fileSize": 117935,
    "voiceTime": 2,
    "toId": "{{toId}}"
  }
}'

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "isSendSuccess": 1,
    "msgServerId": 1011353,
    "msgType": 2,
    "msgUniqueIdentifier": "901efcada57ff16a469411b3e7f1b009",
    "seq": 7104740,
    "timestamp": 1778132182,
    "extras": {
      "base64RawData": "eyJkZW1vIjoiZGF0YSJ9",
      "signedMsg": {
        "infoBuffer": "eyJpbmZvIjoiZGVtbyJ9",
        "originalContentType": 2,
        "signature": "demo_signature_9f3a2c"
      }
    }
  }
}

修改于 2026-07-03 10:03:16

发送文件消息

发送链接消息