录音文件

查询录音文件

• 描述

  分页查询录音文件记录

• URI

  /wscrm-bus-api/open/audioRecord/page

• 请求方式

  POST、Content-Type: application/json

• 请求参数说明

参数名	类型	是否必填	备注
tenantId	Long	是	公司编号
info	Object	是	查询条件
current	int	否	页码 默认 1
pageSize	int	否	数量 默认 10

info 参数说明

参数名	类型	是否必填	备注
friendWhatsId	String	否	目标客户
whatsId	String	否	客服账号
chatType	Integer	否	消息类别 1 个人 2 群聊
actionType	Integer	否	1 发送 2 接收
contentType	Integer	否	内容类型
startChatTime	Long	否	聊天时间(起始) 毫秒级时间戳
endChatTime	Long	否	聊天时间(结束) 毫秒级时间戳
agentAccount	String	否	坐席账号(完全匹配)

• 请求示例

{
  "tenantId": 82,
  "current": 1,
  "pageSize": 10,
  "info": {
    "whatsId": "8613800138000",
    "friendWhatsId": "8613900139000",
    "startChatTime": 1725120000000,
    "endChatTime": 1727807999000
  }
}

• 响应示例

{
  "code": 200,
  "message": "Success",
  "data": {
    "records": [
      {
        "id": 369,
        "userId": 621443,
        "tenantId": 520274,
        "chatType": 1,
        "contentType": 3,
        "actionType": 1,
        "currentWhatsId": "8613800138000",
        "friendWhatsId": "8613900139000",
        "senderWhatsId": "8613800138000",
        "sendTime": 1789961544000,
        "soundRecordUrl": "https://xxx.oss-xxx.aliyuncs.com/audio_record/520274/20260928/1727500000000_audio.mp3?Expires=...",
        "duration": 12,
        "originType": 1,
        "createBy": 621443,
        "createAt": "2026-09-28 11:30:00"
      }
    ],
    "total": 1,
    "size": 10,
    "current": 1,
    "pages": 1
  }
}

同步录音文件

• 描述

  客户端上传录音文件落库后，向第三方推送同步（配置开启时）

• WebHook

• 配置 ID <MSG_SYNC_AUDIO_RECORD>

• 请求参数说明

  参数名	类型	是否必填	备注
  accessToken	String	是	签名字符串 token（请求头）
  tenantId	int	是	公司 id（请求头）
  timestamp	Long	是	毫秒时间戳（请求头）
  data	List	是	录音记录列表（请求体）

  data 参数说明:

  参数名	类型	是否必填	备注
  id	String	是	数据 id
  userId	Long	是	所属座席
  userName	String	是	坐席登录账号
  currentWhatsId	String	是	当前客服号
  friendWhatsId	String	是	好友 whatsapp
  senderWhatsId	String	是	发送人 whatsapp
  actionType	int	是	行为类型 1发送 2接收
  chatType	int	是	聊天性质 1普通 2群聊
  contentType	int	是	内容类型
  soundRecordUrl	String	是	录音文件地址（签名 URL）
  duration	int	否	录音时长（秒）
  sendTime	String	是	消息聊天时间
  originType	Long	否	来源 1 pc
  createAt	String	是	创建时间

• 请求示例:

{
  "data": [
    {
      "id": "369",
      "userId": 621443,
      "userName": "gdkj002",
      "currentWhatsId": "8613800138000",
      "friendWhatsId": "8613900139000",
      "senderWhatsId": "8613800138000",
      "actionType": 1,
      "chatType": 1,
      "contentType": 3,
      "soundRecordUrl": "https://xxx.oss-xxx.aliyuncs.com/audio_record/520274/20260928/1727500000000_audio.mp3?Expires=...",
      "duration": 12,
      "sendTime": "2026-09-28 11:30:00",
      "originType": 1,
      "createAt": "2026-09-28 11:30:05"
    }
  ]
}

• 返回参数说明

  参数名	类型	是否必填	备注
  code	int	是	状态码
  message	String	否	描述
  data	String	否	数据

• 响应示例:

  {
    "code": 200,
    "message": "success!",
    "data": ""
  }