触发Microsoft Teams活动通知时遇AAD App ID冲突错误求助

核心问题 #

Teams管理后台里有两个共用同一个AAD App ID的应用——已公开的1.0.0版和正在审核的2.0.0版，且两个应用都没有删除选项，触发活动通知时系统无法区分目标应用，直接抛出错误：
Found multiple applications with the same AAD App ID 'ff682f83-2e00-4acb-8010-a3d7b4f3c832' - a Teams Application ID is required to resolve which application is correct.

保留双应用的解决办法 #

• 给活动通知请求添加teamsAppId参数
  在触发活动通知的API请求中，必须明确加入teamsAppId字段，将其值设置为对应版本应用的Teams唯一ID（直接从Teams管理后台对应应用的详情页即可获取）。示例请求片段：

  {
    "recipient": {
      "userId": "目标用户ID"
    },
    "message": {
      "attachment": {
        "contentType": "application/vnd.microsoft.card.adaptive",
        "content": {
          // 此处填写自适应卡片内容
        }
      }
    },
    "teamsAppId": "对应版本的Teams应用ID"
  }
  

  该参数能让系统精准识别要触发通知的目标应用版本。

• 联系Teams开发者支持配置版本优先级
  若添加参数后问题仍存在，直接提交工单给Teams开发者支持，说明两个应用的版本号、共用的AAD App ID及冲突场景，请求协助设置版本优先级——比如让审核中的新版本或当前公开版在触发通知时被优先识别，无需删除任一应用。

• 分版本验证通知触发逻辑
  分别使用两个版本的teamsAppId做测试：用1.0.0版的ID发通知，确认公开版用户可正常接收；用2.0.0版的ID发通知，确认审核/测试环境能正常接收，确保两个版本的通知路径完全隔离。

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