使用工具类
 
https://gitee.com/binary/weixin-java-tools
 
 
 
1 pom引用
 
        <!-- 企业微信工具集 https://mvnrepository.com/artifact/com.github.binarywang/wx-java -->
        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-cp</artifactId>
            <version>3.9.0</version>
        </dependency>
 
 
 
2 增加配置 application.yml
 
 
 
普通企业微信不需要配置baseApiUrl / oauth2redirectUri
 
 
# 微信相关
wechat:
  # 私有部署企业微信
  privatecp:
    corpId: wwxxxxxxxxxx
    baseApiUrl: http://127.0.0.1:161
    oauth2redirectUri: http://127.0.0.1:161
    # 应用配置
    appConfigs:
      - agentId: 1000001
        secret: xxxxxxxxxxxxxxxxxxxxx
      - agentId: 1000002
        secret: xxxxxxxxxxxxxxxxxxxxx
 
 
 
3 增加配置信息类
 
package com.xxx.auth.config;

import java.util.List;

import com.xxx.auth.urils.JsonUtils;
import org.springframework.boot.context.properties.ConfigurationProperties;

import lombok.Getter;
import lombok.Setter;

/**
 * @author GuanWeiMail@163.com
 */
@Getter
@Setter
@ConfigurationProperties(prefix = "wechat.privatecp")
public class WxCpPrivateProperties {
    /**
     * 设置微信企业号的corpId
     */
    private String corpId;

    /**
     * 基础api域名
     */
    private String baseApiUrl;

    /**
     * oauth2 网页授权请求域名
     */
    private String oauth2redirectUri;

    /**
     * 应用配置集合
     */
    private List<AppConfig> appConfigs;

    @Getter
    @Setter
    public static class AppConfig {
        /**
         * 设置微信企业应用的AgentId
         */
        private Integer agentId;

        /**
         * 设置微信企业应用的Secret
         */
        private String secret;

        /**
         * 设置微信企业号的token
         */
        private String token;

        /**
         * 设置微信企业号的EncodingAESKey
         */
        private String aesKey;

    }

    @Override
    public String toString() {
        return JsonUtils.toJson(this);
    }
}
 
 
 
工具类
 
package com.tpln.auth.urils;

import com.fasterxml.jackson.annotation.JsonInclude.Include;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;

/**
 *
 *  Json工具类
 *  @author
 */
public class JsonUtils {
    private static final ObjectMapper JSON = new ObjectMapper();

    static {
        JSON.setSerializationInclusion(Include.NON_NULL);
        JSON.configure(SerializationFeature.INDENT_OUTPUT, Boolean.TRUE);
    }

    public static String toJson(Object obj) {
        try {
            return JSON.writeValueAsString(obj);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }

        return null;
    }
}
 
 
 
 
 
4 增加配置类
 
 
 
普通企业微信不需要配置baseApiUrl / oauth2redirectUri
 
 
package com.xxx.auth.config;

import java.util.Map;
import java.util.stream.Collectors;
import javax.annotation.PostConstruct;

import me.chanjar.weixin.cp.config.impl.WxCpDefaultConfigImpl;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Configuration;

import com.google.common.collect.Maps;
import lombok.val;
import me.chanjar.weixin.cp.api.WxCpService;
import me.chanjar.weixin.cp.api.impl.WxCpServiceImpl;
import me.chanjar.weixin.cp.message.WxCpMessageRouter;

/**
 * @Title: 私有部署企业微信配置类
 * @Description: 集成企业微信认证
 * @Version: v1.0
 * @Author: Mr.Guan
 * @Mail GuanWeiMail@163.com
 * @DateTime: 2020-09-08 20:01:04
 * @Package com.xxx.auth.config
 */
@Configuration
@EnableConfigurationProperties(WxCpPrivateProperties.class)
public class WxCpPrivateConfiguration {

    /**
     * 配置信息
     */
    private WxCpPrivateProperties properties;

    private static Map<Integer, WxCpMessageRouter> routers = Maps.newHashMap();
    private static Map<Integer, WxCpService> cpServices = Maps.newHashMap();

    @Autowired
    public WxCpPrivateConfiguration(WxCpPrivateProperties properties) {
        this.properties = properties;
    }


    public static Map<Integer, WxCpMessageRouter> getRouters() {
        return routers;
    }

    public static WxCpService getCpService(Integer agentId) {
        return cpServices.get(agentId);
    }

    /**
     * 初始化Services
     * 初始化多个企业应用
     */
    @PostConstruct
    public void initServices() {
        cpServices = this.properties.getAppConfigs().stream().map(appConfig -> {
            val configStorage = new WxCpDefaultConfigImpl();

            //普通企业微信不需要配置baseApiUrl / oauth2redirectUri
            configStorage.setBaseApiUrl(this.properties.getBaseApiUrl());
            configStorage.setOauth2redirectUri(this.properties.getOauth2redirectUri());


            configStorage.setCorpId(this.properties.getCorpId());
            configStorage.setAgentId(appConfig.getAgentId());
            configStorage.setCorpSecret(appConfig.getSecret());
            configStorage.setToken(appConfig.getToken());
            configStorage.setAesKey(appConfig.getAesKey());
            val service = new WxCpServiceImpl();
            service.setWxCpConfigStorage(configStorage);
            routers.put(appConfig.getAgentId(), this.newRouter(service));
            return service;
        }).collect(Collectors.toMap(service -> service.getWxCpConfigStorage().getAgentId(), a -> a));
    }

    private WxCpMessageRouter newRouter(WxCpService wxCpService) {
        final val newRouter = new WxCpMessageRouter(wxCpService);

        return newRouter;
    }
}
 
 
 
5 网页授权地址
 
 
 
http://127.0.0.1:161/connect/oauth2/authorize?appid=wwxxxxxxxxxx&redirect_uri=http://服务器ip:8889/auth/callback/WECHAT_ENTERPRISE&response_type=code&scope=SCOPE&agentid=1000001&state=STATE#wechat_redirect
 
 
 
 
 
 
参考
 
package com.xxx.auth.controller;

import cn.hutool.core.util.StrUtil;
import cn.hutool.json.JSONUtil;
import com.xxx.auth.config.WxCpPrivateConfiguration;
import com.xxx.auth.emnu.SourceInfoEnum;
import me.chanjar.weixin.cp.api.WxCpService;
import me.chanjar.weixin.cp.bean.WxCpOauth2UserInfo;
import me.chanjar.weixin.cp.bean.WxCpUser;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;
import java.util.Map;

/**
 * @Title: 认证Controller
 * @Description: 描述
 * @Version: v1.0
 * @Author: Mr.Guan
 * @Mail GuanWeiMail@163.com
 * @DateTime: 2020-08-24 20:01:04
 */
@RestController
@RequestMapping("auth")
public class AuthController {

    public static void main(String[] args) {


        System.out.println(SourceInfoEnum.valueOf("WECHAT_ENTERPRISE"));

    }

    /**
     * auth平台中配置的授权回调地址
     * 以本项目为例，在创建"企业微信"授权应用时的回调地址应为：http://127.0.0.1:8443/auth/callback/wechat_enterprise?callback=
     * 企业微信免登陆
     * 获取企业用户信息 关联子系统用户 实现免登
     * @param request
     * @param source    请求来源：WECHAT_ENTERPRISE:企业微信
     * @return
     * @throws Exception
     */
    @RequestMapping("callback/{source}")
    public Object login(HttpServletRequest request, @PathVariable("source") String source) throws Exception{

        //获取请求参数
        Map<String, String[]> parameterMap = request.getParameterMap();
        System.out.println(JSONUtil.parse(parameterMap).toStringPretty());

        if(StrUtil.isBlank(source)){
            return "error";
        }


        switch (SourceInfoEnum.valueOf(source)){
            // 企业微信
            case WECHAT_ENTERPRISE:

                String code = parameterMap.get("code")[0];


                //获取微信服务
                WxCpService wxCpService = WxCpPrivateConfiguration.getCpService(1000001);

                //获取用户ID
                WxCpOauth2UserInfo userInfo = wxCpService.getOauth2Service().getUserInfo(code);
                System.out.println(JSONUtil.parse(userInfo).toStringPretty());

                //获取通讯录
//                List<WxCpDepart> list = wxCpService.getDepartmentService().list(1L);
//                for (WxCpDepart wxCpDepart : list) {
//                    List<WxCpUser> wxCpUsers = wxCpService.getUserService().listByDepartment(wxCpDepart.getId(), false, 0);
//                    System.out.println(JSONUtil.parse(wxCpDepart).toStringPretty());
//                    System.out.println(JSONUtil.parse(wxCpUsers).toStringPretty());
//                }


                //获取用户明细信息
                WxCpUser byId = wxCpService.getUserService().getById(userInfo.getUserId());

                System.out.println(byId);


                //判断子系统是否存在该用户, 存在则直接免登, 生成 token 存入session / redis
                //不存在则创建用户

                break;
            default:
                break;
        }



        return "ok";
    }

}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

项目上为了支持新的业务，扩展了通过企业微信扫码登录和通过企业微信容器内的直接访问应用服务的免密登录。
 
1.扫码登录
 
企业微信以Userid作为企业内的用户身份唯一标识，集成接口可以参考官网文档：
 
https://work.weixin.qq.com/api/doc#90000/90135/90988
 
1）扫码登录首先要构建登录二维码链接
 
这部分要在访问登录页面login时生成，并提供链接图标，用户通过点击登录也面的链接图标即可跳转到企业微信的二维码登录页面，通过手机端扫码即可。
 
二维码的链接url为：https://open.work.weixin.qq.com/wwopen/sso/qrConnect?appid=CORPID&agentid=AGENTID&redirect_uri=REDIRECT_URI&state=STATE，需要配置corpid，secret和agentid；
 
也可以参考官网设置内嵌式的二维码页面，引入企业微信提供的js文件。
 
集成通过OAuth协议来实现，扫码成功后，会得到临时的授权code，通过code和token获取用户信息，
 
获取token的链接url为：https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
 
获取到token以后，再次通过token获取用户信息，
 
获取用户信息的链接url为：https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
 
2）容器内直接免密登录
 
与扫码不同的是，当前业务需求不需要扫码，可以参考官网文档
 
https://work.weixin.qq.com/api/doc#90000/90135/91020
 
二维码的链接改成认证链接
 
url为：https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect
 
其他流程是相同的；
 
注意：企业微信也提供openid信息，如果需要使用openid来作为用户身份标识，可以通过企业微信提供的通过userid获取openid的接口实现；可以参考官网https://work.weixin.qq.com/api/doc#90000/90135/90202
 
userid获取openid接口url：https://qyapi.weixin.qq.com/cgi-bin/user/convert_to_openid?access_token=ACCESS_TOKEN；
 
该部分需要使用token。
 
根据业务需求，可以将企业微信的userid作为用户标识，如果是已有了用户数据，可以通过绑定userid的方式来实现与现有业务系统的兼容。
 
 
 
技术有限，如有问题，可通过qq交流740273040
 
 

1.企业微信申请
 
企业微信官方地址：https://work.weixin.qq.com/
 
 
 
2.企业微信给用户发消息
 
申请企业微信以后，我们可以用管理员登录企业微信后台。
 
2.1.登录企业微信后台管理
 
 
2.2.创建应用
 
在应用管理模块，创建一个应用
 

 
 
2.3.发送消息
 
进入我们创建的引用，点击发送消息
 
 
 点击发送后，登录企业微信客户端，即可查看到我们的企业微信消息。
 
 
3.集成企业微信发送消息
 
上述操作中，我们是通过系统的后台管理界面进行发送消息的，现在我们来开始用java的方式来集成企业微信。这里氛围两种，一种是Spring环境下的集成，一种是非Sping环境下的集成。
 
3.1.Spring项目集成企业微信
 
这里我们以SpringBoot项目为例子：
 
3.1.1.创建一个SpringBoot项目
 
代码结构如下
 
 
3.1.2.配置RestTemplate
 
@SpringBootConfiguration
public class RestTemplateConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}
 
3.1.2.创建报文映射实体类
 
3.1.2.1.创建TokenResult
 
该类用来映射请求token返回json报文
 
public class TokenResult {
	
	private String errcode;
	
	private String errmsg;
	
	private String access_token;
	
	private String expires_in;
	//get 、set略，
}
 
3.1.2.2.创建MsgRequestDTO
 
该类是发送企业消息报文映射的实体类
 
public class  MsgRequestDTO{
 /**
     * 成员账号
     */
    private String touser;
    /**
     * 消息类型
     */
    private String msgtype;
    /**
     * 企业应用的agentID
     */
    private int agentid;
    /**
     * 传送的消息
     */
    private Map<String, String> text;
	//省略get set
}
 
3.1.2.3.创建MsgResult
 
该类是映射发送消息返回报文映射的实体类
 
public class MsgResult {
	
	private String errcode;
	
	private String errmsg;
	
	private String invaliduser;
	//省略get  set
	
}
 
3.1.3.发送消息到企业微信用户
 
这里使用restTemplate来进行请求
 首先我们需要用企业ID和企业密匙，获取到token
 然后组装请求报文发送消息
 
@RestController
@RequestMapping("/sendMsg")
public class SendMsgControlelr {
		
	@Autowired
	private RestTemplate http;
	
	@GetMapping("/wechat")
	public MsgResult SendToWechat() {
		
		//企业微信地址
    	String baseUrl = "https://qyapi.weixin.qq.com/cgi-bin/gettoken";
        //企业ID
        String corpid = "ww3e993d7d77b48bfe";
        //企业密匙
        String corpsecret = "063X5BODdWSq6LzyUSz22EEOpgVTTwOyaSK3GUI9dik";
        //代理商ID
        int agentId = 1000002;
			
        String urlToken = baseUrl+"?corpid="+corpid+"&corpsecret="+corpsecret;
        String token = http.getForEntity(urlToken, TokenResult.class).getBody().getAccess_token();
        
        String  msgUrl = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token="+token;
        MsgRequestDTO  requestData = new MsgRequestDTO();
        requestData.setAgentid(agentId);
        requestData.setTouser("HuTao");
        requestData.setMsgtype("text");
        Map<String,String> text = new HashMap<>();
        text.put("content", "aaaaaaaaaaaaaaaaaa");
        requestData.setText(text);
        
        ResponseEntity<MsgResult> postForEntity = http.postForEntity(msgUrl, requestData, MsgResult.class);
        return postForEntity.getBody();
	}
}
 
3.2.非Spring项目集成企业微信

在越来越多人都想把工作和生活分开，不想用自己的私人微信去联系客户。针对这个问题，企业微信就可以很好的帮大家解放私人微信，因此有不少员工都开始使用企业微信去运营客户。
 
在使用企业微信后，很多员工都需要把之前微信上的客户以及微信群也一并转过去。为了避免创建过多的群聊让客户反感，也为了节省重新拉客户进群的时间，可以直接把微信群转为企业微信群吗？
 
如何把微信群转到企业微信
 
在3.1.10版本中，企业微信教育版可以把微信群转为企业微信群，而其它微信群暂时是不支持转为企业微信外部群的。
 
不过你可以创建一个新的企业微信外部群，重新在企业微信上添加微信上的客户为好友后，再拉他们进群。
 
 
 
如果客户比较多，重新添加客户以后再发送进群邀请，需要的时间会比较久，所以我们也可以直接通过分享企业微信群二维码到微信群的方式，让客户进群。
 
在邀请客户进群的过程中，要是群人数达到了上限，客户就会进群失败。这个时候如果创建一个新群重新邀请客户加入，可能会造成对客户的过度打扰，客户就不愿意进群了。
 
怎样减少客户进群流失
 
要是想减少客户进群过程中的流失，可以使用企业的群活码功能。企业微信群活码能关联五个群聊，在邀请客户进群的过程中，如果一个群聊人数满了，群活码会自动创建新群，五个群上限一共为1000人，免去了员工自己创建新群的繁琐。
 
 
需要注意的是，企业微信群活码关联的群，在达到200人之后，客户扫码后是会自动进入到下一个新群的，并且超过200人后需要员工自己手动拉客户进群。
 
有的企业客户不止1000人，都需要邀请进群的话，怎样可以突破企业微信群活码1000人的限制呢？
 
可以借助第三方服务商–小店帮。工具有无限拉群功能，客户扫码后，不用添加企业成员就可以直接入群，很大程度的简化了客户入群的流程，可以增加客户的入群率。
 
 
 
无限拉群功能不需要企业自己创建群聊，上传了活码后，客户扫描就可以进群，并且群个数不受限制，企业不用担心客户会因为群聊人数满了而入群失败。
 
客户进群后，企业还需要对客户进行一系列的社群营销活动，使用小店帮可以帮您更高效的运营社群！