企业微信-按钮卡片消息处理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（翱途）企业应用开发平台

开源、自主可控的协同办公底座

研发与运营

纵横翱途（杭州）科技有限公司

企业级协同应用 · 工作流引擎 · AI 智能体

www.o2oa.net ｜ 400-888-0545