本文为您介绍了数据统计相关的接口说明。

API名称 描述
GetIndexCurrentValue 获取当前数据统计指标
GetAgentIndexRealTime 获取坐席详情实时数据
GetHotlineAgentDetailReport 获取热线坐席维度数据详情
GetHotlineGroupDetailReport 获取热线技能组维度数据详情

GetIndexCurrentValue

获取当前数据统计指标(当日累计指标 || 当前指标)。

查询逻辑优先级:
  • 若GroupIds不为空,则查询对应技能组列表下数据指标。
  • 否则,若DepIds不为空,则查询对应技能组分组下数据指标。
  • 否则,查询该租户下数据指标。

请求参数

参数名称 类型 是否必填 描述
InstanceId String 实例ID,在控制台上可以看到
DepIds String 技能组分组id列表,多个id以英文逗号(“,”)分割(实例:"2332,23323")
GroupIds String 技能组id列表,多个id以英文逗号(“,”)分割(示例:"2323,232323")

返回数据

参数说明 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Code String 错误编码
Message String 错误描述
Data List 查询结果数据,具体协议如下

Data数据说明

字段 类型 描述
indexName String 指标code
canAcc Boolean 是否可累加(false表示为瞬时数据指标)
indexValue String 指标值
indexShowName String 指标展示名
desc String 指标描述

已有数据指标说明

IndexName IndexShowName
hotlineRateRateSati 热线即时满意度(当天收到的满意评价数 / 参评数)
hotline_rate_service_level 服务水平
punctual 遵时度
n_incall 客户电话请求量(包含被接起和未接起)
n_normal_answer 客户电话请求中被客服接起的量
n_overflow_in 溢入量
n_overflow_out 溢出量
n_inqueue 当前排队量
t_inqueue_max 所有排队电话中,最长的等待时长(单位:秒)
give_rate (进线量 - 接听量)/ 进线量
pickup_rate_20s 20s被接起的电话量 / 进线量
pickup_rate_60s 60s被接起的电话量 / 进线量
n_online_now 当前在线的坐席数(包含通话、空闲、小休、后处理)
n_busy_now 通话中状态的坐席数(包含入呼、外呼)
n_idle_now 空闲状态中的坐席数(正常情况下代表该坐席可以接听、外呼电话)
n_acw_now 后处理状态中的坐席数
n_resttype_now 小休状态中的坐席数(包含签入小休、普通小休、就餐小休、培训等一切小休状态)
n_resttype1_now 普通小休状态中的坐席数
n_resttype2_now 就餐小休状态中的坐席数
n_resttype3_now 会议小休状态中的坐席数
n_resttype4_now 辅导小休状态中的坐席数
n_resttype5_now 培训小休状态中的坐席数
n_resttype98_now 系统强制小休状态中的坐席数
n_resttype99_now 坐席签入小休状态中的坐席数
n_resttype97_now
hotlineNumRateSati 热线即时满意评价数(当天收到的满意评价数)
hotlineNumRateUnSati 热线即时不满意评价数(当天收到的不满意评价数)
hotlineNumRateNormal 热线即时一般评价数(当天收到的一般评价数)
ATT 平均入呼通话时长
ACW 平均后处理时长
INCALL ACW 呼入平均后处理时长
OUTCALL ACW 呼出平均后处理时长
hotline_rate_value_data 即时问卷满意度
hotline_rate_accumulate_data 参评量

返回结果示例

{
  "RequestId": "09CD5EE1-F54D-4777-9CC5-6C171B7C7E46",
  "Message": "successful",
  "Data": [
    {
      "indexName": "hotlineRateRateSati",
      "canAcc": "true",
      "indexValue": "100%",
      "indexNameShow": "hotlineRateRateSati",
      "desc": "热线即时满意度(当天收到的满意评价数 / 参评数)"
    },
    {
      "indexName": "hotline_rate_service_level",
      "canAcc": "true",
      "indexValue": "100%",
      "indexNameShow": "服务水平",
      "desc": "服务水平"
    },
    {
      "indexName": "punctual",
      "canAcc": "false",
      "indexValue": "100%",
      "indexNameShow": "遵时度",
      "desc": "遵时度"
    },
    {
      "indexName": "n_incall",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "n_incall",
      "desc": "客户电话请求量(包含被接起和未接起)"
    },
    {
      "indexName": "n_normal_answer",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "n_normal_answer",
      "desc": "客户电话请求中被客服接起的量"
    },
    {
      "indexName": "n_overflow_in",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "n_overflow_in",
      "desc": "溢入量"
    },
    {
      "indexName": "n_overflow_out",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "n_overflow_out",
      "desc": "溢出量"
    },
    {
      "indexName": "n_inqueue",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_inqueue",
      "desc": "当前排队量"
    },
    {
      "indexName": "t_inqueue_max",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "t_inqueue_max",
      "desc": "所有排队电话中,最长的等待时长(单位:秒)"
    },
    {
      "indexName": "give_rate",
      "canAcc": "true",
      "indexValue": "0.00%",
      "indexNameShow": "give_rate",
      "desc": "(进线量 - 接听量)/ 进线量"
    },
    {
      "indexName": "pickup_rate_20s",
      "canAcc": "true",
      "indexValue": "0.00%",
      "indexNameShow": "pickup_rate_20s",
      "desc": "20s被接起的电话量 / 进线量"
    },
    {
      "indexName": "pickup_rate_60s",
      "canAcc": "true",
      "indexValue": "0.00%",
      "indexNameShow": "pickup_rate_60s",
      "desc": "60s被接起的电话量 / 进线量"
    },
    {
      "indexName": "n_online_now",
      "canAcc": "false",
      "indexValue": "2",
      "indexNameShow": "n_online_now",
      "desc": "当前在线的坐席数(包含通话、空闲、小休、后处理)"
    },
    {
      "indexName": "n_busy_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_busy_now",
      "desc": "通话中状态的坐席数(包含入呼、外呼)"
    },
    {
      "indexName": "n_idle_now",
      "canAcc": "false",
      "indexValue": "2",
      "indexNameShow": "n_idle_now",
      "desc": "空闲状态中的坐席数(正常情况下代表该坐席可以接听、外呼电话)"
    },
    {
      "indexName": "n_acw_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_acw_now",
      "desc": "后处理状态中的坐席数"
    },
    {
      "indexName": "n_resttype_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype_now",
      "desc": "小休状态中的坐席数(包含签入小休、普通小休、就餐小休、培训等一切小休状态)"
    },
    {
      "indexName": "n_resttype1_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype1_now",
      "desc": "普通小休状态中的坐席数"
    },
    {
      "indexName": "n_resttype2_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype2_now",
      "desc": "就餐小休状态中的坐席数"
    },
    {
      "indexName": "n_resttype3_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype3_now",
      "desc": "会议小休状态中的坐席数"
    },
    {
      "indexName": "n_resttype4_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype4_now",
      "desc": "辅导小休状态中的坐席数"
    },
    {
      "indexName": "n_resttype5_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype5_now",
      "desc": "培训小休状态中的坐席数"
    },
    {
      "indexName": "n_resttype98_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype98_now",
      "desc": "系统强制小休状态中的坐席数"
    },
    {
      "indexName": "n_resttype99_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype99_now",
      "desc": "坐席签入小休状态中的坐席数"
    },
    {
      "indexName": "n_resttype97_now",
      "canAcc": "false",
      "indexValue": "0",
      "indexNameShow": "n_resttype97_now",
      "desc": "暂无指标说明"
    },
    {
      "indexName": "hotlineNumRateSati",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "hotlineNumRateSati",
      "desc": "热线即时满意评价数(当天收到的满意评价数)"
    },
    {
      "indexName": "hotlineNumRateUnSati",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "hotlineNumRateUnSati",
      "desc": "热线即时不满意评价数(当天收到的不满意评价数)"
    },
    {
      "indexName": "hotlineNumRateNormal",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "hotlineNumRateNormal",
      "desc": "热线即时一般评价数(当天收到的一般评价数)"
    },
    {
      "indexName": "ATT",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "ATT",
      "desc": "平均入呼通话时长"
    },
    {
      "indexName": "ACW",
      "canAcc": "true",
      "indexValue": "10",
      "indexNameShow": "ACW",
      "desc": "平均后处理时长"
    },
    {
      "indexName": "INCALL ACW",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "INCALL ACW",
      "desc": "呼入平均后处理时长"
    },
    {
      "indexName": "OUTCALL ACW",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "OUTCALL ACW",
      "desc": "呼出平均后处理时长"
    },
    {
      "indexName": "hotline_rate_value_data",
      "canAcc": "true",
      "indexValue": "0.00%",
      "indexNameShow": "即时问卷满意度"
    },
    {
      "indexName": "hotline_rate_accumulate_data",
      "canAcc": "true",
      "indexValue": "0",
      "indexNameShow": "参评量"
    }
  ],
  "Code": "200",
  "Success": true
}

GetAgentIndexRealTime

获取坐席实时数据详情。

查询逻辑优先级:
  • 若GroupIds不为空,则查询对应技能组列表下数据指标。
  • 否则,若DepIds不为空,则查询对应技能组分组下数据指标。
  • 否则,查询该租户下数据指标。

请求参数

参数名称 类型 是否必填 描述
InstanceId String 实例ID,在控制台上可以看到
DepIds List<Long> 技能组分组id列表
GroupIds List<Long> 技能组id列表
PageSize Integer 分页大小(不传默认为10)
CurrentPage Integer 页码(不传默认为1)
StartDate Long 开始日期时间戳(毫秒)
EndDate Long 结束日期时间戳(毫秒)

返回参数

参数说明 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Code String 错误编码
Message String 错误描述
Data Struct 查询结果数据-具体协议如下
Data.Page Integer 当前页面
Data.PageSize Integer
Data.Total Integer 查询总量
Data.Columns Array 返回列描述
Data.Rows List 返回数据结果

返回结果示例

{
  "RequestId": "BE3AC5C8-EDC0-4D87-9CCE-42DD3903051B",
  "Message": "successful",
  "Data": {
    "PageSize": 2,
    "Total": 863,
    "Columns": [
      {
        "Title": "客服ID",
        "Key": "servicerId"
      },
      {
        "Title": "对外昵称",
        "Key": "servicerNickName"
      },
      {
        "Title": "坐席状态",
        "Key": "status"
      },
      {
        "Title": "状态持续时长",
        "Key": "statusLastTime"
      }
    ],
    "Page": 1,
    "Rows": [
      {
        "statusLastTime": "00:31:12",
        "servicerNickName": "逸笙",
        "servicerId": "296002",
        "status": "话后处理"
      },
      {
        "statusLastTime": "00:55:49",
        "servicerNickName": "shi123880",
        "servicerId": "300303",
        "status": "空闲"
      }
    ]
  },
  "Code": "200",
  "Success": true
}

GetHotlineAgentDetailReport

获取热线坐席维度(T+1)数据详情。

查询逻辑优先级:
  • 若GroupIds不为空,则查询对应技能组列表下数据指标。
  • 否则,若DepIds不为空,则查询对应技能组分组下数据指标。
  • 否则,查询该租户下数据指标。

请求参数

参数名称 类型 是否必填 描述
InstanceId String 实例ID,在控制台上可以看到
DepIds List<Long> 技能组分组id列表
GroupIds List<Long> 技能组id列表
PageSize Integer 分页大小(不传默认为10)
CurrentPage Integer 页码(不传默认为1)
StartDate Long 开始日期时间戳(毫秒)
EndDate Long 结束日期时间戳(毫秒)

返回参数

参数说明 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Code String 错误编码
Message String 错误描述
Data Struct 查询结果数据-具体协议如下
Data.Page Integer 当前页面
Data.PageSize Integer
Data.Total Integer 查询总量
Data.Columns Array 返回列描述
Data.Rows List 返回数据结果

返回结果示例

{
  "Message": "successful",
  "RequestId": "24D9F55F-064E-48D2-851C-5C6ABC654C9E",
  "Data": {
    "PageSize": 2,
    "Total": 40,
    "Columns": [
      {
        "Title": "客服名称",
        "Key": "servicerName"
      },
      {
        "Title": "服务接起量",
        "Key": "hotline_num_incall_answer"
      },
      {
        "Title": "60s响应率",
        "Key": "hotline_rate_handle_in_60s"
      },
      {
        "Title": "登录时长",
        "Key": "hotline_time_login"
      },
      {
        "Title": "入呼平均接听时长",
        "Key": "hotline_time_incall_avg"
      },
      {
        "Title": "呼入平均后处理时长",
        "Key": "hotline_time_acw_incall"
      },
      {
        "Title": "小休总时长",
        "Key": "hotline_time_agent_rest"
      },
      {
        "Title": "小休总次数",
        "Key": "hotline_num_to_rest_cnt"
      },
      {
        "Title": "小休比例",
        "Key": "hotline_rate_rest_time"
      },
      {
        "Title": "空闲总时长",
        "Key": "hotline_time_agent_idle"
      },
      {
        "Title": "外呼量",
        "Key": "call_out_cnt"
      },
      {
        "Title": "外呼接通量",
        "Key": "call_out_intervene_cnt"
      },
      {
        "Title": "外呼总时长",
        "Key": "call_out_all_len"
      },
      {
        "Title": "外呼振铃总时长",
        "Key": "call_out_ring_len"
      },
      {
        "Title": "外呼接通总时长",
        "Key": "call_out_intervene_len"
      },
      {
        "Title": "外呼平均时长",
        "Key": "hotline_time_outcall_avg"
      },
      {
        "Title": "外呼平均后处理时长",
        "Key": "hotline_time_acw_outcall"
      },
      {
        "Title": "参评量",
        "Key": "evaluate_cnt"
      },
      {
        "Title": "参评率",
        "Key": "evaluate_rate"
      }
    ],
    "Page": 1,
    "Rows": [
      {
        "hotline_time_acw_incall": "-",
        "hotline_time_acw_outcall": "-",
        "hotline_time_outcall_avg": "-",
        "hotline_num_incall_answer": 0,
        "servicerId": 366001,
        "hotline_time_login": 0,
        "hotline_rate_handle_in_60s": "-",
        "hotline_time_agent_idle": 0,
        "hotline_time_agent_rest": 0,
        "servicerName": "欧阳亚雄",
        "hotline_time_incall_avg": "-",
        "hotline_num_to_rest_cnt": 0,
        "hotline_rate_rest_time": "-",
        "hotline_num_outcall_cnt": 0
      },
      {
        "hotline_time_acw_incall": "-",
        "hotline_time_acw_outcall": "-",
        "hotline_time_outcall_avg": "-",
        "hotline_num_incall_answer": 0,
        "servicerId": 373005,
        "hotline_time_login": 0,
        "hotline_rate_handle_in_60s": "-",
        "hotline_time_agent_idle": 0,
        "hotline_time_agent_rest": 0,
        "servicerName": "隆耀昌",
        "hotline_time_incall_avg": "-",
        "hotline_num_to_rest_cnt": 0,
        "hotline_rate_rest_time": "-",
        "hotline_num_outcall_cnt": 0
      }
    ]
  },
  "Code": "200",
  "Success": true
}

GetHotlineGroupDetailReport

获取热线技能组维度T+1数据详情。

查询逻辑优先级:
  • 若GroupIds不为空,则查询对应技能组列表下数据指标。
  • 否则,若DepIds不为空,则查询对应技能组分组下数据指标。
  • 否则,查询该租户下数据指标。

请求参数

参数名称 类型 是否必填 描述
InstanceId String 实例ID,在控制台上可以看到
DepIds List<Long> 技能组分组id列表
GroupIds List<Long> 技能组id列表
PageSize Integer 分页大小(不传默认为10)
CurrentPage Integer 页码(不传默认为1)
StartDate Long 开始日期时间戳(毫秒)
EndDate Long 结束日期时间戳(毫秒)

返回参数

参数说明 类型 是否为空 描述
RequestId String 请求ID,用于跟踪错误原因
Success Boolean 接口调用是否成功
Code String 错误编码
Message String 错误描述
Data Struct 查询结果数据-具体协议如下
Data.Page Integer 当前页面
Data.PageSize Integer
Data.Total Integer 查询总量
Data.Columns Array 返回列描述
Data.Rows List 返回数据结果

返回结果示例

{
  "RequestId": "5DEC197D-EFD0-4200-A32B-EB1F3FD8D1B3",
  "Message": "successful",
  "Data": {
    "PageSize": 2,
    "Total": 25,
    "Columns": [
      {
        "Title": "技能组名称",
        "Key": "skillGroupName"
      },
      {
        "Title": "服务请求量",
        "Key": "hotline_num_incall_cnt"
      },
      {
        "Title": "服务接起量",
        "Key": "hotline_num_incall_answer"
      },
      {
        "Title": "60s响应率",
        "Key": "hotline_rate_handle_in_60s"
      },
      {
        "Title": "放弃率",
        "Key": "hotline_rate_give_up"
      },
      {
        "Title": "平均等待时长",
        "Key": "hotline_time_member_avg_wait"
      },
      {
        "Title": "参评量",
        "Key": "evaluate_cnt"
      },
      {
        "Title": "参评率",
        "Key": "evaluate_rate"
      }
    ],
    "Page": 1,
    "Rows": [
      {
        "hotline_rate_agent_use": "-",
        "hotline_time_member_avg_wait": "18.00",
        "evaluate_cnt": 0,
        "hotline_time_outcall_avg": "-",
        "hotline_num_incall_answer": 2,
        "evaluate_rate": "0.00%",
        "hotline_num_cph": "-",
        "hotline_rate_handle_in_60s": "100.00%",
        "hotline_time_agent_idle": "0",
        "hotline_time_outcall": "0",
        "hotline_time_agent_rest": "0",
        "skillGroupName": "智联技能组1",
        "hotline_time_aht_incall": "0.00",
        "skillGroupId": 535009,
        "hotline_num_incall_cnt": 2,
        "hotline_rate_give_up": "0.00%",
        "hotline_num_outcall_cnt": 0
      },
      {
        "hotline_rate_agent_use": "-",
        "hotline_time_member_avg_wait": "13.50",
        "evaluate_cnt": 0,
        "hotline_time_outcall_avg": "-",
        "hotline_num_incall_answer": 2,
        "evaluate_rate": "0.00%",
        "hotline_num_cph": "-",
        "hotline_rate_handle_in_60s": "66.67%",
        "hotline_time_agent_idle": "0",
        "hotline_time_outcall": "0",
        "hotline_time_agent_rest": "0",
        "skillGroupName": "UAT技能组",
        "hotline_time_aht_incall": "0.00",
        "skillGroupId": 585008,
        "hotline_num_incall_cnt": 3,
        "hotline_rate_give_up": "33.33%",
        "hotline_num_outcall_cnt": 0
      }
    ]
  },
  "Code": "200",
  "Success": true
}