文档首页/ 云客服/ API参考/ CC-Gateway 配置接口参考/ VDN配置接口说明/ 技能队列/ 查询

更新时间：2025-12-01 GMT+08:00

查看PDF

查询

场景描述

调用该接口查询技能队列。

接口方法

该接口仅支持GET方法，不支持POST、PUT、DELETE等方法。

接口URI

https://ip:port/agentgateway/resource/config/vdn/skill?skillIds=5,6,7

其中，ip为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号。

该接口的接口URI参数说明如表1所示。

表1 URI参数说明
序号	名称	参数类型	是否必选	说明
1	skillIds	string	False	需要查询的技能队列编号，取值类型为整数，取值范围为1～5000。为空时，表示查询所有数据。如果一次查询多个技能队列则技能队列ID之间以“,”分隔，最多一次可支持查询500个字符。

日志中的方法名

querySkillQueue

请求消息

消息头

表2 消息头参数说明
序号	名称	参数类型	是否必选	说明
1	Content-Type	string	True	消息主体编码方式，缺省值：application/json; charset=UTF-8
2	Guid	string	True	Guid的取值为C5 智能辅助类接口鉴权方式接口返回的guid。

响应消息

表3 消息体参数说明
序号	名称	参数类型	说明
1	message	string	描述
2	retcode	number	操作的结果原因码。取值类型为整数。 0：成功非0：失败，具体见“错误码定义”章节
3	result	array	查询座席结果信息的对象数组。单个result数组元素定义如表4所示。

表4 result对象参数说明
序号	名称	参数类型	说明
3.1	skillId	number	技能队列ID
3.2	Data	object	参考表5

表5 Data消息体参数说明
序号	名称	参数类型	是否必选	说明
3.2.1	name	string	True	技能队列的名称。
3.2.2	mediaTypeId	number	True	媒体类型。 1：文字交谈 2：点击通话 4：回呼请求 5：普通语音电话 15：预测呼出 16：预浏览呼出 17：消息呼叫 53：Social Chat 55：H5 Video
3.2.3	skillParameter	object	False	技能参数对象。该对象参数说明请参见表6
3.2.4	serviceId	number	True	外呼任务的标识。
3.2.5	description	string	False	技能队列描述。最大长度：255。

表6 技能参数对象参数说明
序号	名称	参数类型	是否必选	说明
3.2.3.1	maxAgentWrapupTime	number	False	座席最大整理态时长。取值范围为0～3600。默认值为0。
3.2.3.2	calcOfMaxCallNum	number	False	最大呼叫排队数目计算方法。 0：固定值 1：按签入座席比例默认值为0。
3.2.3.3	maxCallNum	number	False	最大呼叫排队数目或比例系数。取值范围为0～10000。默认值为100。
3.2.3.4	maxWaitTime	number	False	最大排队等待时长。取值范围为1～60000。默认值为60。
3.2.3.5	restNum	array	True	休息人数。数组长度为48，数组对应一天24小时的时段，每半个小时为一个时间段。取值范围为0～255。默认值为225。
3.2.3.6	supportVideo	number	False	支持视频。 0：否 1：是默认值为0。
3.2.3.7	busyRate	number	False	遇忙、排队溢出转接队列占用率。取值范围为0～100。默认值为100。
3.2.3.8	noAgentsRate	number	False	无人上班转接设备。该对象的参数说明请参见表7。
3.2.3.9	busyTransferDevice	object	False	遇忙、排队溢出转接设备。转接参数的设备类型只能是技能队列、业务代表、IVR。该对象的参数说明请参见表7。
3.2.3.10	noAgentsTransferDevice	object	False	无人上班转接设备。该对象的参数说明请参见表7。
3.2.3.11	timeOutRate	number	False	排队超时转接队列占用率。取值范围为0～100。默认值为100。
3.2.3.12	cancelRate	number	False	取消排队转接队列占用率。取值范围为0～100。默认值为100。
3.2.3.13	timeOutTransferDevice	object	False	排队超时转接设备。该对象的参数说明请参见表7。
3.2.3.14	cancelTransferDevice	object	False	取消排队转接设备。该对象的参数说明请参见表7。
3.2.3.15	conditionOfBusyTransfer	number	False	忙转条件。 0：设备占用率 1：等待时长默认值为0。
3.2.3.16	valueOfCondition	number	False	设备占有率或等待时长。忙转条件为设备占用率时，代表设备占用率：取值范围为0～100。默认值为100。忙转条件为等待时长时，代表等待时长：取值范围为0～9999。默认值为0。
3.2.3.17	waitVoice	object	False	排队等待。该对象的参数说明请参见表8
3.2.3.18	keepVoice	object	False	呼叫保持等待音。该对象的参数说明请参见表8
3.2.3.19	workNoBeforeVoice	object	False	报工号前播放的语音。该对象的参数说明请参见表8
3.2.3.20	workNoAfterVoice	object	False	报工号后播放的语音。该对象的参数说明请参见表8
3.2.3.21	maxTalkTime	number	False	最大通话时长，单位为秒。取值范围为1～86400。默认值为86400。
3.2.3.22	waitCallInsertMode	number	False	排队呼叫插入方式。 0：队头 1：重排队默认值为0。

表7 参数说明
序号	名称	参数类型	是否必选	说明
3.2.3.8.1	transferType	string	False	转接方式。 Release Transfer
3.2.3.8.2	deviceType	number	False	设备类型。 1:Skill 2:Agent 3:Ivr 8:Dn
3.2.3.8.3	value	number	False	设备编号。

表8 放音参数说明
序号	名称	参数类型	是否必选	说明
3.2.3.17.1	parameterType	string	False	参数类型。 Voice IVR
3.2.3.17.2	voiceType	string	False	语音类型。 SPT VP SIG None
3.2.3.17.3	voiceChildType	string	False	语音子类型 Chinese English Dialect1 Dialect2 ReportSound ReportFile None
3.2.3.17.4	customLangIndex	number	False	自定义放音语种编码的编号。
3.2.3.17.5	value	string	False	设备编号。最大长度256

报文样例

消息头

Content-Type:application/json; charset=UTF-8
Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1

请求参数
 无

响应参数

{
    "result": [
        {
            "skillId": 10,
            "Data": {
                "skillParameter": {
                    "waitCallInsertMode": "0",
                    "busyRate": 20,
                    "supportVideo": 0,
                    "busyTransferDevice": {
                        "transferType": "Transfer",
                        "deviceType": "Skill",
                        "value": 1
                    },
                    "maxWaitTime": 30,
                    "maxCallNum": 30,
                    "cancelRate": 20,
                    "timeOutTransferDevice": {
                        "transferType": "Transfer",
                        "deviceType": "Skill",
                        "value": 1
                    },
                    "waitVoice": {
                        "parameterType": "Voice",
                        "voiceType": "SIG",
                        "voiceChildType": "None",
                        "customLangIndex": 0,
                        "value": "29"
                    },
                    "keepVoice": {
                        "parameterType": "IVR",
                        "voiceType": "None",
                        "voiceChildType": "None",
                        "value": "95588"
                    },
                    "noAgentsRate": 20,
                    "maxAgentWrapupTime": 30,
                    "noAgentsTransferDevice": {
                        "transferType": "Transfer",
                        "deviceType": "Skill",
                        "value": 1
                    },
                    "timeOutRate": 20,
                    "restNum": [
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10,
                        10
                    ],
                    "cancelTransferDevice": {
                        "transferType": "Transfer",
                        "deviceType": "Skill",
                        "value": 1
                    }
                },
                "name": "test11",
                "mediaTypeId": 5,
                "serviceId": 11,
                "description": "skillDesc",
            }
        }
    ],
    "message": "success",
    "retcode": "0"
}

父主题： 技能队列

上一篇：修改

下一篇：删除

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

查询