您当前的位置: 首页 > 

O2OA R&D

暂无认证

  • 5浏览

    0关注

    306博文

    0收益

  • 0浏览

    0点赞

    0打赏

    0留言

私信
关注
热门博文

O2OA开源协同办公平台,如何支持微信公众号集成?

O2OA R&D 发布时间:2021-05-07 09:39:02 ,浏览量:5

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 字段是固定形式,不需要配置。

 

效果如下:

(转自公众号:浙江兰德网络)

 

关注
打赏
1661237735
查看更多评论
立即登录/注册

微信扫码登录

0.1922s