用过此接口新增队列。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnterpriseId |
integer |
是 |
呼叫中心 id |
7000002 |
| Queue |
object |
是 |
队列信息 |
|
| ServiceLevel |
integer |
是 |
服务水平秒数，低于此时间内接听的认为是高服务水平 |
10 |
| AnnounceSound |
integer |
是 |
播报固定语音 0 关闭 1 打开 |
0 |
| WrapupTime |
integer |
是 |
整理时间，取值范围 3-3600 秒 |
30 |
| MaxLen |
integer |
是 |
最大等待数，设置范围 0-999，0 表示不做任何限制 |
0 |
| Description |
string |
是 |
队列名 |
queueName |
| AnnouncePosition |
integer |
否 |
位置播报 0 关闭 1 大于 announce_position_param 时播放 2 小于等于 announce_position_param 时播放 |
0 |
| AnnounceSoundFile |
string |
否 |
固定语音文件 |
announceSoundFile3 |
| CreateTime |
string |
否 |
创建时间，格式: yyyy-MM-dd HH:mm:ss |
2026-04-20 10:00:00 |
| QueueTimeout |
integer |
是 |
队列超时时间，取值范围 20-600 秒，默认 600 秒 |
80 |
| AnnounceSoundFrequency |
integer |
否 |
播放固定语音周期，秒数 |
10 |
| AnnouncePositionYouarenext |
integer |
否 |
是否播报'您是下一位',0 关闭，1 开启 |
0 |
| AnnouncePositionParam |
integer |
否 |
多余少余 n 个时播报，必须大于等于 2 |
2 |
| MemberTimeout |
integer |
是 |
座席超时时间，取值范围 20-60 秒，默认 25 秒 |
25 |
| Weight |
integer |
是 |
队列优先级，取值范围 1-10，数值越高，优先级越高 |
8 |
| JoinEmpty |
integer |
是 |
队列中为空时是否可以 join，取值：1：置忙 2：通话中 4：振铃 8：无效 16：整理 |
1 |
| Qno |
string |
是 |
队列号 |
3003 |
| MusicClass |
string |
是 |
等待语音 class |
default |
| Strategy |
string |
是 |
呼叫策略：rrordered:技能优先 rrmemory:轮选 fewestcalls:平均 random:随机 linear:顺序 leastrecent:最长空闲时间 |
rrordered |
| Retry |
integer |
是 |
座席超时无应答,呼叫下一座席的延迟秒数 |
5 |
| SayAgentno |
boolean |
是 |
语音报号，true:播报，false:不播报 |
true |
| VipSupport |
integer |
是 |
是否支持 vip，1:支持，0:不支持 |
1 |
| AnnouncePositionFrequency |
integer |
否 |
位置播报周期，秒数 |
0 |
| QueueSkills |
array<object> |
是 |
队列技能 |
|
|
object |
是 |
|||
| SkillLevel |
integer |
是 |
技能值 |
10 |
| SkillId |
integer |
是 |
skill 的 id |
66 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
废弃参数 |
无 |
| RequestId |
string |
请求 ID。 |
90E63D28-E31D-1EB2-8939-A9486641**** |
| Message |
string |
返回信息。 |
OK |
| Data |
object |
返回数据。 |
|
| QueueSkills |
array<object> |
队列技能数组 |
|
|
object |
|||
| SkillLevel |
integer |
技能值 |
5 |
| CreateTime |
string |
创建时间，格式: yyyy-MM-dd HH:mm:ss |
2026-04-20 10:00:00 |
| QueueId |
integer |
队列 id |
51937 |
| SkillId |
integer |
skill 的 id |
48734 |
| Id |
integer |
queueSkill 关系表中 id |
54474 |
| EnterpriseId |
integer |
企业编号 |
7000002 |
| Queue |
object |
队列配置信息 |
|
| ServiceLevel |
integer |
服务水平秒数，低于此时间内接听的认为是高服务水平 |
10 |
| AnnounceSound |
integer |
播报固定语音 0 关闭 1 打开 |
0 |
| WrapupTime |
integer |
整理时间，取值范围 3-3600 秒 |
30 |
| MaxLen |
integer |
最大等待数，设置范围 0-999，0 表示不做任何限制 |
0 |
| Description |
string |
队列名 |
queueName |
| AnnouncePosition |
integer |
位置播报 0 关闭 1 大于 announce_position_param 时播放 2 小于等于 announce_position_param 时播放 |
0 |
| AnnounceSoundFile |
string |
固定语音文件 |
sound_file3 |
| CreateTime |
string |
创建时间，格式: yyyy-MM-dd HH:mm:ss |
2026-04-20 10:00:00 |
| QueueTimeout |
integer |
队列超时时间，取值范围 5-600 秒，默认 600 秒 |
60 |
| AnnounceSoundFrequency |
integer |
播放固定语音周期，秒数 |
0 |
| AnnouncePositionYouarenext |
integer |
是否播报'您是下一位',0 关闭，1 开启 |
0 |
| AnnouncePositionParam |
integer |
多余少余 n 个时播报 |
2 |
| MemberTimeout |
integer |
座席超时时间，取值范围 20-60 秒，默认 25 秒 |
25 |
| Weight |
integer |
队列优先级，取值范围 1-10，数值越高，优先级越高 |
10 |
| JoinEmpty |
integer |
队列中为空时是否可以 join，取值：1：置忙 2：通话中 4：振铃 8：无效 16：整理 |
1 |
| EnterpriseId |
integer |
企业编号 |
7000002 |
| Qno |
string |
队列号 |
12331 |
| MusicClass |
string |
等待语音 class |
default |
| Strategy |
string |
呼叫策略：rrordered:技能优先 rrmemory:轮选 fewestcalls:平均 random:随机 linear:顺序 leastrecent:最长空闲时间 |
rrordered |
| Id |
integer |
队列 id |
80 |
| Retry |
integer |
座席超时无应答,呼叫下一座席的延迟秒数 |
5 |
| SayAgentno |
boolean |
语音报号，true:播报，false:不播报 |
false |
| VipSupport |
integer |
是否支持 vip，1:支持，0:不支持 |
0 |
| AnnouncePositionFrequency |
integer |
位置播报周期，秒数 |
10 |
| Code |
string |
状态码。 |
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "无",
"RequestId": "90E63D28-E31D-1EB2-8939-A9486641****",
"Message": "OK",
"Data": {
"QueueSkills": [
{
"SkillLevel": 5,
"CreateTime": "2026-04-20 10:00:00",
"QueueId": 51937,
"SkillId": 48734,
"Id": 54474,
"EnterpriseId": 7000002
}
],
"Queue": {
"ServiceLevel": 10,
"AnnounceSound": 0,
"WrapupTime": 30,
"MaxLen": 0,
"Description": "queueName",
"AnnouncePosition": 0,
"AnnounceSoundFile": "sound_file3",
"CreateTime": "2026-04-20 10:00:00",
"QueueTimeout": 60,
"AnnounceSoundFrequency": 0,
"AnnouncePositionYouarenext": 0,
"AnnouncePositionParam": 2,
"MemberTimeout": 25,
"Weight": 10,
"JoinEmpty": 1,
"EnterpriseId": 7000002,
"Qno": "12331",
"MusicClass": "default",
"Strategy": "rrordered",
"Id": 80,
"Retry": 5,
"SayAgentno": false,
"VipSupport": 0,
"AnnouncePositionFrequency": 10
}
},
"Code": "OK"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。