目录

公众号接入

本章节,讲解如果将你的公众号,接入到系统中。步骤如下:

  • 第一步,申请公众号(可选)
  • 第二步,在系统中,添加公众号账号
  • 第三步,在公众号中,配置接入信息

# 1. 配置步骤

本小节,手把手教你如何将公众号接入到系统中。

# 第一步,申请公众号(可选)

友情提示:如果你已经有公众号,可以忽略这一步。

① 如果你还没有公众号,可以申请一个测试帐号。

申请测试账号

申请地址:微信公众平台接口测试帐号申请 (opens new window)

② 申请完成后,获得一个测试号。如下图所示:

测试账号信息

# 第二步,添加公众号账号

点击 [公众号管理 -> 账号管理] 菜单,添加一个公众号账号。如下图所示:

添加公众号账号

# 第三步,配置接入信息

① 找一个内网穿透工具,转发到本地的 48080 端口。例如说,ngrok (opens new window)frp (opens new window)natapa (opens new window) 等等。

这里,我们使用 natapp 作为内网传统工具。访问 https://natapp.cn/tunnel/buy/free (opens new window) 地址,免费购买一个隧道。如下图所示:

免费购买一个隧道

② 购买完成后,参考 《NATAPP 1 分钟快速新手图文教程》 (opens new window) 文档,将 natapp 进行启动。如下图所示:

启动隧道

③ 打开微信公众号界面,填写 URL 和 Token 信息。如下图所示:

填写 URL 和 Token 信息

点击提交后,看到“配置成功”提示,说明配置成功。

# 2. 实现代码

本小节,将介绍如何实现公众号接入的代码。

# 2.1 表结构

公众号账号对应 mp_account 表,结构如下图所示:

表结构

# 2.2 账号管理界面

# 2.3 配置接入回调

第三步,配置接入信息 时,微信公众号会回调系统的 GET /admin-api/mp/open/{appID} 接口,进行接入配置的验证。对应 MpOpenController (opens new window) 类的 checkSignature 方法,如下图所示:

checkSignature 方法

对应 《微信公众号官方文档 —— 接入指南》 (opens new window) 文档。

友情提示:

项目使用的微信工具开发包是 weixin-java-mp (opens new window),超级好用!

# 2.4 消息处理

配置接入完成后,用户发给公众号的消息,公众号都会回调到 POST /admin-api/mp/open/{appID} 接口,进行消息的处理。对应 MpOpenController (opens new window) 类的 handleMessage 方法,如下图所示:

handleMessage 方法

核心逻辑是第二步,再解析到消息后,交给 WxMpMessageRouter 进行消息的处理。WxMpMessageRouter 在 DefaultMpServiceFactory (opens new window) 初始化,设置每种消息对应的 handler (opens new window) 处理器。如下图所示:

消息处理器

具体每个处理器的实现,后续每个章节单独详细讲解。

上次更新: 2023/03/01, 00:29:36

本站由 钟意 使用 Stellar 1.28.1 主题创建。
又拍云 提供CDN加速/云存储服务
vercel 提供托管服务
湘ICP备2023019799号-1
总访问 次 | 本页访问