查询指定座席详细信息

场景描述

查询指定座席详细信息。

请求方法

设置成“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 请求头参数
序号	名称	参数类型	是否必选	说明
1	Content-Type	String	True	固定填 application/json; charset=UTF-8。
2	Authorization	String	True	生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。

消息头
 Content-Type:application/json; charset=UTF-8

消息体

该接口的请求消息体举例如下：

{
    "queryParam":
    {
        "ccId":1, 
        "vdn":1,
        "agentId":101
    }
}

该接口的请求消息体参数说明请参见表2。

表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。

表3 消息体参数说明
参数名	数据类型	说明
result	string	查询结果。取值如下： 0：成功非0：失败失败的原因说明请参见错误码参考。
resultDatas	object	查询成功后，返回结果信息的对象。该对象的参数说明请参见表4。

表4 resultDatas对象参数说明
参数名	数据类型	说明
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