文档

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

更新时间:

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

调试

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

授权信息

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

请求参数

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

分页序号,范围 1-100。

1
PageSizeinteger

分页大小,范围 1-100。

100
SkillGroupIdListstring

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

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

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

1532448000000
EndTimelong

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

1532707199000
InstanceIdstring

实例 ID。

ccc-test

返回参数

名称类型描述示例值
object
Codestring

响应码。

OK
HttpStatusCodeinteger

HTTP 状态码。

200
Messagestring

响应信息。

RequestIdstring

请求 ID。

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

数据。

PageNumberinteger

分页序号,范围 1-100。

1
PageSizeinteger

分页大小,范围 1-100。

100
TotalCountinteger

总数。

4
Listobject []

技能组历史数据列表。

SkillGroupNamestring

技能组名称。

skillgroup
SkillGroupIdstring

技能组 ID。

skillgroup@ccc-test
Inboundobject

呼入指标。

AverageRingTimefloat

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

5
CallsOverflowlong

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

0
CallsAbandonedInRinglong

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

0
CallsHandledlong

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

7
TotalWorkTimelong

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

85
TotalAbandonedInRingTimelong

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

0
MaxWorkTimelong

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

12
CallsAttendedTransferOutlong

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

0
AverageWaitTimefloat

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

5
TotalHoldTimelong

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

0
MaxAbandonTimelong

最大放弃时长,单位秒。

0
AverageWorkTimefloat

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

13
CallsQueuedlong

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

7
CallsBlindTransferInlong

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

0
SatisfactionIndexfloat

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

0
AverageAbandonedInRingTimefloat

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

0
AverageAbandonTimefloat

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

0
CallsRingedlong

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

7
CallsBlindTransferOutlong

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

0
CallsAttendedTransferInlong

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

0
CallsAbandonedlong

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

0
MaxAbandonedInQueueTimelong

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

0
TotalWaitTimelong

总等待时长,单位秒。

34
TotalRingTimelong

总振铃时长,单位秒。

32
MaxTalkTimelong

最大通话时长,单位秒。

0
MaxRingTimelong

最大振铃时长,单位秒。

12
AbandonRatefloat

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

0
TotalTalkTimelong

总通话时长,单位秒。

447
TotalAbandonTimelong

总放弃时长,单位秒。

0
CallsOfferedlong

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

7
MaxAbandonedInRingTimelong

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

0
MaxWaitTimelong

最大等待时长,单位秒。

13
AverageAbandonedInQueueTimefloat

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

0
ServiceLevel20float

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

0
MaxHoldTimelong

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

0
SatisfactionRatefloat

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

0
AverageTalkTimefloat

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

64
CallsHoldlong

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
HandleRatefloat

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

1
CallsTimeoutlong

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

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
AverageHoldTimefloat

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

0
TotalAbandonedInQueueTimelong

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

0
CallsAbandonedInQueuelong

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

0
Outboundobject

呼出指标。

AverageRingTimefloat

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

0
CallsDialedlong

拨号量。

6
CallsAnsweredlong

接通量。

1
TotalWorkTimelong

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

9
CallsAttendedTransferOutlong

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

0
MaxWorkTimelong

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

0
TotalDialingTimelong

总拨号时长,单位秒。

218
TotalHoldTimelong

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

0
AverageWorkTimefloat

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

2
CallsBlindTransferInlong

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

0
SatisfactionIndexfloat

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

0
CallsRingedlong

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

0
CallsAttendedTransferInlong

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

0
CallsBlindTransferOutlong

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

0
TotalRingTimelong

总振铃时长,单位秒。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
MaxRingTimelong

最大振铃时长,单位秒。

0
TotalTalkTimelong

总通话时长,单位秒。

3
MaxDialingTimelong

最大拨号时长,单位秒。

12
AnswerRatefloat

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

0
MaxHoldTimelong

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

0
AverageTalkTimefloat

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

3
SatisfactionRatefloat

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

0
CallsHoldlong

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
AverageHoldTimefloat

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

0
AverageDialingTimefloat

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

37
Overallobject

整体指标。

TotalTalkTimelong

总通话时长,单位秒。

449
TotalLoggedInTimelong

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

23218
OccupancyRatefloat

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

0.02332222293912065
TotalWorkTimelong

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

94
MaxHoldTimelong

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

0
MaxWorkTimelong

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

12
AverageBreakTimefloat

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

0
TotalHoldTimelong

总保持时长,单位秒。

0
SatisfactionRatefloat

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

0
MaxBreakTimelong

最大小休时长,单位秒。

1
AverageWorkTimefloat

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

8
AverageTalkTimefloat

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

0
SatisfactionIndexfloat

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
MaxReadyTimelong

最大就绪时长,单位秒。

19328
AverageReadyTimefloat

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

0
AverageHoldTimefloat

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

0
TotalReadyTimelong

总就绪时长,单位为秒。

22428
TotalBreakTimelong

总小休时长,单位为秒。

3
MaxTalkTimelong

最大通话时长,单位秒。

0
TotalCallslong

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

13

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400Parameter.FormatThe format of parameter %s is invalid. %s该参数的格式不合法。
400Parameter.BlankThe parameter %s may not be null or blank.该参数不能为null或含有空白符的字符串。
500InternalService.CommonAn internal service error occurred. %s内部服务错误。

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

变更历史

变更时间变更内容概要操作
2023-11-22OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:500
入参OpenAPI 入参发生变更
    新增入参:MediaType
出参OpenAPI 返回结构发生变更
  • 本页导读 (0)
文档反馈