[TOC] ## 1 前提準備 ### 1.1 注冊釘釘賬號 注冊地址：<https://oa.dingtalk.com/register_new.htm> 輸入手機號，獲取驗證碼即可。  第二步填寫你的公司信息，邀請碼沒有不填就行。 ### 1.2 創建釘釘應用（H5微應用） 1. 首先登錄釘釘后臺 https://open-dev.dingtalk.com/ 2. 鼠標移動到上方導航欄的`應用開發`,點擊`企業內部開發`  3. 點擊`創建應用`按鈕  4. 應用類型一定要選`H5微應用`，開發方式一定選`企業自助開發`  5. 根據實際情況填寫名稱和描述，之后點確定創建即可 ### 1.3 開發者IP白名單配置及首頁地址配置(用于免登錄) 1. 在新創建的應用詳情里，找到左側導航欄的`開發管理`，并單擊右側的`修改按鈕`  2. 填寫服務器出口IP及首頁地址 - 出口ip ``` 192.144.199.247 ``` - 應用首頁地址及PC端首頁地址，`租戶id`可以在組織信息中找到，如本示例`2088` - 租戶id  - 應用首頁地址及PC端首頁地址 ``` https://app.qiaoqiaoyun.com/tenantId/租戶id ```  ### 1.4 接口權限的獲取 1. 在應用中找到`權限管理`  2. 點擊`通訊錄管理` 3. 點擊全選按鈕 4. 點擊`批量申請`按鈕 5. 注意：如果有多頁，只有當前頁的權限會被申請到，下一頁的權限需要手動切換到下一頁再申請。  >還需要在個人權限上申請`個人手機號信息`及`通信錄個人信息讀權限`  ## 2 敲敲云配置 ### 2.1 釘釘用戶部門同步到敲敲云 - 找到釘釘配置`AgentId`、`AppKey`、`AppSecret`  - 進入敲敲云首頁 https://app.qiaoqiaoyun.com/myapps/index - 點擊租戶管理  - 點擊第三方配置，在右側第二項點擊`對接信息錄入`,在點擊`編輯`按鈕  - 將`AgentId`、`AppKey`、`AppSecret`分別錄入  - 點擊同步即可完成釘釘同步  >[danger] 釘釘同步到敲敲云規則： - 部門及用戶均可同步 - 當用戶敲敲云沒有注冊的時候，系統自動創建成員，默認賬號即`手機號`，默認密碼即`手機號+租戶門牌號`，`租戶門牌號`管理員可以在`組織信息`中找到 - 當成員存在系統中，但當前租戶中沒有該成員，則默認`審核中`，由管理員審核通過后方可加入租戶 - 當成員存在系統中，存在當前租戶中，直接做更新操作 >[danger] 注意：當部門同步出現多條數據時（即重復數據），請查看一個企業下是否存在多個應用id對應不同的租戶  ### 2.2 釘釘應用免登錄 - 配置免登錄回調地址 ··· https://api.qiaoqiaoyun.com ···  - 在PC端釘釘找到工作臺，找到對應創建的應用，直接點擊即可  - 進入頁面