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;
@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)
@Service
public class FeginClientSender implements ISenderService{
@Autowired
private WechatRobotActions wechatRobotActions;
@Override
public 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 {
@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、实践
上面说了也可以发送图片,包括链接等,类似于下面这种
代码如下,实体类相信自己懂得修改
@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);
}