调用ListHistoricalSkillGroupReport获取指定实例下的一个或多个技能组的历史数据报表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PageNumber | integer | 是 | 分页序号，范围 1-100。 | 1 |
| PageSize | integer | 是 | 分页大小，范围 1-100。 | 100 |
| SkillGroupIdList | string | 否 | 待查询的技能组 ID 列表，格式为 JSON 数组的字符串，数组元素为技能组 ID，非必填，默认为空，表示查询当前分页下的所有技能组。 | ["skillgroup1@ccc-test", "skillgroup2@ccc-test2"] |
| StartTime | long | 否 | 获取的历史数据的起始时间，格式为 Unix 时间戳，单位毫秒，非必填，默认为当天的 0 时，最早为当前时间往前 180 天，统计的时间精度为小时，向前取整，闭区间。 | 1532448000000 |
| EndTime | long | 否 | 获取的历史数据的终止时间，格式为 Unix 时间戳，单位毫秒，非必填，默认为当前时间，统计的时间精度为小时，向后取整，开区间。例如：开始时间为 11:12:20，结束时间为 11:45:50，则对齐后的入参时间范围为[11:00:00, 12:00:00) ，即大于等于 11 点，小于 12 点。 | 1532707199000 |
| InstanceId | string | 是 | 实例 ID。 | ccc-test |
| MediaType | string | 否 | 媒体类型，默认是语音(Audio), 其他可选参数包括 Chat 和 Video. | VIDEO |
返回参数
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "无",
"RequestId": "26A34338-5CD9-4C95-A7A6-5BDCE76C6B94",
"Data": {
"PageNumber": 1,
"PageSize": 100,
"TotalCount": 4,
"List": [
{
"SkillGroupName": "skillgroup",
"SkillGroupId": "skillgroup@ccc-test",
"Inbound": {
"AverageRingTime": 5,
"CallsOverflow": 0,
"CallsAbandonedInRing": 0,
"CallsHandled": 7,
"TotalWorkTime": 85,
"TotalAbandonedInRingTime": 0,
"MaxWorkTime": 12,
"CallsAttendedTransferOut": 0,
"AverageWaitTime": 5,
"TotalHoldTime": 0,
"MaxAbandonTime": 0,
"AverageWorkTime": 13,
"CallsQueued": 7,
"CallsBlindTransferIn": 0,
"SatisfactionIndex": 0,
"AverageAbandonedInRingTime": 0,
"AverageAbandonTime": 0,
"CallsRinged": 7,
"CallsBlindTransferOut": 0,
"CallsAttendedTransferIn": 0,
"CallsAbandoned": 0,
"MaxAbandonedInQueueTime": 0,
"TotalWaitTime": 34,
"TotalRingTime": 32,
"MaxTalkTime": 0,
"MaxRingTime": 12,
"AbandonRate": 0,
"TotalTalkTime": 447,
"TotalAbandonTime": 0,
"CallsOffered": 7,
"MaxAbandonedInRingTime": 0,
"MaxWaitTime": 13,
"AverageAbandonedInQueueTime": 0,
"ServiceLevel20": 0,
"MaxHoldTime": 0,
"SatisfactionRate": 0,
"AverageTalkTime": 64,
"CallsHold": 0,
"SatisfactionSurveysOffered": 0,
"HandleRate": 1,
"CallsTimeout": 0,
"SatisfactionSurveysResponded": 0,
"AverageHoldTime": 0,
"TotalAbandonedInQueueTime": 0,
"CallsAbandonedInQueue": 0,
"CallsQueuingTimeout": 0,
"CallsQueuingOverflow": 0,
"AccessChannelTypeDetails": [
{
"AccessChannelType": "Web",
"CallsOffered": 2
}
],
"AverageFirstResponseTime": 6,
"AverageResponseTime": 8,
"CallsQueuingFailed": 0,
"ServiceLevel15": 0.7,
"ServiceLevel30": 0.9,
"TotalMessagesSent": 12,
"TotalMessagesSentByAgent": 9,
"TotalMessagesSentByCustomer": 3
},
"Outbound": {
"AverageRingTime": 0,
"CallsDialed": 6,
"CallsAnswered": 1,
"TotalWorkTime": 9,
"CallsAttendedTransferOut": 0,
"MaxWorkTime": 0,
"TotalDialingTime": 218,
"TotalHoldTime": 0,
"AverageWorkTime": 2,
"CallsBlindTransferIn": 0,
"SatisfactionIndex": 0,
"CallsRinged": 0,
"CallsAttendedTransferIn": 0,
"CallsBlindTransferOut": 0,
"TotalRingTime": 0,
"MaxTalkTime": 0,
"MaxRingTime": 0,
"TotalTalkTime": 3,
"MaxDialingTime": 12,
"AnswerRate": 0,
"MaxHoldTime": 0,
"AverageTalkTime": 3,
"SatisfactionRate": 0,
"CallsHold": 0,
"SatisfactionSurveysOffered": 0,
"SatisfactionSurveysResponded": 0,
"AverageHoldTime": 0,
"AverageDialingTime": 37
},
"Overall": {
"TotalTalkTime": 449,
"TotalLoggedInTime": 23218,
"OccupancyRate": 0.02332222293912065,
"TotalWorkTime": 94,
"MaxHoldTime": 0,
"MaxWorkTime": 12,
"AverageBreakTime": 0,
"TotalHoldTime": 0,
"SatisfactionRate": 0,
"MaxBreakTime": 1,
"AverageWorkTime": 8,
"AverageTalkTime": 0,
"SatisfactionIndex": 0,
"SatisfactionSurveysOffered": 0,
"SatisfactionSurveysResponded": 0,
"MaxReadyTime": 19328,
"AverageReadyTime": 0,
"AverageHoldTime": 0,
"TotalReadyTime": 22428,
"TotalBreakTime": 3,
"MaxTalkTime": 0,
"TotalCalls": 13,
"BreakCodeDetailList": [
{
"BreakCode": "会议",
"Count": 2,
"Duration": 3600
}
]
},
"Back2Back": {
"CallsDialed": 100,
"AnswerRate": 0.6,
"CallsAnswered": 100,
"TotalTalkTime": 100,
"MaxTalkTime": 100,
"AverageTalkTime": 100,
"TotalRingTime": 100,
"MaxRingTime": 100,
"AverageRingTime": 100,
"TotalCustomerRingTime": 100,
"MaxCustomerRingTime": 100,
"AverageCustomerRingTime": 100,
"AgentHandleRate": 1,
"CallsCustomerAnswered": 8,
"CustomerAnswerRate": 0.8
}
}
]
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.Format | The format of parameter %s is invalid. %s | 该参数的格式不合法。 |
| 400 | Parameter.Blank | The parameter %s may not be null or blank. | 该参数不能为null或含有空白符的字符串。 |
| 500 | InternalService.Common | An internal service error occurred. %s | 内部服务错误。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2023-11-22 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |