集成Microsoft Teams的Azure Bot首次使用SSO时重复发送消息的问题解决方案咨询

我之前也碰到过类似的问题，结合Bot Framework Composer和Teams的特性，给你几个排查和解决的方向：

1. 过滤Teams重复触发的ConversationUpdate事件 #

Teams在用户首次打开聊天窗口时，有时候会重复发送ConversationUpdate事件（比如一次是用户加入会话，一次是Bot被添加到会话，或是Teams内部机制导致的重复推送）。如果你的欢迎消息是绑定这个事件触发的，就会导致重复发送。

解决步骤：

• 在Composer的触发器里，找到触发欢迎消息的ConversationUpdate事件逻辑
• 添加条件判断：只在首次触发时发送消息。比如检查turn.activity.membersAdded里是否只有当前用户，或者通过turn.context.activity.id记录已处理的事件ID，避免重复处理
• 或者更简单的方式：判断turn.activity.membersAdded中的成员是否是Bot本身，如果是则跳过，只在用户加入时发送欢迎消息。示例条件表达式：

  @not(contains(turn.activity.membersAdded, turn.bot.id))
  

2. 调整SSO初始化与欢迎消息的触发顺序 #

启用SSO后，首次打开聊天时，Bot会先触发SSO的授权流程，这个过程中可能会因为回调逻辑的重复执行，导致欢迎消息被多次发送。

解决方法：

• 将欢迎消息的发送时机延迟到SSO授权完成之后。比如在Composer里添加一个“等待SSO完成”的步骤，确认用户完成授权后再发送欢迎消息
• 或者在SSO的OnTokenResponseReceived触发器中，检查是否是首次会话，只发送一次欢迎消息，避免和ConversationUpdate事件的消息重复

3. 检查Teams Manifest文件的配置错误 #

Manifest文件的错误配置也可能导致重复事件推送：

• 确认bots数组中只有一个Bot条目，不要重复添加相同的botId
• 检查webApplicationInfo里的SSO配置是否正确，避免因为配置错误导致Teams重复触发Bot事件
• 确认supportedEvents中没有重复订阅conversationUpdate事件

4. 启用Bot的消息去重机制 #

在Azure Bot Service层面，也可以配置消息去重：

• 登录Azure Portal，找到你的Bot资源，进入“Channels” -> “Microsoft Teams”频道设置
• 检查是否启用了消息重试，如果开启了可以尝试关闭，或者调整重试次数
• 在Composer的代码中，添加一个简单的去重逻辑：比如在对话状态中记录已发送的欢迎消息标记，每次触发时先检查标记，已发送则跳过。示例：

  @not(equals(turn.dialogState.welcomeSent, true))
  

  发送消息后，设置turn.dialogState.welcomeSent = true

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