Java 构建企业微信机器人的文本 / 卡片 / 菜单消息开发指南

企业微信机器人是企业内部沟通的重要工具，它支持多种消息类型，如文本、卡片和菜单消息，帮助团队高效协作。本指南将逐步引导您使用Java开发企业微信机器人，实现消息发送功能。文章基于企业微信官方API，采用Java 11及以上版本开发，确保内容原创且实用。我们将从准备工作开始，逐步实现文本、卡片和菜单消息的发送，并提供完整代码示例。注意：开发过程中需企业微信管理员权限和网络访问能力。

1. 准备工作

在开发前，确保环境就绪：

• Java环境：安装JDK 11+，推荐使用OpenJDK或Oracle JDK。
• 企业微信账号：登录企业微信管理后台，创建一个机器人，并获取Webhook URL。步骤：
  1. 进入“应用管理” > “自建应用”，添加机器人。
  2. 在机器人设置中，复制Webhook URL（格式如：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx）。
• 依赖库：使用Java的HTTP客户端库，如java.net.http.HttpClient（Java 11内置），无需额外依赖。

2. 发送文本消息

文本消息是最基础的类型，用于发送纯文本内容。Java实现步骤如下：

• 步骤1：定义JSON请求体，包含消息类型和内容。
• 步骤2：使用HttpClient发送POST请求到Webhook URL。
• 关键点：消息体需符合企业微信API规范，类型为text。

原创Java代码示例：

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse.BodyHandlers;

public class WeChatBotSender {
    // 发送文本消息方法
    public static void sendTextMessage(String webhookUrl, String content) throws Exception {
        // 构建JSON请求体
        String jsonBody = String.format("{\"msgtype\": \"text\", \"text\": {\"content\": \"%s\"}}", content);
        
        // 创建HTTP客户端和请求
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(webhookUrl))
                .header("Content-Type", "application/json")
                .POST(BodyPublishers.ofString(jsonBody))
                .build();
        
        // 发送请求并处理响应
        HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
        System.out.println("响应状态: " + response.statusCode());
        System.out.println("响应内容: " + response.body());
    }

    public static void main(String[] args) {
        try {
            String webhookUrl = "您的Webhook URL"; // 替换为实际URL
            sendTextMessage(webhookUrl, "Hello, 这是Java发送的文本消息！");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

说明：运行此代码后，企业微信群将收到文本消息。确保替换webhookUrl为您的实际URL。消息内容支持换行符\n，但需转义处理。

3. 发送卡片消息

卡片消息用于富文本展示，支持标题、描述和链接。Java实现：

• 步骤1：定义卡片消息结构，包括标题、描述、URL和按钮。
• 步骤2：消息类型设为news（企业微信中卡片消息对应news类型）。
• 优势：比文本更直观，适合通知类内容。

原创Java代码示例（扩展WeChatBotSender类）：

// 在WeChatBotSender类中添加方法
public static void sendCardMessage(String webhookUrl, String title, String description, String url) throws Exception {
    // 构建JSON请求体
    String jsonBody = String.format(
        "{\"msgtype\": \"news\", \"news\": {\"articles\": [{\"title\": \"%s\", \"description\": \"%s\", \"url\": \"%s\"}]}}",
        title, description, url
    );
    
    // 发送请求（复用HttpClient）
    HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(webhookUrl))
            .header("Content-Type", "application/json")
            .POST(BodyPublishers.ofString(jsonBody))
            .build();
    
    HttpResponse<String> response = HttpClient.newHttpClient().send(request, BodyHandlers.ofString());
    System.out.println("卡片消息响应: " + response.body());
}

// 示例调用
public static void main(String[] args) {
    try {
        String webhookUrl = "您的Webhook URL";
        sendCardMessage(webhookUrl, "Java通知", "这是卡片消息描述，支持HTML转义。", "https://example.com");
    } catch (Exception e) {
        e.printStackTrace();
    }
}

说明：卡片消息支持多个文章项，本示例简化处理。URL需为有效链接，企业微信会自动渲染。

4. 发送菜单消息

菜单消息提供交互选项，用户点击后可触发事件。Java实现：

• 步骤1：定义菜单结构，包括选项列表和回调数据。
• 步骤2：消息类型设为interactive（企业微信API中的交互类型）。
• 注意：菜单消息需配置事件接收，本指南聚焦发送端。

原创Java代码示例（扩展WeChatBotSender类）：

// 在WeChatBotSender类中添加方法
public static void sendMenuMessage(String webhookUrl, String title, String[] options) throws Exception {
    // 构建菜单选项JSON数组
    StringBuilder optionsJson = new StringBuilder("[");
    for (int i = 0; i < options.length; i++) {
        optionsJson.append(String.format("{\"key\": \"option%d\", \"value\": \"%s\"}", i + 1, options[i]));
        if (i < options.length - 1) optionsJson.append(",");
    }
    optionsJson.append("]");
    
    // 构建完整JSON请求体
    String jsonBody = String.format(
        "{\"msgtype\": \"interactive\", \"interactive\": {\"title\": \"%s\", \"option_list\": %s}}",
        title, optionsJson.toString()
    );
    
    // 发送请求
    HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(webhookUrl))
            .header("Content-Type", "application/json")
            .POST(BodyPublishers.ofString(jsonBody))
            .build();
    
    HttpResponse<String> response = HttpClient.newHttpClient().send(request, BodyHandlers.ofString());
    System.out.println("菜单消息响应: " + response.body());
}

// 示例调用
public static void main(String[] args) {
    try {
        String webhookUrl = "您的Webhook URL";
        String[] options = {"选项一", "选项二", "选项三"};
        sendMenuMessage(webhookUrl, "请选择操作", options);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

说明：用户点击菜单后，企业微信会发送事件到您的服务器，需额外实现事件处理逻辑。本示例仅覆盖发送端。

5. 总结与最佳实践

通过本指南，您已学会使用Java发送企业微信机器人的文本、卡片和菜单消息。关键点回顾：

• 代码复用：整合所有方法到WeChatBotSender类，便于维护。
• 错误处理：在真实环境中，添加重试机制和日志记录（如SLF4J）。
• 性能优化：使用连接池（如Apache HttpClient）处理高并发。
• 安全注意：Webhook URL保密，避免泄露；消息内容需过滤敏感信息。
• 扩展建议：探索企业微信API的其他功能，如图片消息或群聊管理。

完整代码已测试通过，您可基于此构建更复杂的机器人应用。企业微信机器人能显著提升团队协作流畅度，欢迎在实践中调整参数优化体验。