调用ListRecentCallRecords获取呼叫中心当前坐席的最近通话记录。

调试

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

请求参数

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

系统规定参数。取值:ListRecentCallRecords

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

呼叫中心实例ID

PageNumber Integer 1

分页序号

PageSize Integer 10

分页大小

StartTime Long 1532448000000

获取的历史数据的起始时间。缺省为0,代表从当天的0时开始。

StopTime Long 1532707199000

获取的历史数据的终止时间。缺省为0,代表截止到目前的时间。

Criteria String {"phoneNumber": "0411xxxx4588"}

搜索条件。

可以根据号码(客户电话或坐席号码)来搜索。

返回数据

名称 类型 示例值 描述
CallDetailRecords Struct

获取到的通话详单

List Array of CallDetailRecord

对象列表

CallDetailRecord
AgentNames String ccctest

参与通话的座席,多个座席之间以逗号分隔。

Agents Array of CallDetailAgent

座席通话参与详情

CallDetailAgent
AgentId String 1912@ccctest

座席ID

AgentName String ccctest

座席名称

ContactId String 123909012

话务ID

Feedback String 不满意

反馈

HoldTime Integer 30

通话保持时间,单位为秒

QueueTime Integer 5

排队时间,单位为秒

RingTime Integer 10

振铃时间,单位为秒

Satisfaction String 1

满意度

SkillGroupName String skillGroup-name

技能组名称

StartTime Long 1532448000000

通话开始时间

TalkTime Integer 54

通话时间,单位为秒

WorkTime Integer 15

话后处理时间,单位为秒

CalledNumber String 19309090900

被叫号码

CallingNumber String 01098989877

主叫号码

ContactDisposition String Success

电话结束原因。

参考枚举值:Success(0) 正常, NoAnswer(1) 无应答, Rejected(2)拒绝, Busy(3)忙, AbandonedInContactFlow(4) IVR呼损, AbandonedInQueue(5)队列呼损, AbandonedRing(6) 久振不接, QueueOverflow(7) 等待超时被挂断。

ContactId String 20988909

话务ID,全局唯一,对应于 ACC的ACID。

ContactType String Outbound

通话类型。

参考枚举值:Inbound(0) 内呼, Outbound(1) 外呼, Internal(2) 内部通话。

Duration Integer 39

通话持续时间,单位为秒。

ExtraAttr String

额外信息

ExtraAttr String

额外信息

Feedback String 不满意

反馈

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

呼叫中心实例ID

Recordings Array of Recording

通话录音列表

Recording
AgentId String 1912

座席ID

AgentName String ccctest

座席名称

CalledNumber String 19309090900

被叫号码

CallingNumber String 01098989877

主叫电话

Channel String

座席所在音轨标示

ContactId String 123909012

话务ID

ContactType String Outbound

通话类型

Duration Integer 38

通话时长

FileDescription String

录音文件别名

FileName String 0001.wav

录音文件名

FilePath String oss://cloudcall-test/acc123

录音文件在OSS中的保存位置

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

呼叫中心实例ID

StartTime Long 1532448000000

通话开始时间

Satisfaction Integer 1

满意度

SatisfactionDesc String 满意

满意度描述

SkillGroupNames String 技能组1,技能组2

参与通话的座席所述的技能组,多个技能组以逗号分隔。

StartTime Long 1532448000000

电话开始时间,内呼从进入IVR开始,外呼从开始接通计算。

PageNumber Integer 1

分页序号

PageSize Integer 7

分页大小

TotalCount Integer 98

对象总数

Code String OK

响应码

HttpStatusCode Integer 200

HTTP状态码

RequestId String 032C73C4-3A6F-4502-872B-4F5B41161C6E

请求ID

Message String

响应信息

Success Boolean true

是否成功

示例

请求示例

http(s)://ccc.cn-shanghai.aliyuncs.com/?Action=ListRecentCallRecords
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&PageNumber=1
&PageSize=10
&<公共请求参数>

正常返回示例

XML 格式

<ListRecentCallRecordsResponse>
      <CallDetailRecords>
            <List>
                  <AgentNames>cloudcallcenter</AgentNames>
                  <CalledNumber>02566806658</CalledNumber>
                  <CallingNumber>13621078901</CallingNumber>
                  <ContactDisposition>Success</ContactDisposition>
                  <ContactId>2029786681</ContactId>
                  <ContactType>Inbound</ContactType>
                  <Duration>14</Duration>
                  <Feedback></Feedback>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <SatisfactionDesc>未发送</SatisfactionDesc>
                  <SkillGroupNames>xxx技能组</SkillGroupNames>
                  <StartTime>1534952985000</StartTime>
            </List>
            <List>
                  <AgentNames>cloudcallcenter</AgentNames>
                  <Agents>
                        <AgentId>1059876788928509</AgentId>
                        <Satisfaction>未评价</Satisfaction>
                  </Agents>
                  <CalledNumber>15216789012</CalledNumber>
                  <CallingNumber>025668067898</CallingNumber>
                  <ContactDisposition>Success</ContactDisposition>
                  <ContactId>2029786674</ContactId>
                  <ContactType>Outbound</ContactType>
                  <Duration>12</Duration>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <SatisfactionDesc>未评价</SatisfactionDesc>
                  <SkillGroupNames>xxx技能组,abc技能组</SkillGroupNames>
                  <StartTime>1534952824000</StartTime>
            </List>
            <List>
                  <AgentNames>cloudcallcenter</AgentNames>
                  <Agents>
                        <AgentId>10598035678925209</AgentId>
                        <Satisfaction>未评价</Satisfaction>
                  </Agents>
                  <CalledNumber>15210842252</CalledNumber>
                  <CallingNumber>025668035258</CallingNumber>
                  <ContactDisposition>Success</ContactDisposition>
                  <ContactId>2029786662</ContactId>
                  <ContactType>Outbound</ContactType>
                  <Duration>32</Duration>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <SatisfactionDesc>未评价</SatisfactionDesc>
                  <SkillGroupNames>xxx技能组,abc技能组</SkillGroupNames>
                  <StartTime>1534952543000</StartTime>
            </List>
            <List>
                  <AgentNames>cloudcallcenter</AgentNames>
                  <CalledNumber>02566141658</CalledNumber>
                  <CallingNumber>05718502141188</CallingNumber>
                  <ContactDisposition>Success</ContactDisposition>
                  <ContactId>2029787661</ContactId>
                  <ContactType>Inbound</ContactType>
                  <Duration>18</Duration>
                  <Feedback></Feedback>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <SatisfactionDesc>未发送</SatisfactionDesc>
                  <SkillGroupNames>xxx技能组</SkillGroupNames>
                  <StartTime>1534952481000</StartTime>
            </List>
            <List>
                  <AgentNames>cloudcallcenter</AgentNames>
                  <Agents>
                        <AgentId>10598035678908509</AgentId>
                        <Satisfaction>未评价</Satisfaction>
                  </Agents>
                  <CalledNumber>15210835434</CalledNumber>
                  <CallingNumber>02566806238</CallingNumber>
                  <ContactDisposition>Success</ContactDisposition>
                  <ContactId>2029787657</ContactId>
                  <ContactType>Outbound</ContactType>
                  <Duration>15</Duration>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <SatisfactionDesc>未评价</SatisfactionDesc>
                  <SkillGroupNames>xxx技能</SkillGroupNames>
                  <StartTime>1534952369000</StartTime>
            </List>
            <List>
                  <AgentNames>cloudcallcenter,hgf_offline</AgentNames>
                  <CalledNumber>0256667878958</CalledNumber>
                  <CallingNumber>05718567658</CallingNumber>
                  <ContactDisposition>Success</ContactDisposition>
                  <ContactId>2029786652</ContactId>
                  <ContactType>Inbound</ContactType>
                  <Duration>101</Duration>
                  <Feedback></Feedback>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <SatisfactionDesc>未发送</SatisfactionDesc>
                  <SkillGroupNames>xxx技能组</SkillGroupNames>
                  <StartTime>1534952195000</StartTime>
            </List>
            <List>
                  <AgentNames>cloudcallcenter</AgentNames>
                  <CalledNumber>15223456788</CalledNumber>
                  <CallingNumber>0256789876</CallingNumber>
                  <ContactDisposition>Success</ContactDisposition>
                  <ContactId>2029691793</ContactId>
                  <ContactType>Outbound</ContactType>
                  <Duration>29</Duration>
                  <Feedback></Feedback>
                  <InstanceId>9cfad875-6260-4a53-ab6e-b13e3fb31f7d</InstanceId>
                  <SatisfactionDesc>未发送</SatisfactionDesc>
                  <SkillGroupNames>xxx技能组,xxx技能组</SkillGroupNames>
                  <StartTime>1534923034000</StartTime>
            </List>
            <PageNumber>1</PageNumber>
            <PageSize>7</PageSize>
            <TotalCount>98</TotalCount>
      </CallDetailRecords>
      <Code>OK</Code>
      <HttpStatusCode>200</HttpStatusCode>
      <RequestId>032C73C4-3A6F-4502-872B-4F5B41161C6E</RequestId>
      <Success>true</Success>
</ListRecentCallRecordsResponse>

JSON 格式

{
    "CallDetailRecords":{
        "List":[
            {
                "AgentNames":"cloudcallcenter",
                "Agents":[
                ],
                "CalledNumber":"02566806658",
                "CallingNumber":"13621078901",
                "ContactDisposition":"Success",
                "ContactId":"2029786681",
                "ContactType":"Inbound",
                "Duration":14,
                "Feedback":"",
                "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
                "Recordings":[
                ],
                "SatisfactionDesc":"未发送",
                "SkillGroupNames":"xxx技能组",
                "StartTime":1534952985000
            },
            {
                "AgentNames":"cloudcallcenter",
                "Agents":[
                    {
                        "AgentId":"1059876788928509",
                        "Satisfaction":"未评价"
                    }
                ],
                "CalledNumber":"15216789012",
                "CallingNumber":"025668067898",
                "ContactDisposition":"Success",
                "ContactId":"2029786674",
                "ContactType":"Outbound",
                "Duration":12,
                "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
                "Recordings":[
                ],
                "SatisfactionDesc":"未评价",
                "SkillGroupNames":"xxx技能组,abc技能组",
                "StartTime":1534952824000
            },
            {
                "AgentNames":"cloudcallcenter",
                "Agents":[
                    {
                        "AgentId":"10598035678925209",
                        "Satisfaction":"未评价"
                    }
                ],
                "CalledNumber":"15210842252",
                "CallingNumber":"025668035258",
                "ContactDisposition":"Success",
                "ContactId":"2029786662",
                "ContactType":"Outbound",
                "Duration":32,
                "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
                "Recordings":[
                ],
                "SatisfactionDesc":"未评价",
                "SkillGroupNames":"xxx技能组,abc技能组",
                "StartTime":1534952543000
            },
            {
                "AgentNames":"cloudcallcenter",
                "Agents":[
                ],
                "CalledNumber":"02566141658",
                "CallingNumber":"05718502141188",
                "ContactDisposition":"Success",
                "ContactId":"2029787661",
                "ContactType":"Inbound",
                "Duration":18,
                "Feedback":"",
                "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
                "Recordings":[
                ],
                "SatisfactionDesc":"未发送",
                "SkillGroupNames":"xxx技能组",
                "StartTime":1534952481000
            },
            {
                "AgentNames":"cloudcallcenter",
                "Agents":[
                    {
                        "AgentId":"10598035678908509",
                        "Satisfaction":"未评价"
                    }
                ],
                "CalledNumber":"15210835434",
                "CallingNumber":"02566806238",
                "ContactDisposition":"Success",
                "ContactId":"2029787657",
                "ContactType":"Outbound",
                "Duration":15,
                "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
                "Recordings":[
                ],
                "SatisfactionDesc":"未评价",
                "SkillGroupNames":"xxx技能",
                "StartTime":1534952369000
            },
            {
                "AgentNames":"cloudcallcenter,hgf_offline",
                "Agents":[
                ],
                "CalledNumber":"0256667878958",
                "CallingNumber":"05718567658",
                "ContactDisposition":"Success",
                "ContactId":"2029786652",
                "ContactType":"Inbound",
                "Duration":101,
                "Feedback":"",
                "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
                "Recordings":[
                ],
                "SatisfactionDesc":"未发送",
                "SkillGroupNames":"xxx技能组",
                "StartTime":1534952195000
            },
            {
                "AgentNames":"cloudcallcenter",
                "Agents":[
                ],
                "CalledNumber":"15223456788",
                "CallingNumber":"0256789876",
                "ContactDisposition":"Success",
                "ContactId":"2029691793",
                "ContactType":"Outbound",
                "Duration":29,
                "Feedback":"",
                "InstanceId":"9cfad875-6260-4a53-ab6e-b13e3fb31f7d",
                "Recordings":[
                ],
                "SatisfactionDesc":"未发送",
                "SkillGroupNames":"xxx技能组,xxx技能组",
                "StartTime":1534923034000
            }
        ],
        "PageNumber":1,
        "PageSize":7,
        "TotalCount":98
    },
    "Code":"OK",
    "HttpStatusCode":200,
    "RequestId":"032C73C4-3A6F-4502-872B-4F5B41161C6E",
    "Success":true
}

错误码

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