文档

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

更新时间:
目前该API接口已标记为弃用,推荐使用替代API:CCC(2020-07-01) - ListHistoricalAgentReport

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

调试

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

授权信息

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

请求参数

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

实例 ID。

ccc-test
SkillGroupIdstring

按技能组 ID 过滤。

skillgroup@ccc-test
AgentIdsstring

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

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

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

1
PageSizeinteger

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

10

返回参数

名称类型描述示例值
object
HttpStatusCodeinteger

HTTP 状态码。

200
Codestring

响应码。

OK
Messagestring

响应信息。

RequestIdstring

请求 ID。

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

是否成功。

true
PagedAgentSummaryReportobject

数据。

PageNumberinteger

分页序号,范围 1-100。

1
PageSizeinteger

分页大小,范围 1-100。

10
TotalCountinteger

总数。

2
Listarray<object>

坐席概览数据列表。

object

坐席概览数据。

LoginNamestring

座席登录名。

agent
AgentIdstring

坐席 ID。

agent@ccc-test
AgentNamestring

坐席名称。

坐席小王。
SkillGroupNamesstring

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

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

统计打点时刻。

2018-09-13 00:00:00
InstanceIdstring

实例 ID。

ccc-test
SkillGroupIdsstring

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

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

整体指标。

TotalTalkTimelong

总通话时长,单位秒。

0
TotalLoggedInTimelong

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

0
OccupancyRatefloat

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

0
TotalWorkTimelong

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

0
MaxWorkTimelong

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

0
AverageWorkTimelong

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

0
AverageTalkTimelong

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

0
SatisfactionIndexfloat

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
AverageReadyTimelong

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

0
MaxReadyTimelong

最大就绪时长,单位秒。

37
OneTransferCallslong

直接转接的通话数量。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
TotalReadyTimelong

总就绪时长,单位为秒。

0
TotalBreakTimelong

总小休时长,单位秒。

0
TotalCallslong

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

0
Inboundobject

呼入指标。

TotalTalkTimelong

总通话时长,单位秒。

0
CallsOfferedlong

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

0
AverageRingTimelong

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

0
CallsHandledlong

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

0
ServiceLevel20float

20 秒应答率,单位%。

0
TotalWorkTimelong

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

0
MaxWorkTimelong

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

0
AverageWorkTimelong

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

0
AverageTalkTimelong

平均通话时长,单位秒。

0
SatisfactionIndexfloat

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
HandleRatefloat

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

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
TotalRingTimelong

总振铃时长,单位秒。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
MaxRingTimelong

最大振铃时长,单位秒。

0
Outboundobject

呼出指标。

TotalTalkTimelong

总通话时长,单位秒。

0
MaxDialingTimelong

最大拨号时长,单位秒。

0
CallsDialedlong

电话拨号量。

0
CallsAnsweredlong

电话接通量。

0
AnswerRatefloat

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

0
TotalWorkTimelong

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

0
MaxWorkTimestring

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

0
TotalDialingTimelong

总拨号时长,单位秒。

0
AverageTalkTimelong

平均通话时长,单位秒。

0
AverageWorkTimelong

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

0
SatisfactionIndexfloat

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

0
SatisfactionSurveysOfferedlong

满意度调查发送次数。

0
SatisfactionSurveysRespondedlong

满意度调查响应次数。

0
MaxTalkTimelong

最大通话时长,单位秒。

0
AverageDialingTimelong

平均拨号时长,单位秒。

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
        }
      }
    ]
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-11-28OpenAPI 变更为 deprecated,即将下线查看变更详情