跳至主要内容

釘釘、企微、飛書集成HAP時組織結構的同步規則介紹


HAP已經完成和釘釘、企微和飛書的對接集成,在對接後,需要同步兩側的賬號以及組織架構的信息。

一、同步的字段

同步的方嚮: 【企微/釘釘/飛書】的賬號和部門信息同步覆蓋到HAP。

如下錶所示,是目前支持同步的字段,√錶示支持同步,X錶示不支持同步。

說明:

  • 手機號和郵箱

    • SaaS不支持同步,是因為需要通過手機號和郵箱來匹配兩個平臺之間的已有賬號是否是同一個人

    • 企業微信集成時不能獲取到企業用戶的手機號和郵箱

    • 私有部署的釘釘和飛書在綁定賬號後,支持將手機號和郵箱同步覆蓋到HAP

  • 工號: 企業微信默認不同步,但支持綁定自定義字段信息實現同步

  • 職位: 企業微信可通過職務字段同步

  • 組織角色: 企業微信可通過選擇同步標簽字段

二、同步的依據字段

優先通過手機號,其次通過郵箱

優先通過手機號來匹配兩個平臺之間的賬號,如果手機號找不到,則通過郵箱查找匹配,如果依舊匹配不到,則創建新的HAP賬號並建立關聯,新的HAP賬號綁定的是一個虛擬的郵箱。

僅支持釘釘和飛書,企業微信需要手動同步並選擇綁定的賬號

賬號匹配流程圖

以下2種情況不會匹配關聯

  • 1、HAP係統中已經有相同的手機號/郵箱賬戶,但是不在這個您的組織中,不匹配關聯。

  • 2、HAP賬號已經邀請加入組織,但是對方還未激活,不匹配關聯。

三、同步的用戶範圍

僅僅會將【釘釘/企業微信/飛書】側的有效激活賬號同步覆蓋到HAP。

如果同步後,釘釘/企業微信/飛書的賬號離職瞭,再次同步後,HAP這邊的賬號也會自動辦理離職。

  • 1、企業微信側同步的用戶範圍設置

    選擇人員的範圍可以是部門、成員和標簽,如果選擇瞭成員和標簽,那麼不會同步部門信息的。

    特殊規則:如果您想同步完整的部門結構,但又有部分用戶不想同步到HAP占用賬號數量(如實習生),您可在企業微信通訊錄管理中添加自定義文本信息字段“同步”,並將不同步的賬號設置為0,HAP會識彆此標識且不進行同步。詳情參考

  • 2、釘釘側同步的用戶範圍設置

    注意,這裏是同步的人員,如果同步的人在釘釘工作臺可見HAP應用,還需要設置以下範圍。

  • 3、飛書側同步的用戶範圍設置

四、如何定時同步

釘釘、飛書完成集成對接後,支持定時自動同步通訊錄,如每天淩晨1點自動同步一次。

企業微信同步時由於不能獲取用戶的手機號郵箱等信息,無法自動綁定賬戶,不能定時同步。

  • 接口地址:

    https://liteapi.mingdao.com/sync?p=xxxx&c=yyyy

    私有部署地址為:${服務器地址}/integrateapi/sync/auto?p=x&c=y ,例如,http://172.17.30.60:8880/integrateapi/sync/auto?p=x&c=y

  • 參數說明:

    • 參數P

      是36位的組織編號,獲取路徑:HAP組織管理 > 組織信息 > 組織編號

    • 參數c

      不同對接平臺的參數值如下:

      • 釘釘使用的是 CorpId; 在釘釘後臺首頁獲取。

      • 企業微信使用的 企業ID; 在企微管理後臺獲取。

      • 飛書對接使用的是 App ID; 在飛書對接應用中獲取。

      • 華為雲對接使用的是 client_id

使用示例

可以在任意應用創建一個定時觸發的工作流,觸發後調用發送API請求節點即可。注:觸發時間頻率根據需要設定,人數越多同步越慢,因此頻率可以低一些,建議最多控製在每小時一次


文檔問題反饋

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