跳至主要内容

企業微信對接指南

對接方式說明： 根據企業微信自建應用的策略規定，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

  • 同步瞭部門和人員信息

文檔問題反饋

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

這篇文件對你有幫助嗎？