调用Teams录制机器人joinCall接口成功但机器人未在会议中显示

常见故障原因与对应排查步骤 #

• 权限与租户配置问题
  • 核对Azure AD中注册的Bot应用权限，必须已添加Calls.JoinGroupCall.All、Calls.JoinGroupCallAsGuest.All、OnlineMeetings.Read.All应用权限，且已完成租户管理员同意。权限不足时接口会正常返回callId，但后续信令校验会失败，无法实际入会。
  • 核对Bot的Teams应用清单配置，必须声明支持会议、群组呼叫场景，且应用已在测试租户中完成部署（侧载或发布到租户应用目录），没有被租户应用策略拦截。
  • 核对会议所属租户的会议策略：如果是跨租户加入会议，需确认目标租户未开启外部媒体Bot拦截、未禁用匿名用户加入会议的权限。
• 回调连通性问题（最高发）
  • 验证ngrok隧道状态：免费版ngrok重启后会更换公网域名，需确认当前ngrok分配的地址、Bot服务配置的回调基地址、Azure Bot注册时填写的Webhook地址三者完全一致，且ngrok已正确映射到Bot服务的HTTPS端口（官方示例默认用9442端口）。
  • 验证回调链路连通性：Teams通讯平台收到join请求后，会主动向Bot的回调地址发送信令请求，可在ngrok的本地监控面板（默认地址是http://127.0.0.1:4040）查看有没有来自Microsoft通讯平台的POST请求，如果完全没有相关请求，就是回调地址配置错误或网络被拦截；如果有请求但返回非2xx状态码，检查Bot回调处理逻辑是否抛出异常。
  • 验证证书有效性：Bot回调地址必须使用公网信任的SSL证书，自签证书会导致TLS握手失败，平台无法推送信令。
• 媒体网络连通性问题
  • 检查Bot部署环境的防火墙、安全组规则，确保没有拦截到Teams媒体服务的UDP/TCP出站流量，媒体流协商失败时，Bot不会出现在会议参会人列表中。
• 参数与服务配置问题
  • 你当前接口返回的call字段是不带协议的相对路径testbotaimeet.ngrok.io/calls/xxx，正常逻辑下应该返回带https://前缀的完整地址，需检查服务配置中是否漏写了回调基地址的HTTPS协议前缀，该配置错误会导致平台无法定位回调地址。
  • 核对传入的JoinURL是否完整未截断，且发起请求时对应会议处于可加入状态（未结束、未到提前加入时限）。
  • 核对服务初始化时使用的ClientId、ClientSecret、TenantId三个身份参数，和Azure AD中注册的Bot应用参数完全一致，身份错配也会导致假成功返回。

排查优先级建议：先查ngrok回调链路与服务日志 → 再核对服务配置参数 → 再验证应用权限与租户策略，按这个顺序90%以上的同类问题都能定位。

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