调用ListRecordingsByContactId根据话务ID查找相关的录音详细信息。

有以下两种获取话务ID（ContactId）方式：

1. 通过调用ListCallDetailRecords，返回参数中包含ContactId。

2. 通过监听软电话SDK中的回调事件（参数表如下），回调事件中会携带每通通话全局唯一的ContactId。 


钩子：某些事件触发时的回调函数
onCallComing  //来电，参数表（connid<通话id>,caller<主叫号码>,calee<被叫号码>,contactId<录音id>,skillgroupId<技能组id>）
onCallDialing  //去电，参数表（connid,caller,calee,contactId）

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListRecordingsByContactId

系统规定参数。取值：ListRecordingsByContactId。

ContactId String 是 2020927xxxx

话务ID
InstanceId String 是 9cfad875-6260-4a53-ab6e-b13e3fb3xxxx

呼叫中心实例ID

返回数据

名称 类型 示例值 描述
Code String OK

响应码
HttpStatusCode Integer 200

HTTP状态码
Message String 无

响应信息
Recordings Array of Recording

录音列表
Recording
AgentId String 29393942232031xxxx

坐席ID。

坐席ID等同于该座席的RAM子账户ID。
AgentName String 小芳

坐席名称
CalledNumber String 1558888****

被叫号码
CallingNumber String 8032****

主叫号码
Channel String 无

已废弃字段
ContactId String 202092xxxx

话务ID
ContactType String Outbound

话务类型
Duration Integer 10

通话时长
FileDescription String 20180711125511-小芳

录音文件描述
FileName String 15312849114340008032xxxx.wav

录音文件名称
FilePath String 无

已废弃字段
InstanceId String 无

已废弃字段
QualityCheckTaskId String 1F0BF809-7B30-4918-9424-4DF23A8BB9B1

智能质检任务ID
QualityCheckTid String 23A1F0BF-7B30-4918-9424-4DF8B809B9B1

智能质检文本ID
StartTime Long 1531284911000

通话开始时间
RequestId String 0997CE25-94D3-41DE-8C7A-E6FCFD8C01E0

请求ID
Success Boolean true

是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=ListRecordingsByContactId
&ContactId=2020927xxxx
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb3xxxx
&<公共请求参数>

正常返回示例

XML格式 

<Message>无</Message>
<RequestId>0997CE25-94D3-41DE-8C7A-E6FCFD8C01E0</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Recordings>
    <Recording>
        <FilePath>无</FilePath>
        <CalledNumber>1558888****</CalledNumber>
        <ContactType>Outbound</ContactType>
        <QualityCheckTid>23A1F0BF-7B30-4918-9424-4DF8B809B9B1</QualityCheckTid>
        <InstanceId>无</InstanceId>
        <Channel>无</Channel>
        <FileName>15312849114340008032xxxx.wav</FileName>
        <StartTime>1531284911000</StartTime>
        <Duration>10</Duration>
        <ContactId>202092xxxx</ContactId>
        <CallingNumber>8032****</CallingNumber>
        <FileDescription>20180711125511-小芳</FileDescription>
        <QualityCheckTaskId>1F0BF809-7B30-4918-9424-4DF23A8BB9B1</QualityCheckTaskId>
        <AgentName>小芳</AgentName>
        <AgentId>29393942232031xxxx</AgentId>
    </Recording>
</Recordings>
<Code>OK</Code>
<Success>true</Success>

JSON格式 

{
    "Message": "无",
    "RequestId": "0997CE25-94D3-41DE-8C7A-E6FCFD8C01E0",
    "HttpStatusCode": 200,
    "Recordings": {
        "Recording": {
            "FilePath": "无",
            "CalledNumber": "1558888****",
            "ContactType": "Outbound",
            "QualityCheckTid": "23A1F0BF-7B30-4918-9424-4DF8B809B9B1",
            "InstanceId": "无",
            "Channel": "无",
            "FileName": "15312849114340008032xxxx.wav",
            "StartTime": 1531284911000,
            "Duration": 10,
            "ContactId": "202092xxxx",
            "CallingNumber": "8032****",
            "FileDescription": "20180711125511-小芳",
            "QualityCheckTaskId": "1F0BF809-7B30-4918-9424-4DF23A8BB9B1",
            "AgentName": "小芳",
            "AgentId": "29393942232031xxxx"
        }
    },
    "Code": "OK",
    "Success": true
}

错误码

访问错误中心查看更多错误码。