Microsoft Teams聊天机器人无法接收文件的技术排查问询

核心结论：范围不匹配确实是导致该问题的关键原因 #

你遇到的情况很典型——supportsFiles=true的配置本身没问题，但Teams在个人（1:1）聊天和团队/群组聊天场景下的文件发送UI逻辑完全不同：

• 在团队/群组会话中：只要manifest里设置了supportsFiles=true，聊天窗口的回形针图标会正常显示，用户可以直接上传文件到团队站点，机器人也能正常接收。
• 在个人（1:1）聊天中：Teams默认不会展示回形针图标，哪怕你开了supportsFiles=true。这是官方的UI设计逻辑，因为个人聊天的文件存储依赖用户的个人OneDrive，Teams为了避免权限混淆，默认隐藏了这个入口。

为什么会出现行为变化？ #

大概率是你之前测试的场景和现在用户使用的场景不一致：

• 比如你最初在团队环境中验证机器人，看到回形针正常显示，以为全场景都支持；但用户是在个人聊天中使用，自然看不到入口。
• 也有可能是Teams的UI更新调整了规则——早期版本可能在个人聊天中也会显示回形针，但现在官方收紧了这个逻辑，只保留团队/群组场景的入口，引导开发者用更可控的方式处理个人聊天的文件上传。

解决办法 #

如果需要在个人聊天中支持文件发送，有两个可行方案：

1. 引导用户拖拽文件：Teams允许用户直接把文件拖拽到个人聊天窗口发送，只要你的机器人supportsFiles=true，就能正常接收文件内容和元数据。
2. 使用自适应卡片实现文件上传：在机器人的回复消息中添加一个自适应卡片按钮，触发Teams的文件选择器API，让用户选择文件上传。这种方式更友好，也能完全控制文件上传的流程，不受场景限制。

额外验证步骤 #

• 确认manifest中的devicePermissions是否包含fileUpload（如果需要更完整的文件操作权限）；
• 先在团队场景中测试，确认回形针正常显示、文件能被机器人接收，排除其他配置问题。

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