Skip to Content

微信服务号管理模板使用教程

模板信息

本模板是一个微信服务号的运营后台,部署后即可把自己的服务号接入 Zion,用网页完成日常运营:

  • 记录用户发来的消息、关注 / 取消关注、菜单点击等事件
  • 管理关注用户,区分已关注和已取消关注
  • 可视化编辑自定义菜单,一键发布到微信
  • 设置关注欢迎语和关键词自动回复
  • 同步公众平台的消息模板,向关注者发送模板消息
  • 内部成员按「管理员 / 运营 / 只读」分配权限,新账号需管理员审批后才能使用

适用账号:已认证的微信服务号(订阅号没有自定义菜单发布和模板消息等接口权限)。

为什么用接口管理微信服务号

微信公众平台自带的后台适合「人工运营」:手动回复、手动改菜单、手动群发。一旦微信服务号要和你自己的业务打通,例如订单发货通知用户、按用户行为自动回复、把关注用户沉淀到自己的用户体系,就需要通过「服务器配置 + 开发者接口」来管理微信服务号。

与公众平台后台的区别

对比项公众平台后台接口管理(本模板)
消息与事件只能在后台查看近期消息,无法导出或关联业务数据每条消息、关注、取消关注、菜单点击都实时写入自己的数据库,可长期保存、查询和统计
关注用户只能在后台浏览关注用户及其关注状态保存在自己的数据表中,可与业务用户、订单等数据关联
自动回复只支持固定规则回复逻辑由行为流决定,可以查数据库、调用外部接口或 AI 后再回复
模板消息后台无法直接发送,只能通过接口调用页面上即可测试和群发,也能在任意业务流程中自动触发,并记录每个接收者的送达结果
团队协作需要管理员扫码登录或授权运营者使用自己系统的账号登录,按账号隔离数据,不必共享公众平台权限
业务联动无可与 Zion 中的其他数据表、行为流、小程序和网页应用直接打通
⚠️

在公众平台启用「服务器配置」后,微信会把用户消息推送到你的服务器,公众平台后台设置的自动回复和自定义菜单将不再生效。所以启用服务器配置后,菜单和自动回复都需要通过接口管理,这也是本模板提供这些功能的原因。

为什么选择本模板

自己对接微信接口,需要处理大量与业务无关的细节。本模板已经把这些做好了:

  • 接入即可用:已实现服务器 URL 验证、签名校验、消息去重和被动回复的 XML 组装,按教程填写配置即可接入。
  • Access Token 自动管理:自动获取并缓存 Access Token,未过期时直接复用、过期后自动重新获取,避免频繁调用触发微信的频率限制。
  • 菜单规则内置校验:限制一级菜单最多 3 个、子菜单最多 5 个,发布时自动组装成微信要求的格式,并提供手机效果预览。
  • 模板消息可靠发送:群发在后台异步执行,页面无需等待发送完成;每个接收者的发送结果和微信送达回执都有记录,方便排查。
  • 零代码、完全可改:所有页面、数据表和行为流都在 Zion 编辑器中可见,无需写代码即可修改页面样式、增加字段或调整业务逻辑。
  • 数据在自己手里:消息、事件和用户数据存储在你自己项目的数据库中,可随时查询、导出和分析。

未来的可扩展性

模板只覆盖了服务号运营的基础能力,在此基础上可以继续扩展:

  • AI 客服:在「微信文本消息处理」行为流中接入 Zion 的 AI 智能体,关键词未命中时由 AI 根据知识库回复用户。
  • 业务通知:在下单、支付、发货、预约等行为流中调用「发送模板消息」,把关键节点自动推送给用户。
  • 用户运营与分群:基于入站记录统计用户的活跃度、菜单点击偏好,给用户打标签,再按标签定向推送。
  • 打通小程序和网页:微信服务号、小程序绑定到同一个微信开放平台账号后,可以通过 UnionID 把微信服务号关注者与小程序、网页中的用户识别为同一人。
  • 定时任务:配合定时触发器,实现每日提醒、到期提醒、周期性数据报告等自动推送。
  • 渠道追踪:扩展带参数二维码接口,统计不同渠道带来的关注人数。
  • 多微信服务号管理:数据模型已按微信服务号区分,可在同一后台管理多个服务号,或进一步做成面向客户的 SaaS 服务。

项目基本操作逻辑

后台左侧是统一的导航栏,共八个页面,其中「成员管理」只有管理员可见。导航栏底部显示当前登录的账号和角色,并提供「退出登录」。

工作台总览

展示当前关注人数、已取消关注人数、今日收到的消息数和启用中的关键词规则数,并通过「接入进度」提示还差哪一步没有配置。下方是常用功能入口和最近收到的 10 条消息与事件。

微信服务号管理工作台

服务号账号

填写要接入的微信服务号资料(账号名称、AppID、原始 ID),并按页面下方的四个步骤完成接入。

服务号账号页面

服务号菜单

左侧是手机效果预览,右侧用来添加一级菜单、子菜单并调整排序。菜单先保存为草稿,点击「发布到微信」后才会同步到微信服务号。

服务号菜单页面

消息事件中心

按时间倒序展示微信服务号收到的所有消息与事件,包括文本消息、关注、取消关注、菜单点击等。

消息事件中心页面

自动回复

设置用户关注时收到的欢迎语,以及按关键词自动回复的规则。右侧可预览用户看到的效果。

自动回复页面

关注用户

查看服务号的关注者,按「全部 / 已关注 / 已取消关注」筛选,并可手动从微信同步关注者列表。

关注用户页面

模板消息

从公众平台同步消息模板,填写模板字段后先发给指定用户测试,再群发给全部关注者,并在「发送记录」中查看每次发送的进度和结果。

模板消息页面

成员管理

仅管理员可见。列出所有注册的账号,管理员可以审批新账号、修改成员角色或停用成员。详见下文「成员与权限」。

接入自己的服务号

准备微信服务号信息

登录 微信公众平台 ,记录以下信息:

  • AppID 与 AppSecret:在「设置与开发 → 基本配置」中查看,AppSecret 需要管理员扫码后才能查看或重置。
  • 原始 ID:在「设置与开发 → 公众号设置 → 账号详情」中查看,以 gh_ 开头。微信推送的每条消息都带有原始 ID,模板靠它识别消息来自哪个微信服务号,务必填写正确。

配置 Secret

AppSecret 和 Token 属于敏感信息,不在页面里填写,而是保存在 Zion 的 Secret 中:

  1. 在 Zion 编辑器打开「设置 → Secret」。
  2. 给「服务号 AppSecret」填入微信服务号的 AppSecret。
  3. 给「Token」填入一个自定义字符串(例如一串随机英文和数字),后面在公众平台配置服务器时需要填写同一个值。

开通管理员账号

预览或发布项目后,打开登录页点击「申请账号」,填写用户名和密码。系统中还没有管理员时,第一个登录的账号会自动成为管理员,之后注册的账号都需要管理员审批。

填写服务号账号

以管理员身份登录后台,进入「服务号账号」页面,填写账号名称、AppID 和原始 ID,点击「保存修改」。账号类型和接入备注可以不填。

配置服务器地址

  1. 在 Zion 编辑器中打开「动作流 → 触发器 → Webhook」,复制「微信服务器URL验证与消息事件接收」对应的 Webhook 地址。
  2. 在微信公众平台进入「设置与开发 → 基本配置 → 服务器配置」,点击「修改配置」:
    • URL:粘贴上一步复制的 Webhook 地址。
    • Token:与 Zion Secret 中的「Token」保持一致。
    • EncodingAESKey:随机生成即可。
    • 消息加解密方式:选择「明文模式」。
  3. 提交并「启用」服务器配置。
⚠️

模板目前只支持明文模式。选择「兼容模式」或「安全模式」后,微信推送的是加密内容,模板无法识别。

配置 IP 白名单

获取 Access Token 时,微信会校验调用方 IP。如果「关注用户」同步或菜单发布提示 40164 invalid ip,错误信息中会带上 Zion 服务器的出口 IP,把它加入公众平台「基本配置 → IP 白名单」即可。

验证接入

用手机关注微信服务号或发送一条消息,然后打开「消息事件中心」。能看到对应记录,就说明接入成功,工作台的「接入进度」也会显示「已收到推送」。

功能使用

同步关注用户

在「关注用户」页面选择服务号,点击「同步关注者」。同步在后台分页进行,提交后稍等片刻点击「刷新列表」即可看到结果。之后有新用户关注或取消关注时,列表会自动更新状态,无需再次同步。

微信已不再通过接口返回用户的昵称和头像,所以列表中的昵称为空属于正常现象,用户以 OpenID 区分。

设置关注欢迎语

在「自动回复」页面选择微信服务号,在「关注欢迎语」中填写内容并点击「保存欢迎语」,再打开右上角的「启用」开关。关闭开关后文案会保留,但不再发送。

设置关键词回复

在「关键词回复」中填写关键词和回复内容,点击「添加规则」。用户发送的消息必须和关键词完全一致(区分大小写和空格)才会触发回复。每条规则都可以单独启用或停用。

编辑与发布菜单

  1. 在「服务号菜单」页面选择微信服务号。
  2. 在「添加一级菜单」中填写菜单名称,选择点击后的动作:
    • 点击回复:填写触发关键词,用户点击菜单后,按「自动回复」中同名的关键词规则回复。
    • 打开网页:填写网页地址。
    • 打开小程序:填写小程序 AppID 和页面路径(小程序需已关联该微信服务号)。
  3. 在「菜单结构」中可以编辑、删除菜单,或给一级菜单「添加子菜单」。一级菜单最多 3 个,每个一级菜单下最多 5 个子菜单;有子菜单的一级菜单只用于展开子菜单。
  4. 也可以直接点击左侧手机预览中的菜单进行编辑。
  5. 确认无误后点击「发布到微信」。用户重新进入微信服务号聊天界面后会看到新菜单。

「点击回复」类型的菜单需要先在「自动回复」中添加同名关键词规则,否则用户点击后不会收到回复。

发送模板消息

模板消息用于向已关注的用户发送服务通知,例如订单状态、预约提醒。请勿用于发送营销内容,否则可能被微信限制模板消息权限。

  1. 在微信公众平台「广告与服务 → 模板消息」中开通功能并添加需要的模板。
  2. 在后台「模板消息」页面点击「从微信同步」,模板库中会出现已添加的模板及其字段。
  3. 在「发送模板消息」中选择模板,页面会按模板字段展示输入框,逐一填写内容。
  4. 按需填写点击消息后打开的网页,或打开的小程序(AppID 和页面路径)。同时填写时优先打开小程序。
  5. 在「发给指定用户」中填写接收者 OpenID(多个用英文逗号分隔),点击「发送测试」,先发给自己确认效果。
  6. 确认无误后点击「发送给全部关注者」。系统只会发送给当前处于已关注状态的用户。群发只有管理员可以操作,运营账号只能发送测试消息。

发送在后台进行,可在「发送记录」中点击「刷新」查看进度。每次发送都会生成一条推送任务,显示成功数、失败数和目标人数。每个接收者的发送结果记录在「公众号通知记录」表中,状态含义如下:

状态含义
SENT微信已接收发送请求
FAILED发送请求被微信拒绝,原因记录在错误信息中
DELIVERED微信回调确认用户已收到
DELIVERY_FAILED微信回调确认送达失败,例如用户拒收

在其他业务中发送模板消息

如果你在模板基础上扩展了业务(例如订单发货后通知用户),可以在自己的动作流中调用「发送模板消息」动作流,输入参数如下:

参数说明
official_account_id公众号配置表中的微信服务号 id
openid接收者在该服务号下的 OpenID
template_id微信模板 ID
data模板字段内容,JSON 格式,例如 {"thing2": {"value": "无线耳机"}}
url点击消息后打开的网页(选填)
mini_appid点击消息后打开的小程序 AppID(选填)
mini_pagepath小程序页面路径(选填)
push_task_id关联的推送任务 id,单独调用时留空

成员与权限

后台面向公司内部的运营人员使用,账号由管理员统一管理:

  1. 新成员在登录页点击「申请账号」注册。注册后的账号处于「待审批」状态,登录后只能看到「账号暂不可用」页面。
  2. 管理员在「成员管理」中为其点击「设为管理员 / 设为运营 / 设为只读」,账号立即可以使用。
  3. 成员离职或不再需要访问时,管理员点击「停用」,该账号会立即失去所有权限。需要恢复时重新分配角色即可。

三种角色的权限如下:

功能管理员运营只读
查看工作台、消息事件、关注用户、发送记录✓✓✓
编辑并发布菜单、设置欢迎语和关键词回复✓✓
同步关注用户、同步消息模板、发送测试消息✓✓
新增或修改微信服务号接入资料✓
模板消息发送给全部关注者✓
成员管理(审批、改角色、停用)✓
  • 所有成员共享后台中的全部微信服务号数据,不按创建人区分。
  • 管理员不能修改自己的角色或停用自己,避免误操作导致没有管理员。需要调整时,请让另一位管理员操作。
  • 权限同时在页面和后端生效:页面会隐藏没有权限的入口,即使绕过页面直接调用接口,后端也会拒绝。
  • 每次模板消息发送会记录「操作人」,菜单发布会在公众号配置中记录「菜单发布人」和「菜单发布时间」。

数据模型

数据表用途
帐户登录账号,新增「成员状态」(待审批 / 正常 / 已停用)和「成员角色」字段
公众号配置微信服务号名称、AppID、原始 ID 等接入资料,其余数据都按微信服务号区分
微信入站记录微信推送的消息与事件,按消息 ID 去重
服务号用户映射关注用户的 OpenID、关注状态与关注时间
公众号菜单草稿菜单名称、类型、触发关键词、链接、排序及父菜单
关键词回复草稿关键词、回复内容及启用状态
关注欢迎语草稿欢迎语内容及启用状态
服务号Token缓存缓存的 Access Token 及过期时间,避免频繁请求微信
消息模板从微信同步的模板标题、内容和字段
推送任务每次模板消息发送的内容、范围、状态与统计
公众号通知记录每个接收者的模板消息发送结果

主要行为流:

行为流说明
微信服务器URL验证与消息事件接收Webhook 入口,校验签名后分发到各事件处理流程
微信文本消息处理 / 微信菜单点击事件处理匹配关键词规则并被动回复
微信关注事件处理 / 微信取消关注事件处理发送欢迎语,更新关注用户状态
获取有效服务号Token读取缓存或向微信获取 Access Token
首次同步服务号关注者资料分页拉取关注者列表
发布公众号自定义菜单将菜单草稿组装后调用微信接口发布
同步消息模板 / 创建推送任务 / 执行推送任务 / 发送模板消息模板消息的同步与发送
检查我的成员状态页面加载时检查登录状态和成员状态,没有管理员时把当前账号设为管理员
设置成员角色管理员审批成员、修改角色或停用成员
内部-授予管理员角色 / 内部-授予运营角色 / 内部-授予只读角色 / 内部-移除成员角色由「设置成员角色」调用,实际增删账号的角色

新增数据表或行为流时,Zion 默认会给所有角色(包括匿名用户)开放权限。请到「设置 → 权限管理」中按「管理员 / 运营 / 只读」重新分配,并关闭匿名用户和「已登录用户」的访问权限。

常见问题

菜单发布或用户同步提示 40164

Zion 服务器的出口 IP 不在微信服务号 IP 白名单中。把错误信息中的 IP 加入公众平台「基本配置 → IP 白名单」后重试。

模板同步或发送提示 48001

微信服务号没有模板消息接口权限。请确认是已认证的服务号,并已在「广告与服务 → 模板消息」中开通功能。

关注后没有收到欢迎语

依次检查:

  • 欢迎语的「启用」开关是否打开。
  • 「服务号账号」中的原始 ID 是否与公众平台一致。
  • 服务器配置是否已启用,且消息加解密方式为「明文模式」。
  • 「消息事件中心」是否出现了关注记录。如果没有记录,说明推送没有到达,请检查 URL 和 Token。

发布菜单后没有变化

微信客户端会缓存菜单。请退出微信服务号聊天界面重新进入,或取消关注后重新关注再查看。

登录后一直显示「账号暂不可用」

账号还没有被审批,或已被停用。请联系管理员在「成员管理」中为该账号分配角色,然后点击「重新检查」。

看不到「成员管理」入口

只有管理员能看到。如果所有管理员账号都无法使用,可以在 Zion 编辑器的数据表「帐户」中把某个账号的「成员状态」改为「正常」、「成员角色」改为「管理员」,并在「设置 → 权限管理」中为该账号添加「管理员」角色。

关注用户的昵称为空

微信已不再通过接口返回用户昵称和头像,这是正常现象。

预览与发布

在 Zion 编辑器右上角点击「预览」即可在网页中体验后台。正式使用前请点击「发布」,并确保已在「同步后端」后完成上述接入配置。

Last updated on