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

场景描述

批量查询技能队列上签入的座席。

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

接口方法

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

内部封装接口

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

请求URL

https://ip:port/rest/cmsapp/v1/openapi/realindex/agent/agentsinskill

其中，公有云环境请联系管理员获取，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～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	skillId	int	技能队列编号。
2.2	agentIds	array	签入该技能的座席工号数组。

样例报文

请求头：

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

请求参数：

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

响应参数：

{
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": [
        {
            "skillId": 1,
            "agentIds": [
                291
            ]
        },
        {
            "skillId": 2,
            "agentIds": []
        }
    ],
    "resultDesc": [
        {
            "skillId": 1,
            "agentIds": [
                291
            ]
        },
        {
            "skillId": 2,
            "agentIds": []
        }
    ]
}

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

上一篇：技能队列维度实时接口

下一篇：批量查询技能队列扩展信息