跳至主要内容

HAP如何與飛書對接集成

集成說明​

HAP可以在飛書中以自建應用的方式進行集成。集成後，支持直接將飛書側的組織架構同步到HAP中，以及在飛書客戶端直接打開HAP，另外也支持將應用與工作流消息推送到飛書。

集成步驟​

1、進入HAP組織後臺​

組織管理員點擊係統頭像進入組織管理後臺，點擊第三方平臺，選擇飛書進入集成頁麵。

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

2、打開對接信息頁麵​

在飛書集成頁麵，點擊【如何獲取對接信息？】打開對接信息頁麵，頁麵不要關閉，此頁麵有對接時需要的信息，例如Logo、主頁地址等信息。

3、登錄飛書開放平臺，創建應用​

飛書開放平臺地址為 (https://open.feishu.cn/app) ，進入開發者後臺，然後點擊“創建應用”。

注意：飛書和lark是兩個相互獨立的平臺。HAP僅支持和飛書的對接，請確保您登錄的應用後臺地址是 open.feishu.cn，而open.larksuite.com 是不支持對接的。

4、填寫應用基本信息​

其中應用圖標從第2步的打開的對接指南頁麵中下載。

5、進入飛書應用的詳情頁​

確定創建應用後，會先進入應用列錶，然後點擊應用名稱進入應用詳情。

6、在飛書應用中設置主頁地址​

地址從第2步的對接指南頁中獲取

  • 1)添加應用能力，選擇"網頁應用"

  • 2)在飛書應用中配置“網頁”，記得先添加

  • 3)在安全配置中配置URL

7、啓用飛書應用的機器人​

啓用機器人功能，這樣在飛書消息側就能直接收到HAP內部的流程、應用消息。

8、添加需要的API權限和數據權限​

需要添加11個接口的權限：

  • 獲取應用信息
  • 以應用身份讀取通訊錄
  • 獲取部門基礎信息
  • 獲取部門組織架構信息
  • 獲取用戶組織架構信息
  • 獲取用戶郵箱信息
  • 獲取用戶受雇信息
  • 獲取用戶 user ID
  • 獲取用戶手機號
  • 以應用的身份發消息
  • 給多個用戶批量發消息

復製上麵的接口名稱，逐個搜索後並開通權限。如下圖：

設置同步的人員和部門

必須選擇[與應用的可用範圍一緻]。

9、創建發布版本和選擇可用人員範圍​

飛書中的應用每次做瞭調整，都需要創建一個發布的新版本以及確認可用人員範圍。

10、創建發布版本和設定同步人員範圍​

1）應用配置完畢後，需要創建發布版本

如果是更新版本時，記得版本號要增大，如1.0.0 改為1.0.1

2) 配置同步人員範圍和應用可見人員範圍

這裏選擇的人員和部門，就是在飛書中可見“HAP”應用的人員，也是同步到HAP的人員和部門。

舉個例子：您公司使用飛書的是100人，使用HAP的人數是30人，那麼這裏就選擇那30人，通過部門或指定人員來選擇控製範圍。

對於後續的同步，都是依據此範圍。例如選擇瞭銷售部，如果飛書中有員工不在銷售部瞭，再一次同步通訊錄時，HAP係統會自動將此人辦理離職，如果飛書有新的人加入瞭銷售部，再一次同步通訊錄時，HAP會自動同步創建此員工的賬號或恢復賬號。

如果需要配置全體人員，請從部分人員選項下勾選所有人員和部門，不要直接選擇‘全體成員’

3)申請發布

每次調整過應用後，都需要創建新的版本，發布並提交給公司的飛書管理員審核。確保版本是已上架纔能正常使用調整後的內容。

根據調整的內容不同，有些是自動審核通過，有些則需要管理員手動操作審核。下圖是管理員手動審核的地方。

可以請管理員將此應用設置為免審核，這樣我們提交發布申請後自動通過審核。

11、完善HAP中和飛書的對接信息​

將App ID和App Secret寫入到下麵的地方

如何獲取App ID和App Secret

12、同步通訊錄​

同步後，會將飛書的人員信息新增到更新同步進HAP

同步前必看​

從飛書的通訊錄同步到HAP，是依據手機號和郵箱（優先手機號）進行匹配關聯的。

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

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

  • HAP賬號要在組織內

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

在手機號匹配不上時，會再按郵箱搜索匹配，在點此查看具體的匹配關聯流程

在同步前，管理員要做好及明晰以下3點：

  • 1、確定好使用HAP的飛書賬號範圍， 範圍設置參考本文第9步。

  • 2、已經有HAP賬號的且加入組織的員工，一定要讓員工核對好HAP賬戶綁定的手機號和飛書的手機號是否一緻，如果不一緻，請盡快綁定或換綁保持一緻，全部確認後再進行同步通訊錄的操作。

  • 3、還沒有HAP賬戶的員工，點擊同步後，會自動創建一個HAP賬戶，賬戶會綁定一個隨機生成的郵箱

13、完成集成​

進入飛書工作臺，可以直接打開HAP。

  • 飛書PC端

  • 飛書APP

常見問題​

1、請求非法，請聯係應用開發者​

這是因為沒有找到重定嚮地址，請參考第6步，在安全設置中配置重定嚮URL

2、同步通訊錄時，提示接口錯誤。​

這是因為申請的權限接口缺少，請參考第8步，添加需要的權限。

3、提示同步失敗​

文檔問題反饋

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