描述
根据话务ID(ContactId)查找相关的录音详细信息。ContactId获取方式有以下两种方式:
- 通过调用 ListCallDetailRecords ,返回参数中包含ContactId;
- 通过监听 软电话SDK 中的回调事件(如下图),回调事件中会携带每通通话全局唯一的ContactId;

请求参数
名称 |
类型 |
是否必须 |
描述 |
Action |
String |
是 |
系统规定参数,ListRecordingsByContactId |
InstanceId |
String |
是 |
呼叫中心实例ID |
ContactId |
String |
是 |
话务ID |
返回参数
名称 |
类型 |
是否必须 |
描述 |
Recordings |
List\ |
是 |
返回参数,录音列表 |
ContactId |
String |
是 |
话务ID |
ContactType |
String |
是 |
话务类型,参考枚举类型内呼, 外呼, 内部通话 |
AgentId |
String |
是 |
坐席ID,坐席ID等同于该座席的RAM子账户ID |
AgentName |
String |
是 |
坐席名字 |
CallingNumber |
String |
是 |
主叫号码 |
CalledNumber |
String |
是 |
被叫号码 |
StartTime |
String |
是 |
通话开始时间 |
Duration |
String |
是 |
通话时长 |
FileName |
String |
是 |
录音文件名字 |
FileDescription |
String |
是 |
录音文件描述 |
Channel |
String |
是 |
座席所在音轨标示 |
InstanceId |
String |
是 |
呼叫中心实例ID |
QualityCheckTid |
String |
是 |
智能质检文本ID |
QualityCheckTaskId |
String |
是 |
智能质检任务ID |
请求示例
https://ccc.cn-shanghai.aliyuncs.com/?
&Action=ListRecordingsByContactId
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&ContactId=2020927020
&<公共请求参数>
返回示例
{
"HttpStatusCode":200,
"Recordings":{
"Recording":[
{
"FileDescription":"20180711125511-小芳",
"AgentName":"小芳",
"CalledNumber":"15588886666",
"CallingNumber":"80327683",
"FileName":"153128491143400080327683.wav",
"Duration":10,
"ContactId":"2020927020",
"StartTime":1531284911000,
"AgentId":"293939422320312215",
"ContactType":"Outbound"
}
]
},
"RequestId":"0997CE25-94D3-41DE-8C7A-E6FCFD8C01E0",
"Success":true,
"Code":"OK"
}
错误码
错误代码 |
描述 |
Http状态码 |
语义 |
NotExist.Instance |
“Call center instance ‘%s’ does not exist” |
404 |
呼叫中心实例不存在。 |
NoPermission.User |
“User ‘%s’ has no permission to ‘%s’” |
403 |
当前用户没有权限进行查询录音。 |
NotExist.User |
“User ‘%s’ of instance ‘%s’ does not exist” |
404 |
用户不存在 |
在文档使用中是否遇到以下问题
更多建议
匿名提交