调用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 是 2020927020

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

呼叫中心实例ID

返回数据

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

响应码
HttpStatusCode Integer 200

HTTP状态码
Message String 无

响应信息
Recordings Array of Recording

录音列表
Recording
AgentId String 293939422320312215

坐席ID。

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

坐席名称
CalledNumber String 15588886666

被叫号码
CallingNumber String 80327683

主叫号码
Channel String null

座席所在音轨标示，默认为null
ContactId String 2020927020

话务ID
ContactType String Outbound

话务类型
Duration Integer 10

通话时长
FileDescription String 20180711125511-小芳

录音文件描述
FileName String 153128491143400080327683.wav

录音文件名称
FilePath String oss://cloudcallcenter-test/accrec/acc9602/171032

录音文件地址
InstanceId String b83df335-0bfb-4204-a910-5219b30e6cb4

呼叫中心实例ID
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)://ccc.cn-shanghai.aliyuncs.com/?Action=ListRecordingsByContactId
&ContactId=2020927020
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&<公共请求参数>

正常返回示例

XML 格式 

<ListRecordingsByContactIdResponse>
      <HttpStatusCode>200</HttpStatusCode>
      <Recordings>
            <Recording>
                  <FileDescription>20180711125511-小芳</FileDescription>
                  <AgentName>小芳</AgentName>
                  <CalledNumber>15588886666</CalledNumber>
                  <CallingNumber>80327683</CallingNumber>
                  <FileName>153128491143400080327683.wav</FileName>
                  <Duration>10</Duration>
                  <ContactId>2020927020</ContactId>
                  <StartTime>1531284911000</StartTime>
                  <AgentId>293939422320312215</AgentId>
                  <ContactType>Outbound</ContactType>
            </Recording>
      </Recordings>
      <RequestId>0997CE25-94D3-41DE-8C7A-E6FCFD8C01E0</RequestId>
      <Success>true</Success>
      <Code>OK</Code>
</ListRecordingsByContactIdResponse>

JSON 格式 

{
    "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"
}

错误码

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