企业微信-按钮卡片消息处理O2OA待办工作的接入
需要使用企业微信的卡片消息处理待办工作，必须得先接入企业微信，请阅读《O2OA集成到企业微信》
首先有一个O2OA的扩展程序：
把扩展程序放入到O2OA的服务器对应的目录下，war包放入custom目录，jar包放入custom->jars目录下：
企业微信管理端配置
打开企业微信管理端，再打开对应已经接入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
按钮卡片消息处理O2OA待办工作的接入已经完成！
温馨提示：O2OA“应用市场”提供了《企业微信消息扩展程序》，可以直接安装。
上一篇：企业微信-O2OA集成到企业微信
下一篇：原生APP-如何使用移动端APP
浙公网安备 33010602009829号