企业微信API：按钮交互型通知+数据回调|应用场景-白码

企业微信API：按钮交互型通知+数据回调

• 发表于：2021-11-16 18:35:03 • 更新于：2021-12-03 14:08:18

516

效果描述：

系统通过api与企业微信进行对接，可实现系统数据与企业微信上进行数据交互。

本次教程以订单的提交效果做示例。

效果演示：

审核通过：

审核拒绝：

效果实现：

首先需要系统集成企业微信，按照提示进行。

2.集成之后，需要在系统上做出系统用户与企业微信号进行绑定的效果，本次示例不再进行说明，绑定企业微信id教程：https://www.bnocode.com/scene/API_15.html

3.在API对接模块中，选择企业微信API（第三方）进行添加企业微信请求API，添加完后进行参数的配置。

新建API：

参数配置：

API请求代码示例：

async function run($input, $output, $modules = modules) {

/**发送应用文本消息

* 官方API：https://work.weixin.qq.com/api/doc/90000/90135/90236

* 错误码查询工具：https://open.work.weixin.qq.com/devtool/query?e=

* touser、toparty、totag不能同时为空

const wxworkThirdApi = $modules.wxworkThirdApi;

let agentid = await wxworkThirdApi.getAgentId();

let touser = $input.touser;

let title = $input.title;//任务标题

let sub_title_text = $input.sub_title_text;

let task_id = $input.task_id;

let data = {

touser: touser,

// "toparty":

// "totag":

msgtype: "template_card",

agentid:agentid,

template_card: {

card_type: "button_interaction",

main_title: {

title: title,

sub_title_text: sub_title_text,

task_id: task_id,

button_list: [

{

text: "拒绝",

style: 3,

key: "reject"

{

text: "通过",

style: 1,

key: "approve"

}

]

};

//发送

let task_card_message = await wxworkThirdApi.request({

method: "post",

url: "message/send",

data

});

/**

* 如果部分接收人无权限或不存在，发送仍然执行，但会返回无效的部分（即invaliduser或invalidparty或invalidtag），常见的原因是接收人不在应用的可见范围内。

* 如果全部接收人无权限或不存在，则本次调用返回失败，errcode为81013。

* 返回包中的userid，不区分大小写，统一转为小写

$output.request= data;

$output.res = task_card_message.response_code;

}

4.在上面的基础上，再新建一个API，并确保该api为开启状态。用于接收到回调数据后，更新推送的交互消息按钮状态。

API请求代码示例：

async function run($input, $output, $modules = modules) {

const wxworkThirdApi = $modules.wxworkThirdApi;

let agentid = await wxworkThirdApi.getAgentId();

let data = {

//userids: [$input.userids],

atall:1,//更新整个任务接收人员，0为不更新，1为更新全部

agentid,

task_id: $input.task_id,

response_code: $input.responseCode,

button: {

replace_name: $input.replace_name,

}

};

let res = await wxworkThirdApi.request({

method: "post",

url: "message/update_template_card",

data

});

$output.request = data;

$output.res = res;

}

5.订单的数据表中，需要加上两个字段，用于存放该订单请求的对应请求task_id和response_code。其中task_id为发送API请求的必须参数，这边建议可直接用系统的订单数据id来做task_id。新建一个“发送交互消息”功能，传递必要的参数。后面在订单新增的时候调用该功能。

数据处理步骤：

代码参照：

async function runProcess($model = model, $plugin = plugin, $params = params) {

let list = $params.list;

let order = $params.order;

let user = $params.user;

let cust = order["_612f0388a7b86f0d632c6ccc"];

let course = order["_612f0388a7b86f0d632c6ccd"];

let total = order["612f0388a7b86f0d632c6cce"];//商品价格

let preferential_amount = order["612f0388a7b86f0d632c6ccf"];//优惠金额

let final_amount = order["612f0388a7b86f0d632c6cd0"];//最终金额

let date = $plugin.moment().format("YYYY-MM-DD")

let time = new Date().getTime();//当前时间戳

let wxworkid = list.map(id => id["612f49359025b63cac3102c4"]) //获取到要接收到消息的用户企业微信idList

let idList = wxworkid.filter(function (id) {//企业微信id去空值

return id != null

})

let newidList = idList.join("|");

let sub_title_text =

`客户：${cust} \n课程包：${course}\n商品价格：${total}\n优惠金额：${preferential_amount}\n最终金额：${final_amount}\n创建日期：${date}`

$model.output["sub_title_text"] = sub_title_text;

$model.output["wxworkid"] = newidList

$model.output["task_id"] = `DD_${order._id}_${time}`

$model.output["title"] = `${user}的订单申请`

}

该功能做好后，在新增订单功能中，调用本功能。

调用步骤示例：

示例代码：

async function runProcess($model = model,$plugin = plugin,$params = params){

await $plugin.program.exec("6141623a841ce71ef89fa745",{//调用发送交互型消息通知功能，功能id

"61416240e87b7e1ee12f4a6e":$params.order //调用发送交互型消息通知功能的选择订单步骤id

})

}

6.新建一个“订单审核”功能，用于企业微信交互消息审核结果回调，更新该消息的按钮状态、订单的审核状态。

7.添加一个webhook并确保该api为开启状态，用于接收任务推送后审批结果回调，并进行处理。

数据回调示例代码：

async function hook($input = {}, $output = {}, $modules = modules) {

//通讯录回调:https://work.weixin.qq.com/api/doc/90000/90135/90967

//外部联系回调:https://work.weixin.qq.com/api/doc/90000/90135/92129

//OA审批回调:https://work.weixin.qq.com/api/doc/90000/90135/91815

//get 请求用于验证有效性

//将数据解密并转换成json

let data = $input;

if (data.Event == "change_contact" && data.ChangeType == "create_party") {

//TODO 处理添加部门事件

} else if (