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賬號要在組織內
示例: 在飛書中,員工綁定的手機號是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、提示同步失敗
文檔問題反饋
文檔中是否有錯彆字、內容過期、難以理解等問題? 點此給我們反饋吧