七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
呼入机器人通话类接口

获取通话完整详情-callId

按通话 ID 查询单通呼入机器人的通话基础信息、咨询分类、大模型积分消耗、对话明细和变量最终结果。

请求参数

名称类型必填描述示例值
callIdstring是通话 ID

返回参数

名称类型描述示例值
requestIdstring请求追踪 ID,排查问题时提供9d4ea6bef22248e3bfff9da3f89e33be
codeint32业务状态码,200 表示业务成功200
messagestring响应消息;业务失败时为失败原因success
dataobject单通通话完整详情
└callInfoobject通话基础信息
└callIdstring通话 ID155f30f0-279f-40d1-9fb8-a7e33811e0da
└recordIdint64通话记录 ID123456
└callerstring主叫号码;接口响应中会按 OpenAPI 加密规则加密kURBJ+ayEdZiU5KdBZ1yrg==
└calleestring被叫号码057136890850
└numberLocationstring主叫号码归属地浙江杭州
└durationint32通话时长,单位秒86
└callStartTimeint64呼叫开始时间,毫秒时间戳1753770505190
└callEndTimeint64呼叫结束时间,毫秒时间戳1753770591190
└robotNamestring机器人名称售前咨询机器人
└callStatusint32接听结果状态编码1
└callStatusDescstring接听结果状态中文描述正常接通挂断
└resultStatusint32接听结果状态编码,与 callStatus 取值一致1
└transferTriggerTypeint32转人工类型,0 表示繁忙转人工,1 表示流程中转接1
└audioUrlstring录音地址https://example.com/audio.wav
└aiMarkint32AI 标记,0 无,1 大模型,2 智能体,3 大模型 + 智能体3
└consultCategoryobject | null咨询分类信息
└idint64咨询分类 ID10001
└namestring咨询分类名称售前咨询
└descriptionstring咨询分类描述用户咨询产品能力、价格等售前问题
└enableStatusint32启用状态1
└activeint32生效状态1
└creditConsumptionobject | null大模型积分消耗信息;通话未产生大模型计费时不返回
└billingModelstring计费模型名称专业模型
└unitPricestring计费单价文案60 积分/分钟
└billingStartTimeint64计费开始时间,毫秒时间戳1753770505190
└billingDurationSecondsint32计费时长,单位秒132
└billingDurationMinutesint32计费时长,单位分钟,不足一分钟按一分钟向上取整3
└consumedCreditsint64消耗积分总数180
└dialogueobject[]对话明细,按发生时间升序
└callIdstring通话 ID155f30f0-279f-40d1-9fb8-a7e33811e0da
└recordIdint64通话记录 ID123456
└speakerstring说话方user
└typestring对话内容类型text
└contextstring对话内容我要查询订单进度
└timestampMsint64发生时间,毫秒时间戳1753770505190
└variableResultobject通话变量最终结果
└snapshotStatusint32快照状态,0 表示无快照,1 表示正常,2 表示读取失败1
└targetCountint32采集目标数7
└capturedCountint32已采集数,包含系统变量5
└notCapturedCountint32未采集数,仅统计自定义变量1
└captureFailedCountint32采集失败数,仅统计自定义变量1
└systemVariablesobject[]系统变量最终结果
└variableKeystring变量编码intent_type
└variableNamestring变量名称意图类型
└valueTypestring变量值类型,取值 string/number/boolean/array/objectstring
└captureStatusint32采集状态,0 未采集、1 已采集、2 采集失败1
└captureStatusDescstring采集状态中文描述已采集
└valueobject变量最终值;类型为 array/object/number/boolean 时为对应的 JSON 值,否则为字符串["售前咨询","产品报价"]
└captureSourcestring变量采集来源大模型变量提取
└captureLocationstring变量采集位置咨询意图确认节点
└captureTextstring变量采集文本我想咨询一下产品报价
└customVariablesobject[]自定义变量最终结果
└variableKeystring变量编码intent_type
└variableNamestring变量名称意图类型
└valueTypestring变量值类型,取值 string/number/boolean/array/objectstring
└captureStatusint32采集状态,0 未采集、1 已采集、2 采集失败1
└captureStatusDescstring采集状态中文描述已采集
└valueobject变量最终值;类型为 array/object/number/boolean 时为对应的 JSON 值,否则为字符串["售前咨询","产品报价"]
└captureSourcestring变量采集来源大模型变量提取
└captureLocationstring变量采集位置咨询意图确认节点
└captureTextstring变量采集文本我想咨询一下产品报价

错误码

状态码描述
90001租户未开通或 API Key 无效
90002签名校验错误
90003请求头中时间戳错误
90005callId 缺失或对应通话不存在
getEndpoint
/open/api/deepvox/callRecord/getDetailByCallId
GET
/open/api/deepvox/callRecord/getDetailByCallId
curl -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"
}

这篇文档有帮助吗?