本文档介绍了如何使用 Microsoft Bot Framework 构建能够主动向群聊发送消息的机器人，无需用户事先与机器人进行交互。重点讲解了机器人在启动时如何获取群聊信息并发送消息，以及一些关键的先决条件和注意事项。
主动消息发送概述
主动消息是指机器人主动发起的，而非响应用户请求的消息。在某些场景下，例如启动时通知、状态更新等，主动消息非常有用。Bot Framework 提供了相应的功能来实现这一目标，但需要注意一些关键步骤。
前提条件
- 机器人安装： 机器人必须先被安装到群聊中。这可以通过用户手动安装，或者通过编程方式使用 Graph API 完成。这是发送主动消息的必要前提。
- 获取 Conversation Reference： 机器人在被安装后，需要捕获群聊的 Conversation Reference。Conversation Reference 包含了机器人与特定会话（例如群聊）进行通信所需的所有信息，例如频道 ID、会话 ID、服务 URL 等。
实现步骤
以下步骤概述了如何实现机器人启动时发送主动消息的功能：
- 机器人初始化： 在机器人启动时，检查是否已经存储了目标群聊的 Conversation Reference。
- 获取 Conversation Reference（如果需要）： 如果没有存储 Conversation Reference，则需要先让用户与机器人进行一次交互（例如，在群聊中提及机器人）。机器人收到消息后，可以捕获该消息的 Conversation Reference 并存储起来。
- 发送主动消息： 使用存储的 Conversation Reference，机器人可以随时向群聊发送主动消息。
示例代码（Java Spring Boot）
以下代码片段展示了如何使用 Bot Framework SDK for Java Spring Boot 发送主动消息：
import com.microsoft.bot.builder.TurnContext;
import com.microsoft.bot.schema.Activity;
import com.microsoft.bot.schema.ConversationReference;
public class ProactiveMessageSender {
public static void sendMessage(ConversationReference conversationReference, String message) {
// 获取 TurnContext
TurnContext turnContext = TurnContext.getTurnContext(conversationReference);
// 创建消息 Activity
Activity activity = Activity.createMessageActivity();
activity.setText(message);
// 发送消息
turnContext.sendActivity(activity).join();
}
public static void main(String[] args) {
// 假设已经存储了 Conversation Reference
ConversationReference conversationReference = loadConversationReference();
// 发送主动消息
sendMessage(conversationReference, "Hello, I'm up and running!");
}
private static ConversationReference loadConversationReference() {
// TODO: 从存储介质（例如数据库、文件）加载 Conversation Reference
// 示例：
// ConversationReference reference = new ConversationReference();
// reference.setChannelId("msteams");
// reference.setConversation(new ConversationAccount().setId("your_conversation_id"));
// reference.setServiceUrl("your_service_url");
// return reference;
return null; // 替换为实际的加载逻辑
}
}代码解释：
- sendMessage 方法接收 Conversation Reference 和消息内容，并使用 TurnContext 发送消息。
- loadConversationReference 方法用于从存储介质加载 Conversation Reference。请务必根据实际情况实现此方法，从数据库或文件中加载存储的 Conversation Reference 信息。
- main 方法演示了如何使用加载的 Conversation Reference 发送主动消息。
注意事项：
- 存储 Conversation Reference： Conversation Reference 非常重要，需要持久化存储。可以使用数据库、文件或其他存储介质。
- 错误处理： 在发送消息时，可能会遇到各种错误，例如网络问题、权限问题等。需要进行适当的错误处理，例如重试、记录日志等。
- 用户体验： 过度发送主动消息可能会影响用户体验。需要谨慎使用主动消息功能，避免打扰用户。
总结
通过以上步骤，您可以构建一个能够主动向群聊发送消息的 Bot Framework 机器人。关键在于确保机器人已被安装到群聊，并正确获取和存储 Conversation Reference。在实际应用中，还需要考虑错误处理、用户体验等因素，以确保机器人的稳定性和可用性。
