Teams自适应卡片Deep Link在Teams预览版（Beta）中无法正常工作

问题概述 #

我有一个发送通知的Bot，通知内的自适应卡片包含指向组织内部Teams应用的Deep Link。该链接在Teams常规版本中可正常跳转至目标应用，但切换到Teams Beta预览版后（应用URL未变更），点击链接会弹出“应用未找到”的错误提示。

可行修复步骤 #

• 严格校验Deep Link格式
  Teams Beta版对Deep Link的格式合规性要求更严格，务必确保链接符合官方标准格式：
  https://teams.microsoft.com/l/application/{应用ID}?tenantId={租户ID}
  重点检查是否遗漏tenantId参数，以及应用ID是否与Beta环境中注册的目标应用ID完全匹配（注意组织内应用在Beta环境的ID可能需要重新确认）。

• 确认Beta环境应用部署状态
  Beta预览版是独立于常规版的环境，需确认目标应用已在Beta环境中完成安装部署，且应用的可见范围、权限配置与常规版本保持一致。

• 清除Beta版缓存并重新登录
  缓存异常可能导致应用识别失败，操作步骤：

  1. 完全退出Teams Beta版
  2. 删除本地缓存文件夹：%appdata%\Microsoft\TeamsBeta\Cache
  3. 重新登录Teams Beta版后测试链接跳转

• 检查自适应卡片链接配置
  排查自适应卡片的链接是否存在格式错误，比如是否有多余转义字符、链接被截断，同时确认卡片的跳转动作正确使用Action.OpenUrl类型，示例配置：

  {
    "type": "Action.OpenUrl",
    "title": "打开目标应用",
    "url": "你的Deep Link地址"
  }
  

• 核对Beta与常规版的应用注册信息
  登录Azure门户，对比目标应用在Beta环境与常规环境的注册配置，确保应用ID、重定向URI等核心参数完全一致，避免Beta环境的应用注册出现配置偏差。

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