~chenjiahe/hx_common.git

chenjiahe

2023-09-18 756acbd7d971fbeebe224bdedfdd1a3e0a195dc2

提交 \| 用户 \| age
5c5945	1	package com.hx.mp.util;
E	2
	3	import net.sf.json.JSONArray;
	4	import net.sf.json.JSONException;
	5	import net.sf.json.JSONObject;
	6	import org.apache.commons.io.IOUtils;
	7
	8	import java.io.OutputStream;
	9	import java.net.HttpURLConnection;
	10	import java.net.URL;
	11
	12	/**
	13	* 企业微信客户工具
	14	*/
	15	public class CorpMpClientUtil {
	16
155ce4	17	/**
A	18	* 生成联系我按钮参数的链接（生成config_id）
5c5945	19	*/
155ce4	20	public static final String CREATE_CONTACT_ID_URL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way?access_token=";
A	21	/**
	22	* 获取企业客户详情链接
	23	*/
	24	public static final String GET_CLIENT_DETAIL_URL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get";
	25	/**
	26	* 获取获取企业标签库链接
	27	*/
	28	public static final String GET_CORP_TAG_LIST = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_corp_tag_list?access_token=";
	29	/**
	30	* 添加客户联系人标签
	31	*/
	32	public static final String ADD_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag?access_token=";
	33	/**
	34	* 编辑企业客户标签
	35	*/
	36	public static final String EDIT_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/edit_corp_tag?access_token=";
	37	/**
	38	* 删除客户联系人标签
	39	*/
	40	public static final String DEL_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/del_corp_tag?access_token=";
	41	/**
	42	* 客户关联企业微信的标签url
	43	*/
	44	public static final String RELATION_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token=";
5c5945	45
4a23ba	46	/**
A	47	* 获取员工客户列表url
	48	*/
	49	public static final String EXTERNAL_CONTACT_LIST = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list";
5c5945	50
155ce4	51	/**
A	52	* 生成企业成员联系我的id-单人
	53	*
	54	* @param accessToken 企业的accessToken
	55	* @param userId 企业成员的userId
	56	* @param state 企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值，不超过30个字符
	57	* @param remark 联系方式的备注信息，用于助记，不超过30个字符
	58	* @return 返回
	59	*/
	60	public static JSONObject createContactId(String accessToken, String userId, String state, String remark) {
	61
	62	String configId = null;
	63	JSONObject data = new JSONObject();
	64	data.put("type", 1);
	65	data.put("scene", 1);
	66	data.put("state", state);
	67	data.put("remark", remark);
	68	JSONArray userIds = new JSONArray();
	69	userIds.add(userId);
	70	data.put("user", userIds);
	71
	72	//请求，返回格式
5c5945	73	/*{
E	74	"errcode": 0,
	75	"errmsg": "ok",
	76	"config_id":"42b34949e138eb6e027c123cba77fAAA"
	77	}*/
	78
155ce4	79	return HttpURLUtil(CREATE_CONTACT_ID_URL + accessToken, data.toString());
A	80	}
5c5945	81
155ce4	82	/**
4a23ba	83	* 获取客户列表
A	84	* @param accessToken 企业的accessToken
	85	* @param userId 企业成员的userId
	86	* @return 返回
	87	*/
	88	public static JSONObject getExternalContactList(String accessToken, String userId) {
	89	return HttpURLUtil(EXTERNAL_CONTACT_LIST + "?access_token=" + accessToken + "&userid=" + userId, null);
	90	}
	91
	92	/**
155ce4	93	* 获取企业客户详情信息
A	94	*
	95	* @param accessToken 企业的accessToken
5c5945	96	* @param externalUserId 外部人员的userId
155ce4	97	* @return 返回
5c5945	98	*/
155ce4	99	public static JSONObject getClientData(String accessToken, String externalUserId) {
A	100	return HttpURLUtil(GET_CLIENT_DETAIL_URL + "?access_token=" + accessToken + "&external_userid=" + externalUserId, null);
	101	}
5c5945	102
155ce4	103	/**
A	104	* 企业可通过此接口获取企业客户标签详情
	105	*
5c5945	106	* @param accessToken 企业的accessToken
155ce4	107	* @param tagId 标签id
A	108	* @param groupId 标签组id
	109	* @return 返回
5c5945	110	*/
155ce4	111	public static JSONObject getCorpTagList(String accessToken, JSONArray tagId, JSONArray groupId) {
A	112	JSONObject data = new JSONObject();
	113	data.put("tag_id", tagId);
	114	data.put("group_id", groupId);
	115	return HttpURLUtil(GET_CORP_TAG_LIST + accessToken, data.toString());
	116	}
5c5945	117
155ce4	118	/**
A	119	* 添加客户联系人标签，
	120	* 如果要向指定的标签组下添加标签，需要填写group_id参数；如果要创建一个全新的标签组以及标签，
	121	* 则需要通过group_name参数指定新标签组名称，如果填写的groupname已经存在，则会在此标签组下新建标签
	122	*
	123	* @param accessToken 企业的accessToken
	124	* @param groupId 组id（组名称和组id必填一个）
	125	* @param groupName 组名称组名称和组id必填一个）
	126	* @param groupOrder 组排序，不填默认企业微信生成规则
	127	* @param tagArray 数组，格式：[{ "name": "TAG_NAME_1", "order": 1 }]
	128	* @return 返回
	129	*/
	130	public static JSONObject addTable(String accessToken, String groupId, String groupName, String groupOrder, JSONArray tagArray) {
	131	JSONObject data = new JSONObject();
	132	data.put("group_id", groupId);
	133	data.put("group_name", groupName);
	134	data.put("order", groupOrder);
	135	data.put("tag", tagArray);
	136	return HttpURLUtil(ADD_TAG + accessToken, data.toString());
	137	}
	138
	139	/**
	140	* 编辑企业客户标签，
	141	* 注意:修改后的标签组不能和已有的标签组重名，标签也不能和同一标签组下的其他标签重名。
	142	*
	143	* @param accessToken 企业的accessToken
	144	* @param id 标签或标签组的id
	145	* @param name 新的标签或标签组名称，最长为30个字符
	146	* @param order 标签/标签组的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
	147	* @return 返回
	148	*/
	149	public static JSONObject editTable(String accessToken, String id, String name, String order) {
	150	JSONObject data = new JSONObject();
	151	data.put("id", id);
	152	data.put("name", name);
	153	data.put("order", order);
	154	return HttpURLUtil(EDIT_TAG + accessToken, data.toString());
	155	}
	156
	157	/**
	158	* 删除客户联系人标签
5c5945	159	* groupArr和tagArr不可同时为空。
E	160	* 如果一个标签组下所有的标签均被删除，则标签组会被自动删除。
155ce4	161	*
5c5945	162	* @param accessToken 企业的accessToken
155ce4	163	* @param groupArr 组id数组
A	164	* @param tagArr 标签id数组
	165	* @return 返回
5c5945	166	*/
155ce4	167	public static JSONObject delTable(String accessToken, JSONArray groupArr, JSONArray tagArr) {
A	168	JSONObject data = new JSONObject();
	169	data.put("tag_id", tagArr);
	170	data.put("group_id", groupArr);
	171	return HttpURLUtil(DEL_TAG + accessToken, data.toString());
	172	}
5c5945	173
E	174	/**
	175	* 客户关联企业微信的标签
	176	* 注意：请确保external_userid是userid的外部联系人。
	177	* add_tag和remove_tag不可同时为空。
155ce4	178	*
A	179	* @param accessToken 企业的accessToken
	180	* @param userId 企业成员的userid
5c5945	181	* @param externalUserId 外部联系人的id
155ce4	182	* @param addTag 新增的标签id（企业标签的id）数组
A	183	* @param removeTag 删除的标签id（企业标签的id）数组
	184	* @return 返回
5c5945	185	*/
155ce4	186	public static JSONObject relationTag(String accessToken, String userId, String externalUserId, JSONArray addTag, JSONArray removeTag) {
5c5945	187	JSONObject data = new JSONObject();
155ce4	188	data.put("userid", userId);
A	189	data.put("external_userid", externalUserId);
	190	data.put("add_tag", addTag);
	191	data.put("remove_tag", removeTag);
	192	return HttpURLUtil(RELATION_TAG + accessToken, data.toString());
5c5945	193	}
E	194
155ce4	195	/**
A	196	* 请求http协议获取信息工具
	197	**/
5c5945	198	public static JSONObject HttpURLUtil(String url, String data) {
E	199	HttpURLConnection con = null;
	200	URL u = null;
	201	String wxMsgXml = null;
	202	JSONObject obj = null;
	203	try {
	204	u = new URL(url);
	205	con = (HttpURLConnection) u.openConnection();
	206	con.setRequestMethod("POST");
	207	con.setDoOutput(true);
	208	con.setDoInput(true);
	209	con.setUseCaches(false);
	210	con.setReadTimeout(5000);
	211	con.setRequestProperty("Charset", "UTF-8");
	212	con.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
	213
	214	if (data != null) {
	215	OutputStream os = con.getOutputStream();
	216	os.write(data.getBytes("utf-8"));
	217	}
	218
	219	if (con.getResponseCode() != 200)
	220	throw new RuntimeException("请求url失败");
	221	// 读取返回内容
	222	wxMsgXml = IOUtils.toString(con.getInputStream(), "utf-8");
	223	obj = JSONObject.fromObject(wxMsgXml);
	224	// //System.out.println("HttpURLUtil:"+wxMsgXml);
	225	} catch (Exception e) {
	226	e.printStackTrace();
	227	obj = new JSONObject();
	228	try {
	229	obj.put("status", 1);
	230	obj.put("errMsg", e.getMessage());
	231	} catch (JSONException e1) {
	232	e1.printStackTrace();
	233	}
	234	} finally {
	235	if (con != null) {
	236	con.disconnect();
	237	}
	238	}
	239	return obj;
	240	}
3f9abe	241
W	242	/**生成企业成员联系我的id-单人
	243	* @param accessToken 企业的accessToken
	244	* @param userId 企业成员的userId
	245	* @param scene 场景，1-在小程序中联系，2-通过二维码联系
	246	* @param state 企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值，不超过30个字符
	247	* @param remark 联系方式的备注信息，用于助记，不超过30个字符
4a23ba	248	* @return 返回
3f9abe	249	*/
W	250	public static JSONObject createContactId(String accessToken,String userId,int scene,String state,String remark){
	251	String configId = null;
	252	JSONObject data = new JSONObject();
	253	data.put("type",1);
	254	data.put("scene",scene);
	255	data.put("state",state);
	256	data.put("remark",remark);
	257	JSONArray userIds = new JSONArray();
	258	userIds.add(userId);
	259	data.put("user",userIds);
	260
	261	//请求，返回格式
	262	/*{
	263	"errcode": 0,
	264	"errmsg": "ok",
	265	"config_id":"42b34949e138eb6e027c123cba77fAAA"
	266	}*/
	267
	268	return HttpURLUtil(CREATE_CONTACT_ID_URL+accessToken,data.toString());
	269	}
5c5945	270	}