调用ListCallDetailRecords获取呼叫中心中的通话详单数据。

从系统可靠性角度考虑,目前查询日期区间限制为最大7天。如果业务需要做大量数据的处理,建议您导出数据到自己的系统,做进一步的数据使用。另外页面中的下载报表功能,可以导出1个月的数据。

注意:为了保证查询效率,返回数据中的 TotalCount 字段,只会在查询第一页时赋值。查询其他页时返回0。

调试

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

请求参数

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

系统规定参数。取值:ListCallDetailRecords

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb3****

呼叫中心实例ID

PageNumber Integer 1

分页序号

PageSize Integer 10

分页大小,最大数量为100

PhoneNumber String 1234456****

待获取数据的呼叫中心的电话号码

StartTime Long 1532448000000

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

StopTime Long 1532707199000

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

Criteria String 客服组

搜索条件。

可以根据客户电话、坐席姓名、技能组名称来搜索。

ContactType String Outbound,Inbound

按呼叫类型筛选。

取值:Inbound(呼入),Outbound(呼出),Back2Back(双呼),PredictiveDial(预测试外呼),PrivacyDial(虚拟号码外呼) 多个条件以逗号隔开。

ContactDisposition String NoAnswer,AbandonedInContactFlow,AbandonedRing

按挂断类型筛选。

取值:Success(正常),NoAnswer(未接通),AbandonedInContactFlow(IVR中放弃),AbandonedInQueue(排队放弃),AbandonedRing(振铃放弃),QueueOverflow(排队超时),OneStepTransfer(转外线),多个条件以逗号隔开。

WithRecording Boolean true

是否需要录音。默认需要,显式的指明不需要可以加快查询速度。

ContactId String 123

通过指定的contactId来查询某一通电话的记录,contactId可以通过软电话SDK发生通话时获取到。

OrderBy String ASC

按时间升降序排列。默认升序,取值: ASC/DESC。

返回数据

名称 类型 示例值 描述
CallDetailRecords Struct

获取到的通话详单

List Array of CallDetailRecord

对象列表

CallDetailRecord
AgentNames String 千牛卖家测试

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

Agents Array of CallDetailAgent

座席列表

CallDetailAgent
AgentId String 101820677302****

座席ID,等同于该座席的RAM子账户ID。

Feedback String 基本技能太差

不满意情况下二级反馈信息

Satisfaction String 不满意

满意度

CalledNumber String 1234444****

被叫号码

CallingNumber String 07553656****

主叫号码

ContactDisposition String Success

电话结束原因。

参考枚举值:Success(正常),NoAnswer(未接通),AbandonedInContactFlow(IVR中放弃),AbandonedInQueue(排队放弃),AbandonedRing(振铃放弃),QueueOverflow(排队超时),OneStepTransfer(转外线)。

ContactId String 2118423213

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

ContactType String Outbound

通话类型。

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

Duration Integer 15

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

Feedback String 基本技能太差

不满意度反馈描述

InstanceId String 14b32e95-405b-4514-8118-85e64b22****

呼叫中心实例ID

Recordings Array of Recording

录音列表

Recording
AgentId String 101820677302****

座席ID,等同于该座席的RAM子账户ID。

AgentName String 千牛卖家测试

座席名称

ContactId String 2118422093

通话ID

Duration Integer 7

通话时长

FileDescription String 20190104121607-千牛卖家测试

录音文件别名

FileName String 154657536797300080308468.wav

录音文件名

QualityCheckTaskId String xxx

智能质检任务ID

QualityCheckTid String xxx

智能质检文本ID

StartTime Long 1546575367000

通话开始时间

Satisfaction Integer 3

满意度对应的按键,比如1或者2。

注:只有在发送满意度邀请给客户,并且客户做出评价反馈后,才返回本字段。如果未发送或者发送但未评价,返回内容中不包含本字段。

SatisfactionDesc String 不满意

在发送满意度客户评价的情况下,该字段为满意度按键(Satisfaction)对应的描述,比如满意、非常满意。若为“未发送”,表示未发送满意度评价邀请给客户;若为“未评价”,表示发送满意度邀请给客户,但客户未评价。

SkillGroupIdList String 68536c62-9c25-4201-b4fa-cb15a0d6****,68536c62-9c25-4201-b4fa-cb15a0d****

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

SkillGroupNames String 默认技能组

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

StartTime Long 1546575494000

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

PageNumber Integer 1

分页序号

PageSize Integer 5

分页大小

TotalCount Integer 3

对象总数

Code String OK

响应码

HttpStatusCode Integer 200

HTTP状态码

Message String

响应信息

RequestId String D70B6625-B54F-4831-BDC4-917A7EBBCE77

请求ID

Success Boolean true

是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=ListCallDetailRecords
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb3****
&PageNumber=1
&PageSize=10
&<公共请求参数>

正常返回示例

XML格式

<Message>无</Message>
<RequestId>D70B6625-B54F-4831-BDC4-917A7EBBCE77</RequestId>
<CallDetailRecords>
    <TotalCount>3</TotalCount>
    <PageSize>5</PageSize>
    <PageNumber>1</PageNumber>
    <List>
        <CallDetailRecord>
            <CalledNumber>1234444****</CalledNumber>
            <ContactType>Outbound</ContactType>
            <InstanceId>14b32e95-405b-4514-8118-85e64b22****</InstanceId>
            <ContactDisposition>Success</ContactDisposition>
            <Satisfaction>3</Satisfaction>
            <StartTime>1546575494000</StartTime>
            <Duration>15</Duration>
            <ContactId>2118423213</ContactId>
            <SatisfactionDesc>不满意</SatisfactionDesc>
            <CallingNumber>07553656****</CallingNumber>
            <Feedback>基本技能太差</Feedback>
            <SkillGroupNames>默认技能组</SkillGroupNames>
            <SkillGroupIdList>68536c62-9c25-4201-b4fa-cb15a0d6****,68536c62-9c25-4201-b4fa-cb15a0d****</SkillGroupIdList>
            <AgentNames>千牛卖家测试</AgentNames>
            <Agents>
                <CallDetailAgent>
                    <Feedback>基本技能太差</Feedback>
                    <Satisfaction>不满意</Satisfaction>
                    <AgentId>101820677302****</AgentId>
                </CallDetailAgent>
            </Agents>
            <Recordings>
                <Recording>
                    <FileDescription>20190104121607-千牛卖家测试</FileDescription>
                    <QualityCheckTid>xxx</QualityCheckTid>
                    <FileName>154657536797300080308468.wav</FileName>
                    <StartTime>1546575367000</StartTime>
                    <Duration>7</Duration>
                    <QualityCheckTaskId>xxx</QualityCheckTaskId>
                    <AgentName>千牛卖家测试</AgentName>
                    <AgentId>101820677302****</AgentId>
                    <ContactId>2118422093</ContactId>
                </Recording>
            </Recordings>
        </CallDetailRecord>
    </List>
</CallDetailRecords>
<HttpStatusCode>200</HttpStatusCode>
<Code>OK</Code>
<Success>true</Success>

JSON格式

{
    "Message": "无",
    "RequestId": "D70B6625-B54F-4831-BDC4-917A7EBBCE77",
    "CallDetailRecords": {
        "TotalCount": 3,
        "PageSize": 5,
        "PageNumber": 1,
        "List": {
            "CallDetailRecord": {
                "CalledNumber": "1234444****",
                "ContactType": "Outbound",
                "InstanceId": "14b32e95-405b-4514-8118-85e64b22****",
                "ContactDisposition": "Success",
                "Satisfaction": 3,
                "StartTime": 1546575494000,
                "Duration": 15,
                "ContactId": 2118423213,
                "SatisfactionDesc": "不满意",
                "CallingNumber": "07553656****",
                "Feedback": "基本技能太差",
                "SkillGroupNames": "默认技能组",
                "SkillGroupIdList": "68536c62-9c25-4201-b4fa-cb15a0d6****,68536c62-9c25-4201-b4fa-cb15a0d****",
                "AgentNames": "千牛卖家测试",
                "Agents": {
                    "CallDetailAgent": {
                        "Feedback": "基本技能太差",
                        "Satisfaction": "不满意",
                        "AgentId": "101820677302****"
                    }
                },
                "Recordings": {
                    "Recording": {
                        "FileDescription": "20190104121607-千牛卖家测试",
                        "QualityCheckTid": "xxx",
                        "FileName": "154657536797300080308468.wav",
                        "StartTime": 1546575367000,
                        "Duration": 7,
                        "QualityCheckTaskId": "xxx",
                        "AgentName": "千牛卖家测试",
                        "AgentId": "101820677302****",
                        "ContactId": 2118422093
                    }
                }
            }
        }
    },
    "HttpStatusCode": 200,
    "Code": "OK",
    "Success": true
}

错误码

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