企业微信通讯录回调通知开发-成员变更

源自：http://www.jylt.cc/#/detail?id=e1c59639475dba2003f95c5370c1e976

回调配置

1. 
2. 
3. 

url配置说明

1. 验证URL有效性
2. 官方开发库下载，使用该开发库能够快速的完成url有效性校验及数据的加解密操作
   java库文件说明

   • com\qq\weixin\mp\aes目录下是用户需要用到的接入企业微信的接口，其中WXBizMsgCrypt.java文件提供的WXBizMsgCrypt类封装了用户接入企业微信的三个接口，其它的类文件用户用于实现加解密，用户无须关心。sample.java文件提供了接口的使用示例。
   • WXBizMsgCrypt封装了VerifyURL, DecryptMsg, EncryptMsg三个接口，分别用于开发者验证接收消息的url、接收消息的解密以及开发者回复消息的加密过程。使用方法可以参考Sample.java文件。
   • 请开发者使用jdk1.6或以上的版本。针对org.apache.commons.codec.binary.Base64，需要导入jar包commons-codec-1.9（或comm ons-codec-1.8等其他版本），我们有提供，官方下载地址：下载
   • 异常java.security.InvalidKeyException:illegal Key Size的解决方案：在官方网站下载JCE无限制权限策略文件（请到官网下载对应的版本， 例如JDK7的下载地址：http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html )：下载后解压，可以看到local_policy.jar和US_export_policy.jar以及readme.txt。
     如果安装了JRE，将两个jar文件放到%JRE_HOME% \lib\security目录下覆盖原来的文件，如果安装了JDK，将两个jar文件放到%JDK_HOME%\jre\lib\security目录下覆盖原来文件。

3. 服务器端写一个接口，供验证URL有效性的时候使用
   示例：比如用户设置的URL为https://demo.qq.com

    @ResponseBody
    @RequestMapping("/")
    public String request(HttpServletRequest request) throws AesException, ParserConfigurationException, IOException, SAXException {
        parameterMap.forEach((key, value) -> log.info("param:name={}, value={}", key, Arrays.toString(value)));

        WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);
        String sVerifyMsgSig = request.getParameter("msg_signature");
        String sVerifyTimeStamp = request.getParameter("timestamp");
        String sVerifyNonce = request.getParameter("nonce");
        String sVerifyEchoStr = request.getParameter("echostr");

        String sEchoStr; //需要返回的明文
        try {
            // 验证URL成功，将sEchoStr返回
            return wxcpt.VerifyURL(sVerifyMsgSig, sVerifyTimeStamp,
                    sVerifyNonce, sVerifyEchoStr);
        } catch (Exception e) {
            //验证URL失败，错误原因请查看异常
            e.printStackTrace();
        }
        return null;
    }

官方接口说明

• 接口地址：成员变更通知
• 具体通知实现请参考：接口示例

遇到的问题

新增用户时无法获取用户的openid

新增用户时，虽然可以获取到用户的userid，但是此时用户没有使用微信登录企业微信并且也没有关注微工作台，导致通过使用接口userid转openid时出现错误，错误信息如下：

“errcode”:43004,“errmsg”:“require subscribe, hint: [1602639092_53_8a5db05a924c2a8ab7d1e5d4bb5c13a1], from ip: *********, more info at https://open.work.weixin.qq.com/devtool/query?e=43004”

解决方案
此时可以先记录下用户的userid，当用户登录企业微信后会触发更新成员事件，此时就可以根据userid获取到用户的openid了。

使用建议

经过这次开发，发现使用企业微信用户信息时使用userid要比使用openid更方便些，用户userid在获取用户信息的时候是可以直接拿的到的，而openid需要经过userid进行转换，有些情况下转换还会不成功。