查询通话记录列表

POST
https://api.itniotech.com/v3/cc/record/query
查询通话记录列表。
 
请求参数
参数 说明 是否必填 类型
current 当前页码,1-N Integer
size 每页显示数,1-100 Integer
params 分页参数 JSONObject
startTime 查询起始时间,ISO8601标准时间格式:2022-01-01T00:00:00+08:00 String
endTime 查询起始时间,ISO8601标准时间格式:2022-01-31T00:00:00+08:00 String
voiceGroupId 坐席组(坐席组查询返回voiceGroupId) Integer
sipGroupName 坐席组 String
seatId 坐席id List<Integer>
seatNameList 坐席名称列表 List<String>
callType 呼叫类型 1-群呼转坐席,2-呼入,3-呼出 List<Integer>
hangupReason 挂机原因:0-呼出未接听,1-呼出被挂断,2-转接响铃挂断,3-转接成功挂断,4-呼叫失败,5-被叫运营商暂无服务,6-被叫不在服务区,7-被叫忙线,8-呼入未接听,9-呼入被挂断 List<Integer>
calledOrCaller 被叫或者主叫号码 String
ccode 国家码 List<String>
hangingDirection 挂断方向,0-客户挂断,1-坐席挂断,3-无 List<Integer>
labelNames 标签名称 List<String>
 
请求示例
Request URL: 
    https://api.itniotech.com/v3/cc/record/query
Request Method:
    POST
Request Headers:
    Content-Type: application/json;charset=UTF-8
    Sign: 05d7a50893e22a5c4bb3216ae3396c7c
    Timestamp: 1630468800
    Api-Key: bDqJFiq9
Request Body:
{
    "current":1,
    "size":15,
    "params":{
        "startTime": "2025-01-08 00:00:00",
        "endTime": "2025-01-09 00:00:00",
        "voiceGroupId": 12
    }
}
 
响应参数
参数 说明 类型
status 状态码,0成功,其他失败参见响应状态码说明 String
reason 失败原因说明 String
data 对象集合 JSONArray
total 总记录条数 Integer
size 每页显示数 Integer
current 当前页码 Integer
pages 总页码 Integer
records 数据集合 JSONArray
keyId 主键id Integer
callSessionId 会话id String
called 加密前的被叫 String
encryptCalled 加密后的被叫 String
calledInfo 被叫信息 String
caller 主叫 String
region 国家/地区 String
seatName 坐席名称 String
sipGroupName 坐席组名称 String
voiceGroupId 坐席组Id Integer
callDuration 通话时长(单位秒) Integer
callType 呼叫类型,1-群呼转坐席 Integer
hangupReason 挂机原因:0-呼出未接听,1-呼出被挂断,2-转接响铃挂断,3-转接成功挂断,4-呼叫失败,5-被叫运营商暂无服务,6-被叫不在服务区,7-被叫忙线,8-呼入未接听,9-呼入被挂断 Integer
hangupCode sip码 String
callStartTime 呼叫开始时间 DateTime
calledAnswerTime 被叫应答时间 DateTime
calledHangupTime 被叫挂机时间 DateTime
voiceUrl 录音url String
voiceUrlList 录音url数组 List<String>
createTime 创建时间 DateTime
updateTime 修改时间 DateTime
ccode 国家码 String
hangingDirection 挂断方向,0-客户挂断,1-坐席挂断,3-无 Integer
labelName 标签名称 String
labelNameList 标签名称转化数组 List<String>
remark 备注 String
callId 语音id String
brandId 品牌ID Integer
brandName 品牌名称 String
errorReason 错误描述 String
ringDuration 响铃时长 Integer
mediaDetected 媒体检测 String
 
响应示例
{
    "status": 0,
    "reason": "success",
    "data": {
        "total": 1,
        "size": 50,
        "current": 1,
        "searchCount": true,
        "pages": 1,
        "records": [
          {
                "keyId": 50180345,
                "callSessionId": "25010316113064799",
                "called": null,
                "encryptCalled": "8613242926514",
                "calledInfo": "{"被叫信息1":null,"被叫信息5":null,"被叫信息10":null,"被叫信息4":null,"被叫信息3":null,"被叫信息2":null,"被叫信息9":null,"被叫信息8":null,"被叫信息7":null,"被叫信息6":null}",
                "caller": "8613200000003",
                "region": null,
                "seatName": "为空看显示号码",
                "sipGroupName": "测试基础设置(话机)",
                "callDuration": 47,
                "callType": 3,
                "hangupReason": 1,
                "hangupCode": "1",
                "callStartTime": "2025-01-03 16:10:39",
                "calledAnswerTime": "2025-01-03 16:10:43",
                "calledHangupTime": "2025-01-03 16:11:30",
                "voiceUrl": "agent-call-record-250103/25010316113064799.wav",
                "voiceUrlList": [
                    "agent-call-record-250103/25010316113064799.wav"
                ],
                "createTime": "2025-01-03 16:11:30",
                "updateTime": "2025-01-03 16:11:30",
                "ccode": "86(China)",
                "hangingDirection": 1,
                "labelName": "[]",
                "labelNameList": [],
                "remark": "11111",
                "callId": "250103161038410100100",
                "brandId": 101,
                "brandName": "ITNIO",
                "errorReason": "sucess call(200)",
                "ringDuration": 4,
                "mediaDetected": null
            }
    ]
    }
}
 
响应状态码
status 状态说明
0 成功
-1 账号认证异常
-2 ip限制
-16 时间戳过期
-18 系统异常
-20 数据已存在
-22 参数异常
-23 数据上限
-76 搜索时间区间不能大于93天