TAPI监控Avaya IP Office分机呼叫事件失败问题求助

1. 确保接收监控分机呼叫事件的关键步骤 #

针对TAPI 3.0的配置和代码实现，需逐一排查以下点：

• 确认监控权限与注册参数：
  调用ITTAPI::RegisterCallNotifications时，必须将bMonitor设为TRUE，同时指定目标分机对应的ITAddress对象；另外通过put_EventFilter设置事件过滤器，必须包含TE_CALLSTATE（呼叫状态事件），否则会过滤掉LINECALLSTATE_OFFERING这类事件。
• 检查COM事件回调实现：
  确保正确实现ITTAPIEventNotification接口的Event方法，在方法内判断事件类型为TE_CALLSTATE后，进一步解析ITCallStateEvent对象获取呼叫状态，不要遗漏对LINECALLSTATE_OFFERING的分支处理。
• 验证线路打开权限：
  调用lineOpen（若混用TAPI 2.x接口）时，需指定LINECALLPRIVILEGE_MONITOR权限；使用TAPI 3.0的ITAddress::Open时，确保权限参数包含监控权限。
• 排查监控范围：
  若监控多个分机，需为每个分机单独调用RegisterCallNotifications；若监控整个线路，可使用ITTAPI::RegisterNotifications并指定线路设备对象。

2. Avaya IP Office的额外配置要求 #

Avaya IP Office系统端必须完成以下配置才能触发TAPI事件：

• 启用TAPI服务并分配权限：
  在Avaya IP Office Manager中，进入System > Telephony Services启用TAPI Service，创建专用的TAPI用户并分配“TAPI Monitor”权限，确保该用户能访问目标分机。
• 配置分机监控权限：
  对每个需要监控的分机，在分机配置页面的“Telephony”选项卡中，启用“Allow TAPI Control”或“Call Monitoring”选项，允许TAPI驱动获取该分机的呼叫事件。
• 驱动端配置验证：
  打开Avaya TAPI驱动的配置工具（通常在控制面板的电话选项中），确认已添加目标分机，且监控模式设置为“Full Call Monitoring”。
• 检查许可证：
  确认Avaya IP Office已激活TAPI相关许可证（如“TAPI License”），无许可证情况下仅能获取分机列表，无法接收事件。

3. 分机事件监控替代方案 #

如果TAPI方案仍无法满足需求，可考虑以下更可靠的替代方案：

• Avaya官方SDK：
  使用Avaya DevConnect提供的IP Office Web Services API或CTI SDK，直接与IP Office系统交互，支持更丰富的呼叫事件监控与控制功能，无需依赖TAPI驱动。
• SIP协议直接对接：
  若分机支持SIP，可通过SIP协议实现监控：注册SIP客户端到IP Office，监听INVITE请求识别来电事件，通过REFER命令实现呼叫转接，灵活性更高。
• CTI中间件：
  采用Avaya Contact Center Express（CCE）或第三方CTI中间件，这类工具提供稳定的事件推送机制和呼叫控制能力，适合企业级复杂呼叫场景。

内容的提问来源于stack exchange，提问作者Chittaranjan Das