文档首页/ 云客服/ API参考/ 座席工作台/ 座席双呼/ 查询呼叫历史记录 (queryCallDetailRecord)
更新时间:2023-09-27 GMT+08:00

查询呼叫历史记录 (queryCallDetailRecord)

场景描述

查询历史记录。

接口方法

POST

接口URI

https://域名/apiaccess/CC-Management/v1/mobileAgent/queryCallDetailRecord,例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-Key

string

False

appKey字段,用户标识

2

Authorization

string

True

鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

body

body

False

请求体参数

表3 body参数结构

序号

名称

参数类型

是否必选

说明

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
表4 响应体参数

序号

名称

参数类型

是否必选

说明

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)

表5 针对ITA双呼的reasonCode说明

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"
    }