4.5 API功能开关
(友情提示:超链接返回的快捷键为Alt + ←)
状态监控开关
开启状态下,当该线路的状态发生变化或产生通话记录时,OM会实时向应用服务器推送相应的API报告。
关闭状态下,当该线路的状态发生变化或产生通话记录时,OM不会推送相应的API报告。
来电应答前控制开关
- 开启状态下,当来电呼叫相应的外线(中继)时,OM不会立刻受理该来电,而是将描述该现象的事件(INVITE事件)推送给应用服务器,由应用服务器决定是否要受理该来电。如果应用服务器希望OM受理该来电,则执行Accept API请求;如果希望OM拒绝该来电,则执行Clear API请求。如果因网络或系统故障等原因应用服务器未收到INVITE事件或收到后未执行控制,则OM等待超时(等待时间由参数API_RESPONSE_TO控制,默认为5秒,设置范围1~120秒,建议不超过30秒)后会自动受理该来电。
- 关闭状态下,当有来电呼叫该外线时,OM自动受理该来电,不会向应用服务器推送INVITE事件。
来电应答后控制开关
开启状态下,当有来电呼叫外线时,OM直接受理该来电,将其接通并保持静音,同时将描述该现象的事件(INCOMING事件)推送给应用服务器,由应用服务器决定如何对该来电进行转接。应用服务器可以执行Transfer API请求,将来电转接到语音菜单、分机或分机组等。如果因网络或系统故障等原因应用服务器未收到INCOMING事件或收到后未执行控制,则OM等待超时(等待时间由参数API_RESPONSE_TO控制,默认为5秒,设置范围1~120秒,建议不超过30秒)后自动将来电转给总机。
特别提示:仅Rev2.1.5.112以后的版本为此机制,对于之前的版本,OM等待应用服务器处理超时后仍不会受理该来电,来电方会一直处于静音状态,直到电话挂断。
关闭状态下,OM会安排自身配置对来电进行转接或导航,如播放欢迎词,且不会推送INCOMING事件。
注:来电应答前控制和来电应答后控制开关是只针对“来电(即呼入)”而设置的开关,内部分机互拨及外呼等其他情况则不起作用。
新老web中API开关的对应关系:
老的web页面
新的web页面(OM20/OM50)
OM20/OM50的web页面上对API开关做了调整,与老的web页面的对应关系为:
线路类型 | 老的web版本 | 新的web版本 |
---|---|---|
分机 | API | 状态监控 |
外线(中继) | 监控 | 状态监控 |
控制 | 状态监控+来电应答后控制(即两个开关都打开) | |
关闭 | 三个开关都关闭 |
说明:“来电应答前控制”是新增加的控制模式,老的web上没有相应配置项。
API值说明:
- 状态监控:开启,API=0x07;关闭,API=0x00;
- 来电应答前控制:开启,API=0x10;关闭,API=0x00;
- 来电应答后控制:开启,API=0x20;关闭,API=0x00。
三者可以叠加,如当某条外线(中继)的API=0x27时,表示同时开启了来电应答后控制和状态监控开关。
说明:2.1.5.94版本做了修改,分机配置API开关,0x08原来是状态监控模式,94版本后修改为DTMF事件汇报模式,会汇报单一拨号号码,呼叫由内部处理。
注:OM是否推送CDR由参数API_CDR(id=1058)决定,而不受API开关控制。
API值对应的事件: