一、概述
支持与微信公众号集成,包括“人员绑定”“应用集成到公众号"”消息互通“,即实现在公众号上使用我们的应用,包括推送消息。
二、操作说明
【云桥对外域名】配置说明
集成企业微信需要配置外网域名地址,在【云桥】-【基础参数设置】配置当前系统的外网域名地址,配置好之后点击保存,如下图所示:
【开通服务器网络权限的说明】
1.如果使用本系统进行公众号集成功能,则需要调用公众号接口,并且最终用户是通过公众号来使用集成的功能,所以本系统部署的云桥服务器必须要求,能够访问外网:即开通这台服务器的上网权限,让云桥服务器能够访问互联网,如果贵公司对网络安全要求较高,至少需要让这个服务器能够访问以下地址:
微信公众号API:https://api.weixin.qq.com
2.同时请网络管理员将本系统的访问地址映射到外网。
3.可以用如下方式验证网络是否通畅:
在云桥服务器上按如下方式检查网络:
ping api.weixin.qq.com 查看是否能ping通
Window:
浏览器访问 https://api.weixin.qq.com/cgi-bin/token 查看是否有返回结果
Linux:
执行命令 curl https://api.weixin.qq.com/cgi-bin/token 查看是否有返回结果
微信公众号接入功能主要是在云桥中建立微信公众号接入信息,将基本的公众号原始ID等信息写入到云桥中。
点击后台管理中心,在所有服务中选择云桥或者平台引擎里点击云桥,即可进入云桥页面,访问【微信公众号集成】菜单,点击右上角【新建微信公众号】,如下图所示:
公众号名称:根据需要填写微信公众号的名称;
公众号原始ID:填写微信公众平台左侧菜单【设置与开发】-【公众号设置】中的原始ID,访问微信公众平台https://mp.weixin.qq.com,即可查看;
公众号类型:选择公众号为服务号或订阅号,服务号有获取用户身份的功能,订阅号则没有,所以一般集成都需要是服务号类型;
是否认证:填写公众号是否经过认证,具体访问微信公众平台https://mp.weixin.qq.com查看;
二维码图片:上传此公众号的二维码图片,可以从微信公众平台左侧菜单【公众号设置】中获取,如下图所示:
AppID、AppSecret:在微信公众平台https://mp.weixin.qq.com页面中点击左侧菜单【设置与开发】-【基本配置】,即可获取AppID、AppSecret,如下图所示:
备注:填写对公众号的描述信息;
在微信公众平台页面中点击左侧菜单【设置与开发】-【基本配置】,将当前系统的外网IP配置到IP白名单中,如下图:
在微信公众平台页面中点击左侧菜单【设置与开发】-【基本配置】,点击【启用】开启服务器配置,如下图:
点击【修改配置】,进入服务器配置页面,如下图:
其中页面上的URL、Token、EncodingAESKey三个值从云桥-微信公众号集成-接收消息中复制即可,消息加密方式推荐使用【安全模式】,填写好之后点击提交;
在微信公众平台页面中点击左侧菜单【设置与开发】-【公众号设置】,找到【网页授权域名】,点击【设置】,如下图:
将云桥-微信公众号集成-回调设置中的可信域名填写到网页授权域名中(订阅号忽略此步骤),填写之后点击保存;
填写之后,下载界面上的txt文件,上传到【云桥】-【微信公众号集成】-【可信域名验证】中:
域名校验文件上传之后,点击保存:
需要注意,可信域名不能带有端口号,即云桥的外网地址必须确保是经过ICP备案的域名并且是标准接口(80或443);
如果公众号集成后需要使用到EC系统中的考勤定位,扫码登录等功能,则需要调用公众号的jsapi方法进行实现,调用的前提是设置js接口安全域名,如果不需要使用到此类功能则可以忽略此步操作;
在【云桥】-【微信公众号集成】-【可信域名验证】中复制可信域名:
将复制的可信域名填写到JS接口安全域名中:在微信公众平台页面中点击左侧菜单【设置与开发】-【公众号设置】-【功能设置】,找到【JS接口安全域名】,点击【设置】,如下图:
填写之后,下载界面上的txt文件,上传到【云桥】-【微信公众号集成】-【可信域名验证】中:
域名校验文件上传之后,点击保存:
需要注意,可信域名不能带有端口号,即云桥的外网地址必须确保是经过ICP备案的域名并且是标准接口(80或443);
粉丝管理功能主要是在云桥中管理微信公众号的粉丝数据,将粉丝人员与ecology系统中的人员进行关联;访问【云桥】-【微信公众号集成】-【粉丝列表】,点击同步,即可将公众号的粉丝用户同步到云桥:
从公众号同步操作完成之后,会显示同步的结果,也可以再次进行从公众号同步操作,并且可以对已同步的数据进行维护操作。用户卡片绑定/解绑,如下图所示:
手动绑定(需要配置公众号菜单)
用户完成公众号菜单配置之后,可以直接访问菜单,然后输入正确的系统账号密码后,对应集成的微信公众号集成-粉丝列表中会记录用户的企业微信账号信息以及绑定关系。
菜单管理功能主要是在云桥中将公众号菜单与业务系统(ecology)功能模块进行对接,即实现在微信公众号中使用业务系统的相关业务功能。
进入【云桥】-【微信公众号集成】-【菜单管理】页面,如下图:
这个页面中可以增加菜单,将ecology系统的模块配置到公众号的菜单中,例如将ecology的工作日报发布到公众号中,调用模块选择打开应用,可以直接选择打开应用【工作日报】,如下图:
也可以根据需求选择定义的链接:
链接管理功能和菜单管理类似,可以选择配置EC系统的业务功能,也可以直接配置自定义链接的功能,新建好链接管理:
复制对应的链接,可以直接配置到公众号开发后台的公众号菜单中,如下图:
消息管理功能主要是将OA应用消息推送到微信公众号中,即实现在微信公众号中接收并处理业务系统的消息。消息正常推送的前提是,微信公众号用户要关联OA系统用户账号。
① 在【云桥】-【消息推送设置】-【消息推送规则】 页面,点击新建,如下图所示:
② 例如将 日报 的消息推送到微信公众号:填写好规则名称,消息来源选择日报,如下图所示:
在规则详情页面,点击【新建】,设置推送目标,第三方企业类型选择【微信公众号】,企业和应用根据实际需要,选择对应的企业团队和应用,如下图所示:
模板ID获取方式:访问微信公众平台https://mp.weixin.qq.com,在【广告与服务】-【模板消息】中新建模板或者使用之前的模板ID;
① 消息推送规则设置,消息类型选择【模板消息】;
① 模板ID获取方式:访问微信公众平台https://mp.weixin.qq.com,在【广告与服务】-【模板消息】中新建模板或者使用之前的模板ID;
① 将模板参数配置到云桥,配置完成后点击【保存】;
① 推送效果如下;
需要参考微信公众号订阅通知说明文档https://developers.weixin.qq.com/doc/offiaccount/Subscription_Messages/intro.html,完成步骤一到步骤五的配置工作,才能进行后续操作;
消息推送规则设置,消息类型选择【订阅通知】;
① 模板ID获取方式:访问微信公众平台https://mp.weixin.qq.com,在【广告与服务】-【订阅通知】中新建模板或者使用之前的模板ID;
① 将模板参数配置到云桥,配置完成后点击【保存】;
① 推送效果如下;
l 电脑端
l 手机端
是否带链接:
① 消息推送报错常见错误码查询入口https://developers.weixin.qq.com/doc/offiaccount/Subscription_Messages/api.html;
例如:
此类情况需要用户主动订阅通知,可参考
https://developers.weixin.qq.com/doc/offiaccount/Subscription_Messages/intro.html
① 功能入口:
② 功能说明:微信公众号需要实现针对微信公众号不同动作的回调自动回复不同的内容,比如用户在微信公众号应用会话中输入的内容,我们可以根据用户的动作来设置回复不同的内容给用户。
③ 功能配置:
l首先,在云桥找到需要接收回调消息的公众号,复制【接收消息】页面的参数:
l在微信公众平台页面中点击左侧菜单【设置与开发】-【基本配置】,点击【启用】开启服务器配置,如下图:
点击【修改配置】,进入服务器配置页面,将云桥复制的参数填写到对应位置,点击保存,如下图:
l开启云桥-微信公众号-接收消息里面的【是否开启应用回调】开关:
④ 回调规则设置:
l回调设置新建具体的消息回复规则:
l规则名称:填写该条规则的名称;
l用户动作:指用户给微信公众号应用发送的是文字消息还是图片消息;
l匹配方式:
【包含】用户给微信公众号应用发送文字内容包含设置的关键字,则匹配上该规则,按照该规则自动给用户回复;
【开头】用户给微信公众号应用发送文字内容的开头文字是设置的关键字,则匹配上该规则,按照该规则自动给用户回复;
【结束】用户给微信公众号应用发送文字内容的末尾文字是设置的关键字,则匹配上该规则,按照该规则自动给用户回复;
【完全匹配】用户给微信公众号应用发送文字内容等于设置的关键字,则匹配上该规则,按照该规则自动给用户回复;
【直接托管】用户给微信公众号应用发送文字消息,无论发送什么文字内容,都给予同样的回复;
l关键字:通过关键字和用户发送的文字消息进行比对,匹配对应的规则,按照该规则自动给用户回复;关键字字数限制50个字符;
注意:只有当用户动作是【发送文字】,才有匹配方式和关键字!
l回复内容:用户给微信公众号应用发消息,匹配上该条规则后,可以在回复内容里面设置自动给用户发送的内容;回复内容字数限制1500个字符;
l优先级:优先级数字越小,表示优先级越高,系统会优先执行优先级高的规则,最小值为1,最大值为100,不支持小数
l启用:启用或者关闭当前规则
l删除/批量删除:
⑤ 功能演示:
l用户发送的文字消息,包含关键字:
l用户发送的文字消息,开头是关键字:
l用户发送的文字消息,结尾是关键字:
l用户发送的文字消息,等于关键字:
l用户发送的文字消息,无论发送什么文字内容,都给予同样的回复:
l用户发送的图片消息:
⑥ 其他说明:
l自动回复支持换行符\n
l自动回复支持超链接