企业微信消息扩展程序
企业微信消息扩展程序
V1.0 O2OA V5.4以上版本 Free
分类:插件
简介
企业微信-按钮卡片消息处理O2OA开发平台待办工作的接入
提示如果您有什么疑问或想法,请来我们的藕粉社区交流吧!
藕粉社区
¥0.0
提示TIPs
如果您有什么疑问或想法,请来我们的藕粉社区交流吧!
安装及使用
应用图片

企业微信管理端配置

打开企业微信管理端,再打开对应已经接入O2OA开发平台的企业微信内建应用,找到接收消息模块:

下面有个开启API接收的按钮,点击进入配置页面:

这里3个字段做如下配置:

URL:这个配置一个前面安装的扩展程序中的一个api地址,http://o2oa访问地址/x_app_qywx_support_assemble_control/jaxrs/qywxcallback ,这个地址是企业微信有消息回调要访问的地址,必须得外网能访问,不然企业微信无法回调,配置不成功!

Token:可以直接点击旁边的随机获取,生成后保存下来,O2OA开发平台配置文件中需要用到

EncodingAESKey : 可以直接点击旁边的随机获取,生成后保存下来,O2OA开发平台配置文件中需要用到

填完这3个字段先不要点击保存按钮,因为点击保存企业微信会马上去回调,不成功就保存不了,因为O2OA开发平台那边还没配置Token和EncodingAESKey所以肯定是不成功的。 不点击保存,马上先去配置O2OA配置文件。

 

O2OA开发平台配置企业微信回调参数

打开O2OA开发平台系统设置->移动端配置->应用集成->企业微信集成:

找到里面 回调Token 回调EncodingAesKey,分别填入上面表单中生成出来的Token和EncodingAESKey,如下:

点击保存,并重启O2OA开发平台。

 

完成重启后,可以点击前面企业微信配置界面的保存按钮了。

 

O2OA开发平台配置消息发送

 

过滤器

打开O2OA开发平台系统设置->服务配置->消息配置,先可以配置一个过滤器,可以过滤 哪些流程、哪些活动需要发送卡片消息:

 

加载器

还可以增加 一个加载器 ,用来处理一些消息体的内容:

目前卡片消息可以定义部分内容:

来源:给消息的body添加一个来源对象,如下:

message.body.source = {
desc: "这里字段是来源的标题,如上图的企业微信",
icon_url: "这里是来源图标的url,来源图片的尺寸建议为72*72",
desc_color: "来源文字的颜色,目前支持:0(默认) 灰色,1 黑色,2 红色,3 绿色"
};

 

一级标题:给消息的body添加一级标题对象,如下:

message.body.main_title = {
  title: "一级标题,建议不超过36个字",
  desc: "标题辅助信息,建议不超过44个字"
};

 

引用文本:给消息的body添加引用文本对象,如下:

message.body.quote_area = {
  title: "引用文本样式的标题",
  quote_text: "引用文本样式的引用文案"
};

 

卡片点击Url:给消息卡片增加一个URL,点击卡片可打开对应的单点后的O2OA开发平台网页,比如当前工作页面:

message.body.card_action = {
    type: 1, // 固定的1 是打开网址
    url: "http://O2OA访问网址/x_desktop/workmobilewithaction.html?workid="+message.body.work
};

 

消息类型配置

目前卡片消息只支持待办消息的处理,所以先到类型配置中找到创建待办的类型:

 

按上图选择对应的类型、过滤器、加载器,以及restful的请求方法写:post 。

url这里填写我们前面扩展程序提供的一个API地址:

http://O2OA开发平台服务地址/x_app_qywx_support_assemble_control/jaxrs/qywxsupport/message/task/receive