修改队列

修改队列的配置，如：队列名称、响铃策略等。

请求地址

{base_url}/{api_path}/queue/update?token={token}

请求参数

参数 是否必选 类型 说明
number 是 String 队列号码。
queuename 否 String 队列名称。
password 否 String 加入队列动态坐席的密码。
ringstrategy 否 String 响铃策略。

取值范围：

  • Ring All：全部响铃。
  • Least Recent：最近最少被叫响铃。
  • Fewest Calls：最少接通响铃。
  • Random：随机响铃。
  • Rrmemory：顺序响铃。
  • Linear：线性响铃。
failoveraction 否 String 呼入失败目的地。

取值范围：

  • Hang up：挂机。
  • Extension：分机。
  • Voicemail：语音信箱。
  • IVR：自动话务员。
  • Ring Group：响铃组。
  • Queue：队列。
  • Conference：会议室。
  • Fax to Email：传真到邮件。
  • Dial by name：通过名字呼叫。
failoverdest 否 String 呼入失败具体目的地。
agents 否 String 固定座席。
agenttimeout 否 String 坐席响铃时间。单位：秒。
wrapuptime 否 Integer 休息时间。单位：秒。
ringinuse 否 String 使用中振铃。

取值范围：

  • on：开启。
  • off：关闭。
retry 否 Integer 重试间隔时间。单位：秒。
取值范围：
  • 10
  • 20
  • 30
  • 40
  • 50
maxwaittime 否 Integer 最大等待时间。单位：秒。
joinempty 否 String 无坐席时允许呼入。
注： 如果你设置此参数，则不要再设置 disallow_to_join_when_empty，因为这两个参数的作用是一样的。

取值范围：
disallow_to_join_when_empty 否 String 无坐席时禁止呼入。
注： 如果你设置此参数，则不要再设置 joinempty，因为这两个参数的作用是一样的。

取值范围：
empty_defined_for_disallow_to_join_when_empty 否 String 视为无坐席的场景。在此场景下禁止呼叫者呼入队列。

取值范围：

  • 1：所有坐席都未注册在线。
  • 2：所有坐席都处于暂停状态。
  • 3：所有坐席都在使用中。
注： 如果你未配置此参数，则此参数默认赋值为 "1,2"。
leavewhenempty 否 String 无坐席时结束等待。

取值范围：

  • on：开启。
    注： 如果你设置此参数为 on，你可以通过配置empty_defined_for_leave_empty 来定义无坐席的场景。
  • off：关闭。
empty_defined_for_leave_empty 否 String 视为无坐席的场景。在此场景下强制呼叫者退出队列。

取值范围：

  • 1：所有坐席都未注册在线
  • 2：所有坐席都处于暂停状态
  • 3：所有坐席都在使用中
注： 如果你未配置此参数，则此参数默认赋值为 "1,2"。
announcepos 否 String 公告当前位置。

取值范围：

  • on：开启。
  • off：关闭。
announcefreq 否 String 播放用户公告的频率。
取值范围：
  • 0
  • 15
  • 30
  • 45
  • 60
  • 120
  • 180
  • 240
  • 300
  • 600
  • 1200
announceholdtime 否 Integer 公告等待时间。

取值范围：

  • on：开启。
  • off：关闭。
userannounce 否 String 系统公告提示音。
userannouncefreq 否 Integer 播放系统公告的频率。
取值范围：
  • 0
  • 15
  • 30
  • 45
  • 60
  • 120
  • 180
  • 240
  • 300
  • 600
  • 1200
breakoutkey 否 String 按键 DTMF。

取值范围：

  • None
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • *
  • #
breakoutaction 否 String 按键目标。

取值范围：

  • Hang up：挂机。
  • Extension：分机。
  • Voicemail：语音信箱。
  • IVR：自动话务员。
  • Ring Group：响铃组。
  • Queue：队列。
  • Conference：会议室。
  • Fax to Email：传真到邮件。
  • Dial by Name：通过名字呼叫。
breakoutdest 否 String 按键目标的最终目的地。
satisfactionsurvey 否 String 满意度调查提示音。没有设置则默认不播报。

默认值：None。
idannouncement 否 String 播放坐席工号的提示音。没有设置则默认不播报。

默认值：None。

响应参数

参数 类型 说明
status String 请求结果。
  • Success：成功。
  • Failed：失败。

示例

请求示例

将队列6700的响铃策略修改为全部响铃。
POST /api/v2.0.0/queue/update?token=1e3b3ebb6a974cb42ed31de5413df52d
Content-Type:application/json; charset=utf-8
Host: 192.168.5.150

{
	"number": "6700",
	"ringstrategy": "Ring All"
}
响应示例
HTTP/1.1 200 OK
Server: Boa/0.94.14rc21
Accept-Ranges: bytes
Connection: close
Content-Type: application/json
Access-control-allow-origin: *
Access-control-allow-methods: GET, POST, OPTIONS, PUT, DELETE

{
    "status": "Success"
}