呼入机器人通话类接口
获取已呼叫通话列表
分页查询租户下呼入机器人通话记录。默认查询最近 7 天;指定 callIdList 时按通话 ID 查询,时间范围参数不生效;时间范围最大 90 天。响应体会经过 OpenAPI 响应加密包装。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| page | int32 | 否 | 页码,从 1 开始;按 callIdList 查询时对 ID 查询结果做手动分页 | |
| pageSize | int32 | 否 | 每页条数,默认 100;时间范围查询最大 100,超过 100 时按 100 查询;按 callIdList 查询时对 ID 查询结果做手动分页 | |
| startTime | int64 | 否 | 查询开始时间,毫秒时间戳;startTime 和 endTime 必须同时传入 | |
| endTime | int64 | 否 | 查询结束时间,毫秒时间戳;startTime 和 endTime 必须同时传入 | |
| callIdList | string[] | 否 | 通话 ID 列表,最多 100 个;传入后按通话 ID 查询,startTime/endTime 不生效 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| requestId | string | 请求追踪 ID,排查问题时提供 | 9d4ea6bef22248e3bfff9da3f89e33be |
| code | int32 | 业务状态码,200 表示业务成功 | 200 |
| message | string | 响应消息;业务失败时为失败原因 | success |
| data | object | 通话记录分页数据 | |
| └list | object[] | 当前页通话记录列表 | |
| └callId | string | 通话 ID | 155f30f0-279f-40d1-9fb8-a7e33811e0da |
| └caller | string | 主叫号码;接口响应中会按 OpenAPI 加密规则加密 | kURBJ+ayEdZiU5KdBZ1yrg== |
| └callee | string | 被叫号码 | 057136890850 |
| └duration | int32 | 通话时长,单位秒 | 86 |
| └numberLocation | string | 主叫号码归属地 | 浙江杭州 |
| └callStartTime | int64 | 呼叫开始时间,毫秒时间戳 | 1753770505190 |
| └callEndTime | int64 | 呼叫结束时间,毫秒时间戳 | 1753770591190 |
| └robotName | string | 机器人名称 | 售前咨询机器人 |
| └callStatus | int32 | 接听状态分类编码 | 1 |
| └callStatusDesc | string | 接听状态中文描述 | 已接通 |
| └resultStatus | int32 | 接听结果状态 | 1 |
| └transferTriggerType | int32 | 转人工类型,0 表示繁忙转人工,1 表示流程中转接 | 1 |
| └audioUrl | string | 录音地址 | https://example.com/audio.wav |
| └consultCategories | object | null[] | 咨询分类列表 | |
| └id | int64 | 咨询分类 ID | 10001 |
| └name | string | 咨询分类名称 | 售前咨询 |
| └description | string | 咨询分类描述 | 用户咨询产品能力、价格等售前问题 |
| └enableStatus | int32 | 启用状态 | 1 |
| └active | int32 | 生效状态 | 1 |
| └aiMark | int32 | AI 标记,0 无,1 大模型,2 智能体,3 大模型 + 智能体 | 3 |
| └total | int64 | 总条数;最大返回上限为 10000 | 231 |
| └page | int32 | 当前页码,从 1 开始 | 1 |
| └pageSize | int32 | 每页条数,默认 100,最大 100 | 100 |
错误码
| 状态码 | 描述 |
|---|---|
| 90001 | 租户未开通或 API Key 无效 |
| 90002 | 签名校验错误 |
| 90003 | 请求头中时间戳错误 |
| 90005 | 参数错误,例如 callIdList 长度超过 100、时间范围缺失或超过 90 天、查询超过 10000 上限 |
getEndpoint
/open/api/deepvox/callRecord/getListcurl -X GET "https://b.163.com/open/api/deepvox/callRecord/getList?page=1&pageSize=100&startTime=1750176000000&endTime=1750780799999&callIdList=call-id-001%2Ccall-id-002"{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success",
"data": {
"list": [
{
"callId": "155f30f0-279f-40d1-9fb8-a7e33811e0da",
"caller": "kURBJ+ayEdZiU5KdBZ1yrg==",
"callee": "057136890850",
"duration": 86,
"numberLocation": "浙江杭州",
"callStartTime": 1753770505190,
"callEndTime": 1753770591190,
"robotName": "售前咨询机器人",
"callStatus": 1,
"callStatusDesc": "已接通",
"resultStatus": 1,
"transferTriggerType": 1,
"audioUrl": "https://example.com/audio.wav",
"consultCategories": [
{
"id": 10001,
"name": "售前咨询",
"description": "用户咨询产品能力、价格等售前问题",
"enableStatus": 1,
"active": 1
}
],
"aiMark": 3
}
],
"total": 231,
"page": 1,
"pageSize": 100
}
}{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success"
}{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success"
}{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success"
}{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success"
}这篇文档有帮助吗?