跳至主要内容

企業微信對接指南


對接方式說明: 根據企業微信自建應用的策略規定,SaaS平臺要對接企業微信,需通過“代開發模式”完成對接,即用戶掃碼授權後,統一交給服務商(HAP)完成剩餘的對接工作。

私有部署用戶和已按自助開發模式完成對接的,可參考自助對接方式進行對接或修改

第一階段:授權代開發

1、進入組織後臺授權頁麵

超級管理員依次點擊 個人頭像 > 組織管理 >第三方平臺,選擇企業微信。

企業微信、釘釘、飛書、Welink隻能選擇一個平臺對接,如果已經對接瞭一個,其他平臺就不再顯示瞭。隻有關閉已集成的對接纔可以對接其他平臺。

2、掃碼授權

企業微信管理員用企業微信APP掃描頁麵中的二維碼進行授權。

掃碼後依次點擊頁麵底部的按鈕,直到授權完成。

點擊下圖中的[確認]按鈕,然後聯係您的顧問協助完成第二階段的代開發

在代開發完成前,這個頁麵和企業微信的對接應用都會顯示為開發中

第二階段:代開發協助處理

此階段的操作需要HAP顧問聯係您時一起協作完成,您也可提前瞭解下

3、授權通訊錄權限

在代開發時,HAP需要獲取通訊錄授權,屆時您的企業微信會收到消息推送,點擊授權即可。

操作步驟如下圖:

完成以上步驟後,隻需等待代開發完成,完成後企業微信會有消息提醒,如下圖:

第三階段:完成對接

4、修改對接應用的基本信息

點此打開企業微信後臺,掃碼登錄。

  • 1)打開對接應用

    進入 應用管理 > 應用 > 自建應用欄,點擊 HAPAPaaS平臺。

  • 2)進行相關操作

    可以修改名稱、圖標、描述等信息,或者停用/啓用。刪除應用在當前應用最下方。

5、配置同步人員範圍

貴司使用企業微信的人員是100人,但是使用HAP的人數可能是50人,並非同步所有的賬號。超過HAP授權人數時會無法同步,因此我們可以根據部門和指定人員來確認好同步的人員範圍, 設定範圍如下圖:

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

同步黑名單

如果您想同步完整的部門結構,但又有一些用戶不想同步到HAP(如實習生、兼職人員),您可在企業微信通訊錄管理中添加自定義文本信息字段命名為“同步”,不需要同步的賬號將此字段設置為0,HAP會識彆此標識且不進行同步。

  • 1)通訊錄中添加自定義字段

  • 2)將不需要同步人設置為0

  • 3)授權給HAP獲取自定義信息

    在授權字段中選擇擴展屬性。

6、同步通訊錄

企業微信賬號要一鍵登錄HAP,那麼在HAP也必須要有一個關聯綁定的組織賬戶,對接完成前最後一步就是同步賬戶數據,將企業微信賬戶和HAP組織賬戶綁定起來。

由於企業微信的通訊錄限製,服務商(HAP)在獲取企業微信賬戶時,不能獲取到手機號和郵箱地址,因此在同步時不能準確的匹配兩個平臺間的賬戶,隻能通過相同姓名默認關聯,再由操作人員決定是否關聯正確,如果不正確可以手動關聯。

開始同步

組織超級管理員進入 組織管理後臺 > 集成 > 第三方平臺 > 點擊【同步】按鈕。然後會顯示齣本次同步的內容,確認好綁定同步的內容後點擊確認同步。

本次同步內容:

1)綁定關係

在下方錶格區,將第三方平臺(企業微信)賬戶綁定到HAP組織賬戶

  • 左側是HAP的組織賬號(還未綁定企業微信),在右側選擇要綁定的第三方平臺賬戶。

  • 係統會根據姓名自動匹配相同姓名的賬戶(有姓名匹配標簽),如果不對,可以移除重新選擇綁定

2)同步內容概覽

選擇完成賬號綁定關係後,在上方會有本次同步的信息匯總

  • 新增組織用戶數

    如果獲取到的企業微信賬戶未綁定到組織賬戶,同步時將會自動創建新的HAP賬戶並與之自動綁定。如下圖,右側詹善福(企業微信賬戶)還未選擇綁定,那麼確定同步時會自動創建新賬號。

  • 匹配到已有組織用戶數

    本次同步將要綁定組織賬戶的企業微信賬戶數量。下方的解綁和綁定都會改變此值。

  • 同步企業微信用戶數

    是在本次同步前已經綁定過組織賬戶的企業微信賬戶數量。 再次點擊同步僅同步信息。如果曆史沒有綁定過,則不顯示此項。

3)確認同步

確認綁定關係後,點擊同步按鈕即可。

如果本次同步還有企業微信賬戶沒有被綁定到組織賬戶,則會有以下提示,讓您再次確認,如果無誤,點擊【確認】按鈕即可。

管理已綁定關係

管理員在組織管理後臺>集成>第三方平臺>數據同步中,可以查看和管理現有的賬號綁定關係。

  • 可以查看目前已經綁定的賬戶

  • 可以取消現有綁定,被取消的企業微信賬戶將不能再登錄HAP,再次點擊同步時,可以重新綁定。

7、接口費用

HAP和企業微信做對接,需要調用企業微信的接口。企業微信針對接口的調用是按賬戶數收費的,這筆費由用戶承擔,管理員先在組織後臺下單確認費用,然後聯係顧問代支付給企業微信。

下單時,僅僅為當前所有的用戶購買瞭接口使用權。如果後續有新人增加,需要您為新用戶再次購買。

如果沒有為用戶支付接口費用,在使用時會提示應用無法使用。

企業微信的企業ID

8、啓用微信掃碼登錄

支持企業微信掃碼快速登錄HAP,不過依然需要一些配置,以及和HAP對接人的協作。

詳情參考:

9、查看對接效果

  • 在企業微信工作臺,可以免密登錄HAP

  • 同步瞭部門和人員信息


文檔問題反饋

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