企業微信集成流程 · JeecgBoot 開發文檔

# 企業微信集成流程 [TOC] ## 前提準備企業微信注冊地址：<https://work.weixin.qq.com/wework_admin/register_wx> 企業微信管理后臺：<https://work.weixin.qq.com/wework_admin/frame> ### 注冊企業微信賬號 1. 根據實際情況填寫企業信息 2. 管理員姓名要和綁定的管理員微信上的真實姓名一致 ![](https://img.kancloud.cn/f5/06/f5065002c3ab869b065ec53ff54e7334_491x762.png) ### 創建企業微信應用 1. 點擊`應用管理` 2. 點擊`應用` 3. 點擊`創建應用` ![](https://img.kancloud.cn/a1/ce/a1cef9e2e1e47c0dc21bbfcda13abf88_618x805.png) 4. 根據實際情況填寫即可 5. 可見范圍一般選擇根部門 ![](https://img.kancloud.cn/2c/fa/2cfa92c1b4acee4b96ffa63e38528f4f_396x463.png) ## 對接配置 1. 配置client-id ![](https://img.kancloud.cn/d2/0a/d20a54af671d552213346b74f264bf83_945x702.png) ![](https://img.kancloud.cn/3b/16/3b16c3813906da285e2d00f2bda4b524_416x285.png) 2. 配置client-secret 2.1 老版本企業微信 ![](https://img.kancloud.cn/85/aa/85aa0970e9fd7b30ad441f3fb88885c3_793x485.png) 2.2 新版本企業微信 ![](https://img.kancloud.cn/8b/da/8bda97e7ce737d9cf88b700439450d04_930x726.png) ![](https://img.kancloud.cn/18/4e/184ef46f2afa0b2fe846704dedc7d559_948x637.png) 3. 配置agent-id（自建應用ID） ![](https://img.kancloud.cn/0e/03/0e032c2eaec1d5815251146d2ff98bff_591x286.png) 4. 配置agent-app-secret（僅新版本企業微信需要） ![](https://img.kancloud.cn/f6/1f/f61f1fc7b91f7f0ba459dec26b8c9b72_491x311.png) ![](https://img.kancloud.cn/35/cc/35cc9c4210cda4acb569b67f16777432_728x291.png) ## 部門同步 ### 部門同步到企業微信優先同步部門，用戶同步時可能會用到部門架構。 1. 在部門管理頁面，點擊同步企業微信按鈕即可 ![](https://img.kancloud.cn/a3/f5/a3f57b9fddf7f177900a7e30ba702530_659x314.png) ![](https://img.kancloud.cn/0c/dd/0cdd16fdb9b7a474f22a75c7ddc21ad0_538x409.png) 2. 規則：本地同步到企業微信，企業微信上有就更新，沒有就創建。本地沒有但是企業微信有的，**刪除**企業微信上的。 ### 從企業微信同步部門到本地 1. 需要在源碼里添加如下選項文件路徑：src/views/system/DepartListSync.vue ![](https://img.kancloud.cn/c5/7c/c57c97638a3f0a45e89a87b7b0b84b83_246x41.png) ![](https://img.kancloud.cn/f4/4a/f44a232e747dfb403ecf03b3815b9645_1170x196.png) 2. 再次回到頁面，發現按鈕變成了下拉形式，點擊`同步到本地`即可 ![](https://img.kancloud.cn/c9/49/c94962b414d41ca1293791f3659ba152_723x416.png) 3. 規則：本地沒有的就創建，有的就更新。本地有，企業微信沒有的，不做任何操作。 ![](https://img.kancloud.cn/52/c2/52c27174cbfe5305e3b7e1869d859670_516x344.png) ## 同步用戶 ### 用戶同步到企業微信 1. 在用戶管理頁面，點擊同步企業微信按鈕即可 ![](https://img.kancloud.cn/6b/34/6b341891e1881d396183657d8f0a0ce1_735x424.png) ![](https://img.kancloud.cn/9e/30/9e306aaa0b1508bac9a18f599eaaf39e_511x260.png) 2. 規則：本地同步到企業微信，企業微信上有就更新，沒有就創建。本地沒有但是企業微信有的，不做任何操作。 ### 從企業微信同步用戶到本地 1. 需要在源碼里添加如下選項文件路徑：src/views/system/UserList.vue ![](https://img.kancloud.cn/c5/7c/c57c97638a3f0a45e89a87b7b0b84b83_246x41.png) ![](https://img.kancloud.cn/4b/8b/4b8b58276e5efefe313e7f4017193904_1176x139.png) 2. 再次回到頁面，發現按鈕變成了下拉形式，點擊`同步到本地`即可 ![](https://img.kancloud.cn/a5/7b/a57b2b33ed41941ae81da9f6f21ec496_526x375.png) 3. 規則：本地有的就更新，沒有的就新增（默認密碼123456）。本地有，企業微信沒有的，不做任何操作。 ![](https://img.kancloud.cn/21/9c/219cce8deea0ef6026d3141d4caf1b67_519x260.png) ## 發送消息 > 注意：企業微信不支持撤回功能 ### 發送消息測試 1. 頁面路徑：常見案例-->第三方APP消息測試 ![](https://img.kancloud.cn/65/38/65387cdcc97acaabf5139f2fcb6a84ec_900x377.png) ### 發送系統公告 1. 頁面路徑：系統管理-->系統通告 2. 直接發布消息即可 ![](https://img.kancloud.cn/e9/d7/e9d7afdecf202deed0389b2ec26a489f_796x664.png) ![](https://img.kancloud.cn/ad/96/ad960c272d69f8203aac5f872316e6d9_133x203.png) 3. 效果預覽： ![](https://img.kancloud.cn/db/d7/dbd764ffad6f8296907eb8f1b082c186_546x632.png) ## 附錄 * [全局錯誤碼 - 企業微信API ](https://developer.work.weixin.qq.com/document/path/95390)