Koa2微信公众号开发之消息管理
一、简介上一节我们搭建好了本地调试环境并且接入了微信公众测试号。这一节我们就来看看公众号的消息管理。并实现一个自动回复功能。 Github源码: github.com/ogilhinn/ko… 阅读建议：微信公众平台开发文档mp.weixin.qq.com/wiki 二、接收消息当普通微信用户向公众账号发消息时，微信服务器将POST消息的XML数据包到开发者填写的URL上。 2.1 接收普通消息数据格式XML的结构基本固定，不同的消息类型略有不同。 用户发送文本消息时，微信公众账号接收到的XML数据格式如下所示： 用户发送图片消息时，微信公众账号接收到的XML数据格式如下所示： 其他消息消息类型的结构请查阅【微信公众平台开发文档】 对于POST请求的处理，koa2没有封装获取参数的方法，需要通过自己解析上下文context中的原生node.js请求对象request。我们将用到row-body这个模块来拿到数据。 2.2 先来优化之前的代码这一节的代码紧接着上一届实现的代码，在上一届的基础上轻微改动了下。 const Koa = require('koa')
const app = new Koa() const crypto = require('crypto') // 将配置文件独立到config.js const config = require('./config') app.use(async ctx => { app.listen(7001); 这儿我们在只在GET中验证了签名值是否合法，实际上我们在POST中也应该验证签名。 将签名验证写成一个函数 优化代码，再POST中也加入验证 app.use(async ctx => {
const { signature,echostr } = ctx.query const TOKEN = config.wechat.token if (ctx.method === 'GET') { if (signature === getSignature(timestamp,TOKEN)) { return ctx.body = echostr } ctx.status = 401 ctx.body = 'Invalid signature' }else if (ctx.method === 'POST') { if (signature !== getSignature(timestamp,TOKEN)) { ctx.status = 401 return ctx.body = 'Invalid signature' } // TODO } }); ... 到这儿我们都没有开始实现接受XML数据包的功能，而是在修改之前的代码。这是为了演示在实际开发中的过程，写任何代码都不是一步到位的，好的代码都是改出来的。 2.3 接收公众号普通消息的XML数据包现在开始进入本节的重点，接受XML数据包并转为JSON // TODO
// 取原始数据 const xml = await getRawBody(ctx.req,{ length: ctx.request.length,limit: '1mb',encoding: ctx.request.charset || 'utf-8' }); console.log(xml) return ctx.body = 'success' // 直接回复success，微信服务器不会对此作任何处理 给你的测试号发送文本消息，你可以在命令行看见打印出如下数据 恭喜，到此你已经可以接收到XML数据了。😯 但是我们还需要将XML转为JSON方便我们的使用，我们将用到xml2js这个包 我们需要写一个解析XML的异步函数，返回一个Promise对象 {
xml2js.parseString(xml,{ trim: true,explicitArray: false,ignoreAttrs: true },function (err,result) {
if (err) {
return reject(err)
}
resolve(result.xml)
})
})
}
接着调用parseXML方法，并打印出结果 一切正常的话*(实际开发中你可能会遇到各种问题)*，命令行将打印出如下JSON数据 到此，我们就能处理微信接收到的消息了，你可以自己测试关注、取消关注、发送各种类型的消息看看这个类型的消息所对应的XML数据格式都是怎么样的 三、回复消息当用户发送消息给公众号时（或某些特定的用户操作引发的事件推送时），会产生一个POST请求，开发者可以在响应包（Get）中返回特定XML结构，来对该消息进行响应（现支持回复文本、图片、图文、语音、视频、音乐）。严格来说，发送被动响应消息其实并不是一种接口，而是对微信服务器发过来消息的一次回复。 3.1 被动回复用户消息数据格式前面说了交互的数据格式为XML，接收消息是XML的，我们回复回去也应该是XML。 微信公众账号回复用户文本消息时的XML数据格式如下所示： 微信公众账号回复用户图片消息时的XML数据格式如下所示: 篇幅所限就不一一列举了，请查阅【微信公众平台开发文档】 前面的代码都是直接回复success，不做任何处理。先来撸一个自动回复吧。收到消息后就回复这儿是JavaScript之禅 3.2 使用ejs模板引擎处理回复内容从这一小段代码中可以看出，被动回复消息就是把你想要回复的内容按照约定的XML格式返回即可。但是一段一段的拼XML那多麻烦。我们来加个模板引擎方便我们处理XML。模板引擎有很多，ejs 是其中一种，它使用起来十分简单 首先下载并引入ejs 如果你之前没用过现在只需要记住下面这几个语法，以及ejs.compile()方法
可以先看看这个ejs的小demo： console.log(mess) / 将打印出如下信息 现在来编写被动回复消息的模板，各种if else，这儿就直接贴代码了 现在就可以使用我们写好的模板回复XML消息了 我们可以把这个回复消息的功能写成一个函数 在回复消息的时候直接调用这个方法即可 现在为了测试我们所写的这个功能，来实现一个【学我说话】的功能: 回复音乐将返回一个音乐类型的消息，回复文本图片，语音，公众号将返回同样的内容，当然了你可以在这个基础上进行各种发挥。 nice，到此时我们的测试号已经能够根据我们的消息做出相应的回应了 本篇再上一节的代码基础上做了一些优化，并重点讲解微信公众号的消息交互，最后实现了个【学我说话】的小功能。下一篇，我们将继续补充消息管理相关的知识。最后再说一句：看文档 😉 参考链接微信公众平台开发文档：mp.weixin.qq.com/wiki raw-body：https://github.com/stream-utils/raw-body xml2js: github.com/Leonidas-fr… ejs:github.com/mde/ejs 源码： github.com/ogilhinn/ko… 以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持编程之家。 （编辑：李大同） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |