AI 助理
文档备案控制台
官方文档
首页 伶鹊 云联络中心 开发参考 API参考（云联络中心） API目录 报表 ListHistoricalSkillGroupReport - 获取技能组历史数据报表

ListHistoricalSkillGroupReport - 获取技能组历史数据报表

更新时间：
复制 MD 格式
产品详情
我的收藏

调用ListHistoricalSkillGroupReport获取指定实例下的一个或多个技能组的历史数据报表。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值
PageNumber

integer

是

分页序号，范围 1-100。

1
PageSize

integer

是

分页大小，范围 1-100。

100
SkillGroupIdList

string

否

待查询的技能组 ID 列表，格式为 JSON 数组的字符串，数组元素为技能组 ID，非必填，默认为空，表示查询当前分页下的所有技能组。

["skillgroup1@ccc-test", "skillgroup2@ccc-test2"]
StartTime

integer

否

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

1532448000000
EndTime

integer

否

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

1532707199000
InstanceId

string

是

实例 ID。

ccc-test
MediaType

string

否

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

VIDEO
SummarizeByInstanceId

boolean

否

按照实例 ID 聚合

返回参数

名称

类型

描述

示例值

object

Code

string

响应码。

OK
Data

object

数据。

List

array<object>

技能组历史数据列表。

array<object>

技能组历史数据。

Back2Back

object

双呼指标。

AgentHandleRate

number

坐席应答率。

1
AnswerRate

number

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

0.6
AverageCustomerRingTime

number

平均客户侧振铃时长，单位秒

100
AverageRingTime

number

平均振铃时长，单位秒。

100
AverageTalkTime

number

平均通话时长，单位秒。

100
CallsAnswered

integer

接通量。

100
CallsCustomerAnswered

integer

客户接听电话数量。

8
CallsDialed

integer

拨号量。

100
CustomerAnswerRate

number

客户接通率。

0.8
MaxCustomerRingTime

integer

最大客户侧振铃时长，单位秒。

100
MaxRingTime

integer

最大振铃时长，单位秒。

100
MaxTalkTime

integer

最大通话时长，单位秒。

100
TotalCustomerRingTime

integer

总客户侧振岭时长，单位秒。

100
TotalRingTime

integer

总振铃时长，单位秒。

100
TotalTalkTime

integer

总通话时长，单位秒。

100
Inbound

object

呼入指标。

AbandonRate

number

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

0
AccessChannelTypeDetails

array<object>

各渠道的统计数据。

object

各渠道的统计数据。

AccessChannelType

string

渠道类型。

Web
CallsOffered

integer

分配的会话数量。

2
AverageAbandonTime

number

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

0
AverageAbandonedInQueueTime

number

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

0
AverageAbandonedInRingTime

number

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

0
AverageFirstResponseTime

number

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

6
AverageHoldTime

number

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

0
AverageResponseTime

number

Chat 会话平均响应时长。

8
AverageRingTime

number

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

5
AverageTalkTime

number

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

64
AverageWaitTime

number

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

5
AverageWorkTime

number

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

13
CallsAbandoned

integer

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

0
CallsAbandonedInQueue

integer

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

0
CallsAbandonedInRing

integer

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

0
CallsAttendedTransferIn

integer

咨询转入量，即由其他技能组发起的咨询转接到该技能组的电话数量，同一技能组内坐席间的转接不计数。若一个坐席同时迁入多个技能组，则该电话的统计归属于签入的第一个技能组。若一通电话由其他技能组多次转接到该技能组，每次转接算一次。下同。

0
CallsAttendedTransferOut

integer

咨询转出量，即由该技能组发起的咨询转接到其他技能组的电话数量，同一技能组内坐席间的转接不计数。

0
CallsBlindTransferIn

integer

直接转入量，即由其他技能组发起的直接转接到该技能组的电话数量，同一技能组内坐席间的转接不计数。若一个坐席同时签入多个技能组，则该电话的统计归属于签入的第一个技能组。若一通电话由其他技能组多次转接到该技能组，每次转接算一次。下同。

0
CallsBlindTransferOut

integer

直接转出量，即由该技能组发起的直接转接到其他技能组的电话数量，同一技能组内坐席间的转接不计数。

0
CallsHandled

integer

应答量，即坐席应答的次数。一通电话每次进入队列后，若被多个坐席应答，算一次。

7
CallsHold

integer

保持量，即发生通话保持的次数。一通电话每次进入队列后，若发生多次通话保持，算一次。

0
CallsOffered

integer

分配量，即分配给该技能组的电话数量，包括通过队列分配的电话数量和通过转接（咨询转接和直接转接）分配的电话数量。计算公式为：CallsQueued+CallsBlindTransferIn+CallsAttentandedTransferIn。

7
CallsOverflow

integer

溢出量，即发生队列（技能组）溢出的电话数量。若一通电话多次进入同一队列，每次溢出算一次。

0
CallsQueued

integer

呼入场景进入队列（技能组）的电话数量，若一通电话多次进入同一队列，每次进入算一次。

7
CallsQueuingFailed

integer

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

0
CallsQueuingOverflow

integer

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

0
CallsQueuingTimeout

integer

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

0
CallsRinged

integer

坐席振铃的电话数量，一通电话每次进入队列后，若分配给多个座席并产生了振铃，算一次。

7
CallsTimeout

integer

超时量，即发生队列（技能组）超时的电话数量。若一通电话多次进入同一队列，每次超时算一次。

0
HandleRate

number

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

1
MaxAbandonTime

integer

最大放弃时长，单位秒。

0
MaxAbandonedInQueueTime

integer

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

0
MaxAbandonedInRingTime

integer

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

0
MaxHoldTime

integer

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

0
MaxRingTime

integer

最大振铃时长，单位秒。

12
MaxTalkTime

integer

最大通话时长，单位秒。

0
MaxWaitTime

integer

最大等待时长，单位秒。

13
MaxWorkTime

integer

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

12
SatisfactionIndex

number

满意度指数，即满意度按键数字（1 位数字）的平均值。

0
SatisfactionRate

number

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
ServiceLevel15

number

15 秒服务水平。

0.7
ServiceLevel20

number

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

0
ServiceLevel30

number

30 秒服务水平。

0.9
TotalAbandonTime

integer

总放弃时长，单位秒。

0
TotalAbandonedInQueueTime

integer

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

0
TotalAbandonedInRingTime

integer

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

0
TotalHoldTime

integer

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

0
TotalMessagesSent

integer

Chat 会话中总消息发送量。

12
TotalMessagesSentByAgent

integer

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

9
TotalMessagesSentByCustomer

integer

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

3
TotalRingTime

integer

总振铃时长，单位秒。

32
TotalTalkTime

integer

总通话时长，单位秒。

447
TotalWaitTime

integer

总等待时长，单位秒。

34
TotalWorkTime

integer

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

85
Outbound

object

呼出指标。

AnswerRate

number

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

0
AverageDialingTime

number

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

37
AverageHoldTime

number

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

0
AverageRingTime

number

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

0
AverageTalkTime

number

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

3
AverageWorkTime

number

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

2
CallsAnswered

integer

接通量。

1
CallsAttendedTransferIn

integer

咨询转入量，即由其他技能组发起的咨询转接到该技能组的电话数量，同一技能组内坐席间的转接不计数。若一个坐席同时迁入多个技能组，则该电话的统计归属于签入的第一个技能组。若一通电话由其他技能组多次转接到该技能组，每次转接算一次。下同。

0
CallsAttendedTransferOut

integer

咨询转出量，即由该技能组发起的咨询转接到其他技能组的电话数量，同一技能组内坐席间的转接不计数。

0
CallsBlindTransferIn

integer

直接转入量，即由其他技能组发起的直接转接到该技能组的电话数量，同一技能组内坐席间的转接不计数。若一个坐席同时签入多个技能组，则该电话的统计归属于签入的第一个技能组。若一通电话由其他技能组多次转接到该技能组，每次转接算一次。下同。

0
CallsBlindTransferOut

integer

直接转出量，即由该技能组发起的直接转接到其他技能组的电话数量，同一技能组内坐席间的转接不计数。

0
CallsDialed

integer

拨号量。

6
CallsHold

integer

保持量，即发生通话保持的电话数量。一通电话在转出当前技能组之前，若发生多次通话保持，算一次。

0
CallsRinged

integer

坐席振铃的电话数量，一通电话每次进入队列后，若分配给多个座席并产生了振铃，算一次。

0
MaxDialingTime

integer

最大拨号时长，单位秒。

12
MaxHoldTime

integer

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

0
MaxRingTime

integer

最大振铃时长，单位秒。

0
MaxTalkTime

integer

最大通话时长，单位秒。

0
MaxWorkTime

integer

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

0
SatisfactionIndex

number

满意度指数，即满意度按键数字（1 位数字）的平均值。

0
SatisfactionRate

number

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
TotalDialingTime

integer

总拨号时长，单位秒。

218
TotalHoldTime

integer

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

0
TotalRingTime

integer

总振铃时长，单位秒。

0
TotalTalkTime

integer

总通话时长，单位秒。

3
TotalWorkTime

integer

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

9
Overall

object

整体指标。

AverageBreakTime

number

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

0
AverageHoldTime

number

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

0
AverageReadyTime

number

平均就绪时长，单位秒。计算公式为：TotalReadyTime/就绪次数。就绪次数为非接口统计字段。

0
AverageTalkTime

number

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

0
AverageWorkTime

number

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

8
BreakCodeDetailList

array<object>

小休详情列表。

object

小休详情。

BreakCode

string

小休类型代码。

会议
Count

integer

此类型小休的发生次数。

2
Duration

integer

此类型小休的总计发生时长，单位为秒。

3600
MaxBreakTime

integer

最大小休时长，单位秒。

1
MaxHoldTime

integer

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

0
MaxReadyTime

integer

最大就绪时长，单位秒。

19328
MaxTalkTime

integer

最大通话时长，单位秒。

0
MaxWorkTime

integer

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

12
OccupancyRate

number

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

0.02332222293912065
SatisfactionIndex

number

满意度指数，即满意度按键数字（1 位数字）的平均值。

0
SatisfactionRate

number

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
TotalBreakTime

integer

总小休时长，单位为秒。

3
TotalCalls

integer

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

13
TotalHoldTime

integer

总保持时长，单位秒。

0
TotalLoggedInTime

integer

总登录时长，单位秒。 注意：不含离线和小休时长

23218
TotalReadyTime

integer

总就绪时长，单位为秒。

22428
TotalTalkTime

integer

总通话时长，单位秒。

449
TotalWorkTime

integer

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

94
SkillGroupId

string

技能组 ID。

skillgroup@ccc-test
SkillGroupName

string

技能组名称。

skillgroup
PageNumber

integer

分页序号，范围 1-100。

1
PageSize

integer

分页大小，范围 1-100。

100
TotalCount

integer

总数。

4
HttpStatusCode

integer

HTTP 状态码。

200
Message

string

响应信息。

无
RequestId

string

请求 ID。

26A34338-5CD9-4C95-A7A6-5BDCE76C6B94

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "Data": {
    "List": [
      {
        "Back2Back": {
          "AgentHandleRate": 1,
          "AnswerRate": 0.6,
          "AverageCustomerRingTime": 100,
          "AverageRingTime": 100,
          "AverageTalkTime": 100,
          "CallsAnswered": 100,
          "CallsCustomerAnswered": 8,
          "CallsDialed": 100,
          "CustomerAnswerRate": 0.8,
          "MaxCustomerRingTime": 100,
          "MaxRingTime": 100,
          "MaxTalkTime": 100,
          "TotalCustomerRingTime": 100,
          "TotalRingTime": 100,
          "TotalTalkTime": 100
        },
        "Inbound": {
          "AbandonRate": 0,
          "AccessChannelTypeDetails": [
            {
              "AccessChannelType": "Web",
              "CallsOffered": 2
            }
          ],
          "AverageAbandonTime": 0,
          "AverageAbandonedInQueueTime": 0,
          "AverageAbandonedInRingTime": 0,
          "AverageFirstResponseTime": 6,
          "AverageHoldTime": 0,
          "AverageResponseTime": 8,
          "AverageRingTime": 5,
          "AverageTalkTime": 64,
          "AverageWaitTime": 5,
          "AverageWorkTime": 13,
          "CallsAbandoned": 0,
          "CallsAbandonedInQueue": 0,
          "CallsAbandonedInRing": 0,
          "CallsAttendedTransferIn": 0,
          "CallsAttendedTransferOut": 0,
          "CallsBlindTransferIn": 0,
          "CallsBlindTransferOut": 0,
          "CallsHandled": 7,
          "CallsHold": 0,
          "CallsOffered": 7,
          "CallsOverflow": 0,
          "CallsQueued": 7,
          "CallsQueuingFailed": 0,
          "CallsQueuingOverflow": 0,
          "CallsQueuingTimeout": 0,
          "CallsRinged": 7,
          "CallsTimeout": 0,
          "HandleRate": 1,
          "MaxAbandonTime": 0,
          "MaxAbandonedInQueueTime": 0,
          "MaxAbandonedInRingTime": 0,
          "MaxHoldTime": 0,
          "MaxRingTime": 12,
          "MaxTalkTime": 0,
          "MaxWaitTime": 13,
          "MaxWorkTime": 12,
          "SatisfactionIndex": 0,
          "SatisfactionRate": 0,
          "SatisfactionSurveysOffered": 0,
          "SatisfactionSurveysResponded": 0,
          "ServiceLevel15": 0.7,
          "ServiceLevel20": 0,
          "ServiceLevel30": 0.9,
          "TotalAbandonTime": 0,
          "TotalAbandonedInQueueTime": 0,
          "TotalAbandonedInRingTime": 0,
          "TotalHoldTime": 0,
          "TotalMessagesSent": 12,
          "TotalMessagesSentByAgent": 9,
          "TotalMessagesSentByCustomer": 3,
          "TotalRingTime": 32,
          "TotalTalkTime": 447,
          "TotalWaitTime": 34,
          "TotalWorkTime": 85
        },
        "Outbound": {
          "AnswerRate": 0,
          "AverageDialingTime": 37,
          "AverageHoldTime": 0,
          "AverageRingTime": 0,
          "AverageTalkTime": 3,
          "AverageWorkTime": 2,
          "CallsAnswered": 1,
          "CallsAttendedTransferIn": 0,
          "CallsAttendedTransferOut": 0,
          "CallsBlindTransferIn": 0,
          "CallsBlindTransferOut": 0,
          "CallsDialed": 6,
          "CallsHold": 0,
          "CallsRinged": 0,
          "MaxDialingTime": 12,
          "MaxHoldTime": 0,
          "MaxRingTime": 0,
          "MaxTalkTime": 0,
          "MaxWorkTime": 0,
          "SatisfactionIndex": 0,
          "SatisfactionRate": 0,
          "SatisfactionSurveysOffered": 0,
          "SatisfactionSurveysResponded": 0,
          "TotalDialingTime": 218,
          "TotalHoldTime": 0,
          "TotalRingTime": 0,
          "TotalTalkTime": 3,
          "TotalWorkTime": 9
        },
        "Overall": {
          "AverageBreakTime": 0,
          "AverageHoldTime": 0,
          "AverageReadyTime": 0,
          "AverageTalkTime": 0,
          "AverageWorkTime": 8,
          "BreakCodeDetailList": [
            {
              "BreakCode": "会议",
              "Count": 2,
              "Duration": 3600
            }
          ],
          "MaxBreakTime": 1,
          "MaxHoldTime": 0,
          "MaxReadyTime": 19328,
          "MaxTalkTime": 0,
          "MaxWorkTime": 12,
          "OccupancyRate": 0.02332222293912065,
          "SatisfactionIndex": 0,
          "SatisfactionRate": 0,
          "SatisfactionSurveysOffered": 0,
          "SatisfactionSurveysResponded": 0,
          "TotalBreakTime": 3,
          "TotalCalls": 13,
          "TotalHoldTime": 0,
          "TotalLoggedInTime": 23218,
          "TotalReadyTime": 22428,
          "TotalTalkTime": 449,
          "TotalWorkTime": 94
        },
        "SkillGroupId": "skillgroup@ccc-test",
        "SkillGroupName": "skillgroup"
      }
    ],
    "PageNumber": 1,
    "PageSize": 100,
    "TotalCount": 4
  },
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "26A34338-5CD9-4C95-A7A6-5BDCE76C6B94"
}

错误码

HTTP status code

错误码

错误信息

描述
400 Parameter.Format The format of parameter %s is invalid. %s 该参数的格式不合法。
400 Parameter.Blank The parameter %s may not be null or blank. 该参数不能为null或含有空白符的字符串。
500 InternalService.Common An internal service error occurred. %s 内部服务错误。

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

变更历史

更多信息，参考变更详情。

上一篇：ListHistoricalAgentReport - 获取坐席历史数据报表下一篇：ListIntervalAgentReport - 获取坐席分段统计报表