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

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

查看PDF

修改

场景描述

调用该接口修改技能队列。

接口方法

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

接口URI

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

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

URI中携带的参数说明如表1所示。

表1 URI中携带的参数说明
序号	名称	参数类型	是否必选	说明
1	skillId	number	True	技能队列的编号。取值类型为整数，取值范围为1～5000。

日志中的方法名

modifySkillQueue

请求消息

消息头

表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 默认值为5。该字段不支持修改。
3	description	string	false	技能队列描述。最大长度：255。
4	skillParameter	object	False	技能参数对象。该对象参数说明请参见表4。该字段支持修改。

表4 技能参数对象参数说明
序号	名称	参数类型	是否必选	说明
4.1	maxAgentWrapupTime	number	False	座席最大整理态时长。取值范围为0～3600。
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。说明：
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：失败，具体见“错误码定义”章节

报文样例

消息头

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"
        ]
    }
}

响应参数

{
    "message": "success",
    "retcode": "0"
}

父主题： 技能队列

上一篇：增加

下一篇：查询

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

盘古Doer提问云社区提问

修改