企业微信集成流程
最后更新于:2022-04-02 07:22:11
# 企业微信集成流程
[TOC]
## 前提准备
企业微信注册地址:
企业微信管理后台:
### 注册企业微信账号
1. 根据实际情况填写企业信息
2. 管理员姓名要和绑定的管理员微信上的真实姓名一致
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/f5/06/f5065002c3ab869b065ec53ff54e7334_491x762.png)
### 创建企业微信应用
1. 点击`应用管理`
2. 点击`应用`
3. 点击`创建应用`
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/a1/ce/a1cef9e2e1e47c0dc21bbfcda13abf88_618x805.png)
4. 根据实际情况填写即可
5. 可见范围一般选择根部门
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2c/fa/2cfa92c1b4acee4b96ffa63e38528f4f_396x463.png)
## 对接配置
1. 配置client-id
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/d2/0a/d20a54af671d552213346b74f264bf83_945x702.png)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/3b/16/3b16c3813906da285e2d00f2bda4b524_416x285.png)
2. 配置client-secret
2.1 老版本企业微信
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/85/aa/85aa0970e9fd7b30ad441f3fb88885c3_793x485.png)
2.2 新版本企业微信
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/8b/da/8bda97e7ce737d9cf88b700439450d04_930x726.png)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/18/4e/184ef46f2afa0b2fe846704dedc7d559_948x637.png)
3. 配置agent-id(自建应用ID)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/0e/03/0e032c2eaec1d5815251146d2ff98bff_591x286.png)
4. 配置agent-app-secret(仅新版本企业微信需要)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/f6/1f/f61f1fc7b91f7f0ba459dec26b8c9b72_491x311.png)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/35/cc/35cc9c4210cda4acb569b67f16777432_728x291.png)
## 部门同步
### 部门同步到企业微信
优先同步部门,用户同步时可能会用到部门架构。
1. 在部门管理页面,点击同步企业微信按钮即可
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/a3/f5/a3f57b9fddf7f177900a7e30ba702530_659x314.png)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/0c/dd/0cdd16fdb9b7a474f22a75c7ddc21ad0_538x409.png)
2. 规则:本地同步到企业微信,企业微信上有就更新,没有就创建。本地没有但是企业微信有的,**删除**企业微信上的。
### 从企业微信同步部门到本地
1. 需要在源码里添加如下选项
文件路径:src/views/system/DepartListSync.vue
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/c5/7c/c57c97638a3f0a45e89a87b7b0b84b83_246x41.png)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/f4/4a/f44a232e747dfb403ecf03b3815b9645_1170x196.png)
2. 再次回到页面,发现按钮变成了下拉形式,点击`同步到本地`即可
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/c9/49/c94962b414d41ca1293791f3659ba152_723x416.png)
3. 规则:本地没有的就创建,有的就更新。本地有,企业微信没有的,不做任何操作。
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/52/c2/52c27174cbfe5305e3b7e1869d859670_516x344.png)
## 同步用户
### 用户同步到企业微信
1. 在用户管理页面,点击同步企业微信按钮即可
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/6b/34/6b341891e1881d396183657d8f0a0ce1_735x424.png)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/9e/30/9e306aaa0b1508bac9a18f599eaaf39e_511x260.png)
2. 规则:本地同步到企业微信,企业微信上有就更新,没有就创建。本地没有但是企业微信有的,不做任何操作。
### 从企业微信同步用户到本地
1. 需要在源码里添加如下选项
文件路径:src/views/system/UserList.vue
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/c5/7c/c57c97638a3f0a45e89a87b7b0b84b83_246x41.png)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/4b/8b/4b8b58276e5efefe313e7f4017193904_1176x139.png)
2. 再次回到页面,发现按钮变成了下拉形式,点击`同步到本地`即可
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/a5/7b/a57b2b33ed41941ae81da9f6f21ec496_526x375.png)
3. 规则:本地有的就更新,没有的就新增(默认密码123456)。本地有,企业微信没有的,不做任何操作。
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/21/9c/219cce8deea0ef6026d3141d4caf1b67_519x260.png)
## 发送消息
> 注意:企业微信不支持撤回功能
### 发送消息测试
1. 页面路径:常见案例-->第三方APP消息测试
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/65/38/65387cdcc97acaabf5139f2fcb6a84ec_900x377.png)
### 发送系统公告
1. 页面路径:系统管理-->系统通告
2. 直接发布消息即可
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/e9/d7/e9d7afdecf202deed0389b2ec26a489f_796x664.png)
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/ad/96/ad960c272d69f8203aac5f872316e6d9_133x203.png)
3. 效果预览:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/db/d7/dbd764ffad6f8296907eb8f1b082c186_546x632.png)
## 附录
* [全局错误码 - 企业微信API ](https://developer.work.weixin.qq.com/document/path/95390)
';