Teams一对一聊天中Adaptive Card Refresh操作报209错误求助

核心问题原因 #

1. Bot权限范围未覆盖一对一聊天：当前清单中bots节点的scopes仅包含team和groupchat，未添加**一对一聊天（personal）**场景，导致该场景下的交互请求被Teams拦截。
2. 通知型Bot限制交互请求：isNotificationOnly设为true时，Bot仅支持发送消息，无法接收用户触发的Invoke类请求（比如Adaptive Card的Refresh操作），这是触发403/209错误的核心原因。
3. 缓存重置后的权限校验：清除Teams缓存后，本地临时权限缓存失效，触发统一权限校验逻辑，原本发送者可用的临时权限也被收回。

具体修复步骤 #

1. 更新Teams应用清单

修改bots节点配置，添加一对一聊天权限并关闭通知型限制：

"bots": [
  {
    "botId": "bot_id_is_here",
    "needsChannelSelector": false,
    "isNotificationOnly": false, // 改为false，允许接收用户交互请求
    "scopes": [
      "team",
      "groupchat",
      "personal" // 添加一对一聊天场景权限
    ]
  }
],

2. 校验Adaptive Card Refresh操作配置

确保Card中的Refresh操作无额外权限限制，目标端点指向正确的Bot服务：

{
  "type": "Action.Refresh",
  "title": "刷新"
  // 避免添加不必要的权限过滤配置
}

3. 重新部署并验证

• 将更新后的应用清单重新上传至Teams管理平台
• 清除所有客户端（浏览器/桌面端）的Teams缓存
• 在一对一聊天场景下，由发送者和接收者分别测试Refresh操作

补充说明 #

Teams频道场景正常是因为频道已在scopes范围内，且频道内的Bot交互对isNotificationOnly限制的兼容性更高。209错误码明确指向操作权限验证失败，核心就是Bot的交互权限未覆盖目标场景，且通知型Bot无法处理用户主动发起的操作请求。

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