点击展开字段说明
total long
符合条件的洞察记录总条数。
---
pageNo / pageSize int
当前页码与每页条数。
---
summary object
统计信息，`include` 含 `summary` 时返回，否则为 `null`。元素结构：
- `passCount`：合格条数
- `failCount`：不合格条数
统计与列表使用同一份筛选条件。若请求已指定 `insightResult`，则 `total` 即为该侧计数、另一侧为 0。
---
list array
洞察记录列表，固定按洞察分析时间倒序。元素结构：
- `insightId`：洞察记录唯一 ID，[洞察详情](https://avavox.com/docs/developer/insight/record-detail.html)与[录音地址](https://avavox.com/docs/developer/insight/record-audio.html)接口的入参
- `sessionId`：通话记录 ID
- `customerNumber`：客户号码，**脱敏返回**，如 `183****6716`
- `robotId` / `robotName`：机器人 ID 与名称
- `callStartTime`：通话开始时间，`yyyy-MM-dd HH:mm:ss`
- `callDuration`：通话时长（秒）
- `totalScore`：综合得分，未分析完成时为 `null`
- `fullScore`：满分值，固定 `100`
- `insightResult`：洞察结果，未分析完成时为 `null`
- `insightStatus`：洞察状态
- `ruleGroupId` / `ruleGroupName`：规则组 ID 与名称
- `mainDeductItems`：主要失分项，**仅含命中项**，按 `level` 权重倒序；元素含 `itemCode`、`itemName`、`level`
- `keyFocus`：是否重点关注
- `analyzedTime`：分析完成时间，未完成时为 `null`
- `tags`：数据标签，`include` 含 `tags` 时返回，元素含 `tagId`、`tagName`
- `diagnosis`：完整诊断条目，`include` 含 `diagnosis` 时返回，结构见[洞察详情](https://avavox.com/docs/developer/insight/record-detail.html)
::: tip null 与空数组的区别
`tags` 与 `diagnosis` 未通过 `include` 请求时返回 `null`；请求了但确实没有数据时返回 `[]`。
:::
## 请求示例
查询 2026 年 4 月分析完成、结果为不合格的记录：
```shell
curl -X POST --location 'https://dashboard.avavox.com/open/api/v1/insight/records/query' \
--header 'Authorization: Bearer $Key' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data '{
"insightTimeRange": {
"start": "2026-04-01 00:00:00",
"end": "2026-04-30 23:59:59"
},
"insightResult": "FAIL",
"insightStatus": "ANALYZED",
"pageNo": 1,
"pageSize": 10
}'
```
按号码精确查询，并附带标签：
```shell
curl -X POST --location 'https://dashboard.avavox.com/open/api/v1/insight/records/query' \
--header 'Authorization: Bearer $Key' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data '{
"keyword": "18395636716",
"robotIds": ["robot_default"],
"ruleGroupIds": ["rg_1001"],
"deductItemCodes": ["sys_item_0007", "sys_item_0015"],
"durationRange": { "min": 30, "max": 300 },
"keyFocus": false,
"include": ["summary", "tags"],
"pageNo": 1,
"pageSize": 10
}'
```
## 响应示例
```json
{
"code": 200,
"success": true,
"message": "操作成功",
"data": {
"total": 2589,
"pageNo": 1,
"pageSize": 10,
"summary": {
"passCount": 684,
"failCount": 189
},
"list": [
{
"insightId": "ins_9f2c81b0",
"sessionId": "b4f26ded895a4e469c3a7f1e2d8b6a04",
"customerNumber": "183****6716",
"robotId": "robot_default",
"robotName": "默认机器人",
"callStartTime": "2026-04-28 11:35:13",
"callDuration": 73,
"totalScore": 81,
"fullScore": 100,
"insightResult": "PASS",
"insightStatus": "ANALYZED",
"ruleGroupId": "rg_1001",
"ruleGroupName": "外呼合规通用组",
"mainDeductItems": [
{
"itemCode": "ri_7c3a1f20",
"itemName": "明确拒绝后持续纠缠",
"level": "SEVERE"
},
{
"itemCode": "ri_9f2c81b0",
"itemName": "错误回应AI身份测试",
"level": "MINOR"
}
],
"keyFocus": false,
"analyzedTime": "2026-04-28 11:40:02",
"tags": [
{ "tagId": "t_01", "tagName": "宽带满意度" }
],
"diagnosis": null
}
]
}
}
```
::: tip 需要遍历大量数据时
不要靠增大 `pageNo` 翻到底，`pageNo * pageSize` 超过 10000 请求会失败。请把 `insightTimeRange` 拆成更短的窗口分段拉取，并以 `insightId` 去重。
:::