🧙发送语音消息

发送语音消息接口文档

此接口支持发送三种类型的语音消息：本地语音、网络语音以及Base64编码语音。

API请求详情

请求方式：POST 请求URL：v2/api

请求参数

Query 参数

• funcname (必需): MagicCgi

• timeout (必需): 10

• wxid (必需): wxid_xxxxx

Body 参数

• CgiCmd (必需): 127

• CgiRequest (必需): 包含发送消息所需的详细信息。

  • ToUserName (必需): 目标用户或群ID

  • 选择一个发送方式:

    • VoicePath (必需): 本地语音路径

    • VoiceUrl: 网络语音URL

    • VoiceBase64: Base64编码的语音数据

  • VoiceTime (必需): 语音时长，单位秒

发送本地语音示例

{
  "CgiCmd": 127,
  "CgiRequest": {
    "ToUserName": "5607240817@chatroom",
    "VoicePath": "./running.silk",
    "VoiceTime": 10
  }
}

发送网络语音示例

{
  "CgiCmd": 127,
  "CgiRequest": {
    "ToUserName": "5607240817@chatroom",
    "VoiceUrl": "http://www.example.com/voice.silk"
  }
}

发送Base64编码语音示例

{
  "CgiCmd": 127,
  "CgiRequest": {
    "ToUserName": "5607240817@chatroom",
    "VoiceBase64": "Base64编码的语音数据",
    "VoiceTime": 10
  }
}

CURL请求示例

curl --location -g --request POST 'http://127.0.0.1:8898/v2/api?funcname=MagicCgi&timeout=10&wxid=Wxid_xxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "CgiCmd": 127,
    "CgiRequest": {
        "ToUserName": "6949093048@chatroom",
        "VoicePath": "./Time/0_00.silk",
        "VoiceTime": 10
    }
}'

返回响应

HTTP状态码: 200

内容格式: JSON

数据结构

• CgiBaseResponse:

  • ErrMsg (必需): 错误消息

  • Ret (必需): 返回状态码

• ResponseData:

  • NewMsgId (必需): 新消息ID

  • ClientMsgId (必需): 客户端消息ID

响应示例

{
  "CgiBaseResponse": {
    "ErrMsg": "string",
    "Ret": 0
  },
  "ResponseData": {
    "NewMsgId": 0,
    "ClientMsgId": "string"
  }
}