查询分机
该API用于查询指定分机的相关信息,如:配置参数、分机状态、通话方等。
请求示例
<?xml version="1.0" encoding="utf-8" ?>
<Control attribute="Query">
<ext id="208"/>
</Control>
参数说明
参数名称 | 类型 | 参数说明 | 参数值说明 |
---|---|---|---|
<ext id> | string | 分机号 | 必须为OM上的有效分机,值不能为空 |
响应示例
<?xml version="1.0" encoding="utf-8" ?>
<Status>
<ext id="208">
<lineid>Phone 1</lineid>
<group id="1"/>
<group id="2"/>
<staffid>1304081</staffid>
<Call_Pickup>yes</Call_Pickup>
<Fwd_Number>18603752801</Fwd_Number>
<Call_Restriction>3</Call_Restriction>
<Off_Line_Num>200</Off_Line_Num>
<mobile>18603752800</mobile>
<fork>18603752802</fork>
<email>admin@hotmail.com</email>
<record>on</record>
<api>7</api>
<voicefile>welcome</voicefile>
<state>active</state>
<outer id="8" from="208" to="13012345678" trunk="02161208234" callid="28680">
<state>talk</state>
</outer>
</ext>
</Status>
参数说明
说明:<>表示必选项,[]表示可选项(当参数值为默认值或空时,响应消息可能不携带该参数),| 表示或者关系
参数名称 | 类型 | 参数说明 | 参数值说明 |
---|---|---|---|
<ext id> | string | 分机号 | 纯数字字符串 |
<lineid> | string | 分机的线路编号,是分机的唯一固定标识 | IPPhone | Phone XXX |
[staffid] | string | 工号,分机接通前会向来电方播放该工号 | 纯数字字符串 |
[group] | int | 分机组,这里为该分机所属的分机组 | 1~50 |
[voicefile] | string | 语音文件,这里为分机队列中排队等待时播放的语音文件 | 只支持.dat和.pcm格式 |
[email] | string | 员工的电子邮件地址(暂无对应功能) | |
[Call_Restriction] | int | 呼叫权限 | 0: 内线,1: 市话, 2: 国内,3: 国际 |
[Call_Pickup] | string | 代接权限,是否允许来电被其它分机代接 | Yes:允许,no:不允许 |
[No_Disturb] | string | 免打扰功能开关,开启免打扰后分机将屏蔽所有来电,但能主动发起呼叫 | on: 开启,off: 关闭 |
[Fwd_Type] | int | 呼叫转移方式 | 0: 关闭,1: 全转,2: 遇忙或无应答转 |
[Fwd_Number] | string | 呼叫转移号码 | 值为空时关闭 |
[fork] | string | 同振号码 | 值为空时关闭 |
[mobile] | string | 分机绑定的手机号,该手机号可作为呼叫转移、离线转移的缺省配置 | 值为空时关闭 |
[record] | string | 实时录音功能开关 | on: 开启,off: 关闭 |
[api] | int | API的功能开关 | 0:关闭API状态监控 7: 开启API状态监控 点击查看API功能开关详细介绍 |
[state] | string | 线路状态 | Ready: 空闲可用 Active: 振铃、回铃或通话中 Progress:模拟分机摘机后等待拨号以及拨号过程中 Offline: IP分机离线 Offhook:模拟分机听催挂音时的状态 |
[outer] | object | 去电,这里作为该查询分机的通话方 | |
[id] | int | 去电的编号,可依据该参数进行呼叫转接 | |
[from] | string | 原始主叫号码 | |
<to> | string | 原始被叫号码(对于visitor而言,原始被叫为来电呼入中继号码) | |
[trunk] | string | 中继号,即该去电从该中继呼出 | |
[callid] | int | 通话的相对唯一标识符 | |
[state] | string | 通话状态 | Talk: 通话进行中 Progress: 呼叫处理过程中 Wait: 呼叫等待中 |
[visitor] | object | 来电,这里作为该查询分机的通话方 | |
<id> | int | 来电的编号,可依据该参数进行呼叫转接等操作 | |
<from> | string | 原始主叫号码 | |
<to> | string | 原始被叫号码(对于visitor而言,原始被叫为来电呼入的中继号码) | |
<callid> | int | 通话的相对唯一标识符 | |
[state] | string | 通话状态 | Talk: 通话进行中 Progress: 呼叫处理过程中 Wait: 呼叫等待中 |
[ext] | object | 分机,这里作为该查询分机的通话方 | |
<id> | string | 分机号 | |
[state] | string | 通话状态 | Talk: 通话进行中 Progress: 呼叫处理过程中 Wait: 呼叫等待中 |