企業號如何接入第三方雲服務

【前言】

微信企業號作為企業移動應用的入口和平台，非常歡迎和第三方廠家一起攜手向企業客戶提供服務。

第三方廠家大致為兩類：定製化服務廠商和標準化雲服務廠商。本文著重描述了第三方雲服務如何與企業號進行對接，以降低客戶管理員進行相關配置的難度，提升對接效率。本文所述的方法，同樣也適用於同定製化廠商的對接。

 

【對接前的準備】

1.         選擇合適的第三方雲服務廠商，了解清楚所提供的雲服務的能力符合你的需求。

2.         對接前要了解幾個基本概念。

第三方應用調用企業號接口時，需要用到三個重要參數：

應用ID：需創建應用後獲得。

CorpID和Secret：第三方應用調用企業號接口的必要參數之一。需創建管理組後才能獲得。

 

而企業號回調第三方應用服務時，也需要用到幾個參數：

回調URL、Token、EncodingAesKey。這三個參數由第三方服務商提供，需要在企業號後台配置好。

 

因此，對接前要做的三項工作是：

 

 

【操作指南】

企業號的消息都是以“應用”來推送的，用戶也必須通過“應用”與企業後台服務交互。因此，第三方雲服務也應以“應用”的形態存在，來對用戶推送消息。

下麵將以“某財務係統”為例，詳細說明接入第三方雲服務，在企業號側的配置方法及注意事項。

 

第一步：建立應用，獲取應用ID

1）首先登錄企業號管理後台，進入“應用中心”創建一個應用，用來與第三方服務進行對接。

 

2）選擇該應用的可見範圍。請注意：可見範圍決定了，企業中哪些成員可以見到這個應用，同時也意味著應用可以給哪些成員發消息。請根據實際需要選擇即可。

 

3）創建完成後，查看該應用，可以獲得該應用ID。這個ID將作為第三方調用企業號接口的參數。

 

第二步：創建管理組，獲取接口能力

使用企業號接口，必須用到CorpID和Secret兩個參數。而這兩個參數，需要創建管理組來獲取。

1）在“設置”中，進入“權限管理”。

 

2）如下圖所示，配置好管理組的各項權限。這裏的設置項將決定第三方應用可以做哪些操作，請務必謹慎設置。

 

應用權限：這裏選擇需要接入的應用即可。“發消息”指的是隻能使用該應用推送消息，“配置應用”指的是除了推送消息，還可以修改應用的配置項。

 

通訊錄權限：指定該管理組可以對通訊錄中哪些成員進行查看或管理。除非第三方應用需要修改企業通訊錄，否則，這裏建議設置為“查看”權限即可。

 

敏感接口權限：指定該管理組可以使用哪些敏感接口。這些接口的作用，及可能帶來的後果分別如下。

獲取部門成員：獲取指定部門下的成員列表。

獲取部門列表：獲取通訊錄下的部門列表。該接口與“獲取部門成員”接口結合使用，將可獲取到企業通訊錄中的所有成員列表。

獲取成員信息：獲取對應成員的詳細信息，包括成員的頭像、手機、郵箱、職務及其他自定義的字段。通常來說，第三方應用未必需要使用到這些詳細信息，該接口建議謹慎授權。

獲取標簽成員：獲取某標簽下的成員列表。與獲取部門成員接口類似。

維護通訊錄：修改通訊錄內容的接口。建議謹慎授權，若第三方應用無需維護通訊錄，則請勿開啟該權限。否則若企業通過其他方式同時維護通訊錄時，可能會造成通訊錄數據相互覆蓋。

3）配置完成後，在該管理組的下方，可以得到CorpID和Secret兩個參數。將這兩個參數提

供給第三方即可。

 

 

第三步：在應用中配置回調參數

如需要企業號將某些用戶事件通知給第三方應用，還需要將應用設置為“回調模式”

1）在“應用中心”裏麵找到“回調模式”，開啟“回調模式”。

2）在彈出的頁麵中填寫回調第三方所需要的必要參數，這幾個參數需要由第三方服務商提供。

配置好這三步，就可以使用該應用與第三方進行連接了。