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值对应的事件:

results matching ""

    No results matching ""