查询来电
该API用于查询指定来电的相关信息,如:来电的属性参数(编号、原始主叫、原始被叫、通话状态、相对唯一标识符)、来电的通话方、呼叫状态。
请求示例
<?xml version="1.0" encoding="utf-8" ?>
<Control attribute="Query">
<visitor id="1"/>
</Control>
参数说明
参数名称 | 类型 | 参数说明 | 参数值说明 |
---|---|---|---|
<visitor id> | int | 来电的编号 | 数字,值为空时列举所有来电 |
响应示例
<?xml version="1.0" encoding="utf-8" ?>
<Status>
<visitor id="1" from="02167103750" to="02161208234" callid="49189">
<ext id=" 200" />
<state> progress </state>
</visitor>
</Status>
解释: 来电1是由外部电话02167103750通过中继线02161208234呼入到OM设备,并且当前正在和分机200通话中。
参数说明
说明:<>表示必选项,[]表示可选项(当参数值为默认值或空时,响应消息可能不携带该参数),| 表示或者关系
参数名称 | 类型 | 说明 |
---|---|---|
[visitor] | object | 来电,为由中继呼入OM的外部通话 |
<id> | int | 来电的编号,可依据该参数对来电进行转接、查询、挂断等操作 |
<from> | string | 原始主叫号码 |
<to> | string | 原始被叫号码(对于visitor而言,原始被叫为来电呼入的中继号码) |
<callid> | int | 通话的相对唯一标识符 |
[ext | menu | outer] | object | 来电的通话方,可能为分机、语音菜单、呼叫寄存区、广播区、去电,为空时表明来电呼入OM后尚未被转接 |
[state] | string | Talk: 通话进行中 Progress: 呼叫处理过程中 Wait: 呼叫等待中 |