企业微信工具栏获取外部联系人unionid

企业微信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然后获取阿巴阿巴其他信息。

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值