企業微信對接指南
對接方式說明: 根據企業微信自建應用的策略規定,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
同步瞭部門和人員信息
文檔問題反饋
文檔中是否有錯彆字、內容過期、難以理解等問題? 點此給我們反饋吧