企业微信_客户联系,获取客户及客户群列表及详情

文章目录

一、调试接口

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"

前端代码

后端代码

四、源码分享

4.1. 后端源码

后端：​​https://gitee.com/gblfy/qywx-inner-java​​

4.2. 前端源码

前端：​​https://gitee.com/gblfy/qywx-vuejs​​