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

获取已呼叫通话列表

分页查询租户下呼入机器人通话记录。默认查询最近 7 天;指定 callIdList 时按通话 ID 查询,时间范围参数不生效;时间范围最大 90 天。响应体会经过 OpenAPI 响应加密包装。

请求参数

名称类型必填描述示例值
pageint32否页码,从 1 开始;按 callIdList 查询时对 ID 查询结果做手动分页
pageSizeint32否每页条数,默认 100;时间范围查询最大 100,超过 100 时按 100 查询;按 callIdList 查询时对 ID 查询结果做手动分页
startTimeint64否查询开始时间,毫秒时间戳;startTime 和 endTime 必须同时传入
endTimeint64否查询结束时间,毫秒时间戳;startTime 和 endTime 必须同时传入
callIdListstring[]否通话 ID 列表,最多 100 个;传入后按通话 ID 查询,startTime/endTime 不生效

返回参数

名称类型描述示例值
requestIdstring请求追踪 ID,排查问题时提供9d4ea6bef22248e3bfff9da3f89e33be
codeint32业务状态码,200 表示业务成功200
messagestring响应消息;业务失败时为失败原因success
dataobject通话记录分页数据
└listobject[]当前页通话记录列表
└callIdstring通话 ID155f30f0-279f-40d1-9fb8-a7e33811e0da
└callerstring主叫号码;接口响应中会按 OpenAPI 加密规则加密kURBJ+ayEdZiU5KdBZ1yrg==
└calleestring被叫号码057136890850
└durationint32通话时长,单位秒86
└numberLocationstring主叫号码归属地浙江杭州
└callStartTimeint64呼叫开始时间,毫秒时间戳1753770505190
└callEndTimeint64呼叫结束时间,毫秒时间戳1753770591190
└robotNamestring机器人名称售前咨询机器人
└callStatusint32接听状态分类编码1
└callStatusDescstring接听状态中文描述已接通
└resultStatusint32接听结果状态1
└transferTriggerTypeint32转人工类型,0 表示繁忙转人工,1 表示流程中转接1
└audioUrlstring录音地址https://example.com/audio.wav
└consultCategoriesobject | null[]咨询分类列表
└idint64咨询分类 ID10001
└namestring咨询分类名称售前咨询
└descriptionstring咨询分类描述用户咨询产品能力、价格等售前问题
└enableStatusint32启用状态1
└activeint32生效状态1
└aiMarkint32AI 标记,0 无,1 大模型,2 智能体,3 大模型 + 智能体3
└totalint64总条数;最大返回上限为 10000231
└pageint32当前页码,从 1 开始1
└pageSizeint32每页条数,默认 100,最大 100100

错误码

状态码描述
90001租户未开通或 API Key 无效
90002签名校验错误
90003请求头中时间戳错误
90005参数错误,例如 callIdList 长度超过 100、时间范围缺失或超过 90 天、查询超过 10000 上限
getEndpoint
/open/api/deepvox/callRecord/getList
GET
/open/api/deepvox/callRecord/getList
curl -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"
}

这篇文档有帮助吗?