2.5.7 分机组队列事件(QUEUE)
通过设备页面配置分机组,且组内分机全忙时,若有分机或来电呼入分机组,OM会向应用服务器汇报该事件。
限制条件
版本要求:Rev2.1.5.118及以上;
只有通过设备页面配置的分机组进入队列时才会有该事件,通过API配置的分机组没有该事件。
报告示例
组内分机全忙,分机和来电相继呼入分机组
分机呼入分机组:
<?xml version="1.0" encoding="utf-8" ?> <Event attribute="QUEUE"> <ext id="200" /> <waiting group="6" count="1" /> </Event>
来电呼入分机组:
<?xml version="1.0" encoding="utf-8" ?> <Event attribute="QUEUE"> <visitor id="77" from="18201008888" to="888" callid="45135" /> <waiting group="6" count="2" /> </Event>
若所有分机离线,分机和来电呼叫分机组
分机呼叫分机组:
<?xml version="1.0" encoding="utf-8" ?> <Event attribute="QUEUE"> <ext id="200" /> <waiting group="7" count="0" reason="offline" /> </Event>
来电呼叫分机组:
<?xml version="1.0" encoding="utf-8" ?> <Event attribute="QUEUE"> <visitor id="77" from="18201008888" to="888" callid="45135" /> <waiting group="7" count="0" reason="offline" /> </Event>
若排队满了,分机和来电呼叫分机组
分机呼叫分机组:
<?xml version="1.0" encoding="utf-8" ?> <Event attribute="QUEUE"> <ext id="200" /> <waiting group="7" count="30" reason="full" /> </Event>
来电呼叫分机组:
<?xml version="1.0" encoding="utf-8" ?> <Event attribute="QUEUE"> <visitor id="2" /> <waiting group="7" count="30" reason="full" /> </Event>
参数说明
参数名称 | 类型 | 参数说明 |
---|---|---|
<ext id> | string | 分机号码,纯数字非空字符串 |
<waiting group> | int | 分机组的唯一标识,不同型号设备起始值不同,最多能添加50个分机组(注意跟分机组的编号区分) |
<count> | int | 在队列中排队等待的个数,取值范围1~30,超过30个后不再排队自动挂断 |
<visitor id> | int | 来电的编号,用于查询、转接、挂断等操作的判断依据 |
<from> | string | 来电时,原始主叫号码 |
<to> | string | 来电时,原始被叫号码(对于visitor而言,原始被叫为来电呼入的中继号码) |
<reason> | string | offline:表示组内分机全离线;full:表示组内分机全忙 |
注:
排队等待的电话个数最多为30个,超过30个后来电自动挂断,不再排队;
Waiting group的值为分机组的相对唯一标识符,注意与分机组的组号区分;
OM只提供进入队列的事件(包括当前队列长度), 出队列需API应用服务器自己维护。如何判断出队列,请点击这里查看方法。