调用GetHistoricalInstanceReport获取呼叫中心实例的历史数据报表。

调试

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

请求参数

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

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

InstanceId String ccc-test

呼叫中心实例ID。

StartTime Long 1532448000000

获取的历史数据的起始时间,默认为当天的0时,最早为当前时间往前180天。统计的时间精度为小时,向前取整,闭区间。

EndTime Long 1532707199000

获取的历史数据的终止时间,默认为当前时间。统计的时间精度为小时,向后取整,开区间。例如:开始时间为 11:12:20,结束时间为 11:45:50,则对齐后的入参时间范围为

11:00:00, 12:00:00) ,即大于等于11点,小于12点。

返回数据

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

响应码。

Data Struct

数据。

Inbound Struct

呼入指标。

AbandonRate Float 0

放弃率。计算公式为:CallsAbandoned/CallsOffered(由于放弃事件与分配事件可能落在不同的时间范围内,所以某些情况下结果可能大于100%)。

AverageAbandonTime Float 0

平均放弃时长,单位秒。计算公式为:TotalAbandonTime/CallsAbandoned。

AverageAbandonedInIVRTime Float 0

平均IVR放弃时长,单位秒。计算公式为:TotalAbandonedInIVRTime/CallsAbandonedInIVR。

AverageAbandonedInQueueTime Float 0

平均排队放弃时长,单位秒。计算公式为:TotalAbandonedInQueueTime/CallsAbandonedInQueue。

AverageAbandonedInRingTime Float 0

平均振铃放弃时长,单位秒。计算公式为:TotalAbandonedInRingTime/CallsAbandonedInRing。

AverageHoldTime Float 0

平均通话保持时长,单位秒。计算公式为:TotalHoldTime/CallsHold。

AverageRingTime Float 0

平均振铃时长,单位秒。计算公式为: TotalRingTime/CallsRinged。

AverageTalkTime Float 0

平均通话时长,单位秒。计算公式为:TotalTalkTime/CallsHandled。

AverageWaitTime Float 0

平均等待时长,平均每通电话的坐席接起前等待时长。计算公式为: TotalWaitTime/CallsHandled。

AverageWorkTime Float 0

平均话后处理时长,单位秒。计算公式为: TotalWorkTime/CallsHandled。

CallsAbandoned Long 0

放弃量。计算公式为:CallsAbandonedInIVR+CallsAbandonedInQueue+CallsAbandonedInRing。

CallsAbandonedInIVR Long 0

IVR放弃量,即电话进入IVR流程之后在IVR环节客户挂机的数量。

CallsAbandonedInQueue Long 0

队列放弃量,即电话进入队列之后在排队环节客户挂机的数量。

CallsAbandonedInRing Long 0

振铃放弃量,即坐席振铃中客户挂机的数量。

CallsAttendedTransferred Long 0

咨询转接量,即发生咨询转接的电话数量。若一通电话发起多次转接,算一次。

CallsBlindTransferred Long 0

直接转接量,即发生直接转接的电话数量。若一通电话发起多次转接,算一次。

CallsHandled Long 0

应答量,即坐席应答的电话数量。若一通电话被多个坐席应答,算一次。

CallsHold Long 0

保持量,即发生通话保持的电话数量。若一通电话保持多次,算一次。

CallsOffered Long 0

呼入到呼叫中心的电话数量。

CallsQueued Long 0

进入队列的电话数量,若一通电话多次进入队列,算一次。

CallsRinged Long 0

座席振铃的电话数量,若一通电话分配给多个座席并产生了振铃,算一次。

HandleRate Float 0

应答率。计算公式为:CallsHandled/CallsOffered(由于应答事件与分配事件可能落在不同的时间范围内,所以某些情况下结果可能大于100%)。

MaxAbandonTime Long 0

最大放弃时长,单位秒。

MaxAbandonedInIVRTime Long 0

最大IVR放弃时长,单位秒。

MaxAbandonedInQueueTime Long 0

最大排队放弃时长,单位秒。

MaxAbandonedInRingTime Long 0

最大振铃放弃时长,单位秒。

MaxHoldTime Long 0

最大通话保持时长,单位秒。

MaxRingTime Long 0

最大振铃时长,单位秒。

MaxTalkTime Long 0

最大通话时长,单位秒。

MaxWaitTime Long 0

最大等待时长,单位秒。

MaxWorkTime Long 0

最大话后处理时长,单位秒。

SatisfactionIndex Float 0

满意度指数,即满意度按键数字(1位数字)的平均值。

SatisfactionRate Float 0

满意率,计算公式为:标记为满意的评价数/满意度调查响应次数。

SatisfactionSurveysOffered Long 0

满意度调查发送次数。

SatisfactionSurveysResponded Long 0

满意度调查响应次数。

ServiceLevel20 Float 0

20S服务水平,等待时长小于等于20秒的电话数量/CallsQueued。

TotalAbandonTime Long 0

总放弃时长,单位秒。

TotalAbandonedInIVRTime Long 0

总IVR放弃时长,单位秒。

TotalAbandonedInQueueTime Long 0

总排队放弃时长,单位秒。

TotalAbandonedInRingTime Long 0

总振铃放弃时长,单位秒。

TotalHoldTime Long 0

总通话保持时长,单位秒。

TotalRingTime Long 0

总振铃时长,单位秒。

TotalTalkTime Long 0

总通话时长,单位秒。

TotalWaitTime Long 0

总等待时长,单位秒。

TotalWorkTime Long 0

总话后处理时长,单位秒。

Outbound Struct

呼出指标。

AnswerRate Float 0

接通率,计算公式为:CallsAnswered/CallsDialed(由于接听事件与应答事件可能落在不同的时间范围内,所以某些情况下结果可能大于100%)。

AverageDialingTime Float 0

平均拨号时长,单位秒。计算公式为:TotalDialingTime/CallsDialed。

AverageHoldTime Float 0

平均通话保持时长,单位秒。计算公式为:TotalHoldTime/CallsHold。

AverageRingTime Float 0

平均振铃时长,单位秒。计算公式为: TotalRingTime/CallsRinged。

AverageTalkTime Float 0

平均通话时长,单位秒。计算公式为:TotalTalkTime/CallsAnswered。

AverageWorkTime Float 0

平均话后处理时长,单位秒。计算公式为:TotalWorkTime/CallsDialed。

CallsAnswered Long 0

接通量。

CallsAttendedTransferred Long 0

咨询转接量,即发生咨询转接的电话数量。若一通电话发起多次转接,算一次。

CallsBlindTransferred Long 0

直接转接量,即发生直接转接的电话数量。若一通电话发起多次转接,算一次。

CallsDialed Long 0

拨号量。

CallsHold Integer 0

保持量,即发生通话保持的电话数量。若一通电话保持多次,算一次。

CallsRinged Long 0

坐席振铃的电话数量,若一通电话分配给多个坐席并产生了振铃,算一次。

MaxDialingTime Long 0

最大拨号时长,单位秒。

MaxHoldTime Long 0

最大通话保持时长,单位秒。

MaxRingTime Long 0

最大振铃时长,单位秒。

MaxTalkTime Long 0

最大通话时长,单位秒。

MaxWorkTime Long 0

最大话后处理时长,单位秒。

SatisfactionIndex Float 0

满意度指数,即满意度按键数字(1位数字)的平均值。

SatisfactionRate Float 0

满意率,计算公式为:标记为满意的评价数/满意度调查响应次数。

SatisfactionSurveysOffered Long 0

满意度调查发送次数。

SatisfactionSurveysResponded Long 0

满意度调查响应次数。

TotalDialingTime Long 0

总拨号时长,单位秒。

TotalHoldTime Long 0

总通话保持时长,单位秒。

TotalRingTime Long 0

总振铃时长,单位秒。

TotalTalkTime Long 0

总通话时长,单位秒。

TotalWorkTime Long 0

总话后处理时长,单位秒。

Overall Struct

整体指标。

AverageBreakTime Float 0

平均小休时长,单位秒。计算公式为:TotalBreakTime/小休次数。小休次数为非接口统计字段。

AverageHoldTime Float 0

平均通话保持时长,单位秒。计算公式为:TotalHoldTime/(呼入CallsHold+呼出CallsHold)。

AverageReadyTime Float 0

平均就绪时长,单位秒。计算公式为:TotalReadyTime/就绪次数。就绪次数为非接口统计字段。(是否需要添加?)

AverageTalkTime Float 0

平均通话时长,单位秒。计算公式为: TotalTalkTime/(CallsAnswered+CallsHandled)。

AverageWorkTime Float 0

平均话后处理时长,单位秒。计算公式为:TotalWorkTime/TotalCalls。

MaxBreakTime Long 0

最大小休时长,单位秒。

MaxHoldTime Long 0

最大通话保持时长,单位秒。

MaxReadyTime Long 0

最大就绪时长,单位秒。

MaxTalkTime Long 0

最大通话时长,单位秒。

MaxWorkTime Long 0

最大话后处理时长,单位秒。

OccupancyRate Float 0

座席利用率,计算公式为: (TotalworkTime + TotalTalkTime ) / TotalLoggedInTime。

SatisfactionIndex Float 0

满意度指数,即满意度按键数字(1位数字)的平均值。

SatisfactionRate Float 0

满意率,计算公式为:标记为满意的评价数/满意度调查响应次数。

SatisfactionSurveysOffered Long 0

满意度调查发送次数。

SatisfactionSurveysResponded Long 0

满意度调查响应次数。

TotalBreakTime Long 0

总小休时长,单位为秒。

TotalCalls Long 0

总电话量。计算公式为:CallsOffered

  • CallsDialed。
TotalHoldTime Long 0

总保持时长,单位秒。

TotalLoggedInTime Long 0

总登录时长,单位秒。不包含小休时长。

TotalReadyTime Long 0

总就绪时长,单位秒。

TotalTalkTime Long 0

总通话时长,单位秒。

TotalWorkTime Long 0

总话后处理时长,单位秒。

HttpStatusCode Integer 200

HTTP状态码。

Message String

响应信息。

RequestId String 943D8EF3-3321-471F-A104-51C96FCA94D6

请求ID。

示例

请求示例

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

正常返回示例

XML格式

<RequestId>943D8EF3-3321-471F-A104-51C96FCA94D6</RequestId>
<Message>无</Message>
<HttpStatusCode>200</HttpStatusCode>
<Data>
    <Inbound>
        <ServiceLevel20>0</ServiceLevel20>
        <CallsAbandonedInQueue>0</CallsAbandonedInQueue>
        <TotalWorkTime>0</TotalWorkTime>
        <TotalHoldTime>0</TotalHoldTime>
        <CallsRinged>0</CallsRinged>
        <MaxAbandonedInIVRTime>0</MaxAbandonedInIVRTime>
        <AverageHoldTime>0</AverageHoldTime>
        <MaxRingTime>0</MaxRingTime>
        <CallsOffered>0</CallsOffered>
        <CallsAbandoned>0</CallsAbandoned>
        <SatisfactionIndex>0</SatisfactionIndex>
        <CallsHold>0</CallsHold>
        <MaxAbandonedInRingTime>0</MaxAbandonedInRingTime>
        <TotalRingTime>0</TotalRingTime>
        <HandleRate>0</HandleRate>
        <TotalAbandonedInIVRTime>0</TotalAbandonedInIVRTime>
        <AverageAbandonedInQueueTime>0</AverageAbandonedInQueueTime>
        <TotalTalkTime>0</TotalTalkTime>
        <AverageWaitTime>0</AverageWaitTime>
        <TotalAbandonedInRingTime>0</TotalAbandonedInRingTime>
        <CallsQueued>0</CallsQueued>
        <MaxTalkTime>0</MaxTalkTime>
        <SatisfactionRate>0</SatisfactionRate>
        <AverageAbandonedInIVRTime>0</AverageAbandonedInIVRTime>
        <TotalAbandonTime>0</TotalAbandonTime>
        <MaxHoldTime>0</MaxHoldTime>
        <AverageTalkTime>0</AverageTalkTime>
        <CallsBlindTransferred>0</CallsBlindTransferred>
        <CallsAbandonedInIVR>0</CallsAbandonedInIVR>
        <MaxAbandonedInQueueTime>0</MaxAbandonedInQueueTime>
        <SatisfactionSurveysOffered>0</SatisfactionSurveysOffered>
        <CallsAbandonedInRing>0</CallsAbandonedInRing>
        <CallsHandled>0</CallsHandled>
        <MaxWaitTime>0</MaxWaitTime>
        <SatisfactionSurveysResponded>0</SatisfactionSurveysResponded>
        <CallsAttendedTransferred>0</CallsAttendedTransferred>
        <MaxAbandonTime>0</MaxAbandonTime>
        <AverageRingTime>0</AverageRingTime>
        <TotalWaitTime>0</TotalWaitTime>
        <AverageAbandonTime>0</AverageAbandonTime>
        <AverageAbandonedInRingTime>0</AverageAbandonedInRingTime>
        <TotalAbandonedInQueueTime>0</TotalAbandonedInQueueTime>
        <AverageWorkTime>0</AverageWorkTime>
        <MaxWorkTime>0</MaxWorkTime>
        <AbandonRate>0</AbandonRate>
    </Inbound>
    <Outbound>
        <TotalDialingTime>0</TotalDialingTime>
        <TotalWorkTime>0</TotalWorkTime>
        <TotalHoldTime>0</TotalHoldTime>
        <CallsRinged>0</CallsRinged>
        <AverageHoldTime>0</AverageHoldTime>
        <MaxRingTime>0</MaxRingTime>
        <SatisfactionIndex>0</SatisfactionIndex>
        <CallsHold>0</CallsHold>
        <TotalRingTime>0</TotalRingTime>
        <AverageDialingTime>0</AverageDialingTime>
        <CallsAnswered>0</CallsAnswered>
        <TotalTalkTime>0</TotalTalkTime>
        <CallsDialed>0</CallsDialed>
        <MaxDialingTime>0</MaxDialingTime>
        <MaxTalkTime>0</MaxTalkTime>
        <SatisfactionRate>0</SatisfactionRate>
        <MaxHoldTime>0</MaxHoldTime>
        <AverageTalkTime>0</AverageTalkTime>
        <AnswerRate>0</AnswerRate>
        <CallsBlindTransferred>0</CallsBlindTransferred>
        <SatisfactionSurveysOffered>0</SatisfactionSurveysOffered>
        <SatisfactionSurveysResponded>0</SatisfactionSurveysResponded>
        <CallsAttendedTransferred>0</CallsAttendedTransferred>
        <AverageRingTime>0</AverageRingTime>
        <AverageWorkTime>0</AverageWorkTime>
        <MaxWorkTime>0</MaxWorkTime>
    </Outbound>
    <Overall>
        <TotalReadyTime>0</TotalReadyTime>
        <TotalCalls>0</TotalCalls>
        <TotalBreakTime>0</TotalBreakTime>
        <TotalWorkTime>0</TotalWorkTime>
        <TotalHoldTime>0</TotalHoldTime>
        <SatisfactionSurveysOffered>0</SatisfactionSurveysOffered>
        <AverageHoldTime>0</AverageHoldTime>
        <SatisfactionIndex>0</SatisfactionIndex>
        <AverageBreakTime>0</AverageBreakTime>
        <SatisfactionSurveysResponded>0</SatisfactionSurveysResponded>
        <TotalTalkTime>0</TotalTalkTime>
        <AverageReadyTime>0</AverageReadyTime>
        <TotalLoggedInTime>0</TotalLoggedInTime>
        <MaxTalkTime>0</MaxTalkTime>
        <SatisfactionRate>0</SatisfactionRate>
        <MaxReadyTime>0</MaxReadyTime>
        <AverageWorkTime>0</AverageWorkTime>
        <MaxWorkTime>0</MaxWorkTime>
        <MaxBreakTime>0</MaxBreakTime>
        <OccupancyRate>0</OccupancyRate>
        <MaxHoldTime>0</MaxHoldTime>
        <AverageTalkTime>0</AverageTalkTime>
    </Overall>
</Data>
<Code>OK</Code>

JSON格式

{
    "RequestId": "943D8EF3-3321-471F-A104-51C96FCA94D6",
    "Message": "无",
    "HttpStatusCode": "200",
    "Data": {
        "Inbound": {
            "ServiceLevel20": "0",
            "CallsAbandonedInQueue": "0",
            "TotalWorkTime": "0",
            "TotalHoldTime": "0",
            "CallsRinged": "0",
            "MaxAbandonedInIVRTime": "0",
            "AverageHoldTime": "0",
            "MaxRingTime": "0",
            "CallsOffered": "0",
            "CallsAbandoned": "0",
            "SatisfactionIndex": "0",
            "CallsHold": "0",
            "MaxAbandonedInRingTime": "0",
            "TotalRingTime": "0",
            "HandleRate": "0",
            "TotalAbandonedInIVRTime": "0",
            "AverageAbandonedInQueueTime": "0",
            "TotalTalkTime": "0",
            "AverageWaitTime": "0",
            "TotalAbandonedInRingTime": "0",
            "CallsQueued": "0",
            "MaxTalkTime": "0",
            "SatisfactionRate": "0",
            "AverageAbandonedInIVRTime": "0",
            "TotalAbandonTime": "0",
            "MaxHoldTime": "0",
            "AverageTalkTime": "0",
            "CallsBlindTransferred": "0",
            "CallsAbandonedInIVR": "0",
            "MaxAbandonedInQueueTime": "0",
            "SatisfactionSurveysOffered": "0",
            "CallsAbandonedInRing": "0",
            "CallsHandled": "0",
            "MaxWaitTime": "0",
            "SatisfactionSurveysResponded": "0",
            "CallsAttendedTransferred": "0",
            "MaxAbandonTime": "0",
            "AverageRingTime": "0",
            "TotalWaitTime": "0",
            "AverageAbandonTime": "0",
            "AverageAbandonedInRingTime": "0",
            "TotalAbandonedInQueueTime": "0",
            "AverageWorkTime": "0",
            "MaxWorkTime": "0",
            "AbandonRate": "0"
        },
        "Outbound": {
            "TotalDialingTime": "0",
            "TotalWorkTime": "0",
            "TotalHoldTime": "0",
            "CallsRinged": "0",
            "AverageHoldTime": "0",
            "MaxRingTime": "0",
            "SatisfactionIndex": "0",
            "CallsHold": "0",
            "TotalRingTime": "0",
            "AverageDialingTime": "0",
            "CallsAnswered": "0",
            "TotalTalkTime": "0",
            "CallsDialed": "0",
            "MaxDialingTime": "0",
            "MaxTalkTime": "0",
            "SatisfactionRate": "0",
            "MaxHoldTime": "0",
            "AverageTalkTime": "0",
            "AnswerRate": "0",
            "CallsBlindTransferred": "0",
            "SatisfactionSurveysOffered": "0",
            "SatisfactionSurveysResponded": "0",
            "CallsAttendedTransferred": "0",
            "AverageRingTime": "0",
            "AverageWorkTime": "0",
            "MaxWorkTime": "0"
        },
        "Overall": {
            "TotalReadyTime": "0",
            "TotalCalls": "0",
            "TotalBreakTime": "0",
            "TotalWorkTime": "0",
            "TotalHoldTime": "0",
            "SatisfactionSurveysOffered": "0",
            "AverageHoldTime": "0",
            "SatisfactionIndex": "0",
            "AverageBreakTime": "0",
            "SatisfactionSurveysResponded": "0",
            "TotalTalkTime": "0",
            "AverageReadyTime": "0",
            "TotalLoggedInTime": "0",
            "MaxTalkTime": "0",
            "SatisfactionRate": "0",
            "MaxReadyTime": "0",
            "AverageWorkTime": "0",
            "MaxWorkTime": "0",
            "MaxBreakTime": "0",
            "OccupancyRate": "0",
            "MaxHoldTime": "0",
            "AverageTalkTime": "0"
        }
    },
    "Code": "OK"
}

错误码

HttpCode 错误码 错误信息 描述
400 Parameter.Blank The parameter %s may not be null or blank. 该参数不能为null或含有空白符的字符串。

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