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

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

调用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
Listarray

坐席历史数据列表。

object

坐席历史数据。

AgentNamestring

坐席姓名。

坐席小王
AgentIdstring

座席ID。

agent1@ccc-test
DisplayIdstring

坐席工号。

001
Inboundobject

呼入数据。

AverageRingTimenumber

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

0
CallsHandledLong

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

0
TotalWorkTimeLong

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

0
CallsAttendedTransferOutLong

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

0
MaxWorkTimeLong

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

0
TotalHoldTimeLong

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

0
AverageWorkTimenumber

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

0
CallsBlindTransferInLong

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

0
SatisfactionIndexnumber

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

0
CallsRingedLong

坐席振铃的电话数量。

0
CallsAttendedTransferInLong

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

0
CallsBlindTransferOutLong

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

0
TotalRingTimeLong

总振铃时长,单位秒。

0
MaxTalkTimeLong

最大通话时长,单位秒。

0
MaxRingTimeLong

最大振铃时长,单位秒。

0
TotalTalkTimeLong

总通话时长,单位秒。

0
CallsOfferedLong

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

0
MaxHoldTimeLong

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

0
AverageTalkTimenumber

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

0
SatisfactionRatenumber

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

0
CallsHoldLong

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

0
SatisfactionSurveysOfferedLong

满意度调查发送次数。

0
HandleRatenumber

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

0
SatisfactionSurveysRespondedLong

满意度调查响应次数。

0
AverageHoldTimenumber

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

0
Outboundobject

呼出数据。

AverageRingTimenumber

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

0
CallsDialedLong

拨号量。

0
CallsAnsweredLong

接通量。

0
TotalWorkTimeLong

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

0
CallsAttendedTransferOutLong

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

0
MaxWorkTimeLong

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

0
TotalDialingTimeLong

总拨号时长,单位秒。

0
TotalHoldTimeLong

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

0
AverageWorkTimenumber

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

0
CallsBlindTransferInLong

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

0
SatisfactionIndexnumber

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

0
CallsRingedLong

坐席振铃的电话数量。

0
CallsAttendedTransferInLong

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

0
CallsBlindTransferOutLong

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

0
TotalRingTimeLong

总振铃时长,单位秒。

0
MaxTalkTimeLong

最大通话时长,单位秒。

0
MaxRingTimeLong

最大振铃时长,单位秒。

0
TotalTalkTimeLong

总通话时长,单位秒。

0
MaxDialingTimeLong

最大拨号时长,单位秒。

0
AnswerRatenumber

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

0
MaxHoldTimeLong

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

0
AverageTalkTimenumber

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

0
SatisfactionRatenumber

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

0
CallsHoldLong

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

0
SatisfactionSurveysOfferedLong

满意度调查发送次数。

0
SatisfactionSurveysRespondedLong

满意度调查响应次数。

0
AverageHoldTimenumber

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

0
AverageDialingTimenumber

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

0
Overallobject

整体数据。

TotalTalkTimeLong

总通话时长,单位秒。

0
TotalLoggedInTimeLong

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

0
OccupancyRatenumber

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

0
TotalWorkTimeLong

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

0
MaxHoldTimeLong

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

0
MaxWorkTimeLong

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

0
AverageBreakTimenumber

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

0
TotalHoldTimeLong

总保持时长,单位秒。

0
SatisfactionRatenumber

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

0
MaxBreakTimeLong

最大小休时长,单位秒。

0
AverageWorkTimenumber

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

0
AverageTalkTimenumber

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

0
SatisfactionIndexnumber

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

0
SatisfactionSurveysOfferedLong

满意度调查发送次数。

0
SatisfactionSurveysRespondedLong

满意度调查响应次数。

0
MaxReadyTimeLong

最大就绪时长,单位秒。

0
AverageReadyTimenumber

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

0
AverageHoldTimenumber

平均通话保持时长,单位秒。计算公式为: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
        },
        "SkillGroupIds": "[\"skillgroup1@ccc-test\",\"skillgroup2@ccc-test\"]",
        "SkillGroupNames": "[\"测试技能组1\",\"测试技能组2\"]"
      }
    ]
  }
}

错误码

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

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

阿里云首页 云呼叫中心 相关技术圈