AdaptiveCards 项目中 Teams 客户端按钮交互失效问题分析

问题背景

在微软 Teams 客户端中使用 AdaptiveCards 时，开发者和用户遇到了一个严重的交互问题。当用户点击卡片中的按钮时，系统无法正确处理交互请求，导致功能失效。这一问题在 Teams 新版客户端中尤为突出，严重影响了用户体验和功能可用性。

问题现象

用户在使用 Teams 客户端（包括网页版和桌面版）时，点击 AdaptiveCards 中的按钮后，系统会发送一个 POST 请求到特定端点。然而，这个请求会返回 400 Bad Request 错误，提示"Invalid JSON payload"。

通过对比分析，发现正常工作的请求和失败的请求之间存在关键差异：

• 正常请求包含完整的 conversation 对象及其 ID
• 失败请求缺少 conversation 对象信息

技术分析

请求机制

Teams 客户端处理 AdaptiveCards 按钮点击时，会构造一个包含以下关键信息的 JSON 请求：

• 操作类型（messageback）
• 消息类型（RichText/Media_Card）
• 用户选择的值
• 用户显示名称
• 认证令牌
• 消息ID
• 会话信息（conversation）

问题根源

问题的核心在于请求构造不完整。当 Teams 客户端未能正确包含 conversation 对象及其 ID 时，后端服务会拒绝处理该请求，导致交互失败。

解决方案

微软 Teams 团队已经确认并修复了这一问题。根据最新反馈，该问题在当前版本的 Teams 客户端中已得到解决。开发者可以验证以下方面来确认修复效果：

1. 检查按钮点击后发送的请求是否包含完整的 conversation 信息
2. 确认请求能够成功到达后端服务并得到正确处理
3. 验证用户交互流程是否恢复正常

最佳实践建议

对于使用 AdaptiveCards 的开发者，建议采取以下措施来确保交互稳定性：

1. 在开发阶段充分测试不同 Teams 客户端版本的行为
2. 实现完善的错误处理机制，应对可能的请求失败情况
3. 保持对微软官方更新的关注，及时应用相关修复
4. 考虑在卡片设计中加入备用交互方式，提高容错能力

总结

AdaptiveCards 作为微软生态中的重要交互组件，其稳定性和可靠性对用户体验至关重要。这次问题的解决展示了微软团队对开发者反馈的响应速度和技术能力。开发者应持续关注官方渠道，确保及时获取类似问题的解决方案和更新信息。