添加对接企业微信标签接口

ANDRU-PC\Andru

2022-08-11 155ce4aba49bb16d0de96eda50ea975d3008fa50

添加对接企业微信标签接口

 src/main/java/com/hx/mp/util/CorpMpClientUtil.java

@@ -8,31 +8,50 @@
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.text.MessageFormat;

/**
 * 企业微信客户工具
 */
public class CorpMpClientUtil {

   /**生成联系我按钮参数的链接（生成config_id）*/
    /**
     * 生成联系我按钮参数的链接（生成config_id）
     */
   public static final String CREATE_CONTACT_ID_URL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_contact_way?access_token=";
   /**获取企业客户详情链接*/
    /**
     * 获取企业客户详情链接
     */
   public static final String GET_CLIENT_DETAIL_URL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get";
   /**添加客户联系人标签*/
    /**
     * 获取获取企业标签库链接
     */
    public static final String GET_CORP_TAG_LIST = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_corp_tag_list?access_token=";
    /**
     * 添加客户联系人标签
     */
   public static final String ADD_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_corp_tag?access_token=";
   /**删除客户联系人标签*/
    /**
     * 编辑企业客户标签
     */
    public static final String EDIT_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/edit_corp_tag?access_token=";
    /**
     * 删除客户联系人标签
     */
   public static final String DEL_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/del_corp_tag?access_token=";
   /**客户关联企业微信的标签url*/
    /**
     * 客户关联企业微信的标签url
     */
   public static final String RELATION_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token=";


    /**生成企业成员联系我的id-单人
    /**
     * 生成企业成员联系我的id-单人
     *
     * @param accessToken 企业的accessToken
     * @param userId 企业成员的userId
     * @param state 企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值，不超过30个字符
     * @param remark 联系方式的备注信息，用于助记，不超过30个字符
     * @return
     * @return 返回
     */
   public static JSONObject createContactId(String accessToken,String userId,String state,String remark){

@@ -56,25 +75,44 @@
       return HttpURLUtil(CREATE_CONTACT_ID_URL+accessToken,data.toString());
   }

    /**获取企业客户详情信息
    /**
     * 获取企业客户详情信息
     *
     * @param accessToken 企业的accessToken
     * @param externalUserId 外部人员的userId
     * @return
     * @return 返回
     */
   public static JSONObject getClientData(String accessToken,String externalUserId){

       return HttpURLUtil(GET_CLIENT_DETAIL_URL+"?access_token="+accessToken+"&external_userid="+externalUserId,null);
   }

    /** 添加客户联系人标签，
    /**
     * 企业可通过此接口获取企业客户标签详情
     *
     * @param accessToken 企业的accessToken
     * @param tagId  标签id
     * @param groupId 标签组id
     * @return 返回
     */
    public static JSONObject getCorpTagList(String accessToken, JSONArray tagId, JSONArray groupId) {
        JSONObject data = new JSONObject();
        data.put("tag_id", tagId);
        data.put("group_id", groupId);
        return HttpURLUtil(GET_CORP_TAG_LIST + accessToken, data.toString());
    }

    /**
     * 添加客户联系人标签，
     *如果要向指定的标签组下添加标签，需要填写group_id参数；如果要创建一个全新的标签组以及标签，
     *则需要通过group_name参数指定新标签组名称，如果填写的groupname已经存在，则会在此标签组下新建标签
     *
     * @param accessToken 企业的accessToken
     * @param groupId 组id（组名称和组id必填一个）
     * @param groupName 组名称 组名称和组id必填一个）
     * @param groupOrder 组排序，不填默认企业微信生成规则
     * @param tagArray 数组，格式：[{ "name": "TAG_NAME_1", "order": 1 }]
     * @return
     * @return 返回
     */
   public static JSONObject addTable(String accessToken,String groupId,String groupName,String groupOrder,JSONArray tagArray){
       JSONObject data = new JSONObject();
@@ -85,15 +123,35 @@
       return HttpURLUtil(ADD_TAG+accessToken,data.toString());
   }

    /**删除客户联系人标签
    /**
     * 编辑企业客户标签，
     * 注意:修改后的标签组不能和已有的标签组重名，标签也不能和同一标签组下的其他标签重名。
     *
     * @param accessToken 企业的accessToken
     * @param id     标签或标签组的id
     * @param name   新的标签或标签组名称，最长为30个字符
     * @param order  标签/标签组的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
     * @return 返回
     */
    public static JSONObject editTable(String accessToken, String id, String name, String order) {
        JSONObject data = new JSONObject();
        data.put("id", id);
        data.put("name", name);
        data.put("order", order);
        return HttpURLUtil(EDIT_TAG + accessToken, data.toString());
    }

    /**
     * 删除客户联系人标签
     * groupArr和tagArr不可同时为空。
     * 如果一个标签组下所有的标签均被删除，则标签组会被自动删除。
     *
     * @param accessToken 企业的accessToken
     * @param groupArr 组id数组
     * @param tagArr 标签id数组
     * @return
     * @return 返回
     */
   public static JSONObject delTable(String accessToken,JSONArray groupArr,String tagArr){
    public static JSONObject delTable(String accessToken, JSONArray groupArr, JSONArray tagArr) {
       JSONObject data = new JSONObject();
       data.put("tag_id",tagArr);
       data.put("group_id",groupArr);
@@ -104,15 +162,15 @@
     * 客户关联企业微信的标签
     * 注意：请确保external_userid是userid的外部联系人。
     * add_tag和remove_tag不可同时为空。
     *
     * @param accessToken 企业的accessToken
     * @param userId 企业成员的userid
     * @param externalUserId 外部联系人的id
     * @param addTag 新增的标签id（企业标签的id）数组
     * @param removeTag 删除的标签id（企业标签的id）数组
     * @return
     * @return 返回
     */
    public static JSONObject relationTag(String accessToken,String userId,String externalUserId
            ,JSONArray addTag,JSONArray removeTag){
    public static JSONObject relationTag(String accessToken, String userId, String externalUserId, JSONArray addTag, JSONArray removeTag) {
        JSONObject data = new JSONObject();
        data.put("userid",userId);
        data.put("external_userid",externalUserId);
@@ -122,7 +180,9 @@
    }


    /** 请求http协议 获取信息工具 **/
    /**
     * 请求http协议 获取信息工具
     **/
    public static JSONObject HttpURLUtil(String url, String data) {
        HttpURLConnection con = null;
        URL u = null;