GetHistoricalInstanceReport - 获取历史实例数据报表

调用GetHistoricalInstanceReport获取指定实例的历史数据报表。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceIdstring

实例 ID。

ccc-test
StartTimelong

获取的历史数据的起始时间,格式为 Unix 时间戳,单位毫秒,非必填,默认为当天的 0 时,最早为当前时间往前 180 天,统计的时间精度为小时,向前取整,闭区间。

1532448000000
EndTimelong

获取的历史数据的终止时间,格式为 Unix 时间戳,单位毫秒,非必填,默认为当前时间,统计的时间精度为小时,向后取整,开区间。例如:开始时间为 11:12:20,结束时间为 11:45:50,则对齐后的入参时间范围为[11:00:00,12:00:00) ,即大于等于 11 点,小于 12 点。

1532707199000
MediaTypestring

媒体类型,默认是语音(Audio), 其他可选参数包括 Chat 和 Video.

VIDEO

返回参数

名称类型描述示例值
object
Codestring

响应码。

OK
HttpStatusCodeinteger

HTTP 状态码。

200
Messagestring

响应信息。

RequestIdstring

请求 ID。

943D8EF3-3321-471F-A104-51C96FCA94D6
Dataobject

数据。

Inboundobject

呼入数据。

AverageRingTimefloat

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

0
CallsVoicemaillong

转语音信箱的通话数量,当通话进入了 IVR 中配置的语音信箱模块,计数加 1。

0
MaxAbandonedInIVRTimelong

最大 IVR 放弃时长,单位秒。IVR 放弃的定义是客户在 IVR 交互过程中挂机,不包括排队状态下客户挂机,不包括通话分配坐席后坐席振铃过程中客户挂机。

100
CallsHandledlong

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

0
CallsIVRExceptionlong

发生 IVR 异常的通话数量,判定条件是 IVR 进入了挂机原因节点且挂机原因节点设置的挂机原因为转人工失败,此时计数加 1。

0
CallsAbandonedInIVRlong

IVR 放弃量,即电话进入 IVR 流程之后在 IVR 环节客户挂机的数量,判断依据为通话详情的挂断原因为 IVR 放弃。

0
MaxWorkTimelong

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

0
TotalHoldTimelong

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

0
MaxAbandonTimelong

最大放弃时长,单位秒。放弃的定义是通话进入 IVR 后,坐席接起前,客户发起挂机。

0
AverageAbandonTimefloat

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

0
CallsRingedlong

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

0
CallsQueuingFailedlong

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

0
TotalRingTimelong

总振铃时长,单位秒。

0
AbandonRatefloat

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

0
TotalTalkTimelong

总通话时长,单位秒。

0
MaxAbandonedInRingTimelong

最大振铃放弃时长,单位秒。振铃放弃的定义是通话分配到坐席后,坐席正在振铃,此时客户挂机。

0
CallsBlindTransferredlong

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

0
AverageAbandonedInIVRTimefloat

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

0
AverageAbandonedInQueueTimefloat

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

0
MaxWaitTimelong

最大等待时长,单位秒。

0
AverageTalkTimefloat

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

0
CallsAttendedTransferredlong

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

0
TotalAbandonedInIVRTimelong

总 IVR 放弃时长,单位秒。

0
CallsQueuingOverflowlong

队列溢出的通话数量,队列溢出指通话在 IVR 排队时队列溢出。

0
CallsAbandonedInRinglong

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

0
TotalAbandonedInRingTimelong

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

0
TotalWorkTimelong

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

0
AverageWaitTimefloat

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

0
AverageWorkTimefloat

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

0
CallsQueuedlong

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

0
AverageAbandonedInRingTimefloat

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

0
SatisfactionIndexfloat

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

0
CallsAbandonedlong

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

0
MaxAbandonedInQueueTimelong

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

0
CallsAbandonedInVoiceNavigatorlong

通话在智能导航模块放弃的数量。

0
TotalWaitTimelong

总等待时长,单位秒。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
MaxRingTimelong

最大振铃时长,单位秒。

0
TotalAbandonTimelong

总放弃时长,单位秒。

0
CallsOfferedlong

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

0
CallsQueuingTimeoutlong

在排队阶段超时的通话数量。

0
ServiceLevel20float

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

0
MaxHoldTimelong

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

0
CallsForwardToOutsideNumberlong

发生转外线的通话数量。

0
SatisfactionRatefloat

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

0
CallsHoldlong

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
HandleRatefloat

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

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
AverageHoldTimefloat

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

0
CallsAbandonedInQueuelong

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

0
TotalAbandonedInQueueTimelong

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

0
CallsCausedIVRExceptionlong

导致 IVR 异常的电话数量。

0
CallsToVoicemaillong

进入语音信箱的电话数量。

3
ServiceLevel15float

15 秒服务水平。

0.78
ServiceLevel30float

30 秒服务水平。

0.9
TotalMessagesSentlong

Chat 会话中总消息发送量。

12
TotalMessagesSentByAgentlong

Chat 会话中坐席发送的总消息量。

8
TotalMessagesSentByCustomerlong

Chat 会话中客户发送的总消息量。

4
AverageFirstResponseTimefloat

Chat 会话平均首次响应时长,单位为秒。

12
AccessChannelTypeDetailListarray<object>

各渠道的统计数据。

AccessChannelTypeDetailobject

渠道的统计数据。

AccessChannelTypestring

渠道类型。

Web
CallsOfferedlong

分配的会话数量。

5
AverageResponseTimefloat

Chat 会话平均响应时长。

15
Outboundobject

呼出指标。

AverageRingTimefloat

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

0
CallsDialedlong

拨号量。

0
CallsAnsweredlong

接通量。

0
TotalWorkTimelong

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

0
MaxWorkTimelong

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

0
TotalDialingTimelong

总拨号时长,单位秒。

0
TotalHoldTimelong

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

0
AverageWorkTimefloat

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

0
SatisfactionIndexfloat

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

0
CallsRingedlong

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

0
TotalRingTimelong

总振铃时长,单位秒。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
MaxRingTimelong

最大振铃时长,单位秒。

0
TotalTalkTimelong

总通话时长,单位秒。

0
MaxDialingTimelong

最大拨号时长,单位秒。

0
CallsBlindTransferredlong

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

0
AnswerRatefloat

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

0
MaxHoldTimelong

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

0
AverageTalkTimefloat

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

0
SatisfactionRatefloat

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

0
CallsAttendedTransferredlong

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

0
CallsHoldinteger

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
AverageHoldTimefloat

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

0
AverageDialingTimefloat

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

0
Overallobject

整体指标。

TotalTalkTimelong

总通话时长,单位秒。

0
TotalLoggedInTimelong

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

0
OccupancyRatefloat

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

0
TotalWorkTimelong

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

0
MaxHoldTimelong

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

0
MaxWorkTimelong

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

0
AverageBreakTimefloat

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

0
TotalHoldTimelong

总保持时长,单位秒。

0
SatisfactionRatefloat

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

0
MaxBreakTimelong

最大小休时长,单位秒。

0
AverageWorkTimefloat

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

0
AverageTalkTimefloat

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

0
SatisfactionIndexfloat

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
MaxReadyTimelong

最大就绪时长,单位秒。

0
AverageReadyTimefloat

平均就绪时长,单位秒。计算公式为:TotalReadyTime/就绪次数,就绪次数暂不对外暴露。

0
AverageHoldTimefloat

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

0
TotalReadyTimelong

总就绪时长,单位秒。

0
TotalBreakTimelong

总小休时长,单位为秒。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
TotalCallslong

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

0
MaxLoggedInAgentslong

此时间范围内最多同时登录的座席数量。

102
Internalobject

内部呼叫指标。

CallsDialedlong

拨号量。

100
CallsAnsweredlong

接通量。

100

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "943D8EF3-3321-471F-A104-51C96FCA94D6",
  "Data": {
    "Inbound": {
      "AverageRingTime": 0,
      "CallsVoicemail": 0,
      "MaxAbandonedInIVRTime": 100,
      "CallsHandled": 0,
      "CallsIVRException": 0,
      "CallsAbandonedInIVR": 0,
      "MaxWorkTime": 0,
      "TotalHoldTime": 0,
      "MaxAbandonTime": 0,
      "AverageAbandonTime": 0,
      "CallsRinged": 0,
      "CallsQueuingFailed": 0,
      "TotalRingTime": 0,
      "AbandonRate": 0,
      "TotalTalkTime": 0,
      "MaxAbandonedInRingTime": 0,
      "CallsBlindTransferred": 0,
      "AverageAbandonedInIVRTime": 0,
      "AverageAbandonedInQueueTime": 0,
      "MaxWaitTime": 0,
      "AverageTalkTime": 0,
      "CallsAttendedTransferred": 0,
      "TotalAbandonedInIVRTime": 0,
      "CallsQueuingOverflow": 0,
      "CallsAbandonedInRing": 0,
      "TotalAbandonedInRingTime": 0,
      "TotalWorkTime": 0,
      "AverageWaitTime": 0,
      "AverageWorkTime": 0,
      "CallsQueued": 0,
      "AverageAbandonedInRingTime": 0,
      "SatisfactionIndex": 0,
      "CallsAbandoned": 0,
      "MaxAbandonedInQueueTime": 0,
      "CallsAbandonedInVoiceNavigator": 0,
      "TotalWaitTime": 0,
      "MaxTalkTime": 0,
      "MaxRingTime": 0,
      "TotalAbandonTime": 0,
      "CallsOffered": 0,
      "CallsQueuingTimeout": 0,
      "ServiceLevel20": 0,
      "MaxHoldTime": 0,
      "CallsForwardToOutsideNumber": 0,
      "SatisfactionRate": 0,
      "CallsHold": 0,
      "SatisfactionSurveysOffered": 0,
      "HandleRate": 0,
      "SatisfactionSurveysResponded": 0,
      "AverageHoldTime": 0,
      "CallsAbandonedInQueue": 0,
      "TotalAbandonedInQueueTime": 0,
      "CallsCausedIVRException": 0,
      "CallsToVoicemail": 3,
      "ServiceLevel15": 0.78,
      "ServiceLevel30": 0.9,
      "TotalMessagesSent": 12,
      "TotalMessagesSentByAgent": 8,
      "TotalMessagesSentByCustomer": 4,
      "AverageFirstResponseTime": 12,
      "AccessChannelTypeDetailList": [
        {
          "AccessChannelType": "Web",
          "CallsOffered": 5
        }
      ],
      "AverageResponseTime": 15
    },
    "Outbound": {
      "AverageRingTime": 0,
      "CallsDialed": 0,
      "CallsAnswered": 0,
      "TotalWorkTime": 0,
      "MaxWorkTime": 0,
      "TotalDialingTime": 0,
      "TotalHoldTime": 0,
      "AverageWorkTime": 0,
      "SatisfactionIndex": 0,
      "CallsRinged": 0,
      "TotalRingTime": 0,
      "MaxTalkTime": 0,
      "MaxRingTime": 0,
      "TotalTalkTime": 0,
      "MaxDialingTime": 0,
      "CallsBlindTransferred": 0,
      "AnswerRate": 0,
      "MaxHoldTime": 0,
      "AverageTalkTime": 0,
      "SatisfactionRate": 0,
      "CallsAttendedTransferred": 0,
      "CallsHold": 0,
      "SatisfactionSurveysOffered": 0,
      "SatisfactionSurveysResponded": 0,
      "AverageHoldTime": 0,
      "AverageDialingTime": 0
    },
    "Overall": {
      "TotalTalkTime": 0,
      "TotalLoggedInTime": 0,
      "OccupancyRate": 0,
      "TotalWorkTime": 0,
      "MaxHoldTime": 0,
      "MaxWorkTime": 0,
      "AverageBreakTime": 0,
      "TotalHoldTime": 0,
      "SatisfactionRate": 0,
      "MaxBreakTime": 0,
      "AverageWorkTime": 0,
      "AverageTalkTime": 0,
      "SatisfactionIndex": 0,
      "SatisfactionSurveysOffered": 0,
      "SatisfactionSurveysResponded": 0,
      "MaxReadyTime": 0,
      "AverageReadyTime": 0,
      "AverageHoldTime": 0,
      "TotalReadyTime": 0,
      "TotalBreakTime": 0,
      "MaxTalkTime": 0,
      "TotalCalls": 0,
      "MaxLoggedInAgents": 102
    },
    "Internal": {
      "CallsDialed": 100,
      "CallsAnswered": 100
    }
  }
}

错误码

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

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

变更历史

变更时间变更内容概要操作
2023-11-22OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情