> ## 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 产品中。它适合已经使用企业微信办公，并希望复用企业成员身份、部门结构和企业安全校验的团队。

***

## 可以接入哪些能力

| 能力                                              | 适合场景              | 说明                       |
| ----------------------------------------------- | ----------------- | ------------------------ |
| 企业微信登录                                          | 内部系统、员工门户、企业白名单访问 | 员工可通过企业微信扫码或企业微信内置浏览器登录  |
| 成员访问控制                                          | 只允许企业内成员访问        | 按企业、应用可见范围或部门范围控制访问      |
| [企业微信通讯录](/superun/integrations/wecom-contacts) | 成员查询、部门树、组织权限     | 读取企业微信成员和部门数据，用于组织架构相关流程 |

***

## 接入前需要准备

* 已完成企业认证的企业微信账号。
* 企业微信管理后台管理员权限。
* 一个企业微信自建应用，并取得 **CorpID**、**AgentID** 和 **Secret**。
* 已完成 ICP 备案、且备案主体与企业微信认证主体一致的自有域名。
* 将 superun 项目发布上线并绑定自有域名。

如果还没有创建自建应用，先参考 [企业微信自建应用后台配置指南](/superun/skills/wecom/wecom-self-built-app-setup) 完成后台配置。

<Warning>
  企业微信对域名和主体一致性要求较严格。在 superun 开发预览域名下调试时，授权、登录等能力可能无法通过企业微信安全校验。建议先发布并绑定自有备案域名后再测试。
</Warning>

***

## 如何在 superun 中启用

<Steps>
  <Step title="创建企业微信自建应用">
    按照 [企业微信自建应用后台配置指南](/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="/superun/skills/wecom/wecom-self-built-app-setup">
    从创建自建应用到配置域名、可信 IP、可见范围和应用凭证。
  </Card>

  <Card title="企业微信通讯录" icon="users" href="/superun/integrations/wecom-contacts">
    接入成员查询、部门树、组织架构和身份映射能力。
  </Card>
</CardGroup>