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

ListHistoricalAgentReport - 获取坐席历史数据报表

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

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

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值
PageNumber

integer

是

分页序号，范围 1-100。

1
PageSize

integer

是

分页大小，范围 1-100。

100
AgentIdList

string

否

坐席 ID 列表，范围 0-100 。

说明

如果坐席 ID 列表不为空，则直接按照坐席 ID 列表进行查询，此时 pageSize 和 pageNumber 参数无效，数据直接返回，如：请求参数：pageNumber = 3 则响应参数中 pageNumber = 3 。

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

integer

否

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

1532448000000
StopTime

integer

否

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

1532707199000
InstanceId

string

是

实例 ID。

ccc-test
MediaType

string

否

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

VIDEO
SkillGroupId

string

否

技能组 ID。

wwtest@test_yunhu

返回参数

名称

类型

描述

示例值

object

Code

string

响应码。

OK
HttpStatusCode

integer

HTTP 状态码。

200
Message

string

响应信息。

无
RequestId

string

请求 ID。

EEEE671A-3E24-4A04-81E6-6C4F5B39DF75
Data

object

数据。

PageNumber

integer

分页序号，范围 1-100。

1
PageSize

integer

分页大小，范围 1-100。

100
TotalCount

integer

总数。

10
List

array<object>

坐席历史数据列表。

array<object>

坐席历史数据。

AgentName

string

坐席姓名。

坐席小王
AgentId

string

座席 ID。

agent1@ccc-test
DisplayId

string

坐席工号。

001
Inbound

object

呼入数据。

AverageRingTime

number

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

0
CallsHandled

integer

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

0
TotalWorkTime

integer

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

0
CallsAttendedTransferOut

integer

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

0
MaxWorkTime

integer

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

0
TotalHoldTime

integer

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

0
AverageWorkTime

number

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

0
CallsBlindTransferIn

integer

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

0
SatisfactionIndex

number

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

0
CallsRinged

integer

坐席振铃的电话数量。

0
CallsAttendedTransferIn

integer

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

0
CallsBlindTransferOut

integer

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

0
TotalRingTime

integer

总振铃时长，单位秒。

0
MaxTalkTime

integer

最大通话时长，单位秒。

0
MaxRingTime

integer

最大振铃时长，单位秒。

0
TotalTalkTime

integer

总通话时长，单位秒。

0
CallsOffered

integer

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

0
MaxHoldTime

integer

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

0
AverageTalkTime

number

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

0
SatisfactionRate

number

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

0
CallsHold

integer

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
HandleRate

number

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

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
AverageHoldTime

number

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

0
AccessChannelTypeDetails

array<object>

各渠道的统计数据。

object

渠道的统计数据。

AccessChannelType

string

渠道类型。

Web
CallsOffered

integer

分配的会话数量。

3
AverageFirstResponseTime

number

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

10
AverageResponseTime

number

Chat 会话平均响应时长。

12
ServiceLevel15

number

15 秒服务水平。

0.85
TotalMessagesSent

integer

Chat 会话中总消息发送量。

16
TotalMessagesSentByAgent

integer

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

7
TotalMessagesSentByCustomer

string

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

9
Outbound

object

呼出数据。

AverageRingTime

number

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

0
CallsDialed

integer

拨号量。

0
CallsAnswered

integer

接通量。

0
TotalWorkTime

integer

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

0
CallsAttendedTransferOut

integer

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

0
MaxWorkTime

integer

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

0
TotalDialingTime

integer

总拨号时长，单位秒。

0
TotalHoldTime

integer

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

0
AverageWorkTime

number

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

0
CallsBlindTransferIn

integer

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

0
SatisfactionIndex

number

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

0
CallsRinged

integer

坐席振铃的电话数量。

0
CallsAttendedTransferIn

integer

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

0
CallsBlindTransferOut

integer

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

0
TotalRingTime

integer

总振铃时长，单位秒。

0
MaxTalkTime

integer

最大通话时长，单位秒。

0
MaxRingTime

integer

最大振铃时长，单位秒。

0
TotalTalkTime

integer

总通话时长，单位秒。

0
MaxDialingTime

integer

最大拨号时长，单位秒。

0
AnswerRate

number

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

0
MaxHoldTime

integer

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

0
AverageTalkTime

number

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

0
SatisfactionRate

number

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

0
CallsHold

integer

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
AverageHoldTime

number

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

0
AverageDialingTime

number

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

0
Overall

object

整体数据。

TotalTalkTime

integer

总通话时长，单位秒。

0
TotalLoggedInTime

integer

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

0
OccupancyRate

number

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

0
TotalWorkTime

integer

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

0
MaxHoldTime

integer

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

0
MaxWorkTime

integer

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

0
AverageBreakTime

number

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

0
TotalHoldTime

integer

总保持时长，单位秒。

0
SatisfactionRate

number

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

0
MaxBreakTime

integer

最大小休时长，单位秒。

0
AverageWorkTime

number

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

0
AverageTalkTime

number

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

0
SatisfactionIndex

number

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
MaxReadyTime

integer

最大就绪时长，单位秒。

0
AverageReadyTime

number

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

0
AverageHoldTime

number

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

0
TotalReadyTime

integer

总就绪时长，单位为秒。

0
TotalBreakTime

integer

总小休时长，单位秒。

0
MaxTalkTime

integer

最大通话时长，单位秒。

0
TotalCalls

integer

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

0
TotalOnSiteOnlineTime

integer

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

已弃用，请使用TotalOnSiteLoggedInTime代替此参数
TotalOffSiteOnlineTime

integer

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

已弃用，请使用TotalOffSiteLoggedInTime代替此参数
TotalOfficePhoneOnlineTime

integer

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

已弃用，请使用TotalOfficePhoneLoggedInTime代替此参数
BreakCodeDetailList

array<object>

各类型小休统计数据。

object

小休统计数据

BreakCode

string

小休类型代码。

会议
Count

integer

此类型小休的发生次数。

3
Duration

integer

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

120
FirstCheckInTime

integer

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

1686030515000
LastCheckOutTime

integer

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

1686030515000
TotalOutboundScenarioTime

integer

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

已弃用，请使用TotalOutboundScenarioLoggedInTime代替此参数
TotalOutboundScenarioReadyTime

integer

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

100
TotalOfficePhoneLoggedInTime

integer

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

3600
TotalOffSiteLoggedInTime

integer

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

100
TotalOnSiteLoggedInTime

integer

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

100
TotalOutboundScenarioLoggedInTime

integer

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

100
SkillGroupIds

string

座席所属技能组 ID 列表，格式为 JSON 数组的字符串，数组元素为技能组 ID。

["skillgroup1@ccc-test","skillgroup2@ccc-test"]
SkillGroupNames

string

座席所属技能组名称列表，格式为 JSON 数组的字符串，数组元素是技能组名称。

["测试技能组1","测试技能组2"]
Back2Back

object

双呼指标。

CallsDialed

string

拨号量。

100
AnswerRate

string

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

0.6
CallsAnswered

string

接通量。

100
TotalTalkTime

string

总通话时长，单位秒。

100
MaxTalkTime

string

最大通话时长，单位秒。

100
AverageTalkTime

string

平均通话时长，单位秒。

100
TotalRingTime

string

总振铃时长，单位秒。

100
MaxRingTime

string

最大振铃时长，单位秒。

100
AverageRingTime

string

平均振铃时长，单位秒。

100
TotalCustomerRingTime

string

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

100
MaxCustomerRingTime

string

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

100
AverageCustomerRingTime

string

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

100
CallsAgentHandled

string

坐席接听电话数量。

10
AgentHandleRate

string

坐席应答率。

1
CallsCustomerAnswered

string

客户接听电话数量。

7
CustomerAnswerRate

string

客户接通率。

0.7
Internal

object

内部呼叫指标。

TotalTalkTime

integer

总通话时长，单位秒。

100
AverageTalkTime

number

平均通话时长，单位秒。

100
MaxTalkTime

integer

最大通话时长，单位秒。

100
CallsOffered

integer

电话呼入数。

100
CallsHandled

integer

电话应答数。

100
CallsTalked

integer

参与通话次数。

100
CallsDialed

integer

拨号量。

100
CallsAnswered

integer

接通量。

100

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "无",
  "RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
  "Data": {
    "PageNumber": 1,
    "PageSize": 100,
    "TotalCount": 10,
    "List": [
      {
        "AgentName": "坐席小王",
        "AgentId": "agent1@ccc-test",
        "DisplayId": "001",
        "Inbound": {
          "AverageRingTime": 0,
          "CallsHandled": 0,
          "TotalWorkTime": 0,
          "CallsAttendedTransferOut": 0,
          "MaxWorkTime": 0,
          "TotalHoldTime": 0,
          "AverageWorkTime": 0,
          "CallsBlindTransferIn": 0,
          "SatisfactionIndex": 0,
          "CallsRinged": 0,
          "CallsAttendedTransferIn": 0,
          "CallsBlindTransferOut": 0,
          "TotalRingTime": 0,
          "MaxTalkTime": 0,
          "MaxRingTime": 0,
          "TotalTalkTime": 0,
          "CallsOffered": 0,
          "MaxHoldTime": 0,
          "AverageTalkTime": 0,
          "SatisfactionRate": 0,
          "CallsHold": 0,
          "SatisfactionSurveysOffered": 0,
          "HandleRate": 0,
          "SatisfactionSurveysResponded": 0,
          "AverageHoldTime": 0,
          "AccessChannelTypeDetails": [
            {
              "AccessChannelType": "Web",
              "CallsOffered": 3
            }
          ],
          "AverageFirstResponseTime": 10,
          "AverageResponseTime": 12,
          "ServiceLevel15": 0.85,
          "TotalMessagesSent": 16,
          "TotalMessagesSentByAgent": 7,
          "TotalMessagesSentByCustomer": "9"
        },
        "Outbound": {
          "AverageRingTime": 0,
          "CallsDialed": 0,
          "CallsAnswered": 0,
          "TotalWorkTime": 0,
          "CallsAttendedTransferOut": 0,
          "MaxWorkTime": 0,
          "TotalDialingTime": 0,
          "TotalHoldTime": 0,
          "AverageWorkTime": 0,
          "CallsBlindTransferIn": 0,
          "SatisfactionIndex": 0,
          "CallsRinged": 0,
          "CallsAttendedTransferIn": 0,
          "CallsBlindTransferOut": 0,
          "TotalRingTime": 0,
          "MaxTalkTime": 0,
          "MaxRingTime": 0,
          "TotalTalkTime": 0,
          "MaxDialingTime": 0,
          "AnswerRate": 0,
          "MaxHoldTime": 0,
          "AverageTalkTime": 0,
          "SatisfactionRate": 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,
          "TotalOnSiteOnlineTime": 0,
          "TotalOffSiteOnlineTime": 0,
          "TotalOfficePhoneOnlineTime": 0,
          "BreakCodeDetailList": [
            {
              "BreakCode": "会议",
              "Count": 3,
              "Duration": 120
            }
          ],
          "FirstCheckInTime": 1686030515000,
          "LastCheckOutTime": 1686030515000,
          "TotalOutboundScenarioTime": 0,
          "TotalOutboundScenarioReadyTime": 100,
          "TotalOfficePhoneLoggedInTime": 3600,
          "TotalOffSiteLoggedInTime": 100,
          "TotalOnSiteLoggedInTime": 100,
          "TotalOutboundScenarioLoggedInTime": 100
        },
        "SkillGroupIds": "[\"skillgroup1@ccc-test\",\"skillgroup2@ccc-test\"]",
        "SkillGroupNames": "[\"测试技能组1\",\"测试技能组2\"]",
        "Back2Back": {
          "CallsDialed": "100",
          "AnswerRate": "0.6",
          "CallsAnswered": "100",
          "TotalTalkTime": "100",
          "MaxTalkTime": "100",
          "AverageTalkTime": "100",
          "TotalRingTime": "100",
          "MaxRingTime": "100",
          "AverageRingTime": "100",
          "TotalCustomerRingTime": "100",
          "MaxCustomerRingTime": "100",
          "AverageCustomerRingTime": "100",
          "CallsAgentHandled": "10",
          "AgentHandleRate": "1",
          "CallsCustomerAnswered": "7",
          "CustomerAnswerRate": "0.7"
        },
        "Internal": {
          "TotalTalkTime": 100,
          "AverageTalkTime": 100,
          "MaxTalkTime": 100,
          "CallsOffered": 100,
          "CallsHandled": 100,
          "CallsTalked": 100,
          "CallsDialed": 100,
          "CallsAnswered": 100
        }
      }
    ]
  }
}

错误码

HTTP status code

错误码

错误信息

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

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

变更历史

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

上一篇：ListCallDetailRecordsV2 - 获取通话详情列表下一篇：ListHistoricalSkillGroupReport - 获取技能组历史数据报表