跳至主要内容

釘釘集成說明和步驟


概述

在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。


文檔問題反饋

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