微信公众号机器人开发详解

引言

微信公众号平台为开发者提供了丰富的接口，可以用来创建能够自动回复消息、执行特定任务的自动化程序。本文将详细介绍如何使用 Node.js 和 Express 框架来开发一个简单的微信公众号机器人，并提供完整的代码示例。

1. 环境准备

确保你的开发环境中已安装了以下工具：

• Node.js (建议使用 LTS 版本)
• npm 或 yarn (建议使用 yarn，因为它更快)

2. 创建项目

使用 Express 创建一个新的 Node.js 项目。

Bash

1mkdir wechat-bot
2cd wechat-bot
3npm init -y
4npm install express body-parser crypto-js axios --save

3. 代码实现

创建一个名为 server.js 的文件，用于编写服务器代码。

Javascript

1// server.js
2const express = require('express');
3const bodyParser = require('body-parser');
4const crypto = require('crypto-js');
5const axios = require('axios');
6
7const app = express();
8const port = 3000; // 服务器端口
9const token = 'your_token'; // 请替换为你的Token
10const appId = 'your_appid'; // 请替换为你的AppID
11const appSecret = 'your_appsecret'; // 请替换为你的AppSecret
12
13// 解析请求体
14app.use(bodyParser.urlencoded({ extended: false }));
15
16// 微信验证
17app.get('/wechat', (req, res) => {
18  const signature = req.query.signature;
19  const timestamp = req.query.timestamp;
20  const nonce = req.query.nonce;
21  const echostr = req.query.echostr;
22
23  const str = [token, timestamp, nonce].sort().join('');
24  const hashStr = crypto.SHA1(str);
25
26  if (hashStr === signature) {
27    res.send(echostr);
28  } else {
29    res.send('Invalid request!');
30  }
31});
32
33// 处理POST请求
34app.post('/wechat', (req, res) => {
35  const xml = req.body;
36  const fromUserName = xml.FromUserName;
37  const toUserName = xml.ToUserName;
38  const msgType = xml.MsgType;
39  const content = xml.Content;
40
41  let responseXml = '';
42
43  switch (msgType) {
44    case 'text':
45      responseXml = createTextResponse(fromUserName, toUserName, '你好！');
46      break;
47    case 'image':
48      responseXml = createTextResponse(fromUserName, toUserName, '你发送了一张图片！');
49      break;
50    // 其他类型的消息可以在这里添加
51    default:
52      responseXml = createTextResponse(fromUserName, toUserName, '未知消息类型！');
53      break;
54  }
55
56  res.type('application/xml');
57  res.send(responseXml);
58});
59
60// 创建文本消息响应
61function createTextResponse(toUserName, fromUserName, content) {
62  return `
63    <xml>
64      <ToUserName><![CDATA[${toUserName}]]></ToUserName>
65      <FromUserName><![CDATA[${fromUserName}]]></FromUserName>
66      <CreateTime>${Date.now()}</CreateTime>
67      <MsgType><![CDATA[text]]></MsgType>
68      <Content><![CDATA[${content}]]></Content>
69    </xml>
70  `;
71}
72
73// 启动服务器
74app.listen(port, () => {
75  console.log(`Server is running on port ${port}`);
76});

4. 代码解释

• 环境配置:

  • 我们使用 express 来创建一个简单的 HTTP 服务器。
  • 使用 body-parser 来解析 POST 请求体。
  • 使用 crypto-js 来计算 SHA1 哈希值。
  • 使用 axios 来调用微信 API。

• 微信验证:

  • 当微信服务器首次尝试与你的服务器建立连接时，会发送一个 GET 请求来验证 Token。
  • 我们需要按照一定的顺序拼接字符串，并计算 SHA1 哈希值来验证签名。

• 处理 POST 请求:

  • 当微信服务器接收到用户的消息时，它会发送一个 POST 请求到你的服务器。
  • 服务器根据消息类型进行不同的处理。

• 创建文本消息响应:

  • 这个函数用于创建一个 XML 格式的文本消息响应。

5. 配置公众号

在微信公众平台后台，配置服务器地址为你的服务器地址。

6. 运行服务器

运行服务器并确保它可以通过公网访问。

Bash

1node server.js

7. 测试

• 使用微信公众号向你的机器人发送消息。
• 观察控制台输出和微信客户端的消息。

结语

通过本文的介绍，你应该已经能够创建一个基本的微信公众号机器人，并了解如何在 Node.js 项目中使用它。微信公众号平台提供了丰富的功能，你可以根据需要添加更多的功能，例如：

• 更复杂的对话逻辑。
• 语音消息处理。
• 图片消息处理。
• 菜单和自定义菜单。

如果你在开发过程中遇到任何问题，可以查阅相关文档或社区资源，微信社区非常活跃，有许多优秀的教程和示例可供参考。