呼入机器人通话类接口
获取通话完整详情-callId
按通话 ID 查询单通呼入机器人的通话基础信息、咨询分类、大模型积分消耗、对话明细和变量最终结果。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| callId | string | 是 | 通话 ID |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| requestId | string | 请求追踪 ID,排查问题时提供 | 9d4ea6bef22248e3bfff9da3f89e33be |
| code | int32 | 业务状态码,200 表示业务成功 | 200 |
| message | string | 响应消息;业务失败时为失败原因 | success |
| data | object | 单通通话完整详情 | |
| └callInfo | object | 通话基础信息 | |
| └callId | string | 通话 ID | 155f30f0-279f-40d1-9fb8-a7e33811e0da |
| └recordId | int64 | 通话记录 ID | 123456 |
| └caller | string | 主叫号码;接口响应中会按 OpenAPI 加密规则加密 | kURBJ+ayEdZiU5KdBZ1yrg== |
| └callee | string | 被叫号码 | 057136890850 |
| └numberLocation | string | 主叫号码归属地 | 浙江杭州 |
| └duration | int32 | 通话时长,单位秒 | 86 |
| └callStartTime | int64 | 呼叫开始时间,毫秒时间戳 | 1753770505190 |
| └callEndTime | int64 | 呼叫结束时间,毫秒时间戳 | 1753770591190 |
| └robotName | string | 机器人名称 | 售前咨询机器人 |
| └callStatus | int32 | 接听结果状态编码 | 1 |
| └callStatusDesc | string | 接听结果状态中文描述 | 正常接通挂断 |
| └resultStatus | int32 | 接听结果状态编码,与 callStatus 取值一致 | 1 |
| └transferTriggerType | int32 | 转人工类型,0 表示繁忙转人工,1 表示流程中转接 | 1 |
| └audioUrl | string | 录音地址 | https://example.com/audio.wav |
| └aiMark | int32 | AI 标记,0 无,1 大模型,2 智能体,3 大模型 + 智能体 | 3 |
| └consultCategory | object | null | 咨询分类信息 | |
| └id | int64 | 咨询分类 ID | 10001 |
| └name | string | 咨询分类名称 | 售前咨询 |
| └description | string | 咨询分类描述 | 用户咨询产品能力、价格等售前问题 |
| └enableStatus | int32 | 启用状态 | 1 |
| └active | int32 | 生效状态 | 1 |
| └creditConsumption | object | null | 大模型积分消耗信息;通话未产生大模型计费时不返回 | |
| └billingModel | string | 计费模型名称 | 专业模型 |
| └unitPrice | string | 计费单价文案 | 60 积分/分钟 |
| └billingStartTime | int64 | 计费开始时间,毫秒时间戳 | 1753770505190 |
| └billingDurationSeconds | int32 | 计费时长,单位秒 | 132 |
| └billingDurationMinutes | int32 | 计费时长,单位分钟,不足一分钟按一分钟向上取整 | 3 |
| └consumedCredits | int64 | 消耗积分总数 | 180 |
| └dialogue | object[] | 对话明细,按发生时间升序 | |
| └callId | string | 通话 ID | 155f30f0-279f-40d1-9fb8-a7e33811e0da |
| └recordId | int64 | 通话记录 ID | 123456 |
| └speaker | string | 说话方 | user |
| └type | string | 对话内容类型 | text |
| └context | string | 对话内容 | 我要查询订单进度 |
| └timestampMs | int64 | 发生时间,毫秒时间戳 | 1753770505190 |
| └variableResult | object | 通话变量最终结果 | |
| └snapshotStatus | int32 | 快照状态,0 表示无快照,1 表示正常,2 表示读取失败 | 1 |
| └targetCount | int32 | 采集目标数 | 7 |
| └capturedCount | int32 | 已采集数,包含系统变量 | 5 |
| └notCapturedCount | int32 | 未采集数,仅统计自定义变量 | 1 |
| └captureFailedCount | int32 | 采集失败数,仅统计自定义变量 | 1 |
| └systemVariables | object[] | 系统变量最终结果 | |
| └variableKey | string | 变量编码 | intent_type |
| └variableName | string | 变量名称 | 意图类型 |
| └valueType | string | 变量值类型,取值 string/number/boolean/array/object | string |
| └captureStatus | int32 | 采集状态,0 未采集、1 已采集、2 采集失败 | 1 |
| └captureStatusDesc | string | 采集状态中文描述 | 已采集 |
| └value | object | 变量最终值;类型为 array/object/number/boolean 时为对应的 JSON 值,否则为字符串 | ["售前咨询","产品报价"] |
| └captureSource | string | 变量采集来源 | 大模型变量提取 |
| └captureLocation | string | 变量采集位置 | 咨询意图确认节点 |
| └captureText | string | 变量采集文本 | 我想咨询一下产品报价 |
| └customVariables | object[] | 自定义变量最终结果 | |
| └variableKey | string | 变量编码 | intent_type |
| └variableName | string | 变量名称 | 意图类型 |
| └valueType | string | 变量值类型,取值 string/number/boolean/array/object | string |
| └captureStatus | int32 | 采集状态,0 未采集、1 已采集、2 采集失败 | 1 |
| └captureStatusDesc | string | 采集状态中文描述 | 已采集 |
| └value | object | 变量最终值;类型为 array/object/number/boolean 时为对应的 JSON 值,否则为字符串 | ["售前咨询","产品报价"] |
| └captureSource | string | 变量采集来源 | 大模型变量提取 |
| └captureLocation | string | 变量采集位置 | 咨询意图确认节点 |
| └captureText | string | 变量采集文本 | 我想咨询一下产品报价 |
错误码
| 状态码 | 描述 |
|---|---|
| 90001 | 租户未开通或 API Key 无效 |
| 90002 | 签名校验错误 |
| 90003 | 请求头中时间戳错误 |
| 90005 | callId 缺失或对应通话不存在 |
getEndpoint
/open/api/deepvox/callRecord/getDetailByCallIdcurl -X GET "https://b.163.com/open/api/deepvox/callRecord/getDetailByCallId?callId=155f30f0-279f-40d1-9fb8-a7e33811e0da"{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success",
"data": {
"callInfo": {
"callId": "155f30f0-279f-40d1-9fb8-a7e33811e0da",
"recordId": 123456,
"caller": "kURBJ+ayEdZiU5KdBZ1yrg==",
"callee": "057136890850",
"numberLocation": "浙江杭州",
"duration": 86,
"callStartTime": 1753770505190,
"callEndTime": 1753770591190,
"robotName": "售前咨询机器人",
"callStatus": 1,
"callStatusDesc": "正常接通挂断",
"resultStatus": 1,
"transferTriggerType": 1,
"audioUrl": "https://example.com/audio.wav",
"aiMark": 3
},
"consultCategory": {
"id": 10001,
"name": "售前咨询",
"description": "用户咨询产品能力、价格等售前问题",
"enableStatus": 1,
"active": 1
},
"creditConsumption": {
"billingModel": "专业模型",
"unitPrice": "60 积分/分钟",
"billingStartTime": 1753770505190,
"billingDurationSeconds": 132,
"billingDurationMinutes": 3,
"consumedCredits": 180
},
"dialogue": [
{
"callId": "155f30f0-279f-40d1-9fb8-a7e33811e0da",
"recordId": 123456,
"speaker": "user",
"type": "text",
"context": "我要查询订单进度",
"timestampMs": 1753770505190
}
],
"variableResult": {
"snapshotStatus": 1,
"targetCount": 7,
"capturedCount": 5,
"notCapturedCount": 1,
"captureFailedCount": 1,
"systemVariables": [
{
"variableKey": "intent_type",
"variableName": "意图类型",
"valueType": "string",
"captureStatus": 1,
"captureStatusDesc": "已采集",
"value": [
"售前咨询",
"产品报价"
],
"captureSource": "大模型变量提取",
"captureLocation": "咨询意图确认节点",
"captureText": "我想咨询一下产品报价"
}
],
"customVariables": [
{
"variableKey": "intent_type",
"variableName": "意图类型",
"valueType": "string",
"captureStatus": 1,
"captureStatusDesc": "已采集",
"value": [
"售前咨询",
"产品报价"
],
"captureSource": "大模型变量提取",
"captureLocation": "咨询意图确认节点",
"captureText": "我想咨询一下产品报价"
}
]
}
}
}{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success"
}{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success"
}{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success"
}{
"requestId": "9d4ea6bef22248e3bfff9da3f89e33be",
"code": 200,
"message": "success"
}这篇文档有帮助吗?