查询呼叫历史记录 (queryCallDetailRecord)
场景描述
查询历史记录。
接口方法
POST
接口URI
https://域名/apiaccess/CC-Management/v1/mobileAgent/queryCallDetailRecord,例如域名是service.besclouds.com
请求说明
| 
        序号  | 
      
        名称  | 
      
        参数类型  | 
      
        是否必选  | 
      
        说明  | 
     
|---|---|---|---|---|
| 
        1  | 
      
        X-APP-Key  | 
      
        string  | 
      
        False  | 
      
        appKey字段,用户标识  | 
     
| 
        2  | 
      
        Authorization  | 
      
        string  | 
      
        True  | 
      
        鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)  | 
     
| 
        序号  | 
      
        名称  | 
      
        参数类型  | 
      
        是否必选  | 
      
        说明  | 
     
|---|---|---|---|---|
| 
        1  | 
      
        body  | 
      
        False  | 
      
        请求体参数  | 
     
| 
        序号  | 
      
        名称  | 
      
        参数类型  | 
      
        是否必选  | 
      
        说明  | 
     
|---|---|---|---|---|
| 
        1  | 
      
        body  | 
      
        object  | 
      
        False  | 
      
        请求体  | 
     
| 
        1.1  | 
      
        endTime  | 
      
        string  | 
      
        True  | 
      
        结束时间,开始时间到结束时间不超过7天,时间戳,如1572794607000  | 
     
| 
        1.2  | 
      
        offset  | 
      
        string  | 
      
        False  | 
      
        分页查询偏移量,默认值0,即不需要偏移 ,非必选  | 
     
| 
        1.3  | 
      
        limit  | 
      
        string  | 
      
        False  | 
      
        分页查询时单页最多的记录条数,默认值100,即每页显示100条,非必选  | 
     
| 
        1.4  | 
      
        startTime  | 
      
        string  | 
      
        True  | 
      
        起始时间,时间戳,如1572794607000  | 
     
| 
        1.5  | 
      
        caller  | 
      
        string  | 
      
        False  | 
      
        主叫号码,可选,不填写默认查询所有 长度限制:string (32)  | 
     
| 
        1.6  | 
      
        taskType  | 
      
        string  | 
      
        False  | 
      
        0:全部类型任务(除ITA双呼) 1:云客服双呼任务 2:查询匿名外呼任务 3:语音通知 4:ITA双呼  | 
     
响应说明
- 响应状态码: 200
 
| 
        序号  | 
      
        名称  | 
      
        参数类型  | 
      
        是否必选  | 
      
        说明  | 
     
|---|---|---|---|---|
| 
        1.1  | 
      
        retCode  | 
      
        string  | 
      
        True  | 
      
        返回码。0表示成功,其他为失败。 1:未查询到数据 2:起止时间格式不符 4:limit或offset分页数据格式不符 12:主叫号码不可用  | 
     
| 
        1.2  | 
      
        retMsg  | 
      
        string  | 
      
        True  | 
      
        失败原因的描述  | 
     
| 
        1.3  | 
      
        result  | 
      
        object  | 
      
        False  | 
      
        返回结果  | 
     
| 
        1.3.1  | 
      
        total  | 
      
        number  | 
      
        False  | 
      
        总记录数  | 
     
| 
        1.3.2  | 
      
        callInfo  | 
      
        array[object]  | 
      
        False  | 
      
        记录列表  | 
     
| 
        1.3.2.1  | 
      
        callSerialNo  | 
      
        string  | 
      
        False  | 
      
        呼叫流水号  | 
     
| 
        1.3.2.2  | 
      
        caller  | 
      
        string  | 
      
        False  | 
      
        主叫号码 长度限制:string (32)  | 
     
| 
        1.3.2.3  | 
      
        called  | 
      
        string  | 
      
        False  | 
      
        被叫号码 长度限制:string (32)  | 
     
| 
        1.3.2.4  | 
      
        startTime  | 
      
        string  | 
      
        False  | 
      
        外呼开始时间,时间戳,如1572794607000  | 
     
| 
        1.3.2.5  | 
      
        endTime  | 
      
        string  | 
      
        False  | 
      
        通话结束时间,时间戳,如1572794607000  | 
     
| 
        1.3.2.6  | 
      
        state  | 
      
        number  | 
      
        False  | 
      
        呼叫状态: 0:待呼叫 1:正在呼叫 2:通话中 3:通话结束 长度限制:number(1)  | 
     
| 
        1.3.2.7  | 
      
        reasonCode  | 
      
        number  | 
      
        False  | 
      
        通话结束原因码: 0~65535, 0: 被叫挂机,通话结束 1:主叫挂机,通话结束 2:外呼主叫失败 3:外呼被叫失败 4:外呼主叫无应答 5:外呼被叫无应答 6:启动呼叫失败 xxx:其他异常 长度限制:number(5) 针对ITA双呼还有一些reasonCode,请参见表5  | 
     
| 
        1.3.2.8  | 
      
        callData  | 
      
        string  | 
      
        False  | 
      
        第三方自定义的呼叫数据信息 长度限制:string(1024)  | 
     
| 
        1.3.2.9  | 
      
        callerPresent  | 
      
        string  | 
      
        False  | 
      
        外显号码,来电显示的号码 长度限制:string(32)  | 
     
| 
        1.3.2.10  | 
      
        alertingTime  | 
      
        string  | 
      
        False  | 
      
        客户振铃时间,时间戳,如1572794607000  | 
     
| 
        1.3.2.11  | 
      
        talkingTime  | 
      
        string  | 
      
        False  | 
      
        客户通话时间,时间戳,如1572794607000  | 
     
| 
        1.3.2.12  | 
      
        releaseTime  | 
      
        string  | 
      
        False  | 
      
        客户释放时间,时间戳,如1572794607000  | 
     
| 
        1.3.2.13  | 
      
        talkDuration  | 
      
        string  | 
      
        False  | 
      
        用户通话时长(秒)  | 
     
| 
        1.3.2.14  | 
      
        agentAlertingTime  | 
      
        string  | 
      
        False  | 
      
        座席振铃时间,时间戳,如1572794607000  | 
     
| 
        1.3.2.15  | 
      
        agentTalkingTime  | 
      
        string  | 
      
        False  | 
      
        座席通话时间,时间戳,如1572794607000  | 
     
| 
        1.3.2.16  | 
      
        agentReleaseTime  | 
      
        string  | 
      
        False  | 
      
        座席释放时间,时间戳,如1572794607000  | 
     
| 
        1.3.2.17  | 
      
        agentTalkDuration  | 
      
        string  | 
      
        False  | 
      
        座席通话时长(秒)  | 
     
| 
        1.3.2.18  | 
      
        taskType  | 
      
        string  | 
      
        False  | 
      
        0:全部类型任务(除ITA双呼) 1:云客服双呼任务 2:查询匿名外呼任务 3:语音通知 4:ITA双呼  | 
     
| 
        1.3.2.19  | 
      
        agentPresent  | 
      
        string  | 
      
        False  | 
      
        外显号码,客户经理来电显示的号码 长度限制:string(32)  | 
     
| 
        retCode  | 
      
        原因值描述  | 
     
|---|---|
| 
        0  | 
      
        不涉及  | 
     
| 
        1  | 
      
        无法找到号码  | 
     
| 
        2  | 
      
        无法路由到网络  | 
     
| 
        3  | 
      
        无法路由到目的地  | 
     
| 
        4  | 
      
        发送特殊消息  | 
     
| 
        5  | 
      
        中继前缀出错  | 
     
| 
        6  | 
      
        通道无法接入  | 
     
| 
        7  | 
      
        已经建立频道  | 
     
| 
        8  | 
      
        抢先占有  | 
     
| 
        9  | 
      
        抢先占有保留  | 
     
| 
        16  | 
      
        正常呼叫清除  | 
     
| 
        17  | 
      
        用户忙  | 
     
| 
        18  | 
      
        无应答  | 
     
| 
        19  | 
      
        无用户应答  | 
     
| 
        20  | 
      
        用户不可及  | 
     
| 
        21  | 
      
        拒绝呼叫  | 
     
| 
        22  | 
      
        号码已改变  | 
     
| 
        23  | 
      
        重定向  | 
     
| 
        25  | 
      
        交换路由错误  | 
     
| 
        26  | 
      
        无用户准许  | 
     
| 
        27  | 
      
        目标无序  | 
     
| 
        28  | 
      
        非法号码格式  | 
     
| 
        29  | 
      
        设备拒绝  | 
     
| 
        30  | 
      
        状态查询  | 
     
| 
        31  | 
      
        正常  | 
     
| 
        34  | 
      
        路由不可达  | 
     
| 
        38  | 
      
        网络状态不好  | 
     
| 
        39  | 
      
        服务链接不上  | 
     
| 
        40  | 
      
        链接进行中  | 
     
| 
        41  | 
      
        暂时失败  | 
     
| 
        42  | 
      
        设备拥塞  | 
     
| 
        43  | 
      
        信息丢弃  | 
     
| 
        44  | 
      
        通道无法接入  | 
     
| 
        46  | 
      
        呼叫阻塞  | 
     
| 
        47  | 
      
        无可用资源  | 
     
| 
        49  | 
      
        品质无效  | 
     
| 
        50  | 
      
        设备没预订  | 
     
| 
        53  | 
      
        闭合群OCB呼出受限  | 
     
| 
        55  | 
      
        闭合群ICB呼入受限  | 
     
| 
        57  | 
      
        无权限发送  | 
     
| 
        58  | 
      
        发送无效  | 
     
| 
        62  | 
      
        等级不一致  | 
     
| 
        63  | 
      
        服务无效  | 
     
| 
        65  | 
      
        发送无法执行  | 
     
| 
        66  | 
      
        通道无法执行  | 
     
| 
        69  | 
      
        设备无效  | 
     
| 
        70  | 
      
        发送有效  | 
     
| 
        79  | 
      
        CV服务没设置  | 
     
| 
        81  | 
      
        引用非法值  | 
     
| 
        82  | 
      
        通道不存在  | 
     
| 
        83  | 
      
        ID不存在  | 
     
| 
        84  | 
      
        呼叫ID不存在  | 
     
| 
        85  | 
      
        无呼叫等待  | 
     
| 
        86  | 
      
        隐藏号码呼叫  | 
     
| 
        87  | 
      
        CUG无成员  | 
     
| 
        88  | 
      
        目标冲突  | 
     
| 
        90  | 
      
        CUG不存在  | 
     
| 
        91  | 
      
        无效网络  | 
     
| 
        95  | 
      
        无效信息  | 
     
| 
        96  | 
      
        非托管元素  | 
     
| 
        97  | 
      
        类型不存在  | 
     
| 
        98  | 
      
        信息没执行  | 
     
| 
        99  | 
      
        信息单元不存在  | 
     
| 
        100  | 
      
        无效的信息单元  | 
     
| 
        101  | 
      
        呼叫状态不一致  | 
     
| 
        102  | 
      
        定时器超时  | 
     
| 
        103  | 
      
        参数不存在  | 
     
| 
        110  | 
      
        消息中带有未识别的参数  | 
     
| 
        111  | 
      
        协议错误  | 
     
| 
        127  | 
      
        未指定的交互  | 
     
- 响应状态码: 400
    
错误的请求:请检查请求路径及参数。
 - 响应状态码: 401
    
未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
 - 响应状态码: 404
    
请求的内容未找到:请检查请求的路径。
 - 响应状态码: 500
    
业务失败:请依次确认您请求中各参数的取值。
 
报文样例
请求头:
x-app-key:9******************************3 Authorization:Bearer e******************************e Content-Type:application/json
请求参数:
{
	"startTime": "1562786332000",
	"endTime": "1563391072000",
	"taskType": "0",
	"offset": "0",
	"limit": "10"
}
  响应头:
{
	"connection": "keep-alive",
	"content-type": "application/json;charset=UTF-8"
}
  响应参数:
{
	"result": {
		"total": 11,
		"callInfo": [{
			"releaseTime": 1621577022000,
			"called": "88889060",
			"callerPresent": "640003",
			"agentAlertingTime": 1621576992000,
			"agentPresent": "640060",
			"talkingTime": 1621576995000,
			"alertingTime": 1621576994000,
			"caller": "88889050",
			"agentTalkingTime": 1621576994000,
			"agentReleaseTime": 1621577022000,
			"agentTalkDuration": 27,
			"callSerialNo": "1037058396471308289",
			"startTime": 1621576992000,
			"endTime": 1621577022000,
			"talkDuration": 26,
			"state": 3,
			"reasonCode": 1
		}]
	},
	"retCode": "0",
	"retMsg": "Query call detail record successfully"
}