企业微信自建应用收发消息

小橘快跑

已于 2024-05-21 20:04:26 修改

阅读量3k

点赞数 10

分类专栏：企业微信文章标签：企业微信 java

于 2024-04-18 14:35:44 首次发布

本文链接：https://blog.csdn.net/qq_50761817/article/details/137919422

版权

企业微信专栏收录该内容

2 篇文章

订阅专栏

本文介绍了如何在自建应用中开通企业微信API接收消息功能，包括设置回调地址、解密企业微信响应的XML数据，以及处理GET和POST请求。还涉及到了AesException的解决和XML转实体的POM依赖配置。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1、需要开通api接收消息功能

参考企业微信地址：
概述 - 接口文档 - 企业微信开发者中心
2、实现回调地址调用逻辑

（由于此处调用地址和后续应用推送消息的地址一致，代码便整合在一起）

3、代码实现后，点击第一步中的保存按钮，则会开通成功！成功图如下所示：

4、实现企业微信回调接口

    String sToken = "";自建应用中的开通api接口消息详情里的sToken
    String sCorpID = ""; //企业微信后台的企业微信id
    String sEncodingAESKey = ""; 自建应用的开通api接口消息详情里的sEncodingAESKey 
/**
     * @param params  可以接收到请求地址中所有拼接的参数
     * @param xmlData 获取到企业微信响应的xml数据
     * @param request 获取请求类型，因为在自建应用中添加接收api时用的是get请求，接收企业微信收到的消息时用的是post请求，当前处理只做消息接收，未添加消息安全性校验
     * @return
     * @throws Exception
     */
    @RequestMapping("/qw/test")
    private String test(@RequestParam MultiValueMap<String, String> params, @RequestBody String xmlData, HttpServletRequest request) throws Exception {
        String method = request.getMethod();
        WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);

        if (method.equals("GET")) {
            try {
                //解密消息并将明文返回给企业微信，即可以开通api接收消息
                String sEchoStr = wxcpt.VerifyURL(params.toSingleValueMap().get("msg_signature"), params.toSingleValueMap().get("timestamp"),
                        params.toSingleValueMap().get("nonce"), params.toSingleValueMap().get("echostr"));
                return sEchoStr;
            } catch (Exception e) {
                //验证URL失败，错误原因请查看异常
                e.printStackTrace();
            }

        } else {
            //对接收到的消息进行校验
            String sMsg = wxcpt.DecryptMsg(params.toSingleValueMap().get("msg_signature"), params.toSingleValueMap().get("timestamp"),
                    params.toSingleValueMap().get("nonce"), xmlData);
            //将接口中的xmlData 转换为对象
            XmlMapper xmlMapper = new XmlMapper();
            QwDecryptVo decryptVo = xmlMapper.readValue(sMsg, QwDecryptVo.class);
            System.out.println("发送人-->" + decryptVo.getFromUserName() + "；内容--->" + decryptVo.getContent());
            //可添加相应业务处理，然后给用户发确认消息
            String sRespData = "<xml><ToUserName><![CDATA["+decryptVo.getFromUserName()+"]]></ToUserName><FromUserName><![CDATA["+ decryptVo.getToUserName() +"]]></FromUserName><CreateTime>"+new DateTime().getTime() +"</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[已收到该条消息]]></Content><MsgId>"+System.currentTimeMillis()+"</MsgId><AgentID>"+decryptVo.getAgentID()+"</AgentID></xml>";
            return wxcpt.EncryptMsg(sRespData, "", System.currentTimeMillis()+"");
        }
        return null;
    }

sToken 和 sEncodingAESKey 在点击查看消息后所展示的：

5、下载上一步加解密的util包到本地项目

下载地址：加解密库下载与返回码 - 接口文档 - 企业微信开发者中心

6、解决下载的类AesException报错

使用NotePad++ 打开 AesException 类文件，并转码为 utf-8 编码格式保存即可解决

7、xml 转实体所需pom依赖

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
</dependency>

8、xml对应的实体对象

@JacksonXmlRootElement(localName = "xml")
@Data
public class QwDecryptVo {

    @JacksonXmlProperty(localName = "ToUserName")
    private String toUserName;

    @JacksonXmlProperty(localName = "FromUserName")
    private String fromUserName;

    @JacksonXmlProperty(localName = "CreateTime")
    private String createTime;
    @JacksonXmlProperty(localName = "MsgType")
    private String msgType;
    @JacksonXmlProperty(localName = "Content")
    private String content;
    @JacksonXmlProperty(localName = "MsgId")
    private String msgId;
    @JacksonXmlProperty(localName = "AgentID")
    private String agentID;


}

9、解决java.security.InvalidKeyException: Illegal key size报错
参考企业微信接口回调异常java.security.InvalidKeyException: Illegal key size 的解决方法（已解决）_java21 java.security.invalidkeyexception: illegal -CSDN博客

至此，已成功实现接收企业微信自建应用消息！！！