本文为您介绍了数据统计相关的接口说明。
| 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
}
在文档使用中是否遇到以下问题
更多建议
匿名提交