Java企业微信对接（二）微信端回调到企业端

最新推荐文章于 2025-07-01 14:19:16 发布
最新推荐文章于 2025-07-01 14:19:16 发布
阅读量1.8k 收藏 7
点赞数 2
CC 4.0 BY-SA版权
分类专栏： 企业微信对接 文章标签： java 企业微信 微信
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/woshiwangdaye/article/details/127189360
本文介绍了Java环境下企业微信回调服务的配置与实现，包括回调的必要性、配置的URL、Token和EncodingAESKey，以及如何实现两个回调接口，一个用于验证URL有效性，另一个用于接收回调数据。回调服务能够实现自定义服务行为和及时获取状态变化。文章提供了具体的代码示例，强调了回调域名的配置要求。

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

准备工作

先下载demo
在这里插入图片描述

在这里插入图片描述
在这里插入图片描述
下载完成后的目录，把这些类之间copy到工程里面就行，都是封装好的加密算法
在这里插入图片描述

回调配置

什么时候需要回调

在集成企业微信与内部系统时，我们往往需要搭建一个回调服务。回调服务，可以实现：

自定义丰富的服务行为。比如，用户向应用发消息时，识别消息关键词，回复不同的消息内容；用户点击应用菜单时，转化为指令，执行自动化任务。
可以及时获取到状态变化。比如，通讯录发生变化时，不需要定时去拉取通讯录对比，而是实时地获取到变化的通讯录结点，进行同步。

回调服务需要哪些配置

配置回调服务，需要有三个配置项，分别是：URL, Token, EncodingAESKey。
首先，URL为回调服务地址，由开发者搭建（需要满足接口要求，参考第3部分说明），用于接收通知消息或者事件。
在这里插入图片描述
其次，Token用于计算签名，由英文或数字组成且长度不超过32位的自定义字符串。开发者提供的URL是公开可访问的，这就意味着拿到这个URL，就可以往该链接推送消息。
在这里插入图片描述
最后，EncodingAESKey用于消息内容加密，由英文或数字组成且长度为43位的自定义字符串。由于消息是在公开的因特网上传输，消息内容是可被截获的，如果内容未加密，则截获者可以直接阅读消息内容。若消息内容包含一些敏感信息，就非常危险了。EncodingAESKey就是在这个背景基础上提出，将发送的内容进行加密，并组装成一定格式后再发送。
在这里插入图片描述

回调逻辑实现

需要有2个回调接口，
一个get请求，用来验证url 是否有效
一个post请求，用来接收回调数据

企业微信会先判断URL服务是否具备解析企业微信推送消息的能力。
具体方式是，企业微信往URL服务上发一条Get请求带签名及密文参数到URL服务上，如果URL服务检查签名通过，并能正确返回密文参数对应的明文字符串，则验证通过。此时在企业微信的配置就开始生效。
后续的业务请求（比如应用菜单的点击事件，用户消息等），都会类似的方式（签名+密文）向服务URL推送消息。URL服务验证签名通过后，需要将POST数据解密，就可以得到对应的业务消息明文。

在这里插入图片描述

话不多说，直接上代码，准备2个接口

    /**
     * 验证微信回调地址
     *
     * @author: what
     */
    String verifyURL(String msgSignature, String timestamp, String nonce, String echostr);

    /**
     * 企业微信回调数据
     *
     * @author: what
     */
    String decryptMsg(String msgSignature, String timestamp, String nonce, String postData);

实现类

定义常量

    public static final String CHANGE_TYPE = "ChangeType";
    public static final String CHANGE_TYPE_USER = "_user";
    public static final String CHANGE_TYPE_ORG = "_party";
    public static final String CHANGE_TYPE_ACTION_CREATE = "create";
    public static final String CHANGE_TYPE_ACTION_UPDATE = "update";
    public static final String CHANGE_TYPE_ACTION_DELETE = "delete";
    public static final String DATA_CHANGE_TYPE_USER = "UserID";
    public static final String DATA_CHANGE_TYPE_ORG = "ParentId";

    public static final String ERR_CODE = "errcode";
    public static final String ERR_MSG = "errmsg";
    public static final String UTF_8 = "utf-8";
    public static final String APPLICATION = "application/json";
    public static final String SECRET = "xJLwef4564dfgjc19fdfghd245sddfs-XSc";
    public static final String HTTP_URL_CREATE_USER = "https://qyapi.weixin.qq.com/cgi-bin/user/create?access_token=";
    public static final String HTTP_URL_UPDATE_USER = "https://qyapi.weixin.qq.com/cgi-bin/user/update?access_token=";
    public static final String HTTP_URL_DELETE_USER = "https://qyapi.weixin.qq.com/cgi-bin/user/batchdelete?access_token=";
    public static final String HTTP_URL_CREATE_ORG = "https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=";
    public static final String HTTP_URL_UPDATE_ORG = "https://qyapi.weixin.qq.com/cgi-bin/department/update?access_token=";
    public static final String HTTP_URL_DELETE_ORG = "https://qyapi.weixin.qq.com/cgi-bin/department/delete?access_token=";

    String sToken = callbackToken;--这个对应下图中的Token
    String sCorpID = appid;--这个对应企业ID
    String sEncodingAESKey = callbackAesKey;--这个对应下图中的EncodingAESKey

在这里插入图片描述

验证url是否有效，用于get请求

    /**
     * 验证微信回调地址
     *
     * @author: what
     */
    @Override
    public String verifyURL(String msgSignature, String timestamp, String nonce, String echostr){
        String sToken = callbackToken;
        String sCorpID = appid;
        String sEncodingAESKey = callbackAesKey;

        WXBizMsgCrypt wxcpt = null;
        String sEchoStr = null;
        try {
            wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);
            sEchoStr = wxcpt.verifyURL(msgSignature, timestamp, nonce, echostr);
            log.info("验证微信回调地址------------------" + sEchoStr);
        } catch (AesException e) {
            e.printStackTrace();
        }
		return sEchoStr;
    }

接收回调数据，用于post请求

    /**
     * 企业微信回调数据（返回的数据是xml格式，需要把xml转换成json格式）
     *
     * @author: what
     */
    @Override
    public String decryptMsg(String msgSignature, String timestamp, String nonce, String postData){

        String result = "企业微信通讯录回调成功";
        String sToken = callbackToken;
        String sCorpID = appid;
        String sEncodingAESKey = callbackAesKey;
        WXBizMsgCrypt wxcpt = null;
        String sMsg = "";

            try {
                wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);
                sMsg = wxcpt.decryptMsg(msgSignature, timestamp, nonce, postData);
                if(StringUtils.isNotBlank(sMsg)){
                    JSONObject jsonObject = Xml2JsonTool.xmltoJson(sMsg);
                    JSONObject xml = jsonObject.getJSONObject("xml");
                    //如果包含UserID，就是用户数据变更，如果包含ParentId，就是部门数据变更
                    if(sMsg.indexOf(PubConstant.DATA_CHANGE_TYPE_USER) > 0){
                        if(xml.getString(PubConstant.CHANGE_TYPE).equals(PubConstant.CHANGE_TYPE_ACTION_CREATE + PubConstant.CHANGE_TYPE_USER)){
                            //添加用户逻辑
                        }else if(xml.getString(PubConstant.CHANGE_TYPE).equals(PubConstant.CHANGE_TYPE_ACTION_UPDATE + PubConstant.CHANGE_TYPE_USER)){
                            //修改用户逻辑
                        }else if(xml.getString(PubConstant.CHANGE_TYPE).equals(PubConstant.CHANGE_TYPE_ACTION_DELETE + PubConstant.CHANGE_TYPE_USER)){
                            //删除用户逻辑
                        }
                    }else if(sMsg.indexOf(PubConstant.DATA_CHANGE_TYPE_ORG) > 0){
                        if(xml.getString(PubConstant.CHANGE_TYPE).equals(PubConstant.CHANGE_TYPE_ACTION_CREATE + PubConstant.CHANGE_TYPE_USER)){
							//添加部门逻辑
                        }else if(xml.getString(PubConstant.CHANGE_TYPE).equals(PubConstant.CHANGE_TYPE_ACTION_UPDATE + PubConstant.CHANGE_TYPE_USER)){
							//修改部门逻辑
                        }else if(xml.getString(PubConstant.CHANGE_TYPE).equals(PubConstant.CHANGE_TYPE_ACTION_DELETE + PubConstant.CHANGE_TYPE_USER)){
							//删除部门逻辑
                        }
                    }
                }

            } catch (Exception e) {
                e.printStackTrace();
            }
        
        return result;
    }

controller

get请求，用于验证url有效

    @ApiOperation(value = "企业微信回调接口验证", notes = "对接人:what")
    @RequestMapping(value = "/callback", method = RequestMethod.GET, produces = "application/json")
    public void reveiceMsg(
            @RequestParam(name = "msg_signature") final String msgSignature,
            @RequestParam(name = "timestamp") final String timestamp,
            @RequestParam(name = "nonce") final String nonce,
            @RequestParam(name = "echostr") final String echostr,
            final HttpServletResponse response) throws Exception {
        String sEchoStr = wxService.verifyURL(msgSignature, timestamp, nonce, echostr);
        PrintWriter out = response.getWriter();
        try {
            //必须要返回解密之后的明文
            if (StringUtils.isNotBlank(sEchoStr)) {
                log.info("企业微信回调接口验证成功~~~");
            } else {
                log.info("企业微信回调接口验证失败！！！");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        out.write(sEchoStr);
        out.flush();
    }

post请求用户接收回调数据

    @ApiOperation(value = "企业微信回调接口", notes = "对接人:what")
    @RequestMapping(value = "/callback", method = RequestMethod.POST, produces = "application/json")
    public JsonResult reveiceMsg(final HttpServletRequest request,
                                 @RequestParam(name = "msg_signature") final String sMsgSignature,
                                 @RequestParam(name = "timestamp") final String sTimestamp,
                                 @RequestParam(name = "nonce") final String sNonce) throws Exception {

        InputStream inputStream = request.getInputStream();
        String sPostData = IOUtils.toString(inputStream, "UTF-8");
        log.info("回调数据返回================" + sPostData);
        String sEchoStr = wxService.decryptMsg(sMsgSignature, sTimestamp, sNonce, sPostData);
        return JsonResult.ok(sEchoStr);
    }

配置回调域名

一定要记得配置url，必须是备案域名，还有就是ip可信名单，其他的按照这里写基本就没问题了

Java企业微信对接
岁月不饶人，我亦未曾饶过岁月
12-01 2154
最近项目中要对接企业微信，实现通讯录数据同步，即在企业端添加编辑删除用户，部门数据要同步到微信端，同时微信端添加编辑删除用户，部门数据要同步到企业端，实现数据同步功能，需要调用企业微信API和通讯录回调接口，下面就把对接过程中遇到的各种问题，各种坑记录下来分享给需要的同学
Java对接微信支付全过程详解
在技术的广袤天地里，本博客如精准罗盘。剖析前沿科技，深掘代码奥秘，以精炼笔触，带您穿越复杂技术迷宫，速达知识彼岸。
03-07 8304
本文将以系统性、实战性为导向，深入剖析Java对接微信支付的核心流程与关键技术。无论是Native支付、JSAPI支付还是小程序支付，其底层逻辑均围绕预支付订单生成、支付结果异步通知、订单状态主动查询三大核心环节展开。文章不仅提供清晰的代码示例（基于Spring Boot框架与微信支付V3 API），更聚焦于实际开发中的高频痛点：如何通过RSA签名保障通信安全？如何设计幂等回调接口避免重复扣款？如何利用微信平台证书防止伪造请求？这些问题将在文中逐一击破。
微信企业号回调模式配置详细讲解
Jie的博客
07-28 1万+
对于微信企业号，我相信很多人都不陌生了，今天跟大家一起来探讨一下用java怎么去实现微信企业号回调模式配置。 为什么需要开启回调模式？ 对于这点，我相信官方文档中说得比我更清楚，但是我还是想大家熟悉一下什么是回调模式，说白了就是当你有一个属于自己的企业应用，通过用户关注这个微信企业号，希望用户发送的消息或者用户触发的事件都推送到你这个企业应用中处理，此时的你就会用到回调模式，只有开发人员开启了
（JAVA）自建应用调用企业微信API接口，实现消息推送
最新发布
TinpeaV的博客
07-01 2066
自建应用调用企业微信api接口进行消息推送，对企业微信开发者文档进行详细介绍，本文使用到了java+springboot+redis+redisson+Spring-WebFlux（WebClient）技术，可当作调用接口的实战代码。
java实现企业微信回调配置案例
12-10
java实现--企业微信回调配置案例及工具代码
Java实现企业微信回调配置
热门推荐
天王盖地虎的博客
02-21 1万+
在集成企业微信与内部系统时，我们往往需要搭建一个回调服务，本贴基于Java实现企业微信回调配置
微信企业号回调模式实例（Java版）
11-06
微信企业号回调模式实例（Java版） 认真阅读word文档，按照步骤实行，琢磨了一个礼拜，只收一分。
java配置企业微信回调
weixin_40311442的博客
07-01 535
配置,微信相关视频讲解：C语言程序设计入门之环境安装AIGC和微信的辅助学习Java配置企业微信回调 企业微信是一款专门为企业打造的沟通工具，可以帮助企业实现内外部的沟通与协作。其中，回调功能可以帮助企业实现与其他系统的对接，实现信息的实时推送和同步。 在Java开发中，我们可以通过配置企业微信回调接口，实现企业微信消...
企业微信回调模式建立连接需要的java类和jar包，JAVA
04-24
企业微信回调模式建立连接需要的java类和jar包，JAVA方面的代码， 包含7个java类和一个jar包，企业微信回调模式建立连接需要的java类和jar包，JAVA方面的代码， 包含7个java类和一个jar包
Java后台微信企业转账到零钱
07-17
在本文中，我们将深入探讨如何使用Java在后台实现微信企业转账到个人零钱的功能。这个功能通常用于企业向员工支付工资、奖金或者处理退款等业务场景。为了实现这一功能，我们需要掌握以下几个关键知识点： 1. **...
springboot对接微信小程序支付以及回调详细代码
10-09
以上就是使用SpringBoot对接微信小程序支付以及回调的完整流程。这个过程中，我们从创建支付订单到接收和处理支付回调，都进行了详细讲解。确保所有步骤正确执行，就可以实现一个功能完善的微信支付系统。在实际开发...
微信企业号回调接口
11-08
微信企业号回调接口
微信企业号回调模式例子
11-12
微信企业号开发模式接通WeiXinEnterprises微信企业号回调模式例子
微信企业号回调实例.zip
05-09
微信企业号回调消息的加密方案说明，回调模式的开启案实例（python,java,php）
Java企业微信通用开发配置源代码
01-23
用最简单的Servlet实现企业微信通用开发配置，有需要的小伙伴可以看看！
java实现微信企业号和公众号服务端调用方法封装源码
04-26
1、微信企业号服务端调用方法java源码实现 1.1 获取AccessToken 1.2 发送文本消息 1.3 发送消息（包括文本、图像、声音、视频、文件、图文） 1.4 上传素材文件 1.5 获取素材文件 1.6 获取应用素材总数以及每种类型素材的数目 1.7 创建菜单 1.8 删除菜单 1.9 获取菜单列表 2、微信公众号服务端调用方法java源码实现 2.1 在回调模式下验证服务器接口地址 2.2 检验消息的真实性，并且获取解密后的明文. 2.3 将公众平台回复用户的消息加密打包. 2.4 获取AccessToken 2.5 获取网页授权access_token 2.6 获取临时素材文件（不包括视频） 2.7 下载临时素材文件 2.8 发送文本消息 2.9 发消息（包括文本消息、图像、声音、视频、文件、图文、微信后台图文） 2.10 创建菜单 2.11 删除菜单 2.12 获取菜单列表 2.13 获取用户列表 2.14 获取用户基本信息（包括UnionID机制）
java 接收企业微信回调
weixin_37063090的博客
07-16 462
Java 接收企业微信回调：实现与流程解析 企业微信作为企业通讯和办公自动化的重要工具，其提供的回调功能可以让开发者实现自动化的业务流程。本文将介绍如何在Java中接收企业微信的回调，并展示整个流程。 回调流程概述 企业微信的回调机制允许开发者在接收到特定事件时执行自定义逻辑。常见的回调事件包括消息接收、用户操作等。整个流...
企业微信回调实现（java）
choviwu的博客
10-12 7098
前提：这里只针对企业微信（下称企微）内部联系人和外部联系人的回调举例和编码，暂时未贴出回复被动消息等回调，示例语言为java。 文章目录企微API下载demo企业微信后台配置接口地址三个参数接口实现 企微API下载demo 地址：企微java的实现 下载下来得到了如下五个类： 这里为不影响篇幅我就不贴出代码，因为太tm多了。 需要发的就一个类（是我自己实现的，解密xml的工具类） ** 注：前提是maven仓库中有dom4j的依赖，版本自己去定义，我这里用的springboot自带的1.6.x** &.
企业微信java后台开发，回调笔记
weixin_45129171的博客
04-09 894
企业微信java后台开发 最近公司项目组开发企业微信第三方应用，第一次接触企业微信，于是在网上找了一些博文，仅供自己参考学习[https://www.cnblogs.com/uniles/p/11734133.html]) ...
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

珍妮玛•黛金

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值