AI 助理
文档备案控制台
官方文档
首页

ListAgentSummaryReportsSinceMidnight - 获取坐席概览数据列表

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

调用ListAgentSummaryReportsSinceMidnight获取指定实例下按指定条件过滤后的坐席历史数据报表，统计的是从当天0时开始，到当前时间为止的数据。该接口仅对特定用户开放，其他客户不建议调用。

说明

目前该API接口已标记为弃用，推荐使用替代API：CCC(2020-07-01) - ListHistoricalAgentReport。

调试

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

调试

授权信息

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

请求参数

名称

类型

必填

描述

示例值
InstanceId

string

是

实例 ID。

ccc-test
SkillGroupId

string

否

按技能组 ID 过滤。

skillgroup@ccc-test
AgentIds

string

否

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

说明

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

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

integer

否

分页序号，范围 1-100，非必填，默认 1。

1
PageSize

integer

否

分页大小，范围 1-100，非必填，默认 10。

10

返回参数

名称

类型

描述

示例值

object

HttpStatusCode

integer

HTTP 状态码。

200
Code

string

响应码。

OK
Message

string

响应信息。

无
RequestId

string

请求 ID。

27DD30C4-CAE2-481A-97CC-D3C54625341D
Success

boolean

是否成功。

true
PagedAgentSummaryReport

object

数据。

PageNumber

integer

分页序号，范围 1-100。

1
PageSize

integer

分页大小，范围 1-100。

10
TotalCount

integer

总数。

2
List

array<object>

坐席概览数据列表。

array<object>

坐席概览数据。

LoginName

string

座席登录名。

agent
AgentId

string

坐席 ID。

agent@ccc-test
AgentName

string

坐席名称。

坐席小王。
SkillGroupNames

string

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

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

string

统计打点时刻。

2018-09-13 00:00:00
InstanceId

string

实例 ID。

ccc-test
SkillGroupIds

string

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

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

Overall

object

整体指标。

TotalTalkTime

integer

总通话时长，单位秒。

0
TotalLoggedInTime

integer

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

0
OccupancyRate

number

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

0
TotalWorkTime

integer

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

0
MaxWorkTime

integer

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

0
AverageWorkTime

integer

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

0
AverageTalkTime

integer

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

0
SatisfactionIndex

number

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
AverageReadyTime

integer

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

0
MaxReadyTime

integer

最大就绪时长，单位秒。

37
OneTransferCalls

integer

直接转接的通话数量。

0
MaxTalkTime

integer

最大通话时长，单位秒。

0
TotalReadyTime

integer

总就绪时长，单位为秒。

0
TotalBreakTime

integer

总小休时长，单位秒。

0
TotalCalls

integer

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

0
Inbound

object

呼入指标。

TotalTalkTime

integer

总通话时长，单位秒。

0
CallsOffered

integer

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

0
AverageRingTime

integer

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

0
CallsHandled

integer

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

0
ServiceLevel20

number

20 秒应答率，单位%。

0
TotalWorkTime

integer

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

0
MaxWorkTime

integer

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

0
AverageWorkTime

integer

平均话后处理时长，单位秒。

0
AverageTalkTime

integer

平均通话时长，单位秒。

0
SatisfactionIndex

number

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
HandleRate

number

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

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
TotalRingTime

integer

总振铃时长，单位秒。

0
MaxTalkTime

integer

最大通话时长，单位秒。

0
MaxRingTime

integer

最大振铃时长，单位秒。

0
Outbound

object

呼出指标。

TotalTalkTime

integer

总通话时长，单位秒。

0
MaxDialingTime

integer

最大拨号时长，单位秒。

0
CallsDialed

integer

电话拨号量。

0
CallsAnswered

integer

电话接通量。

0
AnswerRate

number

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

0
TotalWorkTime

integer

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

0
MaxWorkTime

string

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

0
TotalDialingTime

integer

总拨号时长，单位秒。

0
AverageTalkTime

integer

平均通话时长，单位秒。

0
AverageWorkTime

integer

平均话后处理时长，单位秒。

0
SatisfactionIndex

number

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

0
SatisfactionSurveysOffered

integer

满意度调查发送次数。

0
SatisfactionSurveysResponded

integer

满意度调查响应次数。

0
MaxTalkTime

integer

最大通话时长，单位秒。

0
AverageDialingTime

integer

平均拨号时长，单位秒。

0

示例

正常返回示例

JSON格式

{
  "HttpStatusCode": 200,
  "Code": "OK",
  "Message": "无",
  "RequestId": "27DD30C4-CAE2-481A-97CC-D3C54625341D",
  "Success": true,
  "PagedAgentSummaryReport": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 2,
    "List": [
      {
        "LoginName": "agent",
        "AgentId": "agent@ccc-test",
        "AgentName": "坐席小王。",
        "SkillGroupNames": "[\"测试技能组1\",\"测试技能组2\"]",
        "Timestamp": "2018-09-13 00:00:00",
        "InstanceId": "ccc-test",
        "SkillGroupIds": "[\"skillgroup1@ccc-test\",\"skillgroup2@ccc-test\"]\n",
        "Overall": {
          "TotalTalkTime": 0,
          "TotalLoggedInTime": 0,
          "OccupancyRate": 0,
          "TotalWorkTime": 0,
          "MaxWorkTime": 0,
          "AverageWorkTime": 0,
          "AverageTalkTime": 0,
          "SatisfactionIndex": 0,
          "SatisfactionSurveysOffered": 0,
          "SatisfactionSurveysResponded": 0,
          "AverageReadyTime": 0,
          "MaxReadyTime": 37,
          "OneTransferCalls": 0,
          "MaxTalkTime": 0,
          "TotalReadyTime": 0,
          "TotalBreakTime": 0,
          "TotalCalls": 0
        },
        "Inbound": {
          "TotalTalkTime": 0,
          "CallsOffered": 0,
          "AverageRingTime": 0,
          "CallsHandled": 0,
          "ServiceLevel20": 0,
          "TotalWorkTime": 0,
          "MaxWorkTime": 0,
          "AverageWorkTime": 0,
          "AverageTalkTime": 0,
          "SatisfactionIndex": 0,
          "SatisfactionSurveysOffered": 0,
          "HandleRate": 0,
          "SatisfactionSurveysResponded": 0,
          "TotalRingTime": 0,
          "MaxTalkTime": 0,
          "MaxRingTime": 0
        },
        "Outbound": {
          "TotalTalkTime": 0,
          "MaxDialingTime": 0,
          "CallsDialed": 0,
          "CallsAnswered": 0,
          "AnswerRate": 0,
          "TotalWorkTime": 0,
          "MaxWorkTime": "0",
          "TotalDialingTime": 0,
          "AverageTalkTime": 0,
          "AverageWorkTime": 0,
          "SatisfactionIndex": 0,
          "SatisfactionSurveysOffered": 0,
          "SatisfactionSurveysResponded": 0,
          "MaxTalkTime": 0,
          "AverageDialingTime": 0
        }
      }
    ]
  }
}

错误码

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

变更历史

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

上一篇：ListAgentStates - 获取坐席状态列表下一篇：ListLegacyAgentEventLogs - 获取遗留坐席事件日志列表