查询技能队列下已签入座席的详细信息

场景描述

根据技能队列ID，返回该技能队列下已签入座席的详细信息。

超过10000座席时，性能会下降。

接口方法

设置成“POST”。该接口仅支持POST方法，不支持PUT、GET和DELTE等方法。

内部封装接口

BMS接口：/ccbms/ws/monitor/agentstatusinfo

请求URL

https://ip:port/rest/cmsapp/v1/openapi/skill/agentbyconfigedskill

其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

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

表2 消息体参数说明
序号	名称	参数类型	是否必选	说明
1	ccId	int	True	呼叫中心编号。取值范围：1～65535
2	vdn	int	True	虚拟呼叫中心编号。取值范围：1～5000
3	skillId	Int	True	技能队列编号。取值范围：1～5000

响应消息

表3 消息体参数说明
序号	名称	参数类型	说明
1	result	String	查询结果。取值如下： 0：成功其他：失败失败的原因说明请参见错误码参考。说明：当前字段为兼容8.12及其之前版本接口响应参数使用。
2	resultCode	string	查询结果。取值如下： "0100000"：成功其他：失败失败的原因说明请参见错误码参考。
3	resultDatas	array	查询成功后，返回结果信息的对象数组。该数组中对象的参数说明请参见表4。说明：当前字段为兼容8.12及其之前版本接口响应参数使用。
4	resultDesc	array	查询成功后，返回结果信息的对象数组。该数组中对象的参数说明请参见表4。

表4 resultDesc/resultDatas对象参数说明
序号	名称	参数类型	说明
2.1	workNo	int	座席工号。
2.2	name	string	座席名称。
2.3	status	int	座席状态，参数说明请参考表5。
2.4	ctiStatus	int	座席平台状态，参数说明请参考CTI平台座席状态码参考
2.5	groupId	int	座席班组ID。
2.6	mediaType	int	座席媒体类型，请参见表1
2.7	vdnId	int	所属VDN ID。
2.8	phoneNumber	string	座席电话号码。
2.9	currentStateTime	long	当前状态时长。(秒)
2.10	loginDate	long	签入时间。（毫秒级时间戳）

表5 座席状态
值	说明
0	未知。对应CTI平台状态的9。
2	表示调用该接口出现异常。
3	示忙状态。对应CTI平台状态的7。
4	空闲状态。对应CTI平台状态的1。
5	整理态。对应CTI平台状态的6。
7	通话态。对应CTI平台状态的2、3、4、5。
8	休息状态。对应CTI平台状态的8。

样例报文

请求头：

Content-Type: application/json;charset=UTF-8
Authorization: ******************

请求参数：

{
    "queryParam":
    {
        "ccId":1, 
        "vdn":1,
        "skillId":1
    }
}

请求参数：

{
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": [
        {
            "workNo": 20011,
            "name": "20011",
            "status": 4,
            "ctiStatus": 1,
            "groupId": 1,
            "mediaType": 1,
            "vdnId": 1,
            "phoneNumber": "70942",
            "currentStateTime": 1505,
            "loginDate": 1501125758000
        }
    ],
    "resultDesc": [
        {
            "workNo": 20011,
            "name": "20011",
            "status": 4,
            "ctiStatus": 1,
            "groupId": 1,
            "mediaType": 1,
            "vdnId": 1,
            "phoneNumber": "70942",
            "currentStateTime": 1505,
            "loginDate": 1501125758000
        }
    ]
}

父主题： 技能队列维度实时接口

上一篇：查询技能组下各种座席状态个数

下一篇：批量查询技能队列维度服务水平