批量查询技能队列扩展信息

场景描述

批量查询技能队列扩展信息。（该接口CTI3.6版本不支持）

接口方法

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

内部封装接口

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

请求URL

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

其中，公有云环境请联系管理员获取，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	skillIds	array	True	技能队列ID信息的对象数组。数组长度不大于1000。技能队列ID取值范围：1～2000。

响应消息

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

表4 resultDesc/resultDatas对象参数说明
序号	名称	参数类型	说明
2.1	skillId	int	技能队列编号
2.2	queueSize	int	当前等待在队列中的呼叫数目
2.3	queueTime	long	队列中等待最久的呼叫的等待时间，单位为秒
2.4	loggedOnAgents	int	当前签入该技能的座席数量
2.5	availAgents	int	该技能队列中当前可用的座席数目
2.6	skillDescrip	string	技能描述
2.7	callId	string	等待最久的呼叫ID
2.8	maxQueueSize	int	队列最大可排多少呼叫如何配置请参见《(For Engineer) ICD VxxxRxxxCxx 产品文档 01 (ICD)》的配置排队处理/接通率参数

样例报文

请求头：

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

请求参数：

{
    "ccId":1, 
    "vdn":170,
    "skillIds":[1,2]
}

响应参数：

{
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": [
        {
            "skillId": 1,
            "queueSize": 0,
            "loggedOnAgents": 0,
            "queueTime": 0,
            "availAgents": 0,
            "skillDescrip": "defaultVedioSkill",
            "callId": "4294967295-4294967295",
            "maxQueueSize": 100
        },
        {
            "skillId": 2,
            "queueSize": 0,
            "loggedOnAgents": 1,
            "queueTime": 0,
            "availAgents": 0,
            "skillDescrip": "defaultAudioSkill",
            "callId": "4294967295-4294967295",
            "maxQueueSize": 100
        }
    ],
    "resultDesc": [
        {
            "skillId": 1,
            "queueSize": 0,
            "loggedOnAgents": 0,
            "queueTime": 0,
            "availAgents": 0,
            "skillDescrip": "defaultVedioSkill",
            "callId": "4294967295-4294967295",
            "maxQueueSize": 100
        },
        {
            "skillId": 2,
            "queueSize": 0,
            "loggedOnAgents": 1,
            "queueTime": 0,
            "availAgents": 0,
            "skillDescrip": "defaultAudioSkill",
            "callId": "4294967295-4294967295",
            "maxQueueSize": 100
        }
    ]
}

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

上一篇：批量查询技能队列上签入的座席

下一篇：批量查询技能队列当前五分钟的呼叫统计信息