首页 云呼叫中心 开发参考 API参考 API目录 报表 ListHistoricalAgentReport - 获取坐席历史数据报表

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

更新时间: 2023-08-23 14:16:46

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

调试

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

调试

授权信息

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

请求参数

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

分页序号,范围1-100。

1
PageSizeinteger

分页大小,范围1-100。

100
AgentIdListstring

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

说明 如果坐席ID列表不为空,则直接按照坐席ID列表进行查询,此时pageSize和pageNumber参数无效,数据直接返回,如:请求参数:pageNumber = 3 则响应参数中pageNumber = 3 。
["agent1@ccc-test", "agent2@ccc-test"]
StartTimelong

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

1532448000000
StopTimelong

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

1532707199000
InstanceIdstring

实例ID。

ccc-test

返回参数

名称类型描述示例值
object
Codestring

响应码。

OK
HttpStatusCodeinteger

HTTP状态码。

200
Messagestring

响应信息。

RequestIdstring

请求ID。

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

数据。

PageNumberinteger

分页序号,范围1-100。

1
PageSizeinteger

分页大小,范围1-100。

100
TotalCountinteger

总数。

10
Listobject []

坐席历史数据列表。

AgentNamestring

坐席姓名。

坐席小王
AgentIdstring

座席ID。

agent1@ccc-test
DisplayIdstring

坐席工号。

001
Inboundobject

呼入数据。

AverageRingTimefloat

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

0
CallsHandledlong

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

0
TotalWorkTimelong

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

0
CallsAttendedTransferOutlong

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

0
MaxWorkTimelong

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

0
TotalHoldTimelong

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

0
AverageWorkTimefloat

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

0
CallsBlindTransferInlong

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

0
SatisfactionIndexfloat

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

0
CallsRingedlong

坐席振铃的电话数量。

0
CallsAttendedTransferInlong

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

0
CallsBlindTransferOutlong

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

0
TotalRingTimelong

总振铃时长,单位秒。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
MaxRingTimelong

最大振铃时长,单位秒。

0
TotalTalkTimelong

总通话时长,单位秒。

0
CallsOfferedlong

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

0
MaxHoldTimelong

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

0
AverageTalkTimefloat

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

0
SatisfactionRatefloat

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

0
CallsHoldlong

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
HandleRatefloat

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

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
AverageHoldTimefloat

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

0
Outboundobject

呼出数据。

AverageRingTimefloat

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

0
CallsDialedlong

拨号量。

0
CallsAnsweredlong

接通量。

0
TotalWorkTimelong

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

0
CallsAttendedTransferOutlong

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

0
MaxWorkTimelong

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

0
TotalDialingTimelong

总拨号时长,单位秒。

0
TotalHoldTimelong

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

0
AverageWorkTimefloat

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

0
CallsBlindTransferInlong

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

0
SatisfactionIndexfloat

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

0
CallsRingedlong

坐席振铃的电话数量。

0
CallsAttendedTransferInlong

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

0
CallsBlindTransferOutlong

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

0
TotalRingTimelong

总振铃时长,单位秒。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
MaxRingTimelong

最大振铃时长,单位秒。

0
TotalTalkTimelong

总通话时长,单位秒。

0
MaxDialingTimelong

最大拨号时长,单位秒。

0
AnswerRatefloat

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

0
MaxHoldTimelong

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

0
AverageTalkTimefloat

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

0
SatisfactionRatefloat

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

0
CallsHoldlong

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

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
SkillGroupIdsstring

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

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

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

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

示例

正常返回示例

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
        },
        "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": 0,
              "Duration": 0
            }
          ],
          "FirstCheckInTime": 0,
          "LastCheckOutTime": 0,
          "TotalOutboundScenarioTime": 0,
          "TotalOutboundScenarioReadyTime": 0
        },
        "SkillGroupIds": "[\"skillgroup1@ccc-test\",\"skillgroup2@ccc-test\"]",
        "SkillGroupNames": "[\"测试技能组1\",\"测试技能组2\"]"
      }
    ]
  }
}

错误码

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

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

变更历史

变更时间变更内容概要操作
2023-05-23OpenAPI 错误码发生变更,OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
阿里云首页 云呼叫中心 相关技术圈