java 接入企业微信机器人发送消息

原创

mob649e8165596b 2024-10-03 05:16:38 ©著作权

©著作权归作者所有：来自51CTO博客作者mob649e8165596b的原创作品，请联系作者获取转载授权，否则将追究法律责任

Java 接入企业微信机器人发送消息

引言

随着企业数字化转型的不断推进，越来越多的公司开始使用即时通讯工具来进行内部沟通和外部联系。企业微信作为一个专业的团队协作工具，提供了接口以便让我们可以将不同的系统进行集成。其中，企业微信机器人提供了简单的API，让我们可以通过HTTP请求发送消息。本文将详细介绍如何在Java中接入企业微信机器人，并发送消息。

企业微信机器人的基本概念

企业微信机器人是企业微信中用于自动化消息发送的一种工具。使用机器人可以实现自动通知、报警以及信息反馈等功能。这些机器人的重要特性包括：

简单易用: 只需通过Webhook URL发送POST请求即可。
多种消息类型: 支持文本、Markdown、图片等多种格式。
可扩展性强: 可以通过 API 集成到其他系统中，满足更多场景需求。

获取Webhook URL

在使用企业微信机器人之前，首先需要创建一个机器人并获取Webhook URL。以下是获取Webhook URL的步骤：

登录企业微信后台。
创建一个新的"自定义机器人"。
选择相应的权限和机器人设置。
复制Webhook URL以备后用。

Java 代码示例

下面的 Java 代码展示了如何通过 HTTP POST 请求发送一条消息到企业微信机器人。

1. Maven 依赖

首先，确保您的项目中已包含 Apache HttpClient 依赖，如果没有，可以在 pom.xml 中添加以下内容：

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version>
</dependency>

2. 发送消息的代码

import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;

public class WeChatRobot {
    private static final String WEBHOOK_URL = "

    public static void sendMessage(String message) {
        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpPost post = new HttpPost(WEBHOOK_URL);
            post.setHeader("Content-Type", "application/json");

            String json = "{ \"msgtype\": \"text\", \"text\": { \"content\": \"" + message + "\" }}";
            post.setEntity(new StringEntity(json));

            try (CloseableHttpResponse response = httpClient.execute(post)) {
                System.out.println("Response Code: " + response.getStatusLine().getStatusCode());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        sendMessage("Hello, this is a message from my Java application!");
    }
}

代码解释

库引入: 使用 org.apache.httpcomponents 中的 httpclient 库，便于发送 HTTP 请求。
Webhook URL: 将实际的 Webhook URL 替换 YOUR_ACCESS_TOKEN 部分。
消息内容: 可以根据需要自定义消息内容，以上示例发送的是文本消息。

发送不同类型的消息

企业微信机器人支持多种类型的消息，除了文本消息，我们也可以发送Markdown格式的消息。以下是Markdown消息的发送示例：

String markdownMessage = "{ \"msgtype\": \"markdown\", \"markdown\": { \"title\": \"Markdown Title\"," +
        "\"text\": \"### Markdown Message\\n - Item 1\\n - Item 2\\n - Item 3\" }}";
post.setEntity(new StringEntity(markdownMessage));

旅行图

接下来我们通过 mermaid 语言创建一个简要的旅行图，描述接入企业微信机器人的流程。

journey
    title 接入企业微信机器人
    section 获取WebHook URL
      登录企业微信后台: 5: 企业
      创建自定义机器人: 5: 企业
      复制Webhook URL: 5: 企业
    section Java代码实现
      引入依赖: 5: 开发者
      编写发送消息代码: 4: 开发者
      测试发送消息: 5: 开发者