查询分机组
该API用于查询分机组的相关信息,如:配置参数(分机成员、呼叫排队时播放的背景音乐、呼叫分配规则)、正在该分机组队列中等待的来电。
注: 分机组队列中的呼叫排队顺序为从上到下。
请求示例
<?xml version="1.0" encoding="utf-8" ?>
<Control attribute="Query">
<group id="1"/>
</Control>
参数说明
参数名称 | 类型 | 参数说明 | 参数值说明 |
---|---|---|---|
<group id> | int | 分机组的编号 | 1~50,值为空时列举所有分机组 |
响应示例
<?xml version="1.0" encoding="UTF-8"?>
<Status>
<group id="1">
<ext id="200"/>
<ext id="208"/>
<voicefile>NowMorning</voicefile>
<distribution>sequential</distribution>
<visitor id="27" from="02167103750" to="02161208234" callid="49162"/>
<visitor id="28" from="13012345678" to="02161204000" callid="49164"/>
</group>
</Status>
解释: 分机组1内有两个分机成员(分机200和分机208),当来电转接到该分机组后,分机组按照distribution(呼叫分配规则)的类型将呼叫分配给分机。当组内分机全忙,来电将会在分机组队列中等待,等待音乐为voicefile指定的语音文件。
参数说明
说明:<>表示必选项,[]表示可选项(当参数值为默认值或空时,响应消息可能不携带该参数)
参数名称 | 类型 | 说明 |
---|---|---|
<group id> | int | 分机组的序号 |
[voicefile] | int | 语音文件,支持dat和pcm两种格式,这里为呼叫等待时播放的音乐 |
[distribution] | string | 有效值:sequential(顺选)、circular(轮选)、group(群振) 默认值:circular |
[ext] | string | 分机,这里为该分机组中的分机成员 |
[visitor] | object | 来电,这里为正处于该分机组等待队列中的来电 |
<id> | int | 来电的编号,可依据该参数对来电进行转接、挂断、查询等操作 |
<from> | string | 原始主叫号码 |
<to> | string | 原始被叫号码(对于visitor而言,原始被叫为来电呼入的中继号码) |
<callid> | string | 通话的相对唯一标识符 |