跳到主要内容
版本:Cloud

集成企业微信(代开发自建应用)

1.集成能力

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

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

2.功能入口

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

集成企业微信(代开发自建应用) 配图 1

3.添加集成流程

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

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

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

集成企业微信(代开发自建应用) 配图 2

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

集成企业微信(代开发自建应用) 配图 3

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

集成企业微信(代开发自建应用) 配图 4

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

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

集成企业微信(代开发自建应用) 配图 5

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

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

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

「账号绑定方式」用于匹配企业微信账号和ONES系统已有账号,具体规则可查看账号绑定方式。

集成企业微信(代开发自建应用) 配图 6

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

集成企业微信(代开发自建应用) 配图 7

目前系统支持同步的字段包含:用户名、邮箱、工号、公司、职位,对应企业微信用户属性值见:读取成员

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

3.9点击添加,可开启集成相关功能​

集成企业微信(代开发自建应用) 配图 8

4.使用集成

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

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

集成企业微信(代开发自建应用) 配图 9

4.1.2成员首次登录​
  • 成员需勾选「邮箱」,同意「个人敏感信息授权」
  • 不管首次登录发生在「4.1.3中的任意登录路径」,都将出现「个人敏感信息授权」,成员需勾选「邮箱」,并同意「个人敏感信息授权」(下图以浏览器访问登录链接为例)
  • 获取邮箱后,ONES将根据邮箱进行「新成员账号自动创建」或「现有成员账号自动绑定」
  • 当该邮箱在组织中无匹配邮箱,将进行「新成员账号自动创建」,成员需完成「验证邮箱」后,将进入系统
  • 当该邮箱在组织中有匹配邮箱,将进行「现有成员账号自动绑定」,成员将进入系统
  • 完成上述步骤后,成员首次登入系统。此时,该成员在「成员管理」页面:将变为已激活,并存在所属部门

集成企业微信(代开发自建应用) 配图 10

4.1.3登录路径​

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

  • 浏览器访问登录链接(登录链接可在集成页面复制)

  • 浏览器访问组织中的工作项或wiki链接

  • 企业微信PC客户端应用访问「消息通知」或「应用主页」

  • 企业微信移动客户端应用访问「消息通知」或「应用主页」

4.2开启消息通知后​

开启企业微信消息通知后,还需要在对应ONES Project和ONES Wiki业务中勾选对应的通知方式,详见消息通知