# 批量查询技能队列上的所有排队的呼叫 #### 场景描述 批量查询技能队列上的所有排队的呼叫。（该接口不支持查询多媒体排队信息，该接口CTI3.6版本不支持） #### 接口方法 设置成"POST"。该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。 #### 内部封装接口 BMS接口： - /ccbms/ws/monitor/querybatchmultiskillqueue - /ccbms/ws/monitor/skillcallqueueinfos #### 请求URL https://ip:port/rest/cmsapp/v1/openapi/skill/batchmultiskill 其中，公有云环境请联系管理员获取，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 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 | 表2请求消息体参数说明 | 序号 | 名称 | 参数类型 | 是否必选 | 说明 | |:---|:---|:---|:---|:---| | 1 | ccId | int | True | 呼叫中心编号。 取值范围：1～65535。 | | 2 | vdn | int | True | 虚拟呼叫中心编号。 取值范围：1～5000。 | | 3 | skillIds | array | True | 技能队列ID信息的对象数组。 数组长度不大于1000。 技能队列ID取值范围：1～10000。 | #### 响应消息 表3响应消息体参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 1 | result | String | 查询结果。取值如下： - 0：成功 - 其他：失败 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 | | 2 | resultCode | string | 查询结果。取值如下： - "0100000"：成功 - 其他：失败 - 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 | | 3 | resultDatas | array | 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见[表4]。 说明： 当前字段为兼容8.13及其之前版本接口响应参数使用。 | | 2 | resultDesc | array | 查询成功后，返回结果信息的对象数组。 该数组中对象的参数说明请参见[表4]。 | 表4resultDesc/resultDatas对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 2.1 | skillId | int | 技能队列编号，取值范围：1～10000。 | | 2.2 | callPropertyExs | array | 在该技能上排队的呼叫数组。 该数组中对象的参数说明请参见[表5]。 | 表5callPropertyExs对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 2.2.1 | callId | string | 呼叫ID | | 2.2.2 | customerLevel | int | 呼叫客户级别 序号从1到254，编号越大，表明客户的地位越高，越重要 | | 2.2.3 | requestType | int | 呼叫特征，具体请参考[表1](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0702.html#ZH-CN_TOPIC_0000002513233717__zh-cn_topic_0000002510109745_zh-cn_topic_0000001190798704_table1635204145620)。 | | 2.2.4 | calling | array | 主叫号码。 | | 2.2.5 | called | array | 被叫号码。 | | 2.2.6 | mediaType | string | 呼叫的媒体类型，不支持多媒体类型呼叫查询，参考[表1](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0698.html#ZH-CN_TOPIC_0000002513233715__zh-cn_topic_0000002510109741_zh-cn_topic_0000001843009401_zh-cn_topic_0000001451970565_zh-cn_topic_0240433933_table13565990) | | 2.2.7 | orgiCalled | string | 原始被叫。 呼叫在进入系统前被叫发生变化，则该参数记录的是首次被呼叫方的号码。 | | 2.2.8 | callInTime | int | 进入时间。（毫秒级时间戳） | | 2.2.9 | callPriority | long | 呼叫优先级（参见《(For Engineer) ICD VxxxRxxxCxx 产品文档 01 (ICD)》**配置技能组**） | | 2.2.10 | waitTime | long | 呼叫在本队列排队时长 | | 2.2.11 | callQueueFlag | long | 本队列是否为该呼叫的主队列。 - 1：表示是主队列 - 0：表示不是主队列 | #### 样例报文 - 请求头： ``` Content-Type: application/json;charset=UTF-8 Authorization: ****************** ``` - 请求参数： ``` { "ccId":1, "vdn":170, "skillIds":[1,2] } ``` - 响应参数： ``` { "result": "0", "resultCode": "0100000", "resultDatas": [ { "skillId": 1, "callPropertyExs": [] }, { "skillId": 2, "callPropertyExs": [ { "requestType": 0, "callPriority": 0, "waitTime": 0, "callQueueFlag": 1, "callId": "1607392439-379", "customerLevel": 0, "calling": "1233", "called": "34565", "mediaType": "MEDIA_TYPE_PHONE", "orgiCalled": "234545", "callInTime": 1223455666 } ] } ], "resultDesc": [ { "skillId": 1, "callPropertyExs": [] }, { "skillId": 2, "callPropertyExs": [ { "requestType": 0, "callPriority": 0, "waitTime": 0, "callQueueFlag": 1, "callId": "1607392439-379", "customerLevel": 0, "calling": "1233", "called": "34565", "mediaType": "MEDIA_TYPE_PHONE", "orgiCalled": "234545", "callInTime": 1223455666 } ] } ] } ```