查询指定座席详细信息
场景描述
查询指定座席详细信息。
请求方法
设置成“POST”。该接口仅支持POST方法,不支持PUT、GET和DELTE等方法。
内部封装接口
BMS接口:/ccbms/ws/monitor/siteagentinfobyagentids
请求URL
https://ip:port/rest/cmsapp/v1/openapi/agentgroup/agentbyworkno
其中,ip为NSLB的服务器IP地址,port为CC-CMS服务在NSLB映射的HTTPS端口号。
请求说明
|
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
|---|---|---|---|---|
|
1 |
Content-Type |
String |
True |
固定填 application/json; charset=UTF-8。 |
|
2 |
Authorization |
String |
True |
生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 |
- 消息头
- 消息体
{ "queryParam": { "ccId":1, "vdn":1, "agentId":101 } }
该接口的请求消息体参数说明请参见表2。
|
参数名 |
数据类型 |
是否必选 |
说明 |
|---|---|---|---|
|
ccId |
int |
True |
呼叫中心编号。 取值范围:1~65535 |
|
vdn |
int |
True |
虚拟呼叫中心编号。 取值范围:1~5000 |
|
agentId |
Int |
True |
座席工号。 取值范围:101-59999 |
响应消息
该接口的响应消息体举例如下:
{
"result": "0",
"resultDatas": {
"workno": 101,
"vdnid": 1,
"citStatus": 0,
"name": "HW35154101",
"phonenumber": null,
"logindate": 4294967295000,
"currentstatetime": 436879,
"mediatype": 0,
"status": 2
}
}
该接口的响应消息体参数说明请参见表3。
|
参数名 |
数据类型 |
说明 |
|---|---|---|
|
result |
string |
查询结果。取值如下:
失败的原因说明请参见错误码参考。 |
|
resultDatas |
object |
查询成功后,返回结果信息的对象。 该对象的参数说明请参见表4。 |
|
参数名 |
数据类型 |
说明 |
|---|---|---|
|
workno |
int |
座席工号。 |
|
vdnid |
int |
所属VDN ID。 |
|
citStatus |
Int |
座席平台状态,请参见CTI平台座席状态码参考。 |
|
name |
String |
座席名称。 |
|
phonenumber |
String |
座席电话号码。 |
|
logindate |
long |
签入时间。 |
|
currentstatetime |
long |
当前状态时长。 |
|
mediatype |
Int |
座席媒体类型,请参见表1 |
|
status |
Int |
座席状态。取值: 0:未知。对应CTT平台状态的9 2:签出状态。对应CTT平台状态的0 3:示忙状态。对应CTI平台状态的7 4:空闲状态。对应CTT平台状态的1 5:整理态。对应CTT平台状态的6 7:通话态。对应CTT平台状态的2、3、4、5 8:休息状态。对应CTT平台状态的8 |