调用ListHistoricalAgentReport获取指定实例下的一个或多个坐席的历史数据报表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PageNumber | integer | 是 | 分页序号，范围 1-100。 | 1 |
| PageSize | integer | 是 | 分页大小，范围 1-100。 | 100 |
| AgentIdList | string | 否 | 坐席 ID 列表，范围 0-100 。 说明
如果坐席 ID 列表不为空，则直接按照坐席 ID 列表进行查询，此时 pageSize 和 pageNumber 参数无效，数据直接返回，如：请求参数：pageNumber = 3 则响应参数中 pageNumber = 3 。
| ["agent1@ccc-test", "agent2@ccc-test"] |
| StartTime | long | 否 | 获取的历史数据的起始时间，默认为当天的 0 时，最早为当前时间往前 180 天。统计的时间精度为小时，向前取整，闭区间，格式为 Unix 时间戳，单位毫秒。 | 1532448000000 |
| StopTime | long | 否 | 获取的历史数据的终止时间，默认为当前时间。统计的时间精度为小时，向后取整，开区间。例如：开始时间为 11:12:20，结束时间为 11:45:50，则对齐后的入参时间范围为 [11:00:00, 12:00:00) ，即大于等于 11 点，小于 12 点，格式为 Unix 时间戳，单位毫秒。 | 1532707199000 |
| InstanceId | string | 是 | 实例 ID。 | ccc-test |
| MediaType | string | 否 | 媒体类型，默认是语音(Audio), 其他可选参数包括 Chat 和 Video. | VIDEO |
| SkillGroupId | string | 否 | 技能组 ID。 | wwtest@test_yunhu |
返回参数
示例
正常返回示例
JSON格式
{
"Code": "OK",
"HttpStatusCode": 200,
"Message": "无",
"RequestId": "EEEE671A-3E24-4A04-81E6-6C4F5B39DF75",
"Data": {
"PageNumber": 1,
"PageSize": 100,
"TotalCount": 10,
"List": [
{
"AgentName": "坐席小王",
"AgentId": "agent1@ccc-test",
"DisplayId": "001",
"Inbound": {
"AverageRingTime": 0,
"CallsHandled": 0,
"TotalWorkTime": 0,
"CallsAttendedTransferOut": 0,
"MaxWorkTime": 0,
"TotalHoldTime": 0,
"AverageWorkTime": 0,
"CallsBlindTransferIn": 0,
"SatisfactionIndex": 0,
"CallsRinged": 0,
"CallsAttendedTransferIn": 0,
"CallsBlindTransferOut": 0,
"TotalRingTime": 0,
"MaxTalkTime": 0,
"MaxRingTime": 0,
"TotalTalkTime": 0,
"CallsOffered": 0,
"MaxHoldTime": 0,
"AverageTalkTime": 0,
"SatisfactionRate": 0,
"CallsHold": 0,
"SatisfactionSurveysOffered": 0,
"HandleRate": 0,
"SatisfactionSurveysResponded": 0,
"AverageHoldTime": 0,
"AccessChannelTypeDetails": [
{
"AccessChannelType": "Web",
"CallsOffered": 3
}
],
"AverageFirstResponseTime": 10,
"AverageResponseTime": 12,
"ServiceLevel15": 0.85,
"TotalMessagesSent": 16,
"TotalMessagesSentByAgent": 7,
"TotalMessagesSentByCustomer": "9"
},
"Outbound": {
"AverageRingTime": 0,
"CallsDialed": 0,
"CallsAnswered": 0,
"TotalWorkTime": 0,
"CallsAttendedTransferOut": 0,
"MaxWorkTime": 0,
"TotalDialingTime": 0,
"TotalHoldTime": 0,
"AverageWorkTime": 0,
"CallsBlindTransferIn": 0,
"SatisfactionIndex": 0,
"CallsRinged": 0,
"CallsAttendedTransferIn": 0,
"CallsBlindTransferOut": 0,
"TotalRingTime": 0,
"MaxTalkTime": 0,
"MaxRingTime": 0,
"TotalTalkTime": 0,
"MaxDialingTime": 0,
"AnswerRate": 0,
"MaxHoldTime": 0,
"AverageTalkTime": 0,
"SatisfactionRate": 0,
"CallsHold": 0,
"SatisfactionSurveysOffered": 0,
"SatisfactionSurveysResponded": 0,
"AverageHoldTime": 0,
"AverageDialingTime": 0
},
"Overall": {
"TotalTalkTime": 0,
"TotalLoggedInTime": 0,
"OccupancyRate": 0,
"TotalWorkTime": 0,
"MaxHoldTime": 0,
"MaxWorkTime": 0,
"AverageBreakTime": 0,
"TotalHoldTime": 0,
"SatisfactionRate": 0,
"MaxBreakTime": 0,
"AverageWorkTime": 0,
"AverageTalkTime": 0,
"SatisfactionIndex": 0,
"SatisfactionSurveysOffered": 0,
"SatisfactionSurveysResponded": 0,
"MaxReadyTime": 0,
"AverageReadyTime": 0,
"AverageHoldTime": 0,
"TotalReadyTime": 0,
"TotalBreakTime": 0,
"MaxTalkTime": 0,
"TotalCalls": 0,
"TotalOnSiteOnlineTime": 0,
"TotalOffSiteOnlineTime": 0,
"TotalOfficePhoneOnlineTime": 0,
"BreakCodeDetailList": [
{
"BreakCode": "会议",
"Count": 3,
"Duration": 120
}
],
"FirstCheckInTime": 1686030515000,
"LastCheckOutTime": 1686030515000,
"TotalOutboundScenarioTime": 0,
"TotalOutboundScenarioReadyTime": 100,
"TotalOfficePhoneLoggedInTime": 3600,
"TotalOffSiteLoggedInTime": 100,
"TotalOnSiteLoggedInTime": 100,
"TotalOutboundScenarioLoggedInTime": 100
},
"SkillGroupIds": "[\"skillgroup1@ccc-test\",\"skillgroup2@ccc-test\"]",
"SkillGroupNames": "[\"测试技能组1\",\"测试技能组2\"]",
"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",
"CallsAgentHandled": "10",
"AgentHandleRate": "1",
"CallsCustomerAnswered": "7",
"CustomerAnswerRate": "0.7"
},
"Internal": {
"TotalTalkTime": 100,
"AverageTalkTime": 100,
"MaxTalkTime": 100,
"CallsOffered": 100,
"CallsHandled": 100,
"CallsTalked": 100,
"CallsDialed": 100,
"CallsAnswered": 100
}
}
]
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.Blank | The parameter %s may not be null or blank. | 该参数不能为null或含有空白符的字符串。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2023-11-22 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |
| 2023-05-23 | OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更 | 查看变更详情 |