新增队列。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnterpriseId |
integer |
是 |
呼叫中心 id |
8004970 |
| Qno |
string |
是 |
队列工号，4 位数字，要求唯一 |
1111 |
| Name |
string |
是 |
队列名称，只允许输入中文，字母，数字，下划线，长度不超过 20 个字符 |
示例值示例值 |
| MaxWait |
integer |
否 |
最大等待数，设置范围 0-999，0 表示不做任何限制。默认值为 5 |
5 |
| MemberTimeout |
integer |
否 |
座席超时时间，取值范围 20-60 秒。默认值为 25 |
26 |
| QueueTimeout |
integer |
否 |
队列超时时间，取值范围 30-600 秒。默认值为 600 |
33 |
| Strategy |
integer |
否 |
呼叫策略， 1：顺序，2：轮选，3：平均，4：随机，5：技能优先，6：距上一通呼入空闲时间累计最长，7：技能优先+距上一通呼入空闲时间累计最长，8：距上一通呼入空闲时间累计最长(全队列)，9：技能优先+距上一通呼入空闲时间累计最长(全队列)，10：全队列平均，11：技能优先+轮选，12：最长空闲时长，13：技能优先+当前空闲状态时长最长，14：距上一通通话空闲时间累计最长，默认值为 2 |
2 |
| Weight |
integer |
否 |
队列优先级，取值范围 1-10。默认值为 1 座席属于多个队列时，优先级高的队列的来电将优先接听；数值越高，优先级越高 |
4 |
| WrapupTime |
integer |
否 |
整理时长，取值范围 3-300 秒，整理期间座席不接受新的呼叫。默认值为 15 |
15 |
| ServiceLevel |
integer |
否 |
服务水平秒数，取值范围 10-30 秒，低于此时间内接听的认为是高服务水平。默认值为 15 |
15 |
| JoinEmpty |
integer |
否 |
队列中为空时是否可以 join，1: 置忙；2: 通话中；4: 振铃；8: 无效；16: 整理 如选多种状态则传对应数值的和，如选置忙和通话中，值为 3。默认值为 0，即都未选中 |
1 |
| QueueMembers |
array<object> |
否 |
队列内座席及技能值设置。技能值 1-10，技能值 1 的优先级为最高 cno 队列下座席号 penalty 该座席在队列中的优先级 |
|
|
object |
否 |
|||
| Cno |
string |
否 |
队列下座席号 |
1111 |
| Penalty |
integer |
否 |
该座席在队列中的优先级 |
3 |
| IbAllowed |
integer |
否 |
是否允许呼入队列，0: 否；1: 是；默认值为 1 |
1 |
| SayCno |
integer |
否 |
是否报座席号，0: 否；1:是；默认值为 0 |
0 |
| VipSupport |
integer |
否 |
VIP 客户优先，0:不支持；1:支持；默认值为 0 |
0 |
| MaxPauseClientFlag |
integer |
否 |
最大并发置忙座席数，开关配置，0:关闭，1:开启；默认值为 0 |
0 |
| MaxPauseClientType |
integer |
否 |
最大并发置忙座席数，配置类型，0:百分比，1:数值；默认值为 0 |
0 |
| MaxPauseClientValue |
integer |
否 |
最大并发置忙座席数，配置值，当配置类型为百分比时最大值为 100，默认值为 0 |
0 |
| ChatStrategy |
integer |
否 |
在线客服分配策略，2：轮选；4：随机；5：技能优先；默认值为 2 |
2 |
| ChatMaxWait |
integer |
否 |
在线客服最大排队数；默认值为 20 |
20 |
| ChatLocation |
integer |
否 |
在线客服排队位置推送(小于该位置则推送)；默认值为 10 |
10 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
废弃参数 |
无 |
| RequestId |
string |
请求 ID |
9FF70B74-1B3C-44C1-ACDF-8DF962988F0E |
| Message |
string |
返回信息。 |
OK |
| Data |
object |
返回的数据内容。 |
|
| ClinkRequestId |
string |
请求 id |
示例值示例值示例值 |
| Queue |
object |
队列配置信息 |
|
| ServiceLevel |
integer |
服务水平秒数，取值范围 10-30 秒，低于此时间内接听的认为是高服务水平 |
27 |
| WrapupTime |
integer |
整理时长，取值范围 3-300 秒，整理期间座席不接受新的呼叫 |
86 |
| MaxPauseClientValue |
integer |
最大并发置忙座席数，配置值 |
38 |
| SayCno |
integer |
语音报号(是否报座席号)(1:是 0: 否) |
1 |
| QueueTimeout |
integer |
队列超时时间，取值范围 30-600 秒 |
33 |
| MaxPauseClientFlag |
integer |
最大并发置忙座席数，开关配置 |
19 |
| ChatLocation |
integer |
在线客服排队位置推送(小于该位置则推送) |
10 |
| ChatStrategy |
integer |
在线客服分配策略，2：轮选；4：随机；5：技能优先 |
2 |
| MemberTimeout |
integer |
座席超时时间，取值范围 20-60 秒 |
20 |
| Weight |
integer |
队列优先级，取值范围 1-10 座席属于多个队列时，优先级高的队列的来电将优先接听；数值越高，优先级越高 |
3 |
| JoinEmpty |
integer |
队列中为空时是否可以 join，1: 置忙，2: 通话中，4: 振铃，8: 无效，16: 整理 如选多种状态则传对应数值的和，如选置忙和通话中，值为 3。默认值为 0 即都未选中 |
0 |
| Name |
string |
座席名称，只允许输入中文，字母，数字，下划线，长度不超过 20 个字符 |
示例值示例值 |
| MaxWait |
integer |
最大等待数，设置范围 0-999，0 表示不做任何限制 |
0 |
| ChatMaxWait |
integer |
在线客服最大排队数 |
10 |
| QueueMembers |
array<object> |
队列内座席及技能值设置。技能值 1-10，技能值 1 的优先级为最高 cno 队列下座席号 penalty 该座席在队列中的优先级 |
|
|
object |
队列内座席及技能值设置 |
||
| Cno |
string |
队列下座席号 |
1111 |
| Penalty |
integer |
该座席在队列中的优先级 |
7 |
| IbAllowed |
integer |
是否允许呼入队列，0: 否；1: 是 |
1 |
| Qno |
string |
队列工号，4 位数字，要求唯一 |
1122 |
| Strategy |
integer |
呼叫策略，1：顺序，2：轮选，3：平均，4：随机，5：技能优先，6：距上一通呼入空闲时间累计最长，7：技能优先+距上一通呼入空闲时间累计最长，8：距上一通呼入空闲时间累计最长(全队列)，9：技能优先+距上一通呼入空闲时间累计最长(全队列)，10：全队列平均，11：技能优先+轮选，12：最长空闲时长，13：技能优先+当前空闲状态时长最长，14：距上一通通话空闲时间累计最长 |
1 |
| MaxPauseClientType |
integer |
最大并发置忙座席数，配置类型 |
73 |
| VipSupport |
integer |
支持 VIP 级别(VIP 客户优先)(0:不支持 1:支持) |
0 |
| Code |
string |
状态码。返回 OK 代表请求成功，其他错误码详见错误码列表。 |
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "无",
"RequestId": "9FF70B74-1B3C-44C1-ACDF-8DF962988F0E",
"Message": "OK",
"Data": {
"ClinkRequestId": "示例值示例值示例值",
"Queue": {
"ServiceLevel": 27,
"WrapupTime": 86,
"MaxPauseClientValue": 38,
"SayCno": 1,
"QueueTimeout": 33,
"MaxPauseClientFlag": 19,
"ChatLocation": 10,
"ChatStrategy": 2,
"MemberTimeout": 20,
"Weight": 3,
"JoinEmpty": 0,
"Name": "示例值示例值",
"MaxWait": 0,
"ChatMaxWait": 10,
"QueueMembers": [
{
"Cno": "1111",
"Penalty": 7
}
],
"IbAllowed": 1,
"Qno": "1122",
"Strategy": 1,
"MaxPauseClientType": 73,
"VipSupport": 0
}
},
"Code": "OK"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。