文章目录
- 一、调试接口
- 1. 阅读文档
- 2. 权限配置
- 3. 指定应用
- 二、POSTMAN调试接口
- 2.1. 获取配置了客户联系功能的成员列表
- 2.2. 获取客户列表
- 2.3. 获取客户详情
- 2.4. 获取客户群列表
- 2.5. 获取客户群详情
- 三、实战演练+代码拆解
- 3.1. 获取配置了客户联系功能的成员列表
- 3.2. 获取客户列表
- 3.3. 获取客户详情
- 3.4. 获取客户群列表
- 3.5. 获取客户群详情
- 四、源码分享
- 4.1. 后端源码
- 4.2. 前端源码
一、调试接口
1. 阅读文档
https://developer.work.weixin.qq.com/document/path/92109
2. 权限配置
配置可使用客户联系功能的成员
进入“客户联系”-“权限配置”-“使用范围”页面,管理员设置哪些人可使用联系客户功能,如未配置,则无法调用后文提到的相关接口。
3. 指定应用
二、POSTMAN调试接口
2.1. 获取配置了客户联系功能的成员列表
文档:https://developer.work.weixin.qq.com/document/path/92571
获取access_token
获取配置了客户联系功能的成员列表
2.2. 获取客户列表
https://developer.work.weixin.qq.com/document/path/92113
userid企业成员的userid的从上面【获取配置了客户联系功能的成员列表】接口中获取,因此,需要提前先调用。
2.3. 获取客户详情
https://developer.work.weixin.qq.com/document/path/92114
2.4. 获取客户群列表
https://developer.work.weixin.qq.com/document/path/92120
这个 “chat_id”: “wrcRIpJwAAEjWiQOBcETmUYzbKr6zORw”,等会会用到
2.5. 获取客户群详情
https://developer.work.weixin.qq.com/document/path/92122
{"errcode": 0,"errmsg": "ok","group_chat": {"chat_id": "wrcRIpJwAAEjWiQOBcETmUYzbKr6zORw","name": "客户群测试","owner": "ZeXin","create_time": 1646097589,"member_list": [{"userid": "MaoYuBaoHe","type": 1,"join_time": 1646097621,"join_scene": 1,"invitor": {"userid": "ZeXin"},"group_nickname": "","name": "王xxx"},{"userid": "ZeXin","type": 1,"join_time": 1646097589,"join_scene": 1,"invitor": {"userid": "ZeXin"},"group_nickname": "","name": "郭xxx"},{"userid": "999f6e8d00c528c685f71901ff2a6a8f","type": 1,"join_time": 1646097621,"join_scene": 1,"invitor": {"userid": "ZeXin"},"group_nickname": "","name": "徐xxx"}],"admin_list": []}
}
三、实战演练+代码拆解
实现思路:和postman一样的只是后端从国rest工具类发起请求到企业微信。
3.1. 获取配置了客户联系功能的成员列表
前端代码
后端代码
3.2. 获取客户列表
前端代码
后端代码
3.3. 获取客户详情
前端代码
后端代码
3.4. 获取客户群列表
前端代码
后端代码
3.5. 获取客户群详情
{errcode: 0, group_chat: {…}, errmsg: "ok"}
errcode: 0
errmsg: "ok"
group_chat:
admin_list: Array(0)
length: 0
__proto__: Array(0)
chat_id: "wrcRIpJwAAEjWiQOBcETmUYzbKr6zORw"
create_time: 1646097589
member_list: Array(3)
0:
group_nickname: ""
invitor: {userid: "ZeXin"}
join_scene: 1
join_time: 1646097621
name: "王xx"
type: 1
userid: "MaoYuBaoHe"
__proto__: Object
1:
group_nickname: ""
invitor: {userid: "ZeXin"}
join_scene: 1
join_time: 1646097589
name: "郭xx"
type: 1
userid: "ZeXin"
__proto__: Object
2:
group_nickname: ""
invitor: {userid: "ZeXin"}
join_scene: 1
join_time: 1646097621
name: "徐xx"
type: 1
userid: "999f6e8d00c528c685f71901ff2a6a8f"
__proto__: Object
length: 3
__proto__: Array(0)
name: "客户群测试"
owner: "ZeXin"
__proto__: Object
__proto__: Object
前端代码
后端代码
四、源码分享
4.1. 后端源码
后端:https://gitee.com/gblfy/qywx-inner-java
4.2. 前端源码
前端:https://gitee.com/gblfy/qywx-vuejs