查询录音内容列表
最后更新: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 |