跳到主要内容

使用云调用接收、发送微信消息

[[toc]]

概述

开发者可能会使用微信客服消息功能,接收小程序用户的客服对话消息,以及发送消息给用户。

小程序·云开发的云调用功能天然打通微信消息推送接口,开发者只需要调用相应的函数即可简单完成消息推送流程。

方案对比

接收消息

发送消息

代码示例

开通了云开发的小程序可以使用云函数接收消息推送,目前仅支持客服消息推送。

参考:使用云函数接受消息推送

第一步:开发者工具云开发控制台中增加配置

打开云开发控制台,到设置 Tab 中选择「全局设置」-「添加消息推送配置」,添加接收消息的云函数。

消息类型对应收包的 MsgType,事件类型对应收包的 Event,同一个 <消息类型, 事件类型> 二元组只能推到一个环境的一个云函数。例如客服消息文本消息对应的就是消息类型为 text,事件类型为空。具体值请查看各个消息的消息格式。

第二步:云函数中接收、处理消息

云函数被触发时,其 event 参数即是接口所定义的 JSON 结构的对象(统一 JSON 格式,不支持 XML 格式)。

以客服消息为例,接收到客服消息推送时,event 结构如下:

{
"FromUserName": "ohl4L0Rnhq7vmmbT_DaNQa4ePaz0",
"ToUserName": "wx3d289323f5900f8e",
"Content": "测试",
"CreateTime": 1555684067,
"MsgId": "49d72d67b16d115e7935ac386f2f0fa41535298877_1555684067",
"MsgType": "text"
}

第三步:发送客服消息

此时可调用客服消息发送接口回复消息,一个简单的接收到消息后统一回复 “收到” 的示例如下:

// 云函数入口文件
const cloud = require("wx-server-sdk");

cloud.init();

// 云函数入口函数
exports.main = async (event, context) => {
const wxContext = cloud.getWXContext();

await cloud.openapi.customerServiceMessage.send({
touser: wxContext.OPENID,
msgtype: "text",
text: {
content: "收到"
}
});

return "success";
};

相关文档