企业微信H5获取外部联系人unionid

企业微信H5获取外部联系人unionid关联小程序获取同一用户在小程序中的数据信息

使用企业微信获取外部联系人unionid关联小程序，优先需要知道的是，企业微信可以通过用户userid获取到unionid，小程序可以通过openid，获取unionid，但是无法获取userid或者openid，两者只能通过统一unionid来关联。
特别需要注意的是，如果开发者拥有多个移动应用、网站应用，可通过获取用户的unionID来区分用户的唯一性，因为只要是同一QQ互联平台下的不同应用，unionID是相同的。换句话说，同一用户，对同一个QQ互联平台下的不同应用，unionID是相同的

关联绑定微信开放平台

我们首先需要做的前置步骤为关联微信开放平台——关联小程序；小程序中关联企业微信；

如果在关联小程序的时候提示未认证，那么就需要去认证，当然这不是免费的！

认证完后就可以继续关联小程序，然后到微信公众平台登录小程序，去关联企业微信，并且你能在这里看见已经关联的开放平台

进入 设置——关联设置；拉倒最底下，开始关联企业微信

然后我们再到企业微信后台注意这里，要进入企业微信后台需要管理员权限
企业微信后台地址：https://work.weixin.qq.com/
首先第一步，进入【客户上下游】选择 客户——点击打开API——进行微信开发者ID绑定，绑定你需要操作的小程序还是需要管理员权限，绑定好后，记得点击 可调用应用，将权限给到你创建好的应用上面。如果还没有创建，就先创建。

创建应用

同样，在企业微信后台管理界面，打开应用管理



填写基本信息床架即可，创建好后可以打开进入应用继续配置信息。进入后需要留意，Agentid和Secret这两个数据要极好后期要用。

配置应用主页，应用负责人，可见范围这块随便鼓捣几下就行，主要还是应用主页。选择网页，填写网页域名例如: http://www.baidu.com 即可。然后保存

配置可信域名；填写例如 www.baidu.com 且该域名要与当前企业主体相关或有联系，记得下载提示中的txt文件，要放到配置域名的根目录下，且保证能够访问得到。

配置白名单 例如 127.0.0.1 如果有多个，记得用 “ ；” 符号分开，符号为英文符号。

代码部分

	// 我所使用的后台为 JFinal你们可以根据自己的框架进行改动
	/**
     * 获取企业微信token 企业ticket 应用ticket
     * */
    public void getToken() {
    	
    		String corpId = "此处为企业微信的corpid"; // 到企业微信管理后台 我的企业 拉到最下面就有
        	String corpSerect = "此处为上面创建的应用的serect";

    		try {
    			String url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=" + corpId + "&corpsecret=" + corpSerect;
    			URL u = new URL(url);
    			HttpsURLConnection huconn = (HttpsURLConnection) u.openConnection();
    			BufferedReader in = null;
    			StringBuilder result = new StringBuilder();
    			huconn.connect();
    			in = new BufferedReader(new InputStreamReader(huconn.getInputStream(), "UTF-8"));
    			String line;
    			while ((line = in.readLine()) != null) {
    				result.append(line);
    			}
    			if (in != null) {
    				in.close();
    			}
    			// 打印返回结果
    			System.out.println("获取token----" + result);
    			// 返回结果为JSONObject格式，需要再做一步操作获取token
    			JSONObject myJsonObject = new JSONObject();
    			myJsonObject = JSONObject.parseObject(result.toString());
    			String token = myJsonObject.getString("access_token");
    			/* 
    			成功获取到token，继续获取 企业所对应的ticket和应用所对应的ticket
    			记得要保存token和两个ticket且时效为7200秒，
    			*/
    			String qyTicket = getqyTicket(token);
    			String yyTicket = getyyTicket(token);
    			// 封装数据返回
    			results.set("qyTicket",qyTicket);
    			results.set("yyTicket",yyTicket);
    			
    			System.out.println(results);
    			rsPara("获取成功", results);
    			
    		} catch (Exception e) {
    			e.printStackTrace();
    		}
    	}
    }
    
    // 获取企业 ticket
    public String getqyTicket(String token) {
    	String ticket = "";
    	try {			//https://qyapi.weixin.qq.com/cgi-bin/get_jsapi_ticket?access_token=
			String url = "https://qyapi.weixin.qq.com/cgi-bin/get_jsapi_ticket?access_token="+token;
			URL u = new URL(url);
			HttpsURLConnection huconn = (HttpsURLConnection) u.openConnection();
			BufferedReader in = null;
			StringBuilder result = new StringBuilder();
			huconn.connect();
			in = new BufferedReader(new InputStreamReader(huconn.getInputStream(), "UTF-8"));
			String line;
			while ((line = in.readLine()) != null) {
				result.append(line);
			}
			if (in != null) {
				in.close();
			}
			// 打印返回结果
			System.out.println("获取qyTicket----" + result);
			// 返回结果为JSONObject格式，需要再做一步操作获取ticket
			JSONObject myJsonObject = new JSONObject();
			myJsonObject = JSONObject.parseObject(result.toString());
			ticket = myJsonObject.getString("ticket");
			// 打印ticket
			System.out.println("qyTicket----" + ticket);
		} catch (Exception e) {
			e.printStackTrace();
		}
    	return ticket;
    }
    
    //获取应用ticket
    public String getyyTicket(String token) {
    	String ticket = "";
    	try {
			String url = "https://qyapi.weixin.qq.com/cgi-bin/ticket/get?access_token="+token+"&type=agent_config";
			URL u = new URL(url);
			HttpsURLConnection huconn = (HttpsURLConnection) u.openConnection();
			BufferedReader in = null;
			StringBuilder result = new StringBuilder();
			huconn.connect();
			in = new BufferedReader(new InputStreamReader(huconn.getInputStream(), "UTF-8"));
			String line;
			while ((line = in.readLine()) != null) {
				result.append(line);
			}
			if (in != null) {
				in.close();
			}
			// 打印返回结果
			System.out.println("获取yyTicket----" + result);
			// 返回结果为JSONObject格式，需要再做一步操作获取ticket
			JSONObject myJsonObject = new JSONObject();
			myJsonObject = JSONObject.parseObject(result.toString());
			ticket = myJsonObject.getString("ticket");
			// 打印ticket
			System.out.println("yyTicket----" + ticket);
		} catch (Exception e) {
			e.printStackTrace();
		}
    	return ticket;
    }
    // 获取用户unionid
    public void getUnionid() {
    	Kv results = new Kv();
    	
    	String userid = get("userid");
    	Dctionaries dction = Dctionaries.dao.template("dctionaries.findByName",Kv.by("sys_name","qywx_token")).findFirst();
    	String token = dction.getSysValue();
    	try {			 //https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN&userid=USERID
    		String url =  "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get?access_token="+token+"&external_userid="+userid;
			URL u = new URL(url);
			HttpsURLConnection huconn = (HttpsURLConnection) u.openConnection();
			BufferedReader in = null;
			StringBuilder result = new StringBuilder();
			huconn.connect();
			in = new BufferedReader(new InputStreamReader(huconn.getInputStream(), "UTF-8"));
			String line;
			while ((line = in.readLine()) != null) {
				result.append(line);
			}
			if (in != null) {
				in.close();
			}
			// 打印返回结果
			System.out.println("获取yyTicket----" + result);
			// 返回结果为JSONObject格式，需要再做一步操作获取unionid
			JSONObject myJsonObject = new JSONObject();
			myJsonObject = JSONObject.parseObject(result.toString());
			
			results.set("union",myJsonObject);
			rsPara("获取成功", results);
			
		} catch (Exception e) {
			e.printStackTrace();
		}
    }
 

前端代码，需要提醒的是wx.config 和 wx.agentConfig二者使用的ticket不一样，但是生成签名的方式是一样的，并且内部条件中对应的时间戳、随机数要和生成签名的时间戳、随机数要一致
wx.agentConfig中的agentid便是刚刚自建应用中的AgentId
生成签名的方式如下链接： https://developer.work.weixin.qq.com/document/path/90506
需要注意的是，使用sha1算法，最好还是在后台全部生成，然后返回前台。我只是偷了个懒。

			async getConfig() {
				
				const res = await Api.getToken();
				let qyticket = res.qyTicket //获取后台返回的企业ticket
				let yyticket = res.yyTicket //获取后台返回的应用ticket

				let nonceStr = util.randomString() //获取随机数
				let timestamp = util.getTime() //获取时间戳
				// 动态获取当前访问域名，一定要动态！！！
				const  curRoute = location.href.split('#')[0];
				
				var qySig = util.getSignature(qyticket, nonceStr, timestamp, curRoute) //生成企业签名
				var yySig = util.getSignature(yyticket, nonceStr, timestamp, curRoute) //生成应用签名
				let that = this
				
				wx.config({
					beta: true, // 必须这么写，否则wx.invoke调用形式的jsapi会有问题
					appId: util.corpid, // 必填，企业微信的corpID
					timestamp: timestamp, // 必填，生成签名的时间戳
					nonceStr: nonceStr, // 必填，生成签名的随机串
					signature: qySig, // 必填，签名，见 附录-JS-SDK使用权限签名算法
					jsApiList: ['getContext', 'getCurExternalContact'], // 必填，需要使用的JS接口列表，凡是要调用的接口都需要传进来
				});
				wx.ready(function() {
					console.log("wx.config验证成功")
					// config信息验证后会执行ready方法，所有接口调用都必须在config接口获得结果之后，config是一个客户端的异步操作，所以如果需要在页面加载时就调用相关接口，则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口，则可以直接调用，不需要放在ready函数中。
					wx.agentConfig({
						corpid: util.corpid, // 必填，企业微信的corpid，必须与当前登录的企业一致
						agentid: util.agentid, // 必填，企业微信的应用id （e.g. 1000247）
						timestamp: timestamp, // 必填，生成签名的时间戳
						nonceStr: nonceStr, // 必填，生成签名的随机串
						signature: yySig, // 必填，签名，见附录-JS-SDK使用权限签名算法
						jsApiList: ['getContext', 'getCurExternalContact'], //必填，传入需要使用的接口名称
						success: function(res) {
							console.log("wx.agentConfit验证成功")
							// 验证，获取外部联系人userid
							wx.invoke('getContext', {}, function(res) {
								if (res.err_msg == "getContext:ok" && res.entry == "single_chat_tools") {
									let entry = res.entry; //返回进入H5页面的入口类型，目前有normal、contact_profile、single_chat_tools、group_chat_tools、chat_attachment
									wx.invoke('getCurExternalContact', {}, function(res) {
										if (res.err_msg == "getCurExternalContact:ok") {
											that.userId = res.userId; //返回当前外部联系人userId
											that.selectCustomer(res.userId)
										} else {
											console.log('错误信息', res) //错误处理
										}
									});
								} else {
									that.flag = false
									uni.showModal({
										title: '提示',
										content: '请在聊天工具栏打开该菜单',
									})
								}
							})
							// 回调
						},
						fail: function(res) {
							console.log("错误：", res);
							if (res.errMsg.indexOf("function not exist") > -1) {
								alert("版本过低请升级");
							}
						},
					});
				});
				//   return;
			},
			async selectCustomer(userid) {
				// 然后通过企业微信拿到的外部联系人userid 发送到后台
				const res1 = await Api.getUnionid({'userid':userid});
				console.log("查看是否获取id：",res1.union.external_contact.unionid)
				//就能成功取到unionid了！！！
				let unionid = res1.union.external_contact.unionid
				
			},

然后就成功拿到unionid了
本记录为 企业微信开发H5页面，创建自建应用，配置工具栏获取当前外部联系人（也可以说客户）的unionid然后获取阿巴阿巴其他信息。