[]

与企业微信集成

1. 概述

1.1 功能概述

随着移动办公的普及，Wyn 支持深度集成企业微信，实现组织架构与权限的自动同步，用户无需切换应用即可在企业微信内直接访问系统文档，打造无缝办公体验。

不仅如此，企业微信用户可以直接扫码登录到 Wyn 站点中，无需重新创建账号体系。

type=info
注意： Wyn仅支持通过 Https 域名的方式与微信集成，因此发布系统时请使用 Https 域名进行发布。

2. 操作步骤

2.1 系统发布

将 Wyn使用 Https 域名发布的方式进行发布。可以使用 Wyn 内置 Https 设置来发布站点（系统配置（包含启用内置https步骤）），也可以使用反向代理发布（使用Nginx反向代理部署Wyn（或部署为子应用程序））。
例如，我们发布后的域名为 “https://wynportal.grapecity.com/”，后续步骤以此为例进行介绍。

2.2 登录企业微信管理后台

登录企业微信管理后台：https://work.weixin.qq.com/wework_admin/loginpage_wx?from=myhome

2.2.1 创建新应用

在企业微信管理后台，单击「应用管理>应用管理>应用>创建应用」，弹出创建新应用的弹窗。
在创建新应用的弹窗中，上传应用logo ，填写应用名称并选择可见范围，最后单击创建应用按钮即可完成新应用的创建。

2.2.2 设置可信域名

在应用首页下方的 开发者接口 中找到网页授权及JS-SDK，然后单击设置可信域名，将根域名即Wyn发布的网站地址设置为可信域名（不包含协议头）。如下图。

2.2.3 配置企业可信IP

在应用首页下方的 开发者接口 中找到企业可信IP，然后单击配置，将根域名即Wyn发布的网站地址的IP设置为可信IP，如下图。

2.2.4 设置应用主页

单击应用主页 中的设置，设置应用主页。

格式为： {portal address} /wechat4work/sso?redirectUri= {portal address} 。
如：https://wynportal.grapecity.com/wechat4work/sso?redirectUri=https://wynportal.grapecity.com。

type=info
注意： 若用户要集成AI对话分析页面，在redirectUri的路径后面要加上/dashboards/chatanalysis，例如：

2.3 系统端配置

系统管理员登录后，依次单击「系统设置>安全设置>外部用户提供程序」，选择企业微信，配置集成信息。

配置项说明：

配置项目	说明	备注
企业Id	填写企业微信的企业ID。
Secret	具体应用的Secret。	在“ 应用管理 ”标签下，“ 应用>自建 ”中找到自建应用。需要发送到企业微信中查看。
AgentId	具体应用的AgentId。	在“ 应用管理 ”标签下，“ 应用>自建 ”中找到自建应用。
最大并发请求数	同步数据时，单次请求同步的用户数量。	建议使用保持默认数据。如同步失败，请尝试将请求数调低。
启用扫码登录	是否开启二维码登录功能。	有关扫码登录的更多介绍，请见微信用户扫码登录。
启用自动同步	是否开启自动同步数据功能。同步数据指的是将企业微信中的用户数据同步到 Wyn 中。	-
同步时间间隔	设置自动同步数据的时间间隔，必须填入正整数，单位“小时”。输入非正整数时，均按1小时计算。	-
同步数据（按钮）	手动同步数据按钮。	-

按照上图中设置完成后，可直接保存设置。这里我们开启了自动同步数据功能，将时间间隔设置为1小时。最后单击保存按钮保存设置。
保存之后系统检测到您开启了自动同步数据功能（约15分钟后），会立即进行首次的数据同步。之后会按照设置的间隔进行自动同步。
1）为了可以立即将企业微信中的用户数据同步到系统中，我们可手动同步数据。

2）提示数据同步成功。

2.4 查看企业微信映射

此时整个配置过程基本完成，可查看企业微信在 Wyn 中的映射情况。
1）可见企业微信是作为全局下的一个单独组织存在。

type=info
提示： 如您需要在企业微信组织中添加新的组织、角色或用户，推荐直接在企业微信端操作，因为Wyn会通过数据同步将企业微信端的最新组织结构覆盖到系统中。

2.5 企业微信登录

在手机中登录企业微信，可以在工作台栏中看到自己创建的应用。单击应用图标，选择组织后即可自动登录 Wyn 。