Microsoft Teams Bot自适应卡片操作按钮报错原因及解决办法

报错原因 #

• 用户手动屏蔽Bot：用户在Teams中将该Bot加入屏蔽列表，导致无法触发任何与Bot相关的交互操作，包括点击卡片按钮。
• Bot权限/清单配置缺失：Bot在Azure或Teams应用清单中的权限配置不全，比如未声明卡片交互所需权限，或者应用清单的bots字段配置错误，导致Teams限制了卡片操作。
• 自适应卡片Action配置不规范：卡片内的操作按钮使用了Teams不支持的Action类型，或者data字段格式错误，触发交互时被Teams拦截。

解决办法 #

• 用户端解除屏蔽：让用户打开与Bot的聊天窗口，点击Bot头像，选择右上角三个点的“更多选项”，取消“屏蔽”设置即可。
• 检查Bot权限与应用清单：
  • 登录Azure门户，确认Bot已正确关联Teams频道，并且配置了ChannelMessage.Send等必要权限。
  • 打开Teams应用的manifest.json文件，检查bots字段的scopes是否覆盖实际使用场景（比如personal个人聊天、team团队频道），同时确保没有错误配置限制交互的权限项。
• 修正卡片Action配置：
  • 确保卡片操作使用Teams支持的类型，比如Action.Submit，避免使用不兼容的Action类型。
  • 校验Action的data字段格式，保证能被Bot后端正确解析，避免格式错误。
  • 用Teams官方自适应卡片设计器测试卡片，确保符合Teams的卡片规范。

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