# 集成企业微信（代开发自建应用）

URL: https://docs.ones.cn/admin/account-integration/third-party-integration/wechat-work-custom-app

# 1.集成能力

通过代开发自建应用集成企业微信后，支持：

| 功能名称 | 功能说明 |
| --- | --- |
| 用户目录同步 | 同步企业微信组织架构至ONES，实现统一账号管理 |
| 登录验证 | 通过企业微信登录到ONES，实现安全快捷地单点登录 |
| 消息通知 | ONES消息通知到企业微信，并点击查看详情页面 |

# 2.功能入口

管理员可在【配置中心】页面，点击「添加账号集成」并选择「企业微信」进行添加集成配置

![集成企业微信（代开发自建应用） 配图 1](https://docs.ones.cn/assets/images/5a12034e799e37ec-7f994f2f44b28c03bfb06ddae1626aaa.png)

# 3.添加集成流程

### 3.1进入「添加企业微信」集成页面

### 3.2企业微信管理员扫码授权

企业微信管理员在「添加企业微信」集成页面（图左），扫码后并在手机端同意授权（图右）

![集成企业微信（代开发自建应用） 配图 2](https://docs.ones.cn/assets/images/9c34e89114764a22-1c771bef0d2f780f7f1b54e3c10841c5.png)

### 3.3提供希望配置的「应用名称」「Logo」「主页地址（添加集成页面里复制）」给ONES业务同学

![集成企业微信（代开发自建应用） 配图 3](https://docs.ones.cn/assets/images/3922949e54db993c-7006511c00cd90195290ae853aeb81b3.png)

### 3.4企业微信管理员收到「请求变更权限」通知时，点击「同意授权」

![集成企业微信（代开发自建应用） 配图 4](https://docs.ones.cn/assets/images/0c4a53b70b919277-b07892ee4781d92c772be97461e7b1b6.png)

### 3.5企业微信管理员收到开发完成通知，进行应用可见范围配置

可在企业微信移动端或PC端，完成应用可见范围的配置

![集成企业微信（代开发自建应用） 配图 5](https://docs.ones.cn/assets/images/3a63445e112a9b47-8f012dec4ef6208634c762735dd547b2.png)

### 3.6待ONES业务同学通知：应用成功上线后，再次进入「添加企业微信」集成页面

应用未上线时，将无法添加集成。在等候期间，可离开添加集成页面等待。

### 3.7确认「选择账号绑定方式」

「账号绑定方式」用于匹配企业微信账号和ONES系统已有账号，具体规则可查看 [账号绑定方式](https://docs.ones.cn/admin/account-integration/start-to-account-integration/account-binding/) 。

![集成企业微信（代开发自建应用） 配图 6](https://docs.ones.cn/assets/images/dba24700f9f0f870-73018a65ee5f5b2013982b9347500b99.png)

### 3.8确认「配置用户属性映射」

![集成企业微信（代开发自建应用） 配图 7](https://docs.ones.cn/assets/images/d97f14f2446a49bb-3f2a7076f69a0d4a18856995671690c9.png)

目前系统支持同步的字段包含：用户名、邮箱、工号、公司、职位，对应企业微信用户属性值见： [读取成员](https://developer.work.weixin.qq.com/document/path/96255)

注意确认企业分辨当前在企业微信中使用的是「邮箱：email」还是「企业邮箱：biz_mail」，并填入「企业微信用户属性-邮箱」中

### 3.9点击添加，可开启集成相关功能

![集成企业微信（代开发自建应用） 配图 8](https://docs.ones.cn/assets/images/adb65028bad04eaa-514f36e58bb8b550185e938ed695a6bd.png)

# 4.使用集成

### 4.1开启「用户目录同步」与「登录验证」后

##### 4.1.1由于企业微信政策影响，ONES无法直接获取成员邮箱与所属部门。开启用户目录同步后，「成员管理」页面：将出现「未激活且无归属部门成员」和「企业微信的组织架构树」。

![集成企业微信（代开发自建应用） 配图 9](https://docs.ones.cn/assets/images/a0237a0f087ef22e-4d3e5cbd05f9f9fae0920da54bc45e10.png)

##### 4.1.2成员首次登录

- 成员需勾选「邮箱」，同意「个人敏感信息授权」
- 不管首次登录发生在「4.1.3中的任意登录路径」，都将出现「个人敏感信息授权」，成员需勾选「邮箱」，并同意「个人敏感信息授权」（下图以浏览器访问登录链接为例）
- 获取邮箱后，ONES将根据邮箱进行「新成员账号自动创建」或「现有成员账号自动绑定」
- 当该邮箱在组织中无匹配邮箱，将进行「新成员账号自动创建」，成员需完成「验证邮箱」后，将进入系统
- 当该邮箱在组织中有匹配邮箱，将进行「现有成员账号自动绑定」，成员将进入系统
- 完成上述步骤后，成员首次登入系统。此时，该成员在「成员管理」页面：将变为已激活，并存在所属部门
![集成企业微信（代开发自建应用） 配图 10](https://docs.ones.cn/assets/images/14e7f1fbc0a606ff-d75db58ab0867652d282e9a3a47b4fdb.png)

##### 4.1.3登录路径

成员可通过以下路径进行企业微信登录：

- 浏览器访问登录链接（登录链接可在集成页面复制）
- 浏览器访问组织中的工作项或wiki链接
- 企业微信PC客户端应用访问「消息通知」或「应用主页」
- 企业微信移动客户端应用访问「消息通知」或「应用主页」

### 4.2开启消息通知后

开启企业微信消息通知后，还需要在对应ONES Project和ONES Wiki业务中勾选对应的通知方式，详见 [消息通知](https://docs.ones.cn/admin/account-integration/what-is-account-integration/notifications/)