企业微信SDK接口API调用-通过手机号或微信好友添加客户
企业微信SDK接口API调用-通过手机号或微信好友添加客户
在企业微信中,通过手机号或微信好友添加客户是非常常见的操作。下面我们将详细描述如何使用企业微信SDK接口API来实现这一功能。
1. 准备工作首先,我们需要准备一个企业微信应用,并且已经获得了相应的凭证(AppID和AppSecret)。这些信息可以在企业微信开发者平台中找到。
其次,我们需要在我们的系统中配置好企业微信SDK接口API的相关设置,包括AppID、AppSecret等。
2. 获取用户手机号当用户通过手机号添加客户时,我们需要获取用户的手机号。我们可以使用企业微信提供的接口来实现这一功能。
接口名称: `get_user_phone`
接口描述: 获取用户手机号请求参数:
| 参数名 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| user_id | String | 是 | 用户ID |
响应参数:
| 参数名 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| phone | String | 是 | 手机号 |
3. 添加客户当我们获取到用户的手机号后,我们可以使用企业微信提供的接口来添加客户。
接口名称: `add_client`
接口描述: 添加客户请求参数:
| 参数名 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| phone | String | 是 | 手机号 |
| name | String | 否 | 客户姓名 |
响应参数:
| 参数名 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| client_id | String | 是 | 客户ID |
4. 添加客户到企业微信好友当我们添加了客户后,我们可以使用企业微信提供的接口来将客户添加到我们的企业微信好友中。
接口名称: `add_friend`
接口描述: 添加好友请求参数:
| 参数名 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| client_id | String | 是 | 客户ID |
响应参数:
| 参数名 | 类型 | 必填 |说明 |
| --- | --- | --- | --- |
| friend_id | String | 是 | 好友ID |
5. 示例代码下面是使用企业微信SDK接口API添加客户的示例代码:
```javapublic void handleMsg(ChannelHandlerContext ctx, TransportMessage vo, String contentJsonStr) {
try {
// 获取用户手机号 JSONObject jsonObject = JSONObject.parseObject(contentJsonStr);
String phone = jsonObject.getString("phone");
String userId = jsonObject.getString("user_id");
// 添加客户 AddClientRequest request = new AddClientRequest();
request.setPhone(phone);
request.setName(jsonObject.getString("name"));
AddClientResponse response = clientService.addClient(request);
if (response != null) {
// 添加客户到企业微信好友 AddFriendRequest addFriendRequest = new AddFriendRequest();
addFriendRequest.setClientId(response.getClientId());
AddFriendResponse addFriendResponse = friendService.addFriend(addFriendRequest);
if (addFriendResponse != null) {
System.out.println("添加客户成功!");
} else {
System.out.println("添加客户失败!");
}
} else {
System.out.println("添加客户失败!");
}
} catch (Exception e) {
System.out.println("错误信息:" + e.getMessage());
}
}
```
上述代码示例中,我们首先获取用户的手机号,然后使用企业微信提供的接口添加客户。最后,我们将客户添加到我们的企业微信好友中。
以上就是通过手机号或微信好友添加客户的详细描述。希望这能够帮助你理解如何使用企业微信SDK接口API来实现这一功能。