查询呼叫信息
前置条件
- 座席已签入
场景描述
座席签入后，查询呼叫信息。
接口方法
置成“GET”。该接口仅支持GET方法，不支持PUT、POST和DELETE等方法。
接口URI
https://ip:port/agentgateway/resource/calldata/{agentid}/callinfo?isNoContainLastCall={isNoContainLastCall}
其中，ip为agentgateway服务器地址，port为agentgateway服务器的HTTPS端口号，{agentid}为座席工号。{isNoContainLastCall}表示当前座席无呼叫时，是否查询上一通呼叫信息（boolean型）。
序号 |
参数名 |
数据类型 |
选取原则 |
说明 |
|---|---|---|---|---|
1 |
agentid |
string |
True |
座席的工号，取值范围：101～59999。 |
2 |
isNoContainLastCall |
boolean |
False |
当前座席无呼叫时，是否查询上一通呼叫信息。取值范围：
|
日志中的方法名
queryCallInfo
请求说明
- 消息头
表2 请求头参数说明 序号
名称
参数类型
是否必选
说明
1
Content-Type
string
True
消息主体编码方式，缺省值：application/json; charset=UTF-8
2
Guid
string
True
静态鉴权（AUTHMODE = 1）签入接口返回的Guid；动态鉴权（AUTHMODE = 2）轮询事件接口返回的Guid。
响应说明
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
1 |
message |
string |
描述 |
2 |
retcode |
string |
错误码。取值如下： 0：成功 非0：失败 |
3 |
result |
object |
查询成功后，返回呼叫信息对象。 该对象的参数说明请参见表4。 |
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
3.1 |
callfeature |
int |
呼叫类型，请参考呼叫类型 |
3.2 |
callid |
string |
呼叫ID |
3.3 |
caller |
int |
主叫号码 |
3.4 |
called |
int |
被叫号码 |
3.5 |
callskill |
string |
呼叫技能描述 |
3.6 |
callskillid |
int |
呼叫技能ID |
3.7 |
orgicallednum |
string |
原始被叫 |
3.8 |
calldata |
string |
随路数据 |
3.9 |
begintime |
long |
应答开始时间，时间戳（毫秒） |
3.10 |
endtime |
long |
通话结束时间，时间戳（毫秒） |
3.11 |
userPriority |
int |
客户级别 |
3.12 |
trunkNo |
int |
中继号 |
3.13 |
logontimes |
int |
进入总时长（秒） |
3.14 |
mediaType |
int |
媒体类型。其中：
|
3.15 |
mediaAbility |
int |
媒体能力。其中：
|
3.16 |
waitTime |
long |
等待应答时间，时间戳（秒） |
3.17 |
trace |
HWCallDeviceTraceEx |
呼叫轨迹扩展属性，请参见表5 |
序号 |
名称 |
参数类型 |
说明 |
|---|---|---|---|
3.17.1 |
waitBeginTime |
long |
等待开始时间，时间戳（毫秒） |
3.17.2 |
waitEndTime |
long |
等待结束时间，时间戳（毫秒），不支持查上一通的呼叫信息 |
3.17.3 |
answerBeginTime |
long |
应答开始时间，时间戳（毫秒） |
3.17.4 |
answerEndTime |
long |
应答结束时间，时间戳（毫秒），不支持查上一通的呼叫信息 |
3.17.5 |
talkBeginTime |
long |
谈话开始时间，时间戳（毫秒） |
3.17.6 |
talkEndTime |
long |
谈话结束时间，时间戳（毫秒），不支持查上一通的呼叫信息 |
3.17.7 |
deviceNo |
int |
设备编号 |
3.17.8 |
deviceType |
int |
设备类型。取值如下
|
3.17.9 |
callDirectMode |
string |
此设备的处理方式，即离开设备的原因。取值如下
|
3.17.10 |
enterReason |
int |
进入此设备的原因，参见表6 |
3.17.11 |
enterReasonDesc |
string |
进入此设备的原因描述 |
3.17.12 |
leaveReason |
int |
离开此设备的原因，参见表6，不支持查上一通的呼叫信息 |
3.17.13 |
leaveReasonDesc |
string |
离开此设备的原因描述，不支持查上一通的呼叫信息 |
3.17.14 |
vdnId |
int |
VDN ID |
原因码 |
含义 |
|---|---|
0 |
普通接入/转移 |
1 |
溢出转 |
2 |
超时转 |
3 |
无人上班转 |
4 |
取消排队转移 |
5 |
座席久不应答转 |
6 |
挂起恢复 |
7 |
连接保持 |
8 |
三方求助 |
9 |
取保持 |
10 |
三方通话 |
11 |
内部求助，求助方释放 |
12 |
拦截 |
13 |
代答 |
14 |
呼叫的被叫分析未配置 |
15 |
用户主动释放 |
16 |
座席释放 |
17 |
转出 |
18 |
保持 |
19 |
内部处理错误 |
20 |
被叫忙 |
21 |
线路忙 |
22 |
手机关机 |
23 |
手机不在服务区 |
24 |
空号 |
25 |
排队机无资源 |
26 |
用户不应答 |
27 |
被叫拒绝 |
28 |
成功转队列 |
29 |
三方转队列 |
30 |
成功转队列超时 |
31 |
三方转队列超时 |
34 |
超时/溢出/遇忙网呼失败排队 |
35 |
网呼回原中心排队 |
36 |
排队的呼叫重路由 |
37 |
由呼入路由进入 CDN |
38 |
由座席咨询进入 CDN |
39 |
CDN 正常返回路由结果 |
40 |
CDN 路由超时 |
41 |
咨询时座席取消 |
42 |
由 CDN 路由超时进入 PGR |
43 |
由 CDN 正常返回路由进入 PGR |
44 |
由呼入路由进入 PGR |
45 |
由坐席咨询进入 PGR |
46 |
坐席不可达，CDN 重路由 |
47 |
呼叫在多个队列排队 |
48 |
在从队列中接听主队列呼叫 |
50 |
座席拒绝呼叫 |
51 |
用户呼叫进入电话会议 |
52 |
会议主席主动释放会议，或 CSS 异常导致会议释放 |
53 |
与会者被请出会议 |
54 |
接通率低于阀值转接 |
88 |
座席接通后，用户挂机 |
89 |
座席应答后，用户挂机 |
触发事件
- 无
错误结果码
- 100-006
报文样例
- 消息头
Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
- 请求参数
- 响应参数
{ "message": "", "retcode": "0", "result": { "callfeature": 0, "callid": "1476838963-224", "caller": "70004", "called": "60015", "callskill": "voice", "callskillid": 20011, "orgicallednum": "", "calldata": "", "begintime": 1476838963000, "endtime": null, "userPriority": 0, "trunkNo": 65535, "logontimes": 0, "mediaType": 5, "mediaAbility": 1, "waitTime": 0, "trace": { "waitBeginTime": 1626179227000, "waitEndTime": 1626179227000, "answerBeginTime": 1626179227000, "answerEndTime": 1626179227000, "talkBeginTime": 1626179227000, "talkEndTime": 1626179227000, "deviceNo": 2005, "deviceType": 2, "callDirectMode": "NORMAL_DIRECT", "enterReason": 0, "enterReasonDesc": "Normal reason", "leaveReason": 0, "leaveReasonDesc": "Normal reason", "vdnId": 214 } } }
