Azure Communication Services CallStarted/CallEnded事件未触发求助

问题背景 #

环境配置 #

• 绑定美国号码的Azure Communication Service
• 名为callEvents的Event Grid主题，包含3个事件订阅
• 3个Event Grid触发的Azure Function：
  • IncomingCallFunction（对应Microsoft.Communication.IncomingCall事件）
  • CallStartedFunction（对应Microsoft.Communication.CallStarted事件）
  • CallEndedFunction（对应Microsoft.Communication.CallEnded事件）
• 自定义WebSocket应用（AI语音代理）处理呼叫

当前现象 #

• 呼叫ACS号码时，WebSocket端点可成功接听，双向通信正常
• 仅IncomingCall事件触发并记录，CallStarted和CallEnded事件完全未触发

已执行排查 #

• 重新创建Event Grid主题及事件订阅
• 验证订阅端点指向正确
• 切换触发器为Webhook

可能原因及排查方向 #

1. 事件触发条件未满足 #

IncomingCall在呼叫到达ACS号码时立即触发，但CallStarted和CallEnded有明确的触发条件：

• CallStarted：需通话成功建立双向媒体流（完成SDP协商、媒体通道连通）后才会触发
• CallEnded：需通话正常挂断或被终止时触发
  排查点：
• 检查自定义WebSocket应用是否完成了完整的SDP协商流程，确认媒体通道已建立
• 查看通话过程中的媒体流状态，确认双向音频传输是否真正完成

2. 事件订阅配置问题 #

• 确认事件订阅中是否准确勾选了Microsoft.Communication.CallStarted和Microsoft.Communication.CallEnded事件类型，避免仅订阅了IncomingCall
• 检查订阅的过滤器规则，是否存在不必要的主题过滤、高级过滤器（比如事件主题前缀/后缀设置错误）导致事件被拦截

3. 自定义WebSocket应用流程缺失 #

此前Skype环境正常，可能是Skype的通话流程默认触发了事件所需的状态更新，而自定义应用缺少关键步骤：

• 确认WebSocket应用在接听呼叫后，是否正确向ACS发送了会话确认或状态更新的指令
• 对比ACS官方WebSocket通话示例，检查是否遗漏了触发事件的必要交互步骤

4. 事件投递与权限问题 #

• 查看Event Grid主题的监控日志（Azure门户>Event Grid主题>监控>日志），搜索CallStarted/CallEnded事件的投递记录，确认是否存在投递失败（如Function返回5xx错误、超时）
• 验证Azure Function的系统分配身份是否具备Event Grid EventSubscriber权限（排除细粒度权限差异问题）

5. ACS服务变更验证 #

可在Azure服务更新日志中查看ACS近期的功能变更，确认是否有事件触发逻辑的调整（此类变更通常会提前发布公告）

后续排查步骤 #

1. 为CallStarted/CallEnded创建独立的测试Webhook订阅（如使用本地测试端点），排除Azure Function本身的问题，验证事件是否能正常投递
2. 启用ACS诊断日志（Azure门户>ACS资源>监控>诊断设置），开启通话相关日志，查看通话建立、结束的完整流程细节，确认是否符合事件触发条件
3. 使用ACS官方呼叫SDK发起测试通话，不依赖自定义WebSocket应用，验证CallStarted/CallEnded事件是否正常触发，排查自定义应用的影响
4. 检查自定义WebSocket应用的代码逻辑，确认在通话建立后是否有正确的状态上报动作，对比官方示例补全缺失步骤

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