企业微信集成外部APP

1. 目标

微信发展到今天，庞大的用户群体使得很多企业选择了微信定制开发。第三方应用可以通过集成企业微信实现企业用户对APP的功能的操作。

2. 准备

2.1 进入微信后台管理页面，开发者需要拥有管理员权限

扫码进入后台管理：https://work.weixin.qq.com/wework_admin/loginpage_wx#profile/wxPlugin

2.2 到应用管理内创建本次需要集成的应用

​

image

2.3 准备好企业的ID 和 应用的ID(AgentId)、Secret

​

image

​

image

3. 开发集成

3.1 集成思路

​

image

3.2 开发步骤

3.2.1 登录企业微信后台，配置应用入口URL和网页授权

​

image

3.2.2 配置的入口URL跳转到应用的中间页面，用于重定向到应用的登录验证中间页面。( 此处也可以直接配置重定向的URL，直接跳转到登录验证。)

     $.get('https://wxfsp.sfwl.net/system/security/getDeriectInfoForWeChat', {},
            function (params, status) {
                console.log(params, status);
                if (status == "success") {
                    var deriectUrl = encodeURIComponent(params.deriectUrl);
                    var reidctUrl = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=" + params.appID + "&response_type=code&scope=snsapi_privateinfo&agentid=" + params.agentId + "&state=WeChat&redirect_uri=" + deriectUrl + "#wechat_redirect";
                    window.location.href = reidctUrl;
                } else {
                    alert('初始化失败！')
                }
            }
        )

3.2.3 重定向后的页面获取到微信授权码code，调用应用后台验证用户信息并登录
- 根据企业ID+应用Secret 获取access_token，并缓存到redis
- 根据access_token+code获取微信用户基本信息 （UserId、user_ticket）
- 根据access_token+user_ticket获取微信用户详细信息（userid、name、mobile、email）
- 根据userid匹配后台用户信息映射表 并做应用的登录

    public void preLoginForWeChat(LoginUser loginUser) {
        String code = loginUser.getCode();
        if(code==null||"".equals(code))
        {
            throw new RuntimeException("未获取到微信code");
        }
        SystemService sService = SpringBeanUtil.getBean(SystemService.class);
        String accessToken = "";
        Object accessTokenTimeObj = redisManager.get("WETCHAT_ACCESSTOKEN_TIME");//先从缓存里获取accessToken缓存的时间
        boolean isGetTokenByURL = false;
        if(accessTokenTimeObj!=null && !"".equals(accessTokenTimeObj)){
            String accessTokenTimeStr = String.valueOf(accessTokenTimeObj);
            Long accessTokenTime = Long.parseLong(accessTokenTimeStr);
            Long thisTime = new Date().getTime();
            long interval = (thisTime - accessTokenTime)/1000;
            if(interval > 6900) //上次缓存到现在大于6900秒,再次通过URL获取
            {
                isGetTokenByURL = true;
            }
            else //否则从缓存中取
            {
                accessToken = String.valueOf(redisManager.get("WETCHAT_ACCESSTOKEN"));
            }
        }
        else //未获取到缓存时间(即没有缓存),需通过URL获取
        {
            isGetTokenByURL = true;
        }
        if(isGetTokenByURL)//缓存中没有时 调用url获取
        {
            AdSysParamDto aspd = sService.getAdSysParamDtoByTypeAndCode("APP_WECHAT","ACCESS_TOKEN_URL");
            if(aspd!=null)
            {
                String tokenUrl = aspd.getParamValues();//url
                if(tokenUrl!=null)
                {
                    String resStr = LocalUtil.sendPost(tokenUrl, null);
                    JSONObject json = JSONObject.parseObject(resStr);
                    accessToken = json.getString("access_token");
                    if(accessToken!=null && !"".equals(accessToken)) //获取到accessToken
                    {
                        redisManager.delete("WETCHAT_ACCESSTOKEN");
                        redisManager.set("WETCHAT_ACCESSTOKEN", accessToken,7000);//缓存accessToken7000秒(accessToken有效期7200秒)
                        redisManager.delete("WETCHAT_ACCESSTOKEN_TIME");
                        String tokenTime = String.valueOf(new Date().getTime());
                        redisManager.set("WETCHAT_ACCESSTOKEN_TIME", tokenTime,7000);//本次缓存的时间
                    }
                }
            }
        }
        if("".equals(accessToken)||"null".equals(accessToken))
        {
            throw new RuntimeException("未获取到微信accessToken");
        }
        
        
        AdSysParamDto aspd = sService.getAdSysParamDtoByTypeAndCode("APP_WECHAT","USER_INFO_URL");
        if(aspd!=null)
        {
            String userUrl = aspd.getParamValues();//url

            if(userUrl!=null)
            {
                userUrl = userUrl.replace("{ACCESS_TOKEN}", accessToken);
                userUrl = userUrl.replace("{CODE}", code);
                String resStr = LocalUtil.sendPost(userUrl, null);
                JSONObject json = JSONObject.parseObject(resStr);
                String userId = json.getString("UserId");
                String userTicket = "";
                if(userId!=null && !"".equals(userId))
                {
                     userTicket = json.getString("user_ticket");
                     
                        Map param = new HashMap();
                        param.put("weChatUserId", userId);
                        ModuleReturn weUserModule = userIfoWeChatMappingAPI.queryUserInfoWechatMapping(param);
                        if(weUserModule.isSuccess())
                        {
                            UserInfoWechatMappingDto weUser = weUserModule.getDatas();
                            if(weUser!=null)
                            {
                                String userAccount = weUser.getUserAccount();
                                String password  = userAccount;//任意密码(此处做单点不校验)
                                loginUser.setIsPointLogin("1");//单点登录
                                loginUser.setUserAccount(userAccount);
                                loginUser.setPassword(userAccount);//单点登录密码不校验
                            }
                        }
                     
                }
                else
                {
                    throw new RuntimeException("未获取到微信userId");
                }
        }
        
    }
    }

3.2.4 应用的前台获取后台接口登录成功结果，跳转到对应的展示页面

4 集成效果

​​​

image

image

image