400-888-0545
首页 > 关于我们 > 新闻详情
O2OA协同办公平台,如何支持微信公众号集成?
发布时间:

O2OA平台拥有配套的原生开发的安卓和IOS移动APP,目前O2OA已经支持微信公众号的集成,用户可以通过关注微信公众号进行工作处理。并且支持待办工作的消息提醒。本文主要介绍如何将O2OA集成到微信公众号上去。


可以先扫下面的二维码关注我们公司的微信公众号进行体验(或者直接文字搜索公众号:浙江兰德网络)

一、自行注册认证微信公众号

首先需要用户自行准备微信公众号,注册地址:https://mp.weixin.qq.com


二、启用配置


公众号管理平台启用服务器


到微信公众号的管理平台,左边菜单底部的【开发】那栏,找到【基本配置】这个菜单点击进入配置页面。


这里分两种情况。

第一,如果公众号本来就已经开启了这个开发服务器配置功能,也就是你们后台本来就有公众号的程序在运行了的。那上面这些数据都已经有了,只需要把一些关键信息复制到O2OA后台的公众号相关的那个配置文件(mpweixin.json)中就行了。


第二,如果公众号没有开启过这个服务器配置,那就需要启用服务器配置信息。这里需要注意的是,因为微信的要求,服务器必须要用http(80) https(443)这两个默认端口,所以O2OA需要开启80端口代理模式。【文章链接】

这里有一点要注意,开启服务器配置,会把公众号原有的菜单清除掉,所以先记得备份记录一下原有的菜单结构和数据。


从上往下说明下:

1 开发者ID(AppID)这个是默认生成的,需要复制到配置文件(mpweixin.json)

2 开发者密码(AppSecret) 这个需要开启,并记录下这个值,需要复制到配置文件(mpweixin.json)

3 IP白名单 这个需要配置,就是你们部署的O2OA服务器的外网的ip地址,O2OA需要访问微信服务器,如果没有配置ip地址,微信那边会拒绝访问。

4 服务器地址(URL) http://O2OA服务器的外网访问地址/x_program_center/jaxrs/mpweixin/check

5 令牌(token) 自定义字符串,可以自行写一个,比如o2oa。需要复制到配置文件(mpweixin.json)

6 消息加密密钥(EncodingAESKey)这个用旁边的自动生成按钮,点击生成一个就行。需要复制到配置文件(mpweixin.json)

7 消息加密方式  选择明文模式。


这里填写和生成各种参数完成后先不要点击保存。先将这些参数配置到O2OA后台的一个配置文件中,如下说明


O2OA服务器配置mpweixin.json配置文件


到O2OA服务器后台config目录下,打开,如果没有就创建一个mpweixin.json文件,如下把前面公众号管理平台生成的参数填入对应的位置

mpweixin.json:

{
"enable": true,
"appid":"填入AppID",
"appSecret":"填入AppSecret",
"token":"填入token",
"encodingAesKey":"填入EncodingAESKey"
}

将mpweixin.json文件保存,重启O2OA服务器。然后就可以在公众号后台那个服务器配置表单点击保存。这个时候提示配置成功就表示公众号和O2OA服务器关联已经完成。


公众号菜单管理

如果微信公众号启用了服务器配置,那公众号的菜单将由配置的服务器管理,不能在公众号的管理平台编辑了。所以O2OA提供了管理公众号菜单的功能。


目前菜单支持3种形式:

分别是发送文字消息点击菜单打开一个网页点击菜单打开一个关联小程序


第一级菜单最多支持3个,第二级菜单最多支持5个。


O2OA 关联菜单配置

O2OA可以关联到公众号菜单,并用网页的形式打开O2OA的页面,可以进行办公操作。

用户关注公众号,这个公众号用户需要和O2OA的内部用户进行一次绑定。这样公众号用户和O2OA的用户之间就建立了联系,就可以打开处理O2OA内部的工作页面。

所以需要建立两个网页菜单,一个是绑定账号、一个是工作页面。


绑定账号

固定形式的URL:

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx1c0c41e607a8b6fe&redirect_uri=【https】%3A%2F%2F【sample.o2oa.net】%2Fx_desktop%2Fmpweixinsso.html%3Ftype%3Dbind&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect

需要注意修改【】符号包含的内容。

第一个是http 或 https

第二个是O2OA访问域名


工作页面

URL:

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx1c0c41e607a8b6fe&redirect_uri=【https】%3A%2F%2F【sample.o2oa.net】%2Fx_desktop%2Fmpweixinsso.html%3Ftype%3Dlogin%26redirect%3Dportalmobile.html%253Fid%253D【mobilePortal】&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect


需要注意修改【】符号包含的内容。

第一个是http 或 https

第二个是O2OA访问域名

第三个是跳转的门户ID


模版消息

目前微信公众号只支持主动给用户发送模版消息,模版消息是服务号才有的功能。所以需要O2OA的待办消息推送给公众号的用户,公众号必须是服务号。


到公众号管理平台,菜单【功能】模块下的,【模版消息】。如果没有【模版消息】这个菜单,点击下面的 添加功能插件 中找到模版消息,添加到菜单中。

到模版消息的模版库中找一个待办消息类的模版,点击详情可以查看模版的格式,如:

这里主要关注详细内容,就是模版的内容,里面有几个参数表示可以替换成需要的业务字段,最终消息的展示结果可以看左边的内容示例。

把这个模版添加到我的模版中。


准备好模版后,到O2OA服务器配置mpweixin.json配置文件:

{
"enable": true,
"appid":"填入AppID",
"appSecret":"填入AppSecret",
"token":"填入token",
"encodingAesKey":"填入EncodingAESKey",
"portalId":"O2OA门户ID,工作处理完成后打开的门户页面的id",
"messageEnable": true, //模版消息是否启用
"tempMessageId": "模版消息id",
"fieldList": [
	{"name": "title", "tempName": "keyword1"},
	{"name": "creatorPerson", "tempName": "keyword2"},
	{"name": "activityName", "tempName": "keyword3"}
	]
}

这里有几个字段配置:

portalId : O2OA门户ID,工作处理完成后打开的门户页面的id

messageEnable : 模版消息是否启用,启用才会发送待办消息到用户

tempMessageId : 模版消息id,就是上面选择的那个模版的ID

fieldList : 这个是模版的内容中业务字段的对应关系,目前O2OA提供了这几个业务字段 【creatorPerson:创建人,  activityName: 当前节点,  processName: 流程名称, startTime: 开始时间, title 标题】。这个配置方式就是把业务字段和模版内容字段一一对应起来,name 代表业务字段名,tempName 代表模版字段名。 如 {"name": "title", "tempName": "keyword1"} 就表示把O2OA工作的title字段,放入到模版内容的keyword1字段的位置上去。


模版中 first 和 remark 字段是固定形式,不需要配置。


效果如下: