查询录音内容列表

最后更新:2026/10/22

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/ai_recording/list?access_token=ACCESS_TOKEN

Query参数:

参数 类型 必填 说明
access_token string 是 调用接口凭证

Body参数:

{
  "current_index": 1,
  "page_size": 20,
  "keyword": "客户咨询",
  "recording_statuses": [2],
  "recording_time_start": 1780000000000,
  "recording_time_end": 1780086400000
}
参数 类型 说明
current_index integer 页码,从 1 开始,默认 1
page_size integer 每页条数,1~100,默认 20
keyword string 标题模糊搜索
recording_id / external_recording_id string 按平台 ID / 来源应用外部 ID 过滤
userids string[] 所属员工列表
source_types / media_types integer[] 来源类型 / 媒体类型;当前媒体类型仅 1
recording_statuses integer[] 状态列表:1 处理中、2 完成、3 失败
relation_status integer 1 已关联、2 未关联
relation_type integer 1 企微客户、2 CRM 联系人
external_userid / contact_id string/long 按关联对象过滤
min_duration / max_duration long 时长范围,单位毫秒
recording_time_start / recording_time_end long 录音时间闭区间
completed_time_start / completed_time_end long 完成时间闭区间
created_time_start / created_time_end long 创建时间闭区间
modified_time_start / modified_time_end long 修改时间闭区间;增量查询必须同时传开始和结束时间

返回结果:

{
  "code": 0,
  "sub_code": "OK",
  "msg": "请求成功",
  "data": {
    "current_index": 1,
    "page_size": 20,
    "total": 1,
    "list": [{ "recording_id": "123456789", "title": "客户咨询录音", "recording_status": 2, "modified_time": 1780000070000 }]
  }
}

参数说明:

参数 类型 说明
code int 返回码,0 表示成功
msg str 对返回码的文本描述内容
data object 返回数据
  current_index int 当前页码
  page_size int 当前每页条数
  total long 符合条件的总记录数
  list object[] 录音详情数组
    recording_id str 平台录音 ID
    title str 录音标题
    recording_status int 1 处理中、2 完成、3 失败
    modified_time long 最近修改时间,毫秒时间戳
sub_code str 业务异常返回码;成功时为 OK

results matching ""

    No results matching ""