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

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

调试

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

请求参数

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

系统规定参数。取值:ListCallDetailRecords。

InstanceId String ccc-test

呼叫中心实例ID。

PageNumber Integer 1

分页序号,范围1-100。

PageSize Integer 100

分页大小,范围1-100。

StartTime Long 1532448000000

获取的历史数据的起始时间,默认为当天的0时。

EndTime Long 1532707199000

获取的历史数据的终止时间,默认为当前时间。

ContactType String Outbound

按呼叫类型筛选。取值:

  • Inbound(呼入)
  • Outbound(呼出)
  • Back2Back(双呼)
ContactDisposition String Success

按挂断类型筛选。取值:

  • Success(正常)
  • NoAnswer(未接通)
  • AbandonedInContactFlow(IVR中放弃)
  • AbandonedInQueue(排队放弃)
  • AbandonedRing(振铃放弃)
  • Reject(客户拒接)
ContactId String job-125152394144124921

通过指定的contactId来查询某一通电话的记录,contactId可以通过软电话SDK发生通话时获取到。如果传入该参数,则自动忽略其他查询参数。

AgentId String ccc-user@ccc-test

坐席ID。

SkillGroupId String skg-default@ccc-test

通话涉及的技能组ID。

SortOrder String ASC

如果OrderByField为空,默认按开始时间降序排列。取值: ASC/DESC。

OrderByField String statTime

排序字段。

Criteria String {"phoneNumber":"073"}

根据主叫或被叫号码模糊查询,JSON字符串。

CallingNumber String 073xxxx7539

主叫号码。

CalledNumber String 132xxxx0523

被叫号码。

SatisfactionList String ["1", "3"]

String类型的满意度列表。

SatisfactionSurveyChannel String IVR

满意度调查渠道:

  • IVR(语音满意度)
  • SMS(短信满意度)
SatisfactionDescriptionList String ["满意","一般"]

满意度描述列表。

返回数据

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

响应码。

Data Struct

数据。

List Array of CallDetailRecord

通话记录列表。

AgentIds String user-test@ccc-test

坐席ID列表,多个值用逗号分隔。

AgentNames String 云呼测试坐席

坐席名称列表。

CallDuration String 30

通话时长,单位秒。

CalledNumber String 133xxxx2315

被叫号码。

CallingNumber String 053xxxx3128

主叫号码。

ContactDisposition String Success

电话结束原因。 Success(正常),NoAnswer(未接通),AbandonedInContactFlow(IVR中放弃),AbandonedInQueue(排队放弃),AbandonedRing(振铃放弃),Reject(客户拒接)。

ContactId String job-125152394144124921

通话ID。

ContactType String Outbound

通话类型。取值:INBOUND(呼入),OUTBOND(呼出)。

EstablishedTime Long 1532448000000

通话建立的时间,如果通话没有建立,此值为空。

InstanceId String ccc-test

呼叫中心实例ID。

IvrTime Long 8

IVR时长,单位秒。即从开始进入IVR到开始进入转人工队列(或客户放弃)之间的时长。

QueueTime Long 0

排队时长,单位秒。即从开始进入转人工队列到坐席开始振铃(或客户放弃,队列超时,队列溢出)之间的时长。

RecordingDuration Long 10

录音时长,单位秒。

RecordingReady Boolean true

录音是否已经生成。若通话没有建立,则返回false。

ReleaseInitiator String agent

挂断方:

  • agent(坐席)
  • customer(客户)
ReleaseTime Long 1532707199000

通话结束时间。

RingTime Long 5

振铃时长,单位秒。即从坐席振铃到坐席接起(或客户放弃)之间的时长。

SatisfactionDescription String 满意

满意度描述。对应于满意度IVR中满意度模块的配置。

SatisfactionIndex Integer 1

满意度。即满意度按键数字(1位数字)的值。

SatisfactionSurveyChannel String IVR

满意度调查渠道。

SatisfactionSurveyOffered Boolean true

是否发送了满意度。

SkillGroupIds String skg-default@ccc-test

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

SkillGroupNames String 默认技能组

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

StartTime Long 1532448000000

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

WaitTime Long 5

客户等待时长,单位秒。即 QueueTime

  • RingTime,若客户等待期间放弃,则为0。
PageNumber Integer 1

分页序号。

PageSize Integer 10

分页大小。

TotalCount Integer 11

总条目数,只有PageNumber为1才会返回,其他都是0。

HttpStatusCode Integer 200

HTTP状态码。

Message String

响应信息。

RequestId String EEEE671A-3E24-4A04-81E6-6C4F5B39DF75

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListCallDetailRecords
&InstanceId=ccc-test
&PageNumber=1
&PageSize=100
&<公共请求参数>

正常返回示例

XML格式

<RequestId>EEEE671A-3E24-4A04-81E6-6C4F5B39DF75</RequestId>
<Message>无</Message>
<HttpStatusCode>200</HttpStatusCode>
<Data>
    <TotalCount>11</TotalCount>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <List>
        <SkillGroupIds>skg-default@ccc-test</SkillGroupIds>
        <IvrTime>8</IvrTime>
        <CalledNumber>133xxxx2315</CalledNumber>
        <ContactType>Outbound</ContactType>
        <ReleaseInitiator>agent</ReleaseInitiator>
        <InstanceId>ccc-test</InstanceId>
        <ContactDisposition>Success</ContactDisposition>
        <StartTime>1532448000000</StartTime>
        <SatisfactionIndex>1</SatisfactionIndex>
        <RingTime>5</RingTime>
        <ContactId>job-125152394144124921</ContactId>
        <CallDuration>30</CallDuration>
        <CallingNumber>053xxxx3128</CallingNumber>
        <ReleaseTime>1532707199000</ReleaseTime>
        <RecordingReady>true</RecordingReady>
        <SkillGroupNames>默认技能组</SkillGroupNames>
        <SatisfactionSurveyChannel>IVR</SatisfactionSurveyChannel>
        <SatisfactionSurveyOffered>true</SatisfactionSurveyOffered>
        <SatisfactionDescription>满意</SatisfactionDescription>
        <AgentIds>user-test@ccc-test</AgentIds>
        <QueueTime>0</QueueTime>
        <EstablishedTime>1532448000000</EstablishedTime>
        <WaitTime>5</WaitTime>
        <AgentNames>云呼测试坐席</AgentNames>
        <RecordingDuration>10</RecordingDuration>
    </List>
</Data>
<Code>OK</Code>

JSON格式

{
    "RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
    "Message": "无",
    "HttpStatusCode": "200",
    "Data": {
        "TotalCount": "11",
        "PageSize": "10",
        "PageNumber": "1",
        "List": [
            {
                "SkillGroupIds": "skg-default@ccc-test",
                "IvrTime": "8",
                "CalledNumber": "133xxxx2315",
                "ContactType": "Outbound",
                "ReleaseInitiator": "agent",
                "InstanceId": "ccc-test",
                "ContactDisposition": "Success",
                "StartTime": "1532448000000",
                "SatisfactionIndex": "1",
                "RingTime": "5",
                "ContactId": "job-125152394144124921",
                "CallDuration": "30",
                "CallingNumber": "053xxxx3128",
                "ReleaseTime": "1532707199000",
                "RecordingReady": "true",
                "SkillGroupNames": "默认技能组",
                "SatisfactionSurveyChannel": "IVR",
                "SatisfactionSurveyOffered": "true",
                "SatisfactionDescription": "满意",
                "AgentIds": "user-test@ccc-test",
                "QueueTime": "0",
                "EstablishedTime": "1532448000000",
                "WaitTime": "5",
                "AgentNames": "云呼测试坐席",
                "RecordingDuration": "10"
            }
        ]
    },
    "Code": "OK"
}

错误码

HttpCode 错误码 错误信息 描述
500 InternalService.Common An internal service error occurred. %s 内部服务错误。
400 Parameter.Format The format of parameter %s is invalid. %s 该参数的格式不合法。

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