查询签入技能队列所有在线座席详细信息
前置条件
- 座席已签入
场景描述
座席签入后,查询签入技能队列所有在线座席详细信息。
接口方法
设置成“GET”。该接口仅支持GET方法,不支持PUT、POST和DELETE等方法。
接口URI
https://ip:port/agentgateway/resource/agentgroup/{agentid}/allonlineagents
其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。
序号 |
参数名 |
数据类型 |
选取原则 |
说明 |
---|---|---|---|---|
1 |
agentid |
string |
True |
座席的工号,取值范围:101~59999。 |
日志中的方法名
queryAllOnlineAgents
请求说明
- 消息头
表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 |
skillMediaType |
int |
技能队列媒体类型。其中:
|
3.2 |
skillId |
int |
技能队列id |
3.3 |
agent |
list |
座席详细信息 该对象的参数说明请参见表5。 |
序号 |
名称 |
参数类型 |
说明 |
---|---|---|---|
3.3.1 |
workno |
string |
座席工号 |
3.3.2 |
name |
string |
座席名称 |
3.3.3 |
status |
int |
座席状态,参见表1 |
3.34 |
ctiStatus |
int |
座席平台状态,请参考表2 |
3.3.5 |
groupid |
int |
座席班组ID |
3.3.6 |
groupname |
string |
未使用该返回参数 |
3.3.7 |
skilllist |
list |
未使用该返回参数 |
3.3.8 |
callids |
list |
未使用该返回参数 |
3.3.9 |
mediatype |
string |
签入媒体服务器是否成功,T表示成功,F表示失败,三位分别表示CTIServer、WebM、MailM。只有签入CTIServer成功,才能进行音视频呼叫业务处理;只有签入WebM成功,才能进行文字交谈业务处理;当前不支持签入MailM。 |
3.3.10 |
vdnid |
int |
所属VDN ID |
3.3.11 |
phonenumber |
string |
座席电话号码 |
3.3.12 |
currentstatetime |
long |
当前状态时长(秒) |
3.3.13 |
logindate |
long |
签入时间,时间戳(毫秒) |
3.3.14 |
inMultimediaConf |
int |
未使用该返回参数 |
3.3.15 |
currentStateReason |
int |
当前状态原因码 |
触发事件
- 无
错误结果码
- 100-006
- 100-007
- 600-005
报文样例
- 消息头
Content-Type:application/json; charset=UTF-8 Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
- 请求参数
无
- 响应参数
{ "result": [ { "skillId": 1, "agent": [ { "workno": "2005", "name": "liukai011", "status": "4", "ctiStatus": "1", "groupid": 0, "groupname": null, "skilllist": [], "mediatype": "TFF", "vdnid": 214, "phonenumber": "88880026", "currentstatetime": 527, "logindate": 1616510142000, "callids": [], "inMultimediaConf": 0, "currentStateReason": 0 }, { "workno": "2007", "name": "", "status": "4", "ctiStatus": "1", "groupid": 0, "groupname": null, "skilllist": [], "mediatype": "TTF", "vdnid": 214, "phonenumber": "88880027", "currentstatetime": 28, "logindate": 1616510634000, "callids": [], "inMultimediaConf": 0, "currentStateReason": 0 } ], "skillMediaType": 5 }, { "skillId": 2, "agent": [ { "workno": "2007", "name": "", "status": "4", "ctiStatus": "1", "groupid": 0, "groupname": null, "skilllist": [], "mediatype": "TTF", "vdnid": 214, "phonenumber": "88880027", "currentstatetime": 28, "logindate": 1616510634000, "callids": [], "inMultimediaConf": 0, "currentStateReason": 0 } ], "skillMediaType": 53 } ], "message": "success", "retcode": "0" }