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

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

查看PDF

增加

场景描述

调用该接口增加技能队列。

添加技能队列的同时也会同时增加一个同名技能元素，一个VDN下技能元素的上限为5000个（如果CTI的配套版本为ICD V300R008C25CP2001，则该上限值为5500个），超出上限则会导致技能队列无法添加。

接口方法

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

接口URI

https://ip:port/agentgateway/resource/config/vdn/skill?skillId=5

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

表1 URI携带的参数说明
序号	参数名	数据类型	选取原则	说明
1	skillId	number	False	技能队列编号。取值的类型为整数，取值范围为1～5000。如果为空，则返回一个skillId。

日志中的方法名

addSkillQueue

请求消息

消息头

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

消息体

表3 消息体参数说明
序号	名称	参数类型	是否必选	说明
1	name	string	True	技能队列的名称。最大长度为100字节，不含"[]'&()=;<>,特殊字符
2	mediaTypeId	number	True	媒体类型。 1：文字交谈 2：点击通话 4：回呼请求 5：普通语音电话 15：预测呼出 16：预浏览呼出 17：消息呼叫 53：Social Chat 55：H5 Video
3	description	string	false	技能队列描述。最大长度：255。
4	skillParameter	object	False	技能参数对象。该对象参数说明请参见表4。

表4 技能参数对象参数说明
序号	名称	参数类型	是否必选	说明
4.1	maxAgentWrapupTime	number	False	座席最大整理态时长。取值范围为0～3600（秒）。默认值为5。
4.2	calcOfMaxCallNum	number	False	最大呼叫排队数目计算方法。 0：固定值 1：按签入座席比例默认值为0。
4.3	maxCallNum	number	False	最大呼叫排队数目或比例系数。取值范围为0～10000。默认值为100。
4.4	maxWaitTime	number	False	最大排队等待时间。取值范围为1～60000（秒）。默认值为60。
4.5	restNum	array	False	休息人数。数组长度为48，数组对应一天24小时的时段，每半个小时为一个时间段。取值范围为0～255。默认值为225。
4.6	supportVideo	number	False	支持视频。 0：否 1：是默认值为0。
4.7	timeOutTransferDevice	object	False	排队超时转接设备。该对象的参数说明请参见表5。
4.8	timeOutRate	number	False	排队超时转接队列占用率。取值范围为0～100。默认值为100。
4.9	busyTransferDevice	object	False	遇忙、排队溢出转接设备。转接参数的设备类型只能是技能队列、业务代表、IVR。该对象的参数说明请参见表5。
4.10	busyRate	number	False	遇忙、排队溢出转接队列占用率。取值范围为0～100。默认值为0。
4.11	cancelTransferDevice	object	False	取消排队转接设备。该对象的参数说明请参见表5。
4.12	cancelRate	number	False	取消排队转接队列占用率。取值范围为0～100。默认值为0。
4.13	noAgentsTransferDevice	object	False	无人上班转接设备。该对象的参数说明请参见表5。
4.14	noAgentsRate	number	False	无人上班转接队列占用率。取值范围为0～100。默认值为0。
4.15	conditionOfBusyTransfer	number	False	忙转条件。 0：设备占用率 1：等待时长默认值为0。
4.16	valueOfCondition	number	False	设备占有率或等待时长。忙转条件为设备占用率时，代表设备占用率：取值范围为0～100。默认值为100。忙转条件为等待时长时，代表等待时长：取值范围为0～9999。默认值为0。
4.17	waitVoice	object	False	排队等待。该对象的参数说明请参见表6。该对象的参数参数传递方式请参见表7
4.18	answerFunction	number	False	业务代表应答方式。 0：报工号 1：报礼貌用语 2：不报语音 3：报原声录音 4：VP报工号 5：TTS音 6：报账号默认值为0。该对象的参数组合方式请参见表12。
4.19	keepVoice	object	False	呼叫保持等待音。该对象的参数说明请参见表8。该对象的参数参数传递方式请参见表9
4.20	workNoBeforeVoice	object	False	报工号前播放的语音。该对象的参数说明请参见表10。该对象的参数参数传递方式请参见表11。说明：报工号前与报工号后的语音类型要一致，语音类型为None时除外。
4.21	workNoAfterVoice	object	False	报工号后播放的语音。该对象的参数说明请参见表10。该对象的参数参数传递方式请参见表11。说明：报工号前与报工号后的语音类型要一致，语音类型为None时除外。
4.22	maxTalkTime	number	False	最大通话时间，单位为秒。取值范围为1～86400。默认值为86400。
4.23	waitCallInsertMode	number	False	排队呼叫插入方式。 0：队头 1：重排队默认值为0。

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

表6 放音参数说明
序号	名称	参数类型	是否必选	说明
4.17.1	parameterType	string	False	参数类型。 Voice IVR
4.17.2	voiceType	string	False	语音类型。 SPT VP SIG None
4.17.3	voiceChildType	string	False	语音子类型 Chinese English Dialect1 Dialect2 ReportSound ReportFile None
4.17.4	value	string	False	设备编号。最大长度：255
4.17.5	customLangIndex	number	False	自定义放音语种编码的编号。

表7 放音参数组合方式
参数类型/parameterType	语音类型/voiceType	语音子类型/voiceChildType	参数值/value
IVR	None	None	接入码，根据实际情况填写。
Voice	SPT	Chinese English Dialect1 Dialect2	文件/网页/序列号。
Voice	VP	ReportSound ReportFile	文件/网页/序列号。
Voice	SIG	None	文件/网页/序列号。
Voice	None	None	""(不放音)

表8 呼叫保持等待音参数说明
序号	名称	参数类型	是否必选	说明
4.19.1	parameterType	string	False	参数类型。 Voice
4.19.2	voiceType	string	False	语音类型。 SPT VP SIG None
4.19.3	voiceChildType	string	False	语音子类型 Chinese English Dialect1 Dialect2 ReportSound ReportFile None
4.19.4	value	string	False	设备编号。最大长度：255
4.19.5	customLangIndex	number	False	自定义放音语种编码的编号。

表9 呼叫保持等待音参数组合方式
参数类型/parameterType	语音类型/voiceType	语音子类型/voiceChildType	参数值/value
Voice	SPT	Chinese English Dialect1 Dialect2	文件/网页/序列号。
Voice	VP	ReportSound ReportFile	文件/网页/序列号。
Voice	SIG	None	文件/网页/序列号。
Voice	None	None	""(不放音)

**表10** 报工号前和报工号后参数说明
序号	名称	参数类型	是否必选	说明
4.20.1	parameterType	string	False	参数类型。 Voice
4.20.2	voiceType	string	False	语音类型。 SPT VP TTS None
4.20.3	voiceChildType	string	False	语音子类型 Chinese English Dialect1 Dialect2 ReportSound None
4.20.4	value	string	False	参数值。
4.20.5	customLangIndex	number	False	自定义放音语种编码的编号。

**表11** 报工号前和报工号后参数参数组合方式
参数类型/parameterType	语音类型/voiceType	语音子类型/voiceChildType	参数值/value
Voice	SPT	Chinese English Dialect1 Dialect2	文件/网页/序列号。
Voice	VP	ReportSound	文件/网页/序列号。
Voice	TTS	Chinese English Dialect1 Dialect2	语音内容。
Voice	None	None	""(不放音)

**表12** 业务代表应答方式与报工号前和报工号后的语音类型的组合方式
座席应答方式	语音类型
0：报工号	SPT None
1：报礼貌用语	无限制
2：不报语音	无限制
3：报原声录音	无限制
4：VP报工号	VP
5：TTS音	TTS None
6：报账号	SPT None

响应消息

**表13** 消息体参数说明
序号	名称	参数类型	说明
1	message	string	描述
2	retcode	number	操作的结果原因码。取值类型为整数。 0：成功非0：失败，具体见“错误码定义”章节
3	result	object	结果信息。该对象的参数说明请参见表14。

**表14** result参数说明
序号	名称	参数类型	说明
3.1	skillId	number	技能ID

报文样例

消息头

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

请求参数

{
    "name": "test123456",
    "mediaTypeId": "5",
    "description": "skillDesc",
    "skillParameter": {
        "waitCallInsertMode": "0",
        "maxAgentWrapupTime": "30",
        "supportVideo": "0",
        "maxCallNum": "30",
        "maxWaitTime": "30",
        "answerFunction": "2",
        "timeOutTransferDevice": {
            "transferType": "Transfer",
            "deviceType": "1",
            "value": "1"
        },
        "timeOutRate": "20",
        "busyTransferDevice": {
            "transferType": "Transfer",
            "deviceType": "1",
            "value": "1"
        },
        "busyRate": "20",
        "cancelTransferDevice": {
            "transferType": "Transfer",
            "deviceType": "1",
            "value": "1"
        },
        "cancelRate": "20",
        "noAgentsTransferDevice": {
            "transferType": "Transfer",
            "deviceType": "1",
            "value": "1"
        },
        "noAgentsRate": "20",
        "waitVoice": {
            "parameterType": "IVR",
            "voiceType": "None",
            "voiceChildType": "None",
            "value": "95588"
        },
        "keepVoice": {
            "parameterType": "IVR",
            "voiceType": "None",
            "voiceChildType": "None",
            "value": "95588"
        },
        "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"
        ]
    }
}

响应参数

{
    "result": {
        "skillId": 4
    },
    "message": "success",
    "retcode": "0"
}

父主题： 技能队列

上一篇：技能队列

下一篇：修改

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

盘古Doer提问云社区提问

增加

场景描述

接口方法

接口URI

日志中的方法名

请求消息

响应消息

报文样例

相关文档

意见反馈

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