查询指定技能队列排队等待呼叫信息
查询指定技能队列排队等待呼叫信息
前置条件
- 座席已签入
- 座席非空闲态,用户拨打接入码处于排队状态
场景描述
座席签入后,查询指定公有技能队列的所有排队等待呼叫信息。
接口方法
设置成“GET”。该接口仅支持GET方法,不支持PUT、POST和DELETE等方法。
接口URI
https://ip:port/agentgateway/resource/calldata/{agentid}/waitcallinfo/{skillid}
其中,ip为agentgateway服务器地址,port为agentgateway服务器的HTTPS端口号。
序号 |
参数名 |
数据类型 |
选取原则 |
说明 |
---|---|---|---|---|
1 |
agentid |
string |
True |
座席的工号,取值范围:101~59999。 |
2 |
skillid |
int |
True |
被查询技能队列ID。 |
日志中的方法名
queryWaitCallInfoBySkillId
请求说明
-
表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 |
list |
查询成功后,返回排队等待呼叫信息对象列表。 该对象的参数说明请参考表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 |
呼叫轨迹扩展属性,预留字段,默认为空。 |
触发事件
- 无
报文样例
- 消息头
Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
- 请求参数
- 响应参数
{ "message": "", "retcode": "0", "result": [ { "callfeature": 0, "callid": "1476707884-279", "caller": "70004", "called": "60015", "callskill": "voice", "callskillid": 1, "orgicallednum": "", "calldata": "", "begintime": 1476707884000, "endtime": null, "userPriority": 0, "mediaType": 5, "mediaAbility": 1, "waitTime": 0, "trace": null }, { "callfeature": 0, "callid": "1476707885-280", "caller": "70003", "called": "60015", "callskill": "voice", "callskillid": 1, "orgicallednum": "", "calldata": "", "begintime": 1476707885000, "endtime": null, "userPriority": 0, "trunkNo": 65535, "logontimes": 0, "mediaType": 5, "mediaAbility": 1, "waitTime": 0, "trace": null } ] }