Merge remote-tracking branch 'origin/master'

fwq

2023-10-23 b9cbfe2653e9b4cf343b9aa1e390f6b1e77206b9

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

@@ -43,6 +43,20 @@
     */
    public static final String RELATION_TAG = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/mark_tag?access_token=";

    /**
     * 获取员工客户列表url
     */
    public static final String EXTERNAL_CONTACT_LIST = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list";

    /**
     * 创建获客链接url
     */
    public static final String CUSTOMER_ACQUISITION_CREATE_LINK = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/customer_acquisition/create_link?access_token=";

    /**
     * 获取获客客户列表
     */
    public static final String CUSTOMER_ACQUISITION_CUSTOMER_LIST = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/customer_acquisition/customer?access_token=";

    /**
     * 生成企业成员联系我的id-单人
@@ -76,6 +90,16 @@
    }

    /**
     * 获取客户列表
     * @param accessToken 企业的accessToken
     * @param userId 企业成员的userId
     * @return 返回
     */
    public static JSONObject getExternalContactList(String accessToken, String userId) {
        return HttpURLUtil(EXTERNAL_CONTACT_LIST + "?access_token=" + accessToken + "&userid=" + userId, null);
    }

    /**
     * 获取企业客户详情信息
     *
     * @param accessToken    企业的accessToken
@@ -83,7 +107,6 @@
     * @return 返回
     */
    public static JSONObject getClientData(String accessToken, String externalUserId) {

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

@@ -179,7 +202,6 @@
        return HttpURLUtil(RELATION_TAG + accessToken, data.toString());
    }


    /**
     * 请求http协议 获取信息工具
     **/
@@ -233,10 +255,9 @@
     * @param scene 场景，1-在小程序中联系，2-通过二维码联系
     * @param state 企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值，不超过30个字符
     * @param remark 联系方式的备注信息，用于助记，不超过30个字符
     * @return
     * @return 返回
     */
    public static JSONObject createContactId(String accessToken,String userId,int scene,String state,String remark){

        String configId = null;
        JSONObject data = new JSONObject();
        data.put("type",1);
@@ -256,4 +277,62 @@

        return HttpURLUtil(CREATE_CONTACT_ID_URL+accessToken,data.toString());
    }

    /**
     * 创建获客链接
     *
     * @param accessToken 企业的accessToken
     * @param linkName  链接名称
     * @param userList 员工用户userId
     * @return 返回
     */
    public static JSONObject createCustomerAcquisitionLink(String accessToken, String linkName, JSONArray userList) {
        JSONObject data = new JSONObject();
        data.put("link_name", linkName);
        JSONObject subData = new JSONObject();
        subData.accumulate("user_list", userList);
        data.put("range", subData);
        /** 返回数据
         * {
         *    "link_id":"LINK_ID",
         *    "link_name":"获客链接1号",
         *    "range":
         *    {
         *          "user_list":["zhangsan","lisi"],
         *       "department_list":[2,3]
         *    },
         *    "skip_verify":true
         * }
         */
        return HttpURLUtil(CUSTOMER_ACQUISITION_CREATE_LINK + accessToken, data.toString());
    }

    /**
     * 获取获客客户列表
     *
     * @param accessToken 企业的accessToken
     * @param linkId  链接id
     * @return 返回
     */
    public static JSONObject getCustomerAcquisitionCustomerList(String accessToken, String linkId) {
        JSONObject data = new JSONObject();
        data.put("link_id", linkId);
        /** 返回数据
         * {
         *     "errcode": 0,
         *     "errmsg": "ok",
         *    "customer_list":
         *    [
         *                {
         *          "external_userid":"woAJ2GCAAAXtWyujaWJHDDGi0mACAAA",
         *          "userid":"zhangsan",
         *          "chat_status":0,
         *          "state":"CHANNEL_A"
         *        }
         *    ],
         *    "next_cursor":"CURSOR"
         * }
         */
        return HttpURLUtil(CUSTOMER_ACQUISITION_CUSTOMER_LIST + accessToken, data.toString());
    }
}