# 微信公众号集成微协同

# 1.1 前置条件

满足使用条件才可以进行私有化微信功公众号部署。

请确认协同系统可以与微协同系统网络互相联通，否则无法进行配置。
请确认微协同系统可以访问微信服务号，否则无法推送消息。
层级目录不能有中文名称。
协同系统的访问地址是公网地址，必须是备案的域名，OA在内网的客户可以使用反向代理，分离部署方案。
微协同服务器地址必须为备案的域名，端口为443，并且为公网地址。
OA版本必须高于或等于8.0SP2版本才支持私有化部署。
私有化部署微协同仅支持服务号集成，不支持订阅号集成。

# 1.2 部署微服务

# 1.2.1 微协同文件

解压wx-core-service.zip文件:

# 1.2.2 改名jdk和wx-core-service 文件夹名称

修改完毕后，保证jdk与wx-core-service这两个文件夹在同一层级

# 1.2.2.1 Linux环境

若为Linux环境，需要为服务器环境中配置JAVA_HOME。

# 1.2.2.2 Windows环境

win环境部署需要单独配置一下wx-core-service/conf/server.xml。

添加上：

<Context path="" docBase="\ROOT\" reloadable="false" ></Context>

添加后应为下图配置：

# 1.2.3 微服务端口配置

端口配置如需更改，修改\wx-core-service\conf目录下的server.xml。具体步骤如下：

# 1.2.4 数据库配置

安装mysql，新建数据库wxt,字符集UTF-8，客户端执行seeyonwx.sql进行数据库初始化。

注意：

1.linux环境在/etc/my.cnf中的[mysqld]后添加添加如下配置，表名不区分大小写： lower_case_table_names=1

2.微协同服务使用的数据库为MySQL，私有化部署包中数据库连接的jar包版本为5.1.38，如果客户使用更高版本的MySQL，请下载对应兼容版本的数据库连接jar包。wx-core-service\webapps\ROOT\WEB-INF\lib该目录下的mysql-connector-java-8.0.20.jar注意替换为数据库对应的版本。如下图所示，需要下载高版本的jar替换低版本的。

# 1.2.5 修改hibernate.properties

wx-core-service\webapps\ROOT\WEB INF\classes\config\spring\hibernate.properties 文件中数据库配置，如下图：

# 1.2.6 修改sysinfo.properties

\wx-core-service\webapps\ROOT\WEB-INF\classes\sysinfo.properties

qyapi_url ：企业微信地址，若企业微信私有部署，写私有部署企业微信地址。 wx_url ：微协同服务外网域名地址（切记要增加 http://，若有端口号，要带上端口号。 qyAdmin：设置登录名（后续登录微协同管理后台使用）。 qyPassword：设置密码（后续登录微协同管理后台使用。

注意：服务号配置参考：1.3.1 服务号开发信息配置到sysinfo

# 1.2.7 启动服务

\wx-core-service\bin中，点击startup.bat启动：

访问对应端口得到这个页面即表示启动正常：

# 1.3 微信服务号后端配置

# 1.3.1 微协同安装程序webapps\ROOT\WEB-INF\classes此路径下的sysinfo.properties文件配置微信公众号的appid和appsecret相应信息

下图中ip白名单配置微协同服务器的地址，并将appid和appsecret配置到sysinfo.properties文件中

# 1.3.2 微信公众号，配置功能设置以及安全域名

根据微信公众号的要求配置业务域名、JS接口安全域名、网页授权域名（此处注意域名和sysinfo.properties文件中的wx_url一致）将微协同服务的地址填上后保存，将该文件下载下来（填写JS接口安全域名时第三步）放在微协同服务器微协同安装目录下webapps\ROOT下，然后在微信公众号上保存

注意的是微协同服务是必须是80或者是https对应的443端口

# 1.4 配置微信公众号菜单

微信公众号已有菜单：在原来的菜单上创建一个菜单，选择跳转网页：

https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=https://微协同地址/menuController/getMenu?accountid=&response_type=code&scope=snsapi_base&state=123#wechat_redirect

APPID：微信公众号的APPID

微协同地址: 微协同服务的地址