> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 企業微信插件

> 在 superun 中接入企業微信登入、成員訪問控制和通訊錄能力。

# 企業微信插件

企業微信插件用於把企業微信帳號體系和組織數據接入到 superun 產品中。它適合已經使用企業微信辦公，並希望複用企業成員身份、部門結構和企業安全校驗的團隊。

***

## 可以接入哪些能力

| 能力                                                      | 適合場景              | 說明                       |
| ------------------------------------------------------- | ----------------- | ------------------------ |
| 企業微信登入                                                  | 內部系統、員工門戶、企業白名單訪問 | 員工可透過企業微信掃碼或企業微信內建瀏覽器登入  |
| 成員訪問控制                                                  | 只允許企業內成員訪問        | 按企業、應用可見範圍或部門範圍控制訪問      |
| [企業微信通訊錄](/zh-Hant/superun/integrations/wecom-contacts) | 成員查詢、部門樹、組織權限     | 讀取企業微信成員和部門數據，用於組織架構相關流程 |

***

## 接入前需要準備

* 已完成企業認證的企業微信帳號。
* 企業微信管理後台管理員權限。
* 一個企業微信自建應用，並取得 **CorpID**、**AgentID** 和 **Secret**。
* 已完成 ICP 備案、且備案主體與企業微信認證主體一致的自有網域。
* 將 superun 專案發佈上線並綁定自有網域。

如果還沒有建立自建應用，先參考 [企業微信自建應用後台配置指南](/zh-Hant/superun/skills/wecom/wecom-self-built-app-setup) 完成後台配置。

<Warning>
  企業微信對網域和主體一致性要求較嚴格。在 superun 開發預覽網域下調試時，授權、登入等能力可能無法通過企業微信安全校驗。建議先發佈並綁定自有備案網域後再測試。
</Warning>

***

## 如何在 superun 中啟用

<Steps>
  <Step title="建立企業微信自建應用">
    按照 [企業微信自建應用後台配置指南](/zh-Hant/superun/skills/wecom/wecom-self-built-app-setup) 建立自建應用，配置應用可見範圍、授權回呼網域和可信 IP。
  </Step>

  <Step title="啟用企業微信插件">
    在「研發」→「技能庫」啟用企業微信插件，填寫 CorpID、AgentID 和 Secret。
  </Step>

  <Step title="選擇要接入的能力">
    先跑通企業微信登入，再按業務需要繼續啟用企業微信通訊錄等子能力。
  </Step>

  <Step title="在正式網域下測試">
    使用已綁定的自有網域測試授權、登入和通訊錄讀取，避免開發預覽網域帶來的安全校驗問題。
  </Step>
</Steps>

***

## 子能力說明

<CardGroup cols={2}>
  <Card title="企業微信自建應用後台配置指南" icon="settings" href="/zh-Hant/superun/skills/wecom/wecom-self-built-app-setup">
    從建立自建應用到配置網域、可信 IP、可見範圍和應用憑證。
  </Card>

  <Card title="企業微信通訊錄" icon="users" href="/zh-Hant/superun/integrations/wecom-contacts">
    接入成員查詢、部門樹、組織架構和身份映射能力。
  </Card>
</CardGroup>