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

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

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博客

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

企业微信自建应用开发是指在企业微信平台上开发自己的应用程序,以满足企业内部的特定需求或提供特定的服务。下面是企业微信自建应用开发的一般步骤: 1. 注册企业微信开发者账号:首先需要在企业微信官方网站上注册一个开发者账号,并获取相应的开发者权限。 2. 创建自建应用:在企业微信管理后台创建自建应用,填写应用基本信息,如应用名称、Logo、应用可见范围等。 3. 开发应用功能:根据需要,在企业微信开发文档中了解开发接口和功能,并进行相应的开发工作。可以通过使用企业微信提供的API,实现消息推送、成员管理、审批流程等功能。 4. 配置权限和回调URL:根据应用的功能需求,配置相应的权限和回调URL。权限设置决定了应用能够访问和操作的范围,回调URL用于接收企业微信平台的事件通知。 5. 测试与发布:在开发完成后,进行本地测试,确保应用功能正常。然后将应用提交给企业微信进行审核,并在审核通过后发布到企业微信管理后台。 6. 安装与使用:安装自建应用企业微信中,然后企业成员可以在企业微信中使用该应用。 需要注意的是,企业微信开发涉及到一些安全和权限的问题,开发者需要严格按照企业微信的开发规范和安全要求进行开发,确保应用的安全性和可用性。此外,开发者还可以参考企业微信提供的开发文档和示例代码进行开发工作。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值