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
- 我这里是单纯的发送文字,更多的可以发送图片、链接、附件等,具体参考文档
@Data
@Accessors(chain = true)
public class Publisher {private String msgtype;private Media file;private Text text;
}
@Data
@Accessors(chain = true)
public class Text {private String content;private List<String> mentioned_list;private List<String> mentioned_mobile_list;
}
@Data
@Accessors(chain = true)
public class Media {private String media_id;
}
4、创建一个接口发送实现类,如果只有一种发送方式,可以不用接口,我这里用了两种方式,分别是通过单纯的http请求的方式发送请求,另一种是通过feignClient的方式进行接口请求,所以使用了接口。
public interface ISenderService {void send(Publisher publisher) throws Exception;
}
5、第一种:使用基础的http请求方式调用企微机器人,这是比较简单的方式,我这里就不提供HttpUtil类的代码了,相信你自己的项目中这种util类肯定会有的,代码相对简单,不同项目会有一些不同,但基本都大同小异。
- 这里的wechatrobot.url配置在配置文件中进行配置,配置的就是上面我们获取到的企微机器人的Webhook地址了
@Service
public class HttpSender implements ISenderService {@Value("${wechatrobot.url}")private String url;@Overridepublic 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)
@Service
public class FeginClientSender implements ISenderService{@Autowiredprivate WechatRobotActions wechatRobotActions;@Overridepublic void send(Publisher publisher) throws Exception {wechatRobotActions.publish(publisher);}
}
@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
wechatrobot:url: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa
8、测试类,并不复杂,相信都会写
@SpringBootTest
class ISenderServiceTest {@Autowiredprivate HttpSender httpSender;@Autowiredprivate FeginClientSender feginClientSender;@Testvoid send() throws Exception {Publisher publisher = new Publisher();publisher.setMsgtype("text");publisher.setText(new Text().setContent("我是甲鱼王,咿呀咿呀哟"));httpSender.send(publisher);}@Testvoid send1() throws Exception {Publisher publisher = new Publisher();publisher.setMsgtype("text");publisher.setText(new Text().setContent("我也是甲鱼王,咿呀咿呀哟"));feginClientSender.send(publisher);}
}
9、实践
上面说了也可以发送图片,包括链接等,类似于下面这种
代码如下,实体类相信自己懂得修改
@Testvoid 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);}