🆕 #2309 【企业微信】新增微信客服帐号管理部分接口

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/kf/WxCpKfAccountAdd.java

@@ -0,0 +1,33 @@
+package me.chanjar.weixin.cp.bean.kf;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 添加客服帐号-请求参数
+ *
+ * @author Fu
+ * @date 2022/1/19 18:59
+ */
+@NoArgsConstructor
+@Data
+public class WxCpKfAccountAdd implements Serializable {
+
+  private static final long serialVersionUID = 3565729481246537411L;
+
+  /**
+   * 客服名称；不多于16个字符
+   */
+  @SerializedName("name")
+  private String name;
+
+  /**
+   * 客服头像临时素材。可以调用上传临时素材接口获取。
+   * 不多于128个字节
+   */
+  @SerializedName("media_id")
+  private String mediaId;
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/kf/WxCpKfAccountAddResp.java

@@ -0,0 +1,32 @@
+package me.chanjar.weixin.cp.bean.kf;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import me.chanjar.weixin.cp.bean.WxCpBaseResp;
+import me.chanjar.weixin.cp.util.json.WxCpGsonBuilder;
+
+/**
+ * 添加客服帐号-返回结果
+ *
+ * @author Fu
+ * @date 2022/1/19 19:04
+ */
+@EqualsAndHashCode(callSuper = true)
+@NoArgsConstructor
+@Data
+public class WxCpKfAccountAddResp extends WxCpBaseResp {
+
+  private static final long serialVersionUID = -6649323005421772827L;
+
+  /**
+   * 新创建的客服帐号ID
+   */
+  @SerializedName("open_kfid")
+  private String openKfid;
+
+  public static WxCpKfAccountAddResp fromJson(String json) {
+    return WxCpGsonBuilder.create().fromJson(json, WxCpKfAccountAddResp.class);
+  }
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/kf/WxCpKfAccountDel.java

@@ -0,0 +1,28 @@
+package me.chanjar.weixin.cp.bean.kf;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 删除客服帐号-请求参数
+ *
+ * @author Fu
+ * @date 2022/1/19 19:09
+ */
+@NoArgsConstructor
+@Data
+public class WxCpKfAccountDel implements Serializable {
+
+  private static final long serialVersionUID = 1997221467585676772L;
+
+  /**
+   * 客服帐号ID。
+   * 不多于64字节
+   */
+  @SerializedName("open_kfid")
+  private String openKfid;
+
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/kf/WxCpKfAccountLink.java

@@ -0,0 +1,40 @@
+package me.chanjar.weixin.cp.bean.kf;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 获取客服帐号链接-请求参数
+ *
+ * @author Fu
+ * @date 2022/1/19 19:18
+ */
+@NoArgsConstructor
+@Data
+public class WxCpKfAccountLink implements Serializable {
+
+  private static final long serialVersionUID = -1920926948347984256L;
+
+  /**
+   * 客服帐号ID
+   */
+  @SerializedName("open_kfid")
+  private String openKfid;
+
+  /**
+   * 场景值，字符串类型，由开发者自定义。
+   * 不多于32字节
+   * 字符串取值范围(正则表达式)：[0-9a-zA-Z_-]*
+   *
+   * 1. 若scene非空，返回的客服链接开发者可拼接scene_param=SCENE_PARAM参数使用，用户进入会话事件会将SCENE_PARAM原样返回。
+   *    其中SCENE_PARAM需要urlencode，且长度不能超过128字节。
+   *    如 https://work.weixin.qq.com/kf/kfcbf8f8d07ac7215f?enc_scene=ENCGFSDF567DF&scene_param=a%3D1%26b%3D2
+   * 2. 历史调用接口返回的客服链接（包含encScene=XXX参数），不支持scene_param参数。
+   * 3. 返回的客服链接，不能修改或复制参数到其他链接使用。否则进入会话事件参数校验不通过，导致无法回调。
+   */
+  @SerializedName("scene")
+  private String scene;
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/kf/WxCpKfAccountLinkResp.java

@@ -0,0 +1,32 @@
+package me.chanjar.weixin.cp.bean.kf;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import me.chanjar.weixin.cp.bean.WxCpBaseResp;
+import me.chanjar.weixin.cp.util.json.WxCpGsonBuilder;
+
+/**
+ * 获取客服帐号链接-结果
+ *
+ * @author Fu
+ * @date 2022/1/19 19:18
+ */
+@EqualsAndHashCode(callSuper = true)
+@NoArgsConstructor
+@Data
+public class WxCpKfAccountLinkResp extends WxCpBaseResp {
+
+  private static final long serialVersionUID = 910205439597092481L;
+
+  /**
+   * 客服链接，开发者可将该链接嵌入到H5页面中，用户点击链接即可向对应的微信客服帐号发起咨询。开发者也可根据该url自行生成需要的二维码图片
+   */
+  @SerializedName("url")
+  private String url;
+
+  public static WxCpKfAccountLinkResp fromJson(String json) {
+    return WxCpGsonBuilder.create().fromJson(json, WxCpKfAccountLinkResp.class);
+  }
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/kf/WxCpKfAccountListResp.java

@@ -0,0 +1,57 @@
+package me.chanjar.weixin.cp.bean.kf;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import me.chanjar.weixin.cp.bean.WxCpBaseResp;
+import me.chanjar.weixin.cp.util.json.WxCpGsonBuilder;
+
+import java.util.List;
+
+/**
+ * 获取客服帐号列表-结果
+ *
+ * @author Fu
+ * @date 2022/1/19 19:13
+ */
+@EqualsAndHashCode(callSuper = true)
+@NoArgsConstructor
+@Data
+public class WxCpKfAccountListResp extends WxCpBaseResp {
+
+  private static final long serialVersionUID = -1317201649692262217L;
+
+  /**
+   * 	帐号信息列表
+   */
+  @JsonProperty("account_list")
+  private List<AccountListDTO> accountList;
+
+  @NoArgsConstructor
+  @Data
+  public static class AccountListDTO {
+    /**
+     * 客服帐号ID
+     */
+    @SerializedName("open_kfid")
+    private String openKfid;
+
+    /**
+     * 客服名称
+     */
+    @SerializedName("name")
+    private String name;
+
+    /**
+     * 客服头像URL
+     */
+    @SerializedName("avatar")
+    private String avatar;
+  }
+
+  public static WxCpKfAccountListResp fromJson(String json) {
+    return WxCpGsonBuilder.create().fromJson(json, WxCpKfAccountListResp.class);
+  }
+}

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/bean/kf/WxCpKfAccountUpd.java

@@ -0,0 +1,41 @@
+package me.chanjar.weixin.cp.bean.kf;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.io.Serializable;
+
+/**
+ * 修改客服帐号-请求参数
+ *
+ * @author Fu
+ * @date 2022/1/19 19:10
+ */
+@NoArgsConstructor
+@Data
+public class WxCpKfAccountUpd implements Serializable {
+
+  private static final long serialVersionUID = -900712046553752529L;
+
+  /**
+   * 要修改的客服帐号ID。
+   * 不多于64字节
+   */
+  @SerializedName("open_kfid")
+  private String openKfid;
+
+  /**
+   * 新的客服名称，如不需要修改可不填。
+   * 不多于16个字符
+   */
+  @SerializedName("name")
+  private String name;
+
+  /**
+   * 新的客服头像临时素材，如不需要修改可不填。可以调用上传临时素材接口获取。
+   * 不多于128个字节
+   */
+  @SerializedName("media_id")
+  private String mediaId;
+}