SpringBoot接入企微机器人

1、企业微信创建机器人(如何创建不懂的请自行百度,很简单的),成功后能获取到一个Webhook地址:https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa

2、创建一个SpringBoot项目(具备基础结构即可,里面的类可暂时忽略)

3、创建dto对象,具体对象的构建可以参考机器人发送消息的入参,群机器人配置说明参考官方文档:https://developer.work.weixin.qq.com/document/path/99110

  • 这里的结构可以自己根据文档里数据结构进行构建
  • 自己需要什么就创建对应的dto
  • 我这里是单纯的发送文字,更多的可以发送图片、链接、附件等,具体参考文档
java 复制代码
@Data
@Accessors(chain = true)
public class Publisher {
    private String msgtype;
    private Media file;
    private Text text;
}
java 复制代码
@Data
@Accessors(chain = true)
public class Text {
    private String content;
    private List<String> mentioned_list;
    private List<String> mentioned_mobile_list;
}
java 复制代码
@Data
@Accessors(chain = true)
public class Media {
    private String media_id;
}

4、创建一个接口发送实现类,如果只有一种发送方式,可以不用接口,我这里用了两种方式,分别是通过单纯的http请求的方式发送请求,另一种是通过feignClient的方式进行接口请求,所以使用了接口。

java 复制代码
public interface ISenderService {
    void send(Publisher publisher) throws Exception;
}

5、第一种:使用基础的http请求方式调用企微机器人,这是比较简单的方式,我这里就不提供HttpUtil类的代码了,相信你自己的项目中这种util类肯定会有的,代码相对简单,不同项目会有一些不同,但基本都大同小异。

  • 这里的wechatrobot.url配置在配置文件中进行配置,配置的就是上面我们获取到的企微机器人的Webhook地址了
java 复制代码
@Service
public class HttpSender implements ISenderService {
    @Value("${wechatrobot.url}")
    private String url;
    @Override
    public void send(Publisher publisher) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        String request = objectMapper.writeValueAsString(publisher);
        HttpUtil.post(url, request);
    }
}

6、第二种:使用FeginClient的方式调用企微机器人,记得启动类上加上注解:@EnableFeignClients,这里涉及到SpringCloud的知识了

  • 如果你的项目里不使用SpringCloud,那就不用关心这个了,了解一下即可,对应pom.xml文件的springCloud的依赖需要自己引入,懂的都懂(DDDD)
java 复制代码
@Service
public class FeginClientSender implements ISenderService{
    @Autowired
    private WechatRobotActions wechatRobotActions;
    @Override
    public void send(Publisher publisher) throws Exception {
        wechatRobotActions.publish(publisher);
    }
}
java 复制代码
@Component
@FeignClient(name = "wechat-robot", url = "${wechatrobot.url}")
public interface WechatRobotActions {
    @PostMapping(path = "",consumes = "application/json")
    void publish( Publisher publisher);
}

7、配置文件:bootstrap.yaml,除了项目本身的一些基础配置,记得加上我们前面用到的配置:wechatrobot.url

java 复制代码
wechatrobot:
  url: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa

8、测试类,并不复杂,相信都会写

java 复制代码
@SpringBootTest
class ISenderServiceTest {
    @Autowired
    private HttpSender httpSender;
    @Autowired
    private FeginClientSender feginClientSender;
    @Test
    void send() throws Exception {
        Publisher publisher = new Publisher();
        publisher.setMsgtype("text");
        publisher.setText(new Text().setContent("我是甲鱼王,咿呀咿呀哟"));
        httpSender.send(publisher);
    }
    @Test
    void send1() throws Exception {
        Publisher publisher = new Publisher();
        publisher.setMsgtype("text");
        publisher.setText(new Text().setContent("我也是甲鱼王,咿呀咿呀哟"));
        feginClientSender.send(publisher);
    }
}

9、实践

上面说了也可以发送图片,包括链接等,类似于下面这种

代码如下,实体类相信自己懂得修改

java 复制代码
@Test
    void send2() throws Exception {
        Publisher publisher = new Publisher();
        publisher.setMsgtype("news");
        List<Article> articles = new ArrayList<>();
        articles.add(new Article()
                .setTitle("2024新安排,元旦放假五天")
                .setDescription("2024放假安排")
                .setUrl("https://pic3.zhimg.com/50/v2-e513e8daa9fd7971719e79ad0d8c8c73_hd.jpg")
                .setPicurl("https://www.gov.cn/zhengce/jiedu/tujie/202310/W020231025350204905165_ORIGIN.jpg"));
        publisher.setNews(new News().setArticles(articles));
        feginClientSender.send(publisher);
    }
相关推荐
小飞Coding10 小时前
Spring Boot 中关于 Bean 加载、实例化、初始化全生命周期的扩展点
spring boot
小飞Coding11 小时前
彻底搞懂 Spring 容器导入配置类:@EnableXXX 与 spring.factories 核心原理
spring boot
凉年技术15 小时前
Java 实现企业微信扫码登录
java·企业微信
悟空码字2 天前
Spring Boot 整合 MongoDB 最佳实践:CRUD、分页、事务、索引全覆盖
java·spring boot·后端
皮皮林5513 天前
拒绝写重复代码,试试这套开源的 SpringBoot 组件,效率翻倍~
java·spring boot
用户908324602736 天前
Spring AI 1.1.2 + Neo4j:用知识图谱增强 RAG 检索(上篇:图谱构建)
java·spring boot
用户8307196840826 天前
Spring Boot 集成 RabbitMQ :8 个最佳实践,杜绝消息丢失与队列阻塞
spring boot·后端·rabbitmq
Java水解7 天前
Spring Boot 视图层与模板引擎
spring boot·后端
Java水解7 天前
一文搞懂 Spring Boot 默认数据库连接池 HikariCP
spring boot·后端
Yz_fore7 天前
地图美化方案-房型图
机器人