Skip to content

Commit 833ff70

Browse files
zhangrongguangBinary Wang
zhangrongguang
authored and
Binary Wang
committed
【企业微信】接待人员管理 添加接待人员/删除接待人员 增加 department_id_list
1 parent 373c1e6 commit 833ff70

2 files changed

Lines changed: 72 additions & 7 deletions

File tree

‎weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/WxCpKfService.java‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,19 @@ public interface WxCpKfService {
7575
*/
7676
WxCpKfServicerOpResp addServicer(String openKfid, List<String> userIdList) throws WxErrorException;
7777

78+
/**
79+
* 接待人员管理
80+
* 添加指定客服账号的接待人员，每个客服账号目前最多可添加2000个接待人员，20个部门。
81+
* userid_list和department_id_list至少需要填其中一个
82+
*
83+
* @param openKfid 客服帐号ID
84+
* @param userIdList 接待人员userid列表。第三方应用填密文userid，即open_userid 可填充个数：1 ~ 100。超过100个需分批调用。
85+
* @param departmentIdList 接待人员部门id列表 可填充个数：0 ~ 20。
86+
* @return 添加客服账号结果 wx cp kf servicer op resp
87+
* @throws WxErrorException 异常
88+
*/
89+
WxCpKfServicerOpResp addServicer(String openKfid, List<String> userIdList,List<String> departmentIdList) throws WxErrorException;
90+
7891
/**
7992
* 接待人员管理
8093
* 从客服帐号删除接待人员
@@ -86,6 +99,19 @@ public interface WxCpKfService {
8699
*/
87100
WxCpKfServicerOpResp delServicer(String openKfid, List<String> userIdList) throws WxErrorException;
88101

102+
/**
103+
* 接待人员管理
104+
* 从客服帐号删除接待人员
105+
* userid_list和department_id_list至少需要填其中一个
106+
*
107+
* @param openKfid 客服帐号ID
108+
* @param userIdList 接待人员userid列表。第三方应用填密文userid，即open_userid 可填充个数：1 ~ 100。超过100个需分批调用。
109+
* @param departmentIdList 接待人员部门id列表 可填充个数：0 ~ 100。超过100个需分批调用。
110+
* @return 删除客服账号结果 wx cp kf servicer op resp
111+
* @throws WxErrorException 异常
112+
*/
113+
WxCpKfServicerOpResp delServicer(String openKfid, List<String> userIdList, List<String> departmentIdList) throws WxErrorException;
114+
89115
/**
90116
* 接待人员管理
91117
* 获取某个客服帐号的接待人员列表

‎weixin-java-cp/src/main/java/me/chanjar/weixin/cp/api/impl/WxCpKfServiceImpl.java‎

Lines changed: 46 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -70,23 +70,62 @@ public WxCpKfAccountLinkResp getAccountLink(WxCpKfAccountLink link) throws WxErr
7070

7171
@Override
7272
public WxCpKfServicerOpResp addServicer(String openKfid, List<String> userIdList) throws WxErrorException {
73-
return servicerOp(openKfid, userIdList, SERVICER_ADD);
73+
return servicerOp(openKfid, userIdList, null, SERVICER_ADD);
74+
}
75+
76+
@Override
77+
public WxCpKfServicerOpResp addServicer(String openKfId, List<String> userIdList, List<String> departmentIdList) throws WxErrorException {
78+
validateParameters(SERVICER_ADD, userIdList, departmentIdList);
79+
return servicerOp(openKfId, userIdList, departmentIdList, SERVICER_ADD);
7480
}
7581

7682
@Override
7783
public WxCpKfServicerOpResp delServicer(String openKfid, List<String> userIdList) throws WxErrorException {
78-
return servicerOp(openKfid, userIdList, SERVICER_DEL);
84+
return servicerOp(openKfid, userIdList, null, SERVICER_DEL);
7985
}
8086

81-
private WxCpKfServicerOpResp servicerOp(String openKfid, List<String> userIdList, String uri) throws WxErrorException {
87+
@Override
88+
public WxCpKfServicerOpResp delServicer(String openKfid, List<String> userIdList, List<String> departmentIdList) throws WxErrorException {
89+
validateParameters(SERVICER_DEL, userIdList, departmentIdList);
90+
return servicerOp(openKfid, userIdList, departmentIdList, SERVICER_DEL);
91+
}
92+
93+
private void validateParameters(String uri, List<String> userIdList, List<String> departmentIdList) {
94+
if ((userIdList == null || userIdList.isEmpty()) && (departmentIdList == null || departmentIdList.isEmpty())) {
95+
throw new IllegalArgumentException("userid_list和department_id_list至少需要填其中一个");
96+
}
97+
if (SERVICER_DEL.equals(uri)) {
98+
if (userIdList != null && userIdList.size() > 100) {
99+
throw new IllegalArgumentException("可填充个数：0 ~ 100。超过100个需分批调用。");
100+
}
101+
if (departmentIdList != null && departmentIdList.size() > 100) {
102+
throw new IllegalArgumentException("可填充个数：0 ~ 100。超过100个需分批调用。");
103+
}
104+
} else {
105+
if (userIdList != null && userIdList.size() > 100) {
106+
throw new IllegalArgumentException("可填充个数：0 ~ 100。超过100个需分批调用。");
107+
}
108+
if (departmentIdList != null && departmentIdList.size() > 20) {
109+
throw new IllegalArgumentException("可填充个数：0 ~ 20。");
110+
}
111+
}
112+
}
113+
114+
private WxCpKfServicerOpResp servicerOp(String openKfid, List<String> userIdList, List<String> departmentIdList, String uri) throws WxErrorException {
82115
String url = cpService.getWxCpConfigStorage().getApiUrl(uri);
83116

84117
JsonObject json = new JsonObject();
85118
json.addProperty("open_kfid", openKfid);
86-
JsonArray userIdArray = new JsonArray();
87-
userIdList.forEach(userIdArray::add);
88-
json.add("userid_list", userIdArray);
89-
119+
if (userIdList != null && !userIdList.isEmpty()) {
120+
JsonArray userIdArray = new JsonArray();
121+
userIdList.forEach(userIdArray::add);
122+
json.add("userid_list", userIdArray);
123+
}
124+
if (departmentIdList != null && !departmentIdList.isEmpty()) {
125+
JsonArray departmentIdArray = new JsonArray();
126+
departmentIdList.forEach(departmentIdArray::add);
127+
json.add("department_id_list", departmentIdArray);
128+
}
90129
String responseContent = cpService.post(url, json.toString());
91130
return WxCpKfServicerOpResp.fromJson(responseContent);
92131
}

0 commit comments

Comments
 (0)