AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

ListHistoricalAgentSkillGroupReport - 获取分组坐席历史数据报表

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

调用ListHistoricalAgentSkillGroupReport获取指定实例下的一个或多个坐席的历史分组数据报表。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值
PageNumber

integer

是

分页序号，范围 1-100。

1
PageSize

integer

是

分页大小，范围 1-100。

10
AgentIdList

string

否

坐席 ID 列表，列表大小 0-100。

["agent1@ccc-test", "agent2@ccc-test"]
StartTime

integer

否

开始时间戳，默认为当天的 0 时。统计的时间精度为小时，向前取整，闭区间。

1634140800000
EndTime

integer

否

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

1620273600000
InstanceId

string

是

实例 ID。

ccc-test

SkillGroupIdList

string

否

技能组 ID 列表，列表大小 0-100。

[ "skg1@ccc-test", "skg2@ccc-test" ]
MediaType

string

否

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

VIDEO

返回参数

名称

类型

描述

示例值

object

Code

string

响应码。

OK
HttpStatusCode

integer

HTTP 状态码。

200
Message

string

响应信息。

无
RequestId

string

请求 ID。

BA03159C-E808-4FF1-B27E-A61B6E888D7F
Data

object

分组坐席历史数据列表。

PageNumber

integer

分页序号，范围 1-100。

1
PageSize

integer

分页大小，范围 1-100。

10
TotalCount

integer

总数，只有 PageNumber 为 1 时才有数据，其他情况都是 0。

11
List

array<object>

分组坐席历史数据列表。

array<object>

分组坐席历史数据。

AgentName

string

坐席姓名。

云呼测试坐席
AgentId

string

座席 ID。

agent1@ccc-test
DisplayId

string

坐席的工号。

1001
SkillGroupName

string

技能组名称。

Default
SkillGroupId

string

技能组 ID。

skillgroup1@ccc-test
Inbound

object

呼入指标。

AverageRingTime

number

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

100
CallsHandled

integer

应答量，即坐席应答的次数。

100
TotalWorkTime

integer

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

100
CallsAttendedTransferOut

integer

咨询转出量。若一通电话多次转出给其他坐席，每次转出算一次。

100
MaxWorkTime

integer

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

100
TotalHoldTime

integer

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

100
AverageWorkTime

number

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

100
CallsBlindTransferIn

integer

直接转入量。若一通电话多次转入给该坐席，每次转入算一次。

100
SatisfactionIndex

number

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

100
CallsRinged

integer

坐席振铃的电话数量。

100
CallsAttendedTransferIn

integer

咨询转入量。若一通电话多次转入给该坐席，每次转入算一次。

100
CallsBlindTransferOut

integer

直接转出量。若一通电话多次转出给其他坐席，每次转出算一次。

100
TotalRingTime

integer

总振铃时长，单位秒。

100
MaxTalkTime

integer

最大通话时长，单位秒。

100
MaxRingTime

integer

最大振铃时长，单位秒。

100
TotalTalkTime

integer

总通话时长，单位秒。

100
CallsOffered

integer

分配量，即分配给此坐席的电话次数, 包括其他坐席盲转和咨询转给此坐席的电话。

100
MaxHoldTime

integer

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

100
AverageTalkTime

number

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

100
SatisfactionRate

number

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

0.5
CallsHold

integer

保持量，即发生通话保持的次数。

100
SatisfactionSurveysOffered

integer

满意度调查发送次数。

100
HandleRate

number

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

100
SatisfactionSurveysResponded

integer

满意度调查响应次数。

100
AverageHoldTime

number

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

100
TotalMessagesSent

integer

Chat 会话中总消息发送量。

12
TotalMessagesSentByAgent

integer

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

6
TotalMessagesSentByCustomer

integer

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

6
AverageFirstResponseTime

number

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

8
AverageResponseTime

number

Chat 会话平均响应时长。

9
Outbound

object

呼出指标。

AverageRingTime

number

平均振铃时长，单位秒。

100
CallsDialed

integer

拨号量。

100
CallsAnswered

integer

接通量。

100
TotalWorkTime

integer

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

100
CallsAttendedTransferOut

integer

咨询转出量。若一通电话多次转出给其他坐席，每次转出算一次。

100
MaxWorkTime

integer

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

100
TotalDialingTime

integer

总拨号时长，单位秒。

100
TotalHoldTime

integer

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

100
AverageWorkTime

number

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

100
CallsBlindTransferIn

integer

直接转入量。若一通电话多次转入给该坐席，每次转入算一次。

100
SatisfactionIndex

number

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

1.4
CallsRinged

integer

坐席振铃的电话数量。

100
CallsAttendedTransferIn

integer

咨询转入量。若一通电话多次转入给该坐席，每次转入算一次。

100
CallsBlindTransferOut

integer

直接转出量。若一通电话多次转出给其他坐席，每次转出算一次。

100
TotalRingTime

integer

总振铃时长，单位秒。

100
MaxTalkTime

integer

最大通话时长，单位秒。

100
MaxRingTime

integer

最大振铃时长，单位秒。

100
TotalTalkTime

integer

总通话时长，单位秒。

100
MaxDialingTime

integer

最大拨号时长，单位秒。

100
AnswerRate

number

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

0.5
MaxHoldTime

integer

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

100
AverageTalkTime

number

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

100
SatisfactionRate

number

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

0.5
CallsHold

integer

保持量，即发生通话保持的次数。

100
SatisfactionSurveysOffered

integer

满意度调查发送次数。

100
SatisfactionSurveysResponded

integer

满意度调查响应次数。

100
AverageHoldTime

number

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

100
AverageDialingTime

number

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

100
Overall

object

整体指标。

TotalTalkTime

integer

总通话时长，单位秒。

100
TotalLoggedInTime

integer

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

100
OccupancyRate

number

座席利用率。

0.5
TotalWorkTime

integer

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

100
MaxHoldTime

integer

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

100
MaxWorkTime

integer

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

100
AverageBreakTime

number

平均小休时长，单位秒。

100
TotalHoldTime

integer

总保持时长，单位秒。

100
SatisfactionRate

number

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

0.5
MaxBreakTime

integer

最大小休时长，单位秒。

100
AverageWorkTime

number

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

100
AverageTalkTime

number

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

100
SatisfactionIndex

number

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

1.4
SatisfactionSurveysOffered

integer

满意度调查发送次数。

100
SatisfactionSurveysResponded

integer

满意度调查响应次数。

100
MaxReadyTime

integer

最大就绪时长，单位秒。

100
AverageReadyTime

number

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

100
AverageHoldTime

number

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

100
TotalReadyTime

integer

总就绪时长，单位为秒。

100
TotalBreakTime

integer

总小休时长，单位秒。

100
MaxTalkTime

integer

最大通话时长，单位秒。

100
TotalCalls

integer

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

100
BreakCodeDetailList

array<object>

小休详情列表。

object

小休详情。

BreakCode

string

小休码。

开会
Count

integer

次数。

1
Duration

integer

时长，单位秒。

100
FirstCheckInTime

integer

最早签入时间，格式是 unix 时间戳，单位到毫秒。

1686030515000
LastCheckOutTime

integer

最后签出时间，格式是 unix 时间戳，单位毫秒。

1686030515000
TotalOutboundScenarioTime

integer

总仅外呼在线时长，单位秒。

100
TotalOutboundScenarioReadyTime

integer

总仅外呼空闲时长，单位秒。

100
TotalOutboundScenarioLoggedInTime

integer

总仅外呼在线时长，单位秒。

120
TotalOfficePhoneLoggedInTime

integer

总办公电话在线时长，单位秒。

120
TotalOffSiteLggedInTime

integer

总场外在线时长，单位秒。

120
TotalOnSiteLoggedInTime

string

总场内在线时长，单位秒。

120
Internal

object

内部呼叫指标。

TotalTalkTime

integer

总通话时长，单位秒。

100
AverageTalkTime

integer

平均通话时长，单位秒。

100
MaxTalkTime

integer

最大通话时长，单位秒。

100
CallsOffered

integer

电话呼入数。

100
CallsHandled

integer

电话应答数。

100
CallsTalk

integer

坐席参与的通话次数。

100
CallsDialed

integer

拨号量。

100
CallsAnswered

integer

接通量。

100
CallsTalked

integer

参与通话次数。

5
Back2Back

object

双呼指标。

CallsDialed

integer

拨号量。

100
AnswerRate

number

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

0.6
CallsAnswered

integer

接通量。

100
AgentAnswerRate

number

坐席侧应答率。

已弃用，请使用AgentHandleRate代替此参数
CallsCustomerHandled

integer

客户侧接起次数。

已弃用，请使用CallsCustomerAnswered代替此参数
CustomerHandleRate

number

客户侧接起率。

已弃用，请使用CustomerAnswerRate代替此参数
TotalTalkTime

integer

总通话时长，单位秒。

100
MaxTalkTime

integer

最大通话时长，单位秒。

100
AverageTalkTime

integer

平均通话时长，单位秒。

100
TotalRingTime

integer

总振铃时长，单位秒。

100
MaxRingTime

integer

最大振铃时长，单位秒。

100
AverageRingTime

number

平均振铃时长，单位秒。

100
TotalCustomerRingTime

integer

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

100
MaxCustomerRingTime

integer

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

100
AverageCustomerRingTime

number

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

100
AgentHandleRate

number

坐席应答率。

0.5
CallsCustomerAnswered

integer

客户接听电话数量。

100
CustomerAnswerRate

number

客户接通率。

0.5
CallsAgentHandled

integer

坐席接听电话数量。

100

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "BA03159C-E808-4FF1-B27E-A61B6E888D7F",
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 11,
    "List": [
      {
        "AgentName": "云呼测试坐席",
        "AgentId": "agent1@ccc-test",
        "DisplayId": "1001",
        "SkillGroupName": "Default",
        "SkillGroupId": "skillgroup1@ccc-test",
        "Inbound": {
          "AverageRingTime": 100,
          "CallsHandled": 100,
          "TotalWorkTime": 100,
          "CallsAttendedTransferOut": 100,
          "MaxWorkTime": 100,
          "TotalHoldTime": 100,
          "AverageWorkTime": 100,
          "CallsBlindTransferIn": 100,
          "SatisfactionIndex": 100,
          "CallsRinged": 100,
          "CallsAttendedTransferIn": 100,
          "CallsBlindTransferOut": 100,
          "TotalRingTime": 100,
          "MaxTalkTime": 100,
          "MaxRingTime": 100,
          "TotalTalkTime": 100,
          "CallsOffered": 100,
          "MaxHoldTime": 100,
          "AverageTalkTime": 100,
          "SatisfactionRate": 0.5,
          "CallsHold": 100,
          "SatisfactionSurveysOffered": 100,
          "HandleRate": 100,
          "SatisfactionSurveysResponded": 100,
          "AverageHoldTime": 100,
          "TotalMessagesSent": 12,
          "TotalMessagesSentByAgent": 6,
          "TotalMessagesSentByCustomer": 6,
          "AverageFirstResponseTime": 8,
          "AverageResponseTime": 9
        },
        "Outbound": {
          "AverageRingTime": 100,
          "CallsDialed": 100,
          "CallsAnswered": 100,
          "TotalWorkTime": 100,
          "CallsAttendedTransferOut": 100,
          "MaxWorkTime": 100,
          "TotalDialingTime": 100,
          "TotalHoldTime": 100,
          "AverageWorkTime": 100,
          "CallsBlindTransferIn": 100,
          "SatisfactionIndex": 1.4,
          "CallsRinged": 100,
          "CallsAttendedTransferIn": 100,
          "CallsBlindTransferOut": 100,
          "TotalRingTime": 100,
          "MaxTalkTime": 100,
          "MaxRingTime": 100,
          "TotalTalkTime": 100,
          "MaxDialingTime": 100,
          "AnswerRate": 0.5,
          "MaxHoldTime": 100,
          "AverageTalkTime": 100,
          "SatisfactionRate": 0.5,
          "CallsHold": 100,
          "SatisfactionSurveysOffered": 100,
          "SatisfactionSurveysResponded": 100,
          "AverageHoldTime": 100,
          "AverageDialingTime": 100
        },
        "Overall": {
          "TotalTalkTime": 100,
          "TotalLoggedInTime": 100,
          "OccupancyRate": 0.5,
          "TotalWorkTime": 100,
          "MaxHoldTime": 100,
          "MaxWorkTime": 100,
          "AverageBreakTime": 100,
          "TotalHoldTime": 100,
          "SatisfactionRate": 0.5,
          "MaxBreakTime": 100,
          "AverageWorkTime": 100,
          "AverageTalkTime": 100,
          "SatisfactionIndex": 1.4,
          "SatisfactionSurveysOffered": 100,
          "SatisfactionSurveysResponded": 100,
          "MaxReadyTime": 100,
          "AverageReadyTime": 100,
          "AverageHoldTime": 100,
          "TotalReadyTime": 100,
          "TotalBreakTime": 100,
          "MaxTalkTime": 100,
          "TotalCalls": 100,
          "BreakCodeDetailList": [
            {
              "BreakCode": "开会",
              "Count": 1,
              "Duration": 100
            }
          ],
          "FirstCheckInTime": 1686030515000,
          "LastCheckOutTime": 1686030515000,
          "TotalOutboundScenarioTime": 100,
          "TotalOutboundScenarioReadyTime": 100,
          "TotalOutboundScenarioLoggedInTime": 120,
          "TotalOfficePhoneLoggedInTime": 120,
          "TotalOffSiteLggedInTime": 120,
          "TotalOnSiteLoggedInTime": "120"
        },
        "Internal": {
          "TotalTalkTime": 100,
          "AverageTalkTime": 100,
          "MaxTalkTime": 100,
          "CallsOffered": 100,
          "CallsHandled": 100,
          "CallsTalk": 100,
          "CallsDialed": 100,
          "CallsAnswered": 100,
          "CallsTalked": 5
        },
        "Back2Back": {
          "CallsDialed": 100,
          "AnswerRate": 0.6,
          "CallsAnswered": 100,
          "AgentAnswerRate": 0,
          "CallsCustomerHandled": 0,
          "CustomerHandleRate": 0,
          "TotalTalkTime": 100,
          "MaxTalkTime": 100,
          "AverageTalkTime": 100,
          "TotalRingTime": 100,
          "MaxRingTime": 100,
          "AverageRingTime": 100,
          "TotalCustomerRingTime": 100,
          "MaxCustomerRingTime": 100,
          "AverageCustomerRingTime": 100,
          "AgentHandleRate": 0.5,
          "CallsCustomerAnswered": 100,
          "CustomerAnswerRate": 0.5,
          "CallsAgentHandled": 100
        }
      }
    ]
  }
}

错误码

HTTP status code

错误码

错误信息

描述
400 Parameter.Blank The parameter %s must not be null or empty. 该参数不能为null值。

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

变更历史

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

上一篇：ListIntervalAgentSkillGroupReport - 获取分组坐席分段统计报表下一篇：GetCallDetailRecord - 获取通话详情