企業微信對接指南
對接方式說明： 根據企業微信自建應用的策略規定，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
APP獲取方式
PC 端獲取方式
點此打開企業微信後臺，掃碼登錄
8、啓用微信掃碼登錄
支持企業微信掃碼快速登錄HAP，不過依然需要一些配置，以及和HAP對接人的協作。
9、查看對接效果
在企業微信工作臺，可以免密登錄HAP
同步瞭部門和人員信息
文檔問題反饋
文檔中是否有錯彆字、內容過期、難以理解等問題？ 點此給我們反饋吧