跳至主要内容

釘釘集成說明和步驟

概述

在HAP中搭建的應用，可以直接安裝在釘釘的工作臺，您可以在釘釘中就能體驗HAP的服務。區彆於一般的SaaS與釘釘集成方案，我們采用瞭釘釘自建內部應用的方式進行集成。效果如下圖：

  • 電腦端效果：

    通過係統默認瀏覽器或釘釘內，打開HAP。

    HAP：將整個平臺集成到釘釘工作臺

    OKR：將單個應用集成到釘釘工作臺

  • 手機端效果：

免費版不支持集成釘釘

集成操作步驟​

步驟簡述

  1. 在釘釘管理後臺安裝一個微應用，建立釘釘和HAP的信息對接。

  2. 同步釘釘通訊錄，完成HAP集成到釘釘。

  3. 優化配置：將待辦消息（審批、填寫）同步到釘釘

  4. 將HAP的單個應用安裝在釘釘工作臺。

請嚴格按照以下步驟進行操作，任何一步齣錯都會導緻集成失敗。

一、建立釘釘和HAP的連接​

1、打開HAP對接指南頁麵​

HAP管理員點擊個人頭像進入組織管理後臺，點擊第三方平臺，選擇釘釘進入集成頁麵。然後點擊如何獲取對接信息打開對接操作指南頁麵，此頁麵不要關閉，後麵的步驟需要頁麵中的以下信息：

  • LOGO （第3點）

  • 應用首頁地址（第4點）

  • PC端首頁地址（第4點）

企業微信、釘釘、釘釘隻能選擇一個平臺對接，如果已經對接瞭一個，另外兩個就不再顯示瞭。如何關閉對接

2、在釘釘中創建對接應用​

釘釘管理員需要登錄釘釘網頁版的開放平臺後臺，創建內部應用。

應用圖標LOGO可從第1步打開的頁麵中下載。

3、添加網頁應用能力​

4、填寫首頁地址​

打開[開發管理]欄，點擊右上角編輯按鈕，填寫將對應的首頁地址填入。

應用首頁地址和PC端首頁地址請在第1步打開的對接指南頁麵的[完成接口信息]中復製

5、確定同步的員工範圍​

特彆重要！

貴司使用釘釘的人員是100人，但是使用HAP的人數可能是50人，因此並非同步所有的賬號。我們可以根據部門和指定人員來確認好同步的人員範圍， 設定範圍如下圖： 如果所有人員使用，直接選擇“全部員工”即可。如果不是全員使用HAP，則選擇指定員工或部門即可。

6、獲取通訊錄權限接口​

特彆重要！

需要獲取釘釘組織內的通訊錄讀取權限，必須添加的權限有以下6個，逐個復製名稱搜索後，點擊右側的申請權限會自動獲得。

  • 通訊錄部門信息讀權限

  • 成員信息讀權限

  • 通訊錄部門成員讀權限

  • 企業員工手機號信息

  • 個人手機號信息

  • 郵箱等個人信息

7、發布應用​

完成以上步驟後，釘釘的配置已經完成，接下來需要創建應用版本並發布應用，讓成員可以使用，保存後直接發布生效。

  • 版本號

    第一次集成就寫1.0.0 ，如果後麵有小的改動，可以後麵增加為1.0.1 、1.0.2. 如果有稍大的版本，可以設為1.1.0...， 如果有重大版本更新時，可以設置2.0.0，當然這並非絕對的，隻要新版本號比舊版本號大即可。

  • 版本描述

    簡要描述本次做瞭什麼配置

  • 待發布內容

    選擇“網頁應用”

  • 可見範圍

    第4步設定的範圍是同步賬號的人員範圍，如果需要同步的人在釘釘工作臺可見HAP應用，還需要設置以下範圍，這部分人在釘釘工作臺可以看見HAP應用的入口。

    在測試階段，可先選擇部分人員可見。這樣就隻有幾個人在釘釘工作臺可看到HAP應用。

    待後麵的步驟也測試完畢後，確認正式使用瞭，再迴來修改應用的可見範圍並發布新版即可。這裏選擇的人，在釘釘工作臺都會看到HAP應用。 一般和第4步同步範圍選擇的人員是一緻的。

二、在HAP同步數據​

1、錄入釘釘中的信息​

組織管理員返迴HAP後臺的釘釘對接界麵，將CorpId等4個對接信息錄入。

獲取CorpId等4個對接信息的方法如下：

  • AgentId、ClientID、ClientSecret

    進入釘釘中創建的應用詳情，點擊憑證與基礎信息，獲取3個信息。

  • CorpId

    在釘釘開放平臺首頁可直接找到CorpId。

點擊保存，並確定如何處理映射關係

2、同步通訊錄​

點擊 【同步】按鈕，可以將釘釘的通訊錄同步到HAP。

同步的信息有：姓名，公司，聯係電話，部門，職位，頭像。

每次同步釘釘的信息都會覆蓋寫入HAP，但HAP頭像隻在第一次同步時會覆蓋。

同步前必看​

將釘釘通訊錄同步到HAP，是依據手機號和郵箱（優先手機號）進行匹配關聯的。如果HAP的組織中有相同手機號的賬戶，則直接建立和釘釘賬號的關聯，如果沒有則自動創建新的HAP賬戶。 也就是說，能和現有HAP賬戶關聯有兩個條件：

  • 兩個平臺間綁定的手機號相同

  • HAP賬號要在組織內

示例： 在釘釘中，員工綁定的手機號是199-9999-9999， 在同步到HAP的組織時，這個組織內有個賬戶也綁定瞭手機號199-9999-9999， 如果有則直接關聯，如果沒有，則自動創建一個新的賬戶並關聯。如果HAP係統中現在有個199-9999-9999的賬戶，但不在您的組織內，依然不會同步並關聯的，而是自動創建一個新的HAP賬戶。

在手機號匹配不上時，會再按郵箱搜索匹配。

因此在同步前，管理員要明晰以下4點：

  • 確定好使用HAP的釘釘賬號範圍， 範圍設置參考本文一.4章節。

  • 一定要讓員工核對好HAP賬戶綁定的手機號和釘釘的手機號是否一緻，如果不一緻，請盡快綁定或換綁保持一緻，全部確認後再進行同步通訊錄的操作。

  • 已經有HAP賬號保證已經在組織內（在組織後臺，人員部門管理顯示瞭纔算加入組織）

  • 還沒有主動注冊HAP賬戶的員工，點擊同步後，會自動創建一個HAP賬戶

開始同步​

組織超級管理員進入 組織管理後臺 > 集成 > 第三方平臺 ，點擊【同步】按鈕。 查看同步內容說明

三、釘釘中打開HAP​

前麵步驟操作後，就完成瞭HAP整個平臺安裝到釘釘的操作瞭。在釘釘工作臺就能看到HAP入口。點擊即可打開。

釘釘中看不到HAP？​

新的應用屬於未分組應用，管理員可將其添加到全員分組中。

四、其他功能配置​

1、待辦消息同步​

工作流中的待辦（待審批、待填寫、待查看）可以同步到釘釘的待辦任務。在釘釘或HAP任意一方處理後，處理狀態都會同步更新。

  • 啓用待辦

    在集成釘釘後，切換到"其他"標簽欄,即可看到啓用釘釘待辦任務。

  • 權限申請

    由於釘釘接口調整，需要訪問釘釘舊版申請權限。

    登錄釘釘後臺，然後點此打開舊版，隻需添加【待辦任務】接口。

    路徑：應用開發>H5微應用>HAP>權限管理

2、釘釘PC端打開HAP的方式​

在釘釘PC端打開HAP時，可以選擇是在釘釘內打開，還是跳轉到係統瀏覽器打開。在釘釘集成配置頁麵，選擇“其他”標簽欄，即可看到打開方式的選項。

3、釘釘中的消息鏈接打開方式​

支持“獨立窗口”打開和“側邊欄”打開兩種方式。

獨立窗口： 新開瀏覽器頁麵打開

側邊欄： 在釘釘APP內右側打開

調整打開方式後，新的消息將按新的方式打開，曆史消息按當時的配置方式打開。

四、將單個應用安裝在釘釘工作臺​

應用管理員進入應用，打開此應用的安裝指南頁麵，一步步按照安裝指南完成安裝。

每個應用的配置信息是不同的,需要安裝的應用都需要這樣操作一遍。

應用安裝在釘釘後，用戶即可在工作臺中看到此應用，點擊即可使用。

打開後如果提示無權限或應用不存在，請聯係管理員調整您的權限配置。

五、釘釘用戶如何通過賬號+密碼登錄HAP​

除瞭通過釘釘直接進入HAP係統，還可以直接通過賬號和密碼登錄HAP係統。

需對賬號進行登錄賬號和密碼的設置：

  • 1、綁定手機號

  • 2、設置密碼

設置步驟

1、從釘釘進入HAP​

2、綁定手機號並設置密碼​

  • 點擊頭像，進入賬號綁定頁麵。

  • 輸入手機號和接收到的驗證碼，然後設置密碼。

密碼設置後，您可以使用前麵綁定的手機號和剛設置密碼直接從HAP登錄，或登錄HAP APP。

文檔問題反饋

文檔中是否有錯彆字、內容過期、難以理解等問題？ 點此給我們反饋吧