企业微信开发（2）——授权安装应用回调

一、前言

前提：第三方服务商已注册并安装第三方应用，并且在第三方应用已经配置回调，且第三方的回调服务地址可用。本节介绍应用授权安装后回调逻辑，变更应用可见性回调逻辑，外部联系人回调逻辑，

二、授权回调

在企业在企业微信后台安装我们的应用时，会有授权回调，首先需要获取永久授权码并保存在自己的应用数据库。
1、获取永久授权码
获取永久授权码
将安装了我们应用的企业放在本地数据库

permanent_code和corpid等相关信息做保存

这里需要将应用可见人、可见部门、可见标签都存起来，方便日后成员变更时用
相关代码如下：

		//调用企业微信接口
        String url = "https://qyapi.weixin.qq.com/cgi-bin/service/get_permanent_code?suite_access_token=" + wx2CpThirdService.getSuiteAccessToken();

        //传递参数
        Map<String, Object> paramMap = new HashMap<>(2);
        paramMap.put("auth_code", tempCode);

        //调用
        String postData = HttpUtil.sendPost(url, JSONObject.toJSONString(paramMap));
        log.info("接口调用成功返回postData==" + postData);

        JSONObject jsonObject = JSONObject.parseObject(postData);

        //获取相关信息并存取
        String corpId = jsonObject.getJSONObject("auth_corp_info").getString("corpid");
        if (StringUtils.isBlank(corpId)) {
            log.error("corpId不存在");
            return false;
        }
        Integer count = lambdaQuery().eq(CpThirdConfig::getCorpId, corpId).eq(CpThirdConfig::getSuiteId, wx2CpThirdProperties.getSuiteId2()).count();
        //先删除相同的corpId
        if (count > 0) {
            return false;
        }

        String permanentCode = jsonObject.getString("permanent_code");
        String corpName = jsonObject.getJSONObject("auth_corp_info").getString("corp_name");

        //文档说，对新的单应用授权，永远只返回一个agent
        JSONObject agentJson = jsonObject.getJSONObject("auth_info").getJSONArray("agent").getJSONObject(0);
        //存取企业的agentId
        String agentId = agentJson.getString("agentid");

        //存取应用可见的人员
        JSONArray allowUserArray = agentJson.getJSONObject("privilege").getJSONArray("allow_user");


        //应用可见部门
        JSONArray allowPartyArray = agentJson.getJSONObject("privilege").getJSONArray("allow_party");


        //应用可见标签
        JSONArray allowTagArray = agentJson.getJSONObject("privilege").getJSONArray("allow_tag");
		 //保存第三方应用信息im_cp_third_config表
        CpThirdConfig cpThirdConfig = new CpThirdConfig();
        cpThirdConfig.setCorpId(corpId)
                .setPermanentCode(permanentCode)
                .setSuiteId(wx2CpThirdProperties.getSuiteId2())
                .setCorpName(corpName)
                .setAgentId(agentId)
                .setAllowUser(ObjectUtils.allNotNull(allowUserArray) ? allowUserArray.toJSONString() : null)
                .setAuthUserInfo(authUserInfo)
                .setReturnData(postData)
                .setAllowParty(ObjectUtils.allNotNull(allowPartyArray) ? allowPartyArray.toJSONString() : null)
                .setAllowTag(ObjectUtils.allNotNull(allowTagArray) ? allowTagArray.toJSONString() : null);

        this.save(cpThirdConfig);

2、生成可见人员角色、管理员角色
根据corid为每一个企业生成三个管理员角色，分别是超级管理员、管理员、可见人员，并且为对应的角色分配不同的菜单权限
涉及到菜单表、菜单角色表
3、保存管理员信息（可见人员不设为管理员，将应用的管理员作为管理员）
将第三方应用到管理员作为我们应用后台管理到管理员，这里很容易混淆。
第三方应用管理员可以在企业微信管理后台设置，理论上，企业微信超级管理员是所有应用的管理员，可以为用户设置单独的应用管理员

可以在管理组设置管理范围和通讯录权限

4、保存可见人员信息
将可见人员单独设一张表，方便以后业务需要
这个地方有个坑
企业微信在获取永久授权吗的时候，返回的可见人员不包含部门内和标签内的可见人员，即当可见范围里面既有可见人员又有可见部门还有可见标签时，返回的会是可见人员、可见部门id、可见标签id，需要再根据可见部门id、可见标签id去查询该部门或者标签内所有的可见人员，这里做的是一个并集的操作。


根据部门id获取部门内成员的userid
根据标签id获取标签内成员的userid

/**
     * 保存可见人员数据到im_cp_allow_user表
     *
     * @param
     * @return
     */
    private Set<String> addAllowUser(String corpId, JSONArray allowUserArray, JSONArray allowPartyArray, JSONArray allowTagArray) {
        //1、可见人员集合（非部门和标签内的可见人员）
        Set<String> allowUserSet = new HashSet<>();
        if (allowUserArray.size() > 0) {
            log.info("应用可见的人员allowUserArray==" + allowUserArray);
            Object[] allowUserObject = allowUserArray.toArray();
            for (int i = 0; i < allowUserObject.length; i++) {
                String allowUser = (String) allowUserObject[i];
                log.info("可见人员allowUser==" + allowUser);
                allowUserSet.add(allowUser);
            }
        }
        log.info("非部门和标签内的可见人员allowUserSet==" + allowUserSet);


        //2、可见人员集合（部门内的可见人员）
        Set<String> partysUserIdSet = new HashSet<>();
        //遍历可见部门，获取可见部门成员
        if (allowPartyArray.size() > 0) {
            log.info("应用可见部门allowPartyArray==" + allowPartyArray);
            Object[] allowPartyObject = allowPartyArray.toArray();
            for (int i = 0; i < allowPartyObject.length; i++) {
                //可见部门id
                int allowPartyId = (int) allowPartyObject[i];
                log.info("可见部门id,allowPartyId==" + allowPartyId);
                //根据部门id获取该部门成员的userid的set集合
                Set<String> partyUserIdSet = getPartyUserIdSet(corpId, allowPartyId);
                log.info("partyUserIdSet==" + partyUserIdSet);
                partysUserIdSet.addAll(partyUserIdSet);
            }

        }
        log.info("部门内的可见人员集合partysUserIdSet==" + partysUserIdSet);

        //3、可见人员集合（标签内的可见人员）
        Set<String> tagsUserIdSet = new HashSet<>();
        //遍历可见标签，获取可见标签成员
        if (allowTagArray.size() > 0) {
            log.info("应用可见标签allowTagArray==" + allowTagArray);
            Object[] allowTagObject = allowTagArray.toArray();
            for (int i = 0; i < allowTagObject.length; i++) {
                //可见标签id
                int allowTagId = (int) allowTagObject[i];
                log.info("可见标签id,allowPartyId==" + allowTagId);
                //根据标签id获取该标签内成员的userid的set集合
                Set<String> tagUserIdSet = getTagUserIdSet(corpId, allowTagId);
                log.info("tagUserIdSet==" + tagUserIdSet);
                tagsUserIdSet.addAll(tagUserIdSet);
            }

        }
        log.info("标签内的可见人员集合tagsUserIdSet==" + tagsUserIdSet);

        //总的可见人员集合，包含allow_user、allow_tag、allow_party的可见人员
        Set<String> allowUsersSet = new HashSet<>();
        allowUsersSet.addAll(allowUserSet);
        allowUsersSet.addAll(partysUserIdSet);
        allowUsersSet.addAll(tagsUserIdSet);
        log.info("总的可见人员集合allowUsersSet==" + allowUsersSet);

        //CpAllowUser集合
        List<CpAllowUser> cpAllowUserList = new ArrayList<>();
        //遍历
        for (String allowUserId : allowUsersSet) {
            CpAllowUser cpAllowUser = new CpAllowUser()
                    .setCorpId(corpId).setAllowUserId(allowUserId);

            cpAllowUserList.add(cpAllowUser);
        }
        log.info("CpAllowUser集合cpAllowUserList==" + cpAllowUserList);
        //批量插入数据
        cpAllowUserService.saveBatch(cpAllowUserList);
        log.info("批量插入cpAllowUserList数据成功！");
        return allowUsersSet;
    }

5、添加默认的物料信息
文章、活动、微沙盘、默认项目
6、保存外部联系人信息
说明：1、外部联系人信息仅针对应用可见人员而言
2、可见人员必须拥有外部联系人权限，建议企业需要将所有置业顾问添加客户联系权限
可见人员必须拥有外部联系人权限在企业微信后台配置：

public Boolean savaExternalUserid(String corpId) {
        log.info("开始添加外部联系人了！");
        //1、获取配置了客户联系功能的成员列表
        List<String> followUserList = getFollwUserList(corpId);
        log.info("成员列表followUserList==" + followUserList);
        if (followUserList == null) {
            return false;
        }

        //2、遍历成员列表，获取客户列表
        String extUserUrl = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list";
        for (String userid : followUserList) {
            List<CpExternalConcatUser> cpExternalConcatUserList = new ArrayList<>();
            String extUserParam = "access_token=" + getAccessToken(corpId) + "&userid=" + userid;

            String extUseGetData = HttpUtil.sendGet(extUserUrl, extUserParam);
            log.error("extUseGetData===" + extUseGetData);
            JSONObject jsonObject2 = JSONObject.parseObject(extUseGetData);
            List<String> extUserList = JSONObject.parseArray(jsonObject2.getString("external_userid"), String.class);
            log.error("extUserList===" + extUserList + "\tuserid===" + userid);

            //如果该用户没有外部联系人，continue
            if (extUserList.size() == 0 || extUserList == null) {
                continue;
            }
            //3、遍历客户列表，获取客户详情
            itratorExUserList(corpId, cpExternalConcatUserList, userid, extUserList);
            log.info("外部联系人客户列表cpExternalConcatUserList==" + cpExternalConcatUserList);
            //4、批量添加外部联系人客户
            boolean addExternalUser = cpExternalConcatUserService.saveBatch(cpExternalConcatUserList);
            log.info("批量添加外部联系人成功！");
            if (!addExternalUser) {
                log.error("添加cpExternalConcatUserList入库失败", new BusinessException("添加cpExternalConcatUserList入库失败"));
                return false;
            }
        }

        return true;

    }

自此，企业授权回调结束。