# 釘釘集成流程 [TOC] ## 前提準備 ### 注冊釘釘賬號 注冊地址：<https://oa.dingtalk.com/register_new.htm> 輸入手機號，獲取驗證碼即可。  第二步填寫你的公司信息，邀請碼沒有不填就行。 ### 創建釘釘應用（H5微應用） 1. 首先登錄釘釘后臺 2. 點擊上方導航欄的`工作臺` 3. 向下滑動找到`自建應用`，并點擊加號創建  4. 鼠標移動到上方導航欄的`應用開發`上，選擇`企業內部開發`  5. 點擊右上角的`創建應用`按鈕 6. 應用類型一定要選`H5微應用`，開發方式一定選`企業自助開發`  7. 根據實際情況填寫名稱和描述，之后點確定創建即可 ### 開發者IP白名單配置 1. 在新創建的應用詳情里，找到左側導航欄的`開發管理` 2. 點擊右上角的`修改`按鈕 3. 填寫服務器出口IP，如果是測試環境，可以去百度上搜索自己的外網IP（見下圖），如果是線上環境，直接填寫線上的公網IP即可。   ### 接口權限的獲取 1. 打開`權限管理` 2. 點擊`通訊錄管理` 3. 點擊全選按鈕 4. 點擊`批量申請`按鈕 5. 注意：如果有多頁，只有當前頁的權限會被申請到，下一頁的權限需要手動切換到下一頁再申請。  >還需要在個人權限上申請`個人手機號信息`及`通信錄個人信息讀權限`  ## 對接配置 1. `AgentId`對應配置里的`agent-id` 2. `AppKey`對應配置里的`client-id` 3. `AppSecret`對應配置里的`client-secret` 4. 配置完成之后需要重啟后端項目，重啟完需要刷新前端頁面 5. 對應關系如下圖所示   ## 同步用戶 ### 用戶同步到釘釘 1. 在用戶管理頁面，點擊同步釘釘按鈕即可   2. 規則：本地同步到釘釘，釘釘上有就更新，沒有就創建。本地沒有但是釘釘有的，不做任何操作。 ### 從釘釘同步用戶到本地 1. 需要在源碼里添加如下選項 文件路徑：src/views/system/UserList.vue   2. 再次回到頁面，發現按鈕變成了下拉形式，點擊`同步到本地`即可  3. 規則：本地有的就更新，沒有的就新增（默認密碼123456）。本地有，釘釘沒有的，不做任何操作。  ## 部門同步 ### 部門同步到釘釘 1. 在部門管理頁面，點擊同步釘釘按鈕即可  2. 規則：本地同步到釘釘，釘釘上有就更新，沒有就創建。本地沒有但是釘釘有的，**刪除**釘釘上的。 ### 從釘釘同步部門到本地 1. 需要在源碼里添加如下選項 文件路徑：src/views/system/DepartListSync.vue   2. 再次回到頁面，發現按鈕變成了下拉形式，點擊`同步到本地`即可  3. 規則：本地沒有的就創建，有的就更新。本地有，釘釘沒有的，不做任何操作。  ## 發送消息 ### 發送消息測試與撤回 1. 頁面路徑：常見案例-->第三方APP消息測試  2. 撤回  ### 發送系統公告與撤回 1. 頁面路徑：系統管理-->系統通告 2. 直接發布消息即可   3. 效果預覽：  4. 撤回  ## 附錄網址 釘釘開發者中心：https://open-dev.dingtalk.com 釘釘后臺： https://oa.dingtalk.com