使用 Bot Framework 发送主动消息：无需事先交互

本文档介绍了如何使用 Microsoft Bot Framework 构建能够主动向群聊发送消息的机器人，无需用户事先与机器人进行交互。重点讲解了机器人在启动时如何获取群聊信息并发送消息，以及一些关键的先决条件和注意事项。

主动消息发送概述

主动消息是指机器人主动发起的，而非响应用户请求的消息。在某些场景下，例如启动时通知、状态更新等，主动消息非常有用。Bot Framework 提供了相应的功能来实现这一目标，但需要注意一些关键步骤。

前提条件

1. 机器人安装： 机器人必须先被安装到群聊中。这可以通过用户手动安装，或者通过编程方式使用 Graph API 完成。这是发送主动消息的必要前提。
2. 获取 Conversation Reference： 机器人在被安装后，需要捕获群聊的 Conversation Reference。Conversation Reference 包含了机器人与特定会话（例如群聊）进行通信所需的所有信息，例如频道 ID、会话 ID、服务 URL 等。

实现步骤

以下步骤概述了如何实现机器人启动时发送主动消息的功能：

1. 机器人初始化： 在机器人启动时，检查是否已经存储了目标群聊的 Conversation Reference。
2. 获取 Conversation Reference（如果需要）： 如果没有存储 Conversation Reference，则需要先让用户与机器人进行一次交互（例如，在群聊中提及机器人）。机器人收到消息后，可以捕获该消息的 Conversation Reference 并存储起来。
3. 发送主动消息： 使用存储的 Conversation Reference，机器人可以随时向群聊发送主动消息。

示例代码（Java Spring Boot）

以下代码片段展示了如何使用 Bot Framework SDK for Java Spring Boot 发送主动消息：

科大讯飞-AI虚拟主播

科大讯飞推出的移动互联网智能交互平台，为开发者免费提供：涵盖语音能力增强型SDK，一站式人机智能语音交互解决方案，专业全面的移动应用分析；

79

查看详情

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。在实际应用中，还需要考虑错误处理、用户体验等因素，以确保机器人的稳定性和可用性。

以上就是使用 Bot Framework 发送主动消息：无需事先交互的详细内容，更多请关注php中文网其它相关文章！