文档首页/ 云客服/ API参考/ 监控类接口参考/ 接口说明/ 实时数据查询类接口/ 技能队列维度实时接口/ 批量查询技能队列上的所有排队的呼叫
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

批量查询技能队列上的所有排队的呼叫

场景描述

批量查询技能队列上的所有排队的呼叫。（该接口不支持查询多媒体排队信息，该接口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 监控/系统外呼/话单/知识库类接口鉴权方式。
表2 请求消息体参数说明

序号

名称

参数类型

是否必选

说明

1

ccId

int

True

呼叫中心编号。

取值范围：1～65535。

2

vdn

int

True

虚拟呼叫中心编号。

取值范围：1～5000。

3

skillIds

array

True

技能队列ID信息的对象数组。

数组长度不大于1000。

取值范围：1～5000。

响应消息

表3 响应消息体参数说明

序号

名称

参数类型

说明

1

result

String

查询结果。取值如下：

  • 0：成功
  • 其他：失败

失败的原因说明请参见错误码参考。

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

2

resultCode

string

查询结果。取值如下：

  • "0100000"：成功
  • 其他：失败
  • 失败的原因说明请参见错误码参考。

3

resultDatas

array

查询成功后，返回结果信息的对象数组。

该数组中对象的参数说明请参见表4。

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

2

resultDesc

array

查询成功后，返回结果信息的对象数组。

该数组中对象的参数说明请参见表4。
表4 resultDesc/resultDatas对象参数说明

序号

名称

参数类型

说明

2.1

skillId

int

技能队列编号

2.2

callPropertyExs

array

在该技能上排队的呼叫数组。

该数组中对象的参数说明请参见表5。
表5 callPropertyExs对象参数说明

序号

名称

参数类型

说明

2.2.1

callId

string

呼叫ID

2.2.2

customerLevel

int

呼叫客户级别

序号从1到254，编号越大，表明客户的地位越高，越重要

2.2.3

requestType

int

呼叫特征，具体请参考表1。

2.2.4

calling

array

主叫号码。

2.2.5

called

array

被叫号码。

2.2.6

mediaType

string

呼叫的媒体类型，不支持多媒体类型呼叫查询，参考表1

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": "1607392439000-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": "1607392439000-379",
                    "customerLevel": 0,
                    "calling": "1233",
                    "called": "34565",
                    "mediaType": "MEDIA_TYPE_PHONE",
                    "orgiCalled": "234545",
                    "callInTime": 1223455666
                }
            ]
        }
    ]
}

相关文档