本文以springboot+vue技術開發的低代碼平臺為案例，介紹應用系統如何集成企業微信，包括同步企業微信組織用戶、單點登錄、消息發送等。

線上體驗：http://www.yunchengxc.com

1、準備應用

1.1、註冊企業微信賬號

作為企業微信的企業管理員，首先登錄企業微信官網，註冊一個企業微信賬號。

如果已經有賬號，則直接使用即可。

企業微信官網：https://work.weixin.qq.com/

填寫註冊信息進行註冊

1.2、創建企業微信應用

在企業微信管理後臺，找到應用管理菜單，點擊下方的“創建應用”按鈕。

填寫應用信息，設置可見範圍為所有人，不然會影響同步用戶和發送消息通知。

1.3、配置開發者介面

新建應用後進入應用詳情，滑倒最下麵配置【網頁授權及JS-SDK】、【企業微信授權登錄】、【企業可信IP】

1.3.1、【網頁授權及JS-SDK】配置可信功能變數名稱

配置這一步驟後才可以配置企業可信IP，填寫項目的功能變數名稱(僅支持功能變數名稱)，功能變數名稱需要在公網能夠訪問到。填寫完成後點擊申請校驗功能變數名稱。

把下載下來的文件放到伺服器上，並且可以根據可信功能變數名稱訪問到文件才算時校驗通過。

1.3.2、【企業微信授權登錄】配置

企業微信掃碼登錄功能需要設置回調地址。回調地址就是正式系統的訪問地址，圖中是本地開發的示例。使用企業微信登錄，只能回調至該功能變數名稱下的頁面。

1.3.3、【企業可信IP】配置

項目需要遠程調用企業微信的介面，這裡要寫我們的公網ip，不然我們的請求會被攔截。

1.4、配置通訊錄同步應用

我們自建的應用只有讀取用戶的許可權，想要進行寫的操作需要通過通訊錄同步應用去調用介面。點擊安全與管理菜單->管理工具->通訊錄同步

點擊開啟介面同步

配置可信IP

2、配置系統參數

2.1、找到應用憑證

點擊我的企業菜單，獲取企業ID(corpId)

打開自建應用獲取自建應用的AgentId(appAgentId) 和 Secret(appSecret)

打開通訊錄同步獲取通訊錄同步Secret(synSecret)

2.2、配置後端參數

在後端工程的yml文件中，把應用憑證對應配置到“yuncheng.workWechat”下，參數名稱與應用憑證的名稱對應。

2.3、配置前端參數

在前端工程的“public/config/bootConfig.js”文件內，配置參數“VUE_APP_WORKWECHAT_APP_ID”的值，對應企業微信的“corpId”；

配置參數“VUE_APP_WORKWECHAT_AGENT_ID”的值，對應企業微信的“AgentId”；配置“VUE_APP_WORKWECHAT_REDIRECT_URI”參數，登錄成功重定向 url，預設當前功能變數名稱，可以不用改動。

在前端工程的“src/settings.js”文件內，配置開關參數“showWorkWechat”的值為“true”，開啟前端的企業微信掃碼按鈕、同步部門用戶按鈕的顯示。

3、同步部門用戶

3.1、同步部門

在組織管理模塊，點擊“同步企業微信->本地同步到企業微信”。

同步完成後，會有彈框提示同步情況，企業微信管理後臺同步後的截圖如下。

3.2、同步用戶

在用戶管理模塊，點擊“同步企業微信->本地同步到企業微信”。

同步完成後，會有彈框提示同步情況，企業微信管理後臺同步後的截圖如下。

註意：同步到企業微信的賬號，如果該賬號沒有加入過當前企業團隊，系統會自動向該賬號發送加入邀請，該賬號需要同意邀請後，才能加入當前企業團隊。

3.3、同步註意事項

部門和用戶的同步規則：以本地數據為準。

本地往企業微信同步，如果企業微信不存在，則新建；如果存在，則更新；如果企業微信有多餘的部門，則刪除，並把刪除部門下的應用轉移到跟部門下。

企業微信往本地同步，如果本地不存在，則新建，如果存在，則更新，如果本地有多餘的賬號，則保持不變。本地新創建的用戶的預設密碼是“123456”，需要自行設置用戶的角色、崗位等信息。

本地和企業微信是否同一用戶的賬號，是通過用戶表的“work_wechat_id”進行判斷的。

4、企業微信掃碼登錄

4.1、掃碼登錄

點擊登錄頁面的企業微信掃碼Tab頁，會顯示企業微信二維碼，使用手機企業微信掃碼功能，完成掃碼登錄。

註意：必須完成上一步的用戶同步，並且企業微信用戶必須接受邀請加入企業團隊後，才能進行掃碼登錄。

4.2、本地用戶和企業微信的關聯欄位

本地和企業微信通過用戶表的“sys_user.work_wechat_id”欄位，和企業微信用戶的賬號id進行關聯。

如果掃碼登錄後，提示用戶不存在，需要檢查企業微信賬號所關聯的“work_wechat_id”，登錄失敗的原因可能有以下幾點：

原因1、在平臺的用戶管理中可能沒有該userId對應的用戶；

原因2、企業管理員可能沒有同步企業微信用戶或者該企業微信賬號沒有加入對應的企業微信企業團隊；

原因3、企業管理員可能沒有給企業微信應用設置可見範圍。