调用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 |
返回参数
示例
正常返回示例
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
},
"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": 0,
"Duration": 0
}
],
"FirstCheckInTime": 0,
"LastCheckOutTime": 0,
"TotalOutboundScenarioTime": 0,
"TotalOutboundScenarioReadyTime": 0
},
"SkillGroupIds": "[\"skillgroup1@ccc-test\",\"skillgroup2@ccc-test\"]",
"SkillGroupNames": "[\"测试技能组1\",\"测试技能组2\"]"
}
]
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Parameter.Blank | The parameter %s may not be null or blank. | 该参数不能为null或含有空白符的字符串。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||||
|---|---|---|---|---|---|---|---|---|
| 2023-05-23 | OpenAPI 错误码发生变更，OpenAPI 返回结构发生变更 | 看变更集 | ||||||
|