调用ListHistoricalAgentSkillGroupReport获取指定实例下的一个或多个坐席的历史分组数据报表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PageNumber | integer | 是 | 分页序号，范围 1-100。 | 1 |
| PageSize | integer | 是 | 分页大小，范围 1-100。 | 10 |
| AgentIdList | string | 否 | 坐席 ID 列表，列表大小 0-100。 | ["agent1@ccc-test", "agent2@ccc-test"] |
| StartTime | long | 否 | 开始时间戳，默认为当天的 0 时。统计的时间精度为小时，向前取整，闭区间。 | 1634140800000 |
| EndTime | long | 否 | 获取的历史数据的终止时间，格式为 Unix 时间戳，单位毫秒，非必填，默认为当前时间，统计的时间精度为小时，向后取整，开区间。例如：开始时间为 11:12:20，结束时间为 11:45:50，则对齐后的入参时间范围为[11:00:00,12:00:00) ，即大于等于 11 点，小于 12 点。 | 1620273600000 |
| InstanceId | string | 是 | 实例 ID。 | ccc-test |
| SkillGroupIdList | string | 否 | 技能组 ID 列表，列表大小 0-100。 | [ "skg1@ccc-test", "skg2@ccc-test" ] |
| MediaType | string | 否 | 媒体类型，默认是语音(Audio), 其他可选参数包括 Chat 和 Video. | VIDEO |
返回参数
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "无",
"RequestId": "BA03159C-E808-4FF1-B27E-A61B6E888D7F",
"Data": {
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 11,
"List": [
{
"AgentName": "云呼测试坐席",
"AgentId": "agent1@ccc-test",
"DisplayId": "1001",
"SkillGroupName": "Default",
"SkillGroupId": "skillgroup1@ccc-test",
"Inbound": {
"AverageRingTime": 100,
"CallsHandled": 100,
"TotalWorkTime": 100,
"CallsAttendedTransferOut": 100,
"MaxWorkTime": 100,
"TotalHoldTime": 100,
"AverageWorkTime": 100,
"CallsBlindTransferIn": 100,
"SatisfactionIndex": 100,
"CallsRinged": 100,
"CallsAttendedTransferIn": 100,
"CallsBlindTransferOut": 100,
"TotalRingTime": 100,
"MaxTalkTime": 100,
"MaxRingTime": 100,
"TotalTalkTime": 100,
"CallsOffered": 100,
"MaxHoldTime": 100,
"AverageTalkTime": 100,
"SatisfactionRate": 0.5,
"CallsHold": 100,
"SatisfactionSurveysOffered": 100,
"HandleRate": 100,
"SatisfactionSurveysResponded": 100,
"AverageHoldTime": 100,
"TotalMessagesSent": 12,
"TotalMessagesSentByAgent": 6,
"TotalMessagesSentByCustomer": 6,
"AverageFirstResponseTime": 8,
"AverageResponseTime": 9
},
"Outbound": {
"AverageRingTime": 100,
"CallsDialed": 100,
"CallsAnswered": 100,
"TotalWorkTime": 100,
"CallsAttendedTransferOut": 100,
"MaxWorkTime": 100,
"TotalDialingTime": 100,
"TotalHoldTime": 100,
"AverageWorkTime": 100,
"CallsBlindTransferIn": 100,
"SatisfactionIndex": 1.4,
"CallsRinged": 100,
"CallsAttendedTransferIn": 100,
"CallsBlindTransferOut": 100,
"TotalRingTime": 100,
"MaxTalkTime": 100,
"MaxRingTime": 100,
"TotalTalkTime": 100,
"MaxDialingTime": 100,
"AnswerRate": 0.5,
"MaxHoldTime": 100,
"AverageTalkTime": 100,
"SatisfactionRate": 0.5,
"CallsHold": 100,
"SatisfactionSurveysOffered": 100,
"SatisfactionSurveysResponded": 100,
"AverageHoldTime": 100,
"AverageDialingTime": 100
},
"Overall": {
"TotalTalkTime": 100,
"TotalLoggedInTime": 100,
"OccupancyRate": 0.5,
"TotalWorkTime": 100,
"MaxHoldTime": 100,
"MaxWorkTime": 100,
"AverageBreakTime": 100,
"TotalHoldTime": 100,
"SatisfactionRate": 0.5,
"MaxBreakTime": 100,
"AverageWorkTime": 100,
"AverageTalkTime": 100,
"SatisfactionIndex": 1.4,
"SatisfactionSurveysOffered": 100,
"SatisfactionSurveysResponded": 100,
"MaxReadyTime": 100,
"AverageReadyTime": 100,
"AverageHoldTime": 100,
"TotalReadyTime": 100,
"TotalBreakTime": 100,
"MaxTalkTime": 100,
"TotalCalls": 100,
"BreakCodeDetailList": [
{
"BreakCode": "开会",
"Count": 1,
"Duration": 100
}
],
"FirstCheckInTime": 1686030515000,
"LastCheckOutTime": 1686030515000,
"TotalOutboundScenarioTime": 100,
"TotalOutboundScenarioReadyTime": 100,
"TotalOutboundScenarioLoggedInTime": 120,
"TotalOfficePhoneLoggedInTime": 120,
"TotalOffSiteLggedInTime": 120,
"TotalOnSiteLoggedInTime": "120"
},
"Internal": {
"TotalTalkTime": 100,
"AverageTalkTime": 100,
"MaxTalkTime": 100,
"CallsOffered": 100,
"CallsHandled": 100,
"CallsTalk": 100,
"CallsDialed": 100,
"CallsAnswered": 100,
"CallsTalked": 5
},
"Back2Back": {
"CallsDialed": 100,
"AnswerRate": 0.6,
"CallsAnswered": 100,
"AgentAnswerRate": 0,
"CallsCustomerHandled": 0,
"CustomerHandleRate": 0,
"TotalTalkTime": 100,
"MaxTalkTime": 100,
"AverageTalkTime": 100,
"TotalRingTime": 100,
"MaxRingTime": 100,
"AverageRingTime": 100,
"TotalCustomerRingTime": 100,
"MaxCustomerRingTime": 100,
"AverageCustomerRingTime": 100,
"AgentHandleRate": 0.5,
"CallsCustomerAnswered": 100,
"CustomerAnswerRate": 0.5,
"CallsAgentHandled": 100
}
}
]
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.Blank | The parameter %s must not be null or empty. | 该参数不能为null值。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2023-11-22 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |