通義靈碼與企業(yè)微信集成配置指南 - 專屬版功能詳解

2025-04-22 16:00 更新

企業(yè)微信集成支持同步企業(yè)微信通訊錄到企業(yè)的用戶管理,同時支持企業(yè)微信的單點登錄。

適用版本

專屬版

創(chuàng)建范圍外用戶

企業(yè)管理員可以在企業(yè)管理 > 第三方集成中配置和管理企業(yè)微信集成。如果需要創(chuàng)建不在企業(yè)微信同步范圍的用戶,可以勾選支持內(nèi)建用戶,可以創(chuàng)建同步范圍外的用戶。

1-3

配置企業(yè)微信集成信息

步驟一 配置企業(yè)內(nèi)部應(yīng)用

  1. 首先需要在企業(yè)微信管理后臺上創(chuàng)建企業(yè)內(nèi)部應(yīng)用,可參考查看如何創(chuàng)建企業(yè)自建應(yīng)用,按照文檔提示填寫創(chuàng)建企業(yè)內(nèi)部應(yīng)用表單信息,然后單擊確定創(chuàng)建。

    1-3

    應(yīng)用圖標:選擇您需要得應(yīng)用圖標。

  2. 當(dāng)應(yīng)用創(chuàng)建好后可以在應(yīng)用詳情中查看 AgentId 和 Secret。

    1-3

  3. 我的企業(yè)中查看企業(yè) ID。

    1-3

  4. 將以上 AgentId、Secret 和企業(yè) ID粘貼到以下輸入框:

    1-3

    企業(yè)內(nèi)部應(yīng)用中的信息填寫完成后,單擊下一步

步驟二 配置應(yīng)用權(quán)限

通義靈碼需要獲取企業(yè)微信的授信,才能夠同步企業(yè)微信通訊錄,以及通過企業(yè)微信登錄,因此需要設(shè)置可信域名和可信 IP。

進入企業(yè)微信管理后臺,在第一步已創(chuàng)建的企業(yè)應(yīng)用詳情頁面開發(fā)者接口中配置授信:

1-3

配置可信 IP 之前需要先配置可信域名,可信域名在通義靈碼配置企業(yè)微信界面獲取:

1-3

當(dāng)前企業(yè)的可信 IP,請聯(lián)系技術(shù)支持人員獲取。

步驟三 配置信息同步與映射

賬號綁定方式:自動綁定的登錄賬號相同的用戶,按照同步策略,自動將通義靈碼上、企業(yè)微信通訊錄中登錄賬號相同的用戶綁定在一起。

通義靈碼將按照下圖中字段映射關(guān)系,自動將企業(yè)微信的用戶信息與通義靈碼中的用戶信息,按照同步策略進行映射同步,確認后單擊下一步。

1-3

步驟四 開啟企業(yè)微信集成的功能服務(wù)

目前提供 2 種功能服務(wù):

  • 用戶和組織同步:開啟后,可保持通義靈碼用戶管理中的用戶目錄和企業(yè)微信通訊錄的同步,建議確認企業(yè)微信應(yīng)用可見權(quán)限范圍。

  • 單點登錄:開啟后,在通義靈碼登錄頁面中即可快速跳轉(zhuǎn)到企業(yè)微信登錄頁面,通過企業(yè)微信登錄通義靈碼。

以上 2 種功能服務(wù)在配置過程中默認不開啟,如果不開啟功能的情況下保存企業(yè)微信集成配置,后續(xù)可以在企業(yè)微信集成詳情頁面中開啟對應(yīng)的功能服務(wù)。

如果選擇開啟對應(yīng)功能的情況下,需要進行相關(guān)配置(以下內(nèi)容適配于修改對應(yīng)功能配置)。

開啟企業(yè)微信的用戶和組織同步

當(dāng)通義靈碼上未開啟其他第三方集成的用戶和組織同步功能時,可以配置企業(yè)微信的用戶和組織同步,支持配置同步時機、用戶差異處理、組織差異處理的規(guī)則。

6-8

  • 數(shù)據(jù)同步時機:默認為手動同步,并支持手動同步、定時同步的切換。

    • 手動同步:需要站點管理員在有數(shù)據(jù)變更后,手動在企業(yè)微信集成詳情頁面單擊執(zhí)行手動同步按鈕完成用戶和組織同步。

      說明

      提示:每次手動同步操作盡量間隔 1 個小時。

    • 定時同步:配置同步的時機和規(guī)則按每天(某刻)、每周(某天某刻)、每月(某天某刻)、每隔一定時間進行同步,如果設(shè)置為定時同步,建議保存配置后完成一次手動同步,以保證數(shù)據(jù)可以及時同步至通義靈碼。

  • 用戶差異處理:默認忽略通義靈碼上多余的賬號,并為在同步范圍內(nèi)的企業(yè)微信賬號創(chuàng)建通義靈碼賬號并綁定,可根據(jù)訴求修改:

    • 已有通義靈碼賬號未匹配到企業(yè)微信賬號-忽略:當(dāng)已有通義靈碼賬號未匹配到企業(yè)微信賬號時,不刪除通義靈碼上的多余賬號。

    • 已有通義靈碼賬號未匹配到企業(yè)微信賬號-刪除通義靈碼賬號:當(dāng)已有通義靈碼賬號未匹配到企業(yè)微信賬號時,刪除通義靈碼上的賬號。

    • 已有企業(yè)微信賬號未匹配到通義靈碼賬號-忽略:當(dāng)已有企業(yè)微信賬號未匹配到通義靈碼賬號時,不在通義靈碼上創(chuàng)建新賬號。

    • 已有企業(yè)微信賬號未匹配到通義靈碼賬號-新建通義靈碼賬號并綁定:當(dāng)已有企業(yè)微信賬號未匹配到通義靈碼賬號時,會按照賬號綁定和屬性映射規(guī)則在通義靈碼上創(chuàng)建新賬號,并與企業(yè)微信賬號綁定。

  • 組織差異處理:默認忽略通義靈碼上多余的部門節(jié)點,并為在同步范圍內(nèi)的企業(yè)微信部門節(jié)點創(chuàng)建通義靈碼部門并綁定,可根據(jù)訴求修改:

    • 已有通義靈碼部門未匹配到企業(yè)微信部門-忽略:當(dāng)已有通義靈碼部門未匹配到企業(yè)微信部門時,不刪除通義靈碼上的部門節(jié)點。

    • 已有通義靈碼部門未匹配到企業(yè)微信部門-刪除通義靈碼部門:當(dāng)已有通義靈碼部門未匹配到企業(yè)微信部門時,刪除通義靈碼上的部門節(jié)點。

    • 已有企業(yè)微信部門未匹配到通義靈碼部門-忽略:當(dāng)已有企業(yè)微信部門未匹配到通義靈碼部門時,不在通義靈碼上創(chuàng)建部門節(jié)點。

    • 已有企業(yè)微信部門未匹配到通義靈碼部門-創(chuàng)建通義靈碼部門并綁定:當(dāng)已有企業(yè)微信部門未匹配到通義靈碼部門時,會在通義靈碼上創(chuàng)建部門節(jié)點,并將雙方部門節(jié)點進行綁定。

開啟單點登錄

打開單點登錄的開關(guān)后,需要將通義靈碼的回調(diào)地址配置在第一步創(chuàng)建的企業(yè)微信應(yīng)用的應(yīng)用詳情 > 開發(fā)者接口 > 企業(yè)微信授權(quán)登錄 > Web網(wǎng)頁 > 設(shè)置授權(quán)回調(diào)域的輸入框中,即可完成企業(yè)微信單點登錄的配置。

高的 (63)

通過企業(yè)微信登錄

開啟單點登錄后,通義靈碼登錄頁面將顯示企業(yè)微信登錄入口,點擊后可進入企業(yè)微信登錄頁面,已綁定企業(yè)微信賬號的用戶可以通過企業(yè)微信登錄通義靈碼。

查看用戶和組織同步結(jié)果

在開啟用戶和組織同步的情況下,打開第三方集成-企業(yè)微信集成詳情頁面,可以查看最新同步結(jié)果:未執(zhí)行同步、同步成功、同步失敗、部分同步成功。

修改/關(guān)閉企業(yè)微信集成的功能服務(wù)

在第三方集成-企業(yè)微信集成詳情頁中,如果開啟了某個功能服務(wù),可以看到修改服務(wù)配置的按鈕,點擊后即可進行相關(guān)功能服務(wù)配置的修改或者關(guān)閉該功能:

  • 關(guān)閉用戶和組織同步:

    • 不解除通義靈碼賬號與企業(yè)微信賬號的綁定關(guān)系。

    • 不再執(zhí)行企業(yè)微信通訊錄的用戶和組織同步。

  • 關(guān)閉單點登錄:

    • 不會解除通義靈碼賬號與企業(yè)微信賬號的綁定關(guān)系。

    • 不支持通過企業(yè)微信賬號登錄通義靈碼,用戶若需要登錄通義靈碼,可使用通義靈碼的登錄賬號和密碼進行登錄。

移除企業(yè)微信集成

在第三方集成-企業(yè)微信集成詳情頁中,可單擊移除集成按鈕,二次確認后即可移除企業(yè)微信集成,移除集成后:

  • 解除通義靈碼賬號和企業(yè)微信賬號的綁定關(guān)系,不會影響已同步的用戶和組織架構(gòu)信息。

  • 不支持通過企業(yè)微信登錄通義靈碼,用戶若需要登錄通義靈碼,可使用通義靈碼的登錄賬號和密碼進行登錄。


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號