微信管理

微信管理用于配置微信公众号、小程序，管理微信相关功能。

功能概述

微信管理包含以下功能：

  • 公众号配置：配置微信公众号参数
  • 小程序配置：配置微信小程序参数
  • 菜单管理：管理公众号自定义菜单
  • 模板消息：管理微信模板消息
  • 用户管理：管理微信关注用户
  • 二维码管理：管理带参数二维码

公众号配置

配置前准备

  • 微信公众号（服务号或订阅号）
  • 已获取AppID和AppSecret
  • 已配置服务器URL

配置步骤

  1. 进入「系统设置」→"微信管理"→"公众号配置"
  2. 填写基本配置：
    • AppID：微信公众号AppID
    • AppSecret：微信公众号AppSecret
    • Token：自定义Token（用于验证）
    • EncodingAESKey：消息加解密密钥（可选）
  3. 配置服务器URL：
    • URL：https://your-domain.com/api/callback/wx/mp
    • 在公众号后台配置服务器配置
  4. 点击"保存配置"
  5. 点击"测试连接"验证

公众号后台配置

  1. 登录微信公众号后台
  2. 进入「开发」→"基本配置"
  3. 配置服务器URL：
    • URL：填写系统提供的回调URL
    • Token：填写配置的Token
    • 点击提交验证
  4. 启用服务器配置

小程序配置

配置前准备

  • 微信小程序账号
  • 已获取AppID和AppSecret

配置步骤

  1. 进入「系统设置」→"微信管理"→"小程序配置"
  2. 填写配置信息：
    • AppID：小程序AppID
    • AppSecret：小程序AppSecret
  3. 配置业务域名（小程序后台）
  4. 点击"保存配置"

小程序业务域名

  1. 登录微信小程序后台
  2. 进入「开发」→"开发管理"→"开发设置"
  3. 配置服务器域名：
    • request合法域名：https://your-domain.com
    • uploadFile合法域名：https://your-domain.com
    • downloadFile合法域名：https://your-domain.com

菜单管理

查看菜单

  1. 进入「系统设置」→"微信管理"→"菜单管理"
  2. 查看当前公众号菜单

菜单类型

类型说明
点击事件用户点击后推送事件
跳转链接点击跳转到网页
小程序点击打开小程序
扫码点击调起扫码
发图点击调起选择图片

编辑菜单

  1. 点击「编辑菜单」
  2. 添加/删除/修改菜单
  3. 设置菜单名称
  4. 选择菜单类型并配置
  5. 点击「保存并发布」

菜单规则

  • 一级菜单：最多3个
  • 二级菜单：每个一级菜单下最多5个
  • 菜单名称：不超过8个汉字或16个字符

模板消息

功能说明

微信公众号模板消息用于向用户推送通知：

  • 订单状态通知
  • 服务提醒
  • 活动通知

申请模板

  1. 登录微信公众号后台
  2. 进入「功能」→"模板消息"
  3. 从模板库选择模板
  4. 点击"添加"
  5. 等待审核通过

配置模板

  1. 进入「系统设置」→"微信管理"→"模板消息"
  2. 添加模板：
    • 模板ID：从公众号后台获取
    • 模板名称：自定义名称
    • 映射字段：配置业务字段与模板字段的映射
  3. 保存配置

使用场景

场景说明
订单支付成功用户支付后推送
订单派单通知技师接单后推送
服务完成通知服务完成后推送
退款通知退款完成后推送

用户管理

查看用户

  1. 进入「系统设置」→"微信管理"→"用户管理"
  2. 查看关注公众号的用户列表

用户信息

字段说明
OpenID用户唯一标识
昵称微信昵称
头像微信头像
性别性别
地区所在地区
关注时间关注公众号时间

用户同步

  1. 点击「同步用户」
  2. 系统会从微信同步最新用户列表
  3. 新关注用户会自动同步

二维码管理

功能说明

生成带参数的二维码，用于：

  • 渠道推广统计
  • 分销邀请
  • 活动引流

创建二维码

  1. 进入「系统设置」→"微信管理"→"二维码管理"
  2. 点击「创建二维码」
  3. 填写信息：
    • 二维码名称
    • 场景值（参数）
    • 类型：临时/永久
    • 有效期（临时二维码）
  4. 点击「生成」

二维码类型

类型有效期数量限制适用场景
临时二维码30天无限制短期活动
永久二维码永久10万个长期渠道

下载二维码

  1. 在二维码列表中找到目标二维码
  2. 点击「下载」
  3. 选择尺寸（小/中/大）
  4. 下载图片

微信网页授权

配置授权域名

  1. 登录微信公众号后台
  2. 进入「设置」→"公众号设置"→"功能设置"
  3. 配置网页授权域名：your-domain.com

使用场景

  • H5页面微信登录
  • 获取用户信息
  • 微信支付

常见问题

Q: 微信配置后提示"Token验证失败"？

A: 请检查：

  1. Token是否一致（公众号后台和系统配置）
  2. 服务器URL是否正确
  3. 服务器是否允许外网访问
  4. 是否配置了HTTPS

Q: 模板消息发送失败？

A:

  1. 检查模板ID是否正确
  2. 检查用户是否关注了公众号
  3. 检查模板字段映射是否正确
  4. 查看微信返回的错误码

Q: 小程序无法请求接口？

A:

  1. 检查是否配置了request合法域名
  2. 域名必须使用HTTPS
  3. 检查是否配置了业务域名
  4. 开发工具可开启"不校验合法域名"调试

Q: 二维码扫码后无反应？

A:

  1. 检查二维码是否过期
  2. 检查服务器是否正常处理扫码事件
  3. 查看微信事件推送日志

Q: 如何测试微信功能？

A:

  1. 使用微信开发者工具测试小程序
  2. 使用测试公众号进行测试
  3. 配置测试环境的微信参数
  4. 关注测试号进行功能测试

安全建议

  1. 保护密钥：不要将AppSecret泄露
  2. IP白名单：在微信后台配置服务器IP白名单
  3. 消息加密：生产环境建议开启消息加密
  4. 定期轮换：定期更换Token和密钥
  5. 日志记录：记录微信交互日志，便于排查问题