Microsoft Teams桌面端Deeplink无法自动填充聊天消息问题

问题核心 #

你使用的DeepLink在Teams移动端、浏览器端能正常跳转到指定机器人并填充消息，但桌面端仅能打开聊天窗口，预设的"Agent Handoff"消息无法显示。当前使用的链接格式：

https://teams.microsoft.com/l/Chat/0/0?users=28:&message=Agent%20handoff

解决步骤 #

• 补全users参数的完整标识
  你的users=28:格式不完整，机器人的用户ID必须是28:<机器人唯一ID>@<租户ID>的完整格式，比如28:abc123-def4-56gh-ijkl-mnopqrstuvwx@contoso.onmicrosoft.com。桌面端对机器人身份的校验更严格，缺失完整ID会导致消息填充逻辑失效。

• 改用机器人专属DeepLink格式
  针对机器人聊天场景，使用优化后的链接结构，桌面端对该格式的参数解析兼容性更好：

  https://teams.microsoft.com/l/chat/0/0?users=28:<完整机器人ID>&message=Agent%20handoff
  

• 强制唤起桌面端应用内打开
  如果还是有问题，在链接末尾添加&launchApp=true，避免通过浏览器中转唤起桌面端时丢失参数：

  https://teams.microsoft.com/l/chat/0/0?users=28:<完整机器人ID>&message=Agent%20handoff&launchApp=true
  

• 更新Teams桌面端版本
  旧版本Teams可能存在DeepLink参数解析的bug，将桌面端更新到最新版后再测试。

额外注意 #

确保message参数的URL编码正确，若后续消息包含特殊字符（如中文、标点），需用标准URL编码工具处理，避免解析异常。

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