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
• 我这里是单纯的发送文字，更多的可以发送图片、链接、附件等，具体参考文档

@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);
    }