微信公众号
高级版及以上商业版功能
校对日期:2026-09-24。需要商业版高级版及以上。 本文面向站点管理员、内容运营人员和公众号运营人员,介绍微信公众号的接入配置及日常操作。
一、功能总览
通过 UJCMS 控制台的微信公众号菜单,您可以将本站文章推送到公众号草稿箱并发布,也可以管理 素材、菜单、粉丝和标签,设置自动回复、创建二维码、发送模板消息、查看统计数据和进行群发。
| 功能 | 控制台入口 | 数据存放位置 |
|---|---|---|
| 添加公众号、服务器配置、日志保留设置 | 微信 → 公众号 | UJCMS |
| 文章推送、推送记录 | 内容 → 文章管理 → 行操作 → 推送公众号;微信 → 推送记录 | 草稿保存在微信,推送记录保存在 UJCMS |
| 永久素材(图片、语音、视频、图文) | 微信 → 素材管理 | 微信服务器 |
| 草稿箱、已发布内容 | 微信 → 草稿箱 / 已发布 | 微信服务器 |
| 自定义菜单 | 微信 → 微信菜单 | 微信服务器 |
| 粉丝、黑名单、用户标签 | 微信 → 粉丝管理 / 粉丝标签 | 微信服务器 |
| 自动回复规则、收发消息记录 | 微信 → 自动回复 / 粉丝消息 | UJCMS |
| 带参数二维码、扫码次数 | 微信 → 二维码 | 二维码由微信创建,相关信息及扫码次数保存在 UJCMS |
| 模板消息、发送记录 | 微信 → 模板消息 | 模板保存在微信,发送记录保存在 UJCMS |
| 用户、图文、接口数据统计 | 微信 → 微信统计 | 微信服务器 |
| 群发、群发记录、额度估算 | 微信 → 群发管理 | 群发由微信执行,记录保存在 UJCMS |
使用前,请先了解以下事项:
- 版本要求:微信公众号功能在商业版高级版及以上版本中提供。社区版控制台的相关菜单带有商业版标识(皇冠图标), 点击后进入功能介绍页;文章管理中的“推送公众号”菜单项显示为灰色,无法点击,并提示“本功能在商业版中提供”。 商业版基础版、标准版不显示这些入口。
- 按站点管理:公众号归属于添加它的站点。各页面顶部的公众号下拉框只显示当前站点的公众号, 切换站点后,列表也会随之切换。一个站点可以添加多个公众号。
- 实时获取数据:素材、草稿、已发布内容、菜单、粉丝、标签、模板列表和统计数据均直接从微信获取, 不保存在 UJCMS 数据库中。每次打开相关页面都会调用微信接口,并占用该接口的每日调用额度。
- 处理结果更新:文章发布、模板消息发送和群发都需要等待微信处理。UJCMS 会先显示“已提交”或 “发布中”,随后通过“刷新状态”或接收微信服务器的通知更新最终状态,具体方式见各功能说明。
以下功能暂不支持在 UJCMS 中操作,请前往微信公众平台: 编辑个性化菜单、发送客服消息、从模板库添加模板及设置行业、订阅通知、按 OpenID 列表群发、 群发语音/图片/视频/卡券,以及设置群发速度。
二、准备工作(在微信开发者平台操作)
自 2025 年 12 月 1 日起,公众号的“开发接口管理”功能(AppID、AppSecret、IP 白名单、服务器配置、 接口权限等)已从微信公众平台迁移至微信开发者平台。 本章涉及的开发配置均在微信开发者平台操作:使用微信扫码登录后,进入我的业务 → 公众号/服务号, 选择对应账号。只有公众号的管理员或开发者才能在该平台查看账号信息,运营者无此权限, 可由管理员在基础信息 → 成员管理中将其添加为开发者。
2.1 确认公众号类型与认证状态
| 功能 | 订阅号 | 服务号 | 是否需要微信认证 |
|---|---|---|---|
| 文章推送、草稿、发布、素材、菜单 | 可用 | 可用 | 部分接口需认证,以微信接口权限页为准 |
| 粉丝、标签、黑名单 | 可用 | 可用 | 否 |
| 自动回复、消息记录、二维码 | 可用 | 可用 | 否 |
| 模板消息 | 不可用 | 可用 | 是 |
| 微信统计 | 可用 | 可用 | 是 |
| 群发 | 可用(每天 1 次) | 可用(每月最多向全部粉丝群发 4 次) | 是 |
具体可用功能以微信开发者平台接口管理 → 接口权限与额度页面列出的权限为准。遇到错误码 48001(接口未授权)时,请先在该页面确认公众号是否已获得相应权限。
2.2 获取 AppID 和 AppSecret
在微信开发者平台的基础信息页面获取:
- 开发者 ID(AppID):显示在基础信息页面。也可在微信公众平台设置与开发 → 账号设置 → 账号详情 的注册信息中查看;
- 开发者密码(AppSecret):在基础信息 → 开发密钥中启用或重置。微信不保存 AppSecret, 重置后仅显示一次,请妥善保存。
2.3 设置 IP 白名单
在基础信息 → 开发密钥页面的API IP 白名单中,添加 UJCMS 服务器的公网出口 IP,即服务器访问外网时使用的 IP 地址。 未添加时,所有接口调用都会失败,错误码为 40164。如果采用集群部署,请添加所有节点的公网出口 IP。
2.4 配置服务器(按需)
以下功能需要微信服务器主动向 UJCMS 发送消息和事件,本文将这一过程称为“回调”。如需使用, 请在基础信息 → 域名与消息推送配置 → 消息推送中启用消息推送。该配置即微信公众平台原来的 “服务器配置”,本文沿用这一名称:
- 自动回复、粉丝消息(记录收发消息)。
- 二维码的扫码次数统计。
- 模板消息送达状态更新;未启用时,发送记录会一直显示“已提交”。
- 群发最终结果和送达统计;未启用时,只能通过“刷新状态”查询结果,无法获取送达统计。
如果仅使用文章推送、素材管理、微信菜单、粉丝管理、粉丝标签和微信统计,可以不启用服务器配置。
启用服务器配置后,微信公众平台自带的自动回复将不再生效,请改用 UJCMS 的“自动回复”功能进行设置。 自定义菜单仍可通过 UJCMS 的“微信菜单”发布。
UJCMS 站点需提供微信服务器能够访问的公网地址,使用 80 或 443 端口,并在 5 秒内响应请求。 具体配置步骤见第三章。
三、添加公众号
入口:微信 → 公众号。
3.1 填写说明
| 字段 | 说明 |
|---|---|
| 名称 | 公众号在 UJCMS 中的显示名称,最多 30 个字符 |
| 开发者ID(AppID) | 填写“获取 AppID 和 AppSecret”一节获取的 AppID |
| 开发者密码(AppSecret) | 填写“获取 AppID 和 AppSecret”一节获取的 AppSecret,保存后不显示明文 |
| 类型 | 选择订阅号或服务号,须与微信公众平台中的实际类型一致。该选项决定能否发送模板消息,以及系统如何估算群发额度 |
| 令牌(Token) | 须与微信开发者平台消息推送配置中的 Token 一致,最多 32 个字符。用于验证微信回调请求;未填写时,回调地址会返回 HTTP 400 |
| 消息加解密密钥(EncodingAESKey) | 须与微信开发者平台消息推送配置中的 EncodingAESKey 一致,长度为 43 个字符。选择“兼容模式”或“安全模式”时必填 |
| 服务器地址(URL) | 保存后自动显示,不可编辑。点击“复制”,将地址填入微信开发者平台消息推送配置的 URL 栏 |
| 日志保留天数 | 0 表示永久保留;大于 0 时,系统每天定时清理超过保留期限的消息记录和模板消息发送记录,最多可设置为 3650 天。详见第十三章 |
| 排版预设 | 推送文章时为正文补充的排版样式:不处理 / 简洁 / 雅致。新建公众号默认“简洁”,升级前已有的公众号为“不处理”。详见 4.4 |
| 自定义排版规则 | 可选。在预设之后应用的排版规则,格式见 4.4;点击“预览排版”可在保存前检查效果 |
| 备注 | 最多 300 个字符 |
可拖动列表中的公众号调整顺序,各页面公众号下拉框也会按此顺序显示。
3.2 操作步骤
点击“新增”,填写名称、AppID、AppSecret,选择公众号类型,然后保存。
如需启用服务器配置,重新打开该公众号的编辑表单,复制“服务器地址(URL)”。如果不需要,可直接跳至第 5 步。 地址格式如下:
text<站点地址>/api/wechat/callback/<公众号ID>控制台会根据当前访问地址生成 URL。如果您通过内网地址访问控制台,请将 URL 中的主机地址改为 站点的公网地址,再填入微信开发者平台。
在微信开发者平台的消息推送配置中填写 URL、Token 和 EncodingAESKey,并选择消息加解密方式 (推荐“安全模式”)。同时,在 UJCMS 的公众号表单中填写相同的 Token 和 EncodingAESKey,并保存。
在微信开发者平台保存配置。微信会向填写的 URL 发送校验请求,由 UJCMS 自动完成验证。 校验通过后,点击“启用”。
回到 UJCMS,打开“素材管理”等需要从微信获取数据的页面,选择该公众号。页面能正常加载数据, 即表示 AppID、AppSecret 和 IP 白名单配置正确。
AppSecret、Token 或 EncodingAESKey 修改并保存后立即生效,无需重启系统。
3.3 删除公众号
删除公众号只会移除 UJCMS 中的公众号信息,不会注销公众号,也不会影响微信服务器上的数据。 删除前,请先清理该公众号关联的推送记录、自动回复规则、消息记录、二维码记录、模板消息发送记录 和群发记录。仍有关联数据时,系统无法删除该公众号。
四、将文章推送到公众号
4.1 前提条件
- 文章在本站的状态为已发布。只有已发布文章才能使用行操作菜单中的“推送公众号”。
- 文章已设置封面图片,且封面通过本站上传并保存在本站配置的存储中(本地、FTP 或 MinIO 均可)。使用外链封面会导致 推送失败,推送记录中显示“封面图片不在本站存储中”。
- 正文图片应通过本站上传。外链图片的地址在推送时会原样保留,但微信会屏蔽这些图片,导致图片无法显示。
- 多篇文章合并推送时,每一篇都必须满足以上条件;只要有一篇不满足,整次推送都不会执行。
4.2 推送流程
推送有两个入口,都在内容 → 文章管理:
- 单篇推送:展开文章的行操作菜单,点击“推送公众号”,生成一篇单图文草稿。
- 多篇合并推送(多图文):勾选 1 至 8 篇文章,点击列表上方的“推送公众号”按钮,这些文章会合并为一篇多图文草稿, 第一篇为头条(显示大图封面),其余为次条。
打开推送窗口后:
- 选择目标公众号。
- 检查文章列表。列表按文章管理中的显示顺序排列,可拖动左侧手柄调整顺序,第一篇标记为“头条”; 点击右侧的 × 可移除文章。不满足条件的文章会以红色标签说明原因(如“草稿”“无封面”), 移除这些文章或为其选择封面后才能保存。一篇多图文最多 8 篇文章。
- 按需点击某篇文章的“编辑”,调整它在公众号中的标题(最多 64 字)、作者(最多 8 字)、摘要(最多 120 字, 多图文只显示头条的摘要)和封面(从文章封面、图片集和正文图片中选择)。这些修改只用于本次推送,不会改变文章本身。 点击“预览”可查看该篇在手机上的图文卡片和正文效果(已套用公众号的排版预设,见 4.4)。
- 按需开启“推送后立即发布”。不开启时,草稿只保存到公众号草稿箱,之后可在“推送记录”或“草稿箱”中发布; 开启后,草稿推送成功即提交发布申请。“发布”只让文章获得永久链接,不会展示给粉丝,含义见 4.3。
- 点击“保存”。
系统会先把每篇文章的封面上传为微信永久图片素材,再将正文中的本站图片逐张上传到微信并替换图片地址, 然后生成一篇图文草稿(多篇文章即一篇多图文)。如果开启了“推送后立即发布”,系统还会提交发布申请。 每篇文章在图文中的内容对应关系如下:
| 微信图文内容 | 来源 | 处理规则 |
|---|---|---|
| 标题 | 推送窗口中的标题,默认为文章标题 | 最多保留前 64 个字符 |
| 作者 | 推送窗口中的作者,默认为文章作者 | 最多保留前 8 个字符 |
| 摘要 | 推送窗口中的摘要,默认为文章摘要 | 最多保留前 120 个字符 |
| 正文 | 文章正文(图片地址已替换,并按公众号排版预设补充内联样式,见 4.4) | — |
| 封面 | 推送窗口中选择的封面,默认为文章封面图片 | 必填,需为本站存储中的图片 |
| 原文链接(阅读原文) | 文章在本站的完整地址 | 站点域名必须是公网域名。域名为 localhost、127.0.0.1 或内网 IP 时(如开发、内网环境),微信会拒绝这类地址,系统不设置原文链接,草稿照常创建,推送记录的“错误信息”列显示“提示:未设置阅读原文链接” |
| 留言 | 关闭 | 不支持修改 |
多图文中只有头条显示摘要,这是微信的规则。每次推送都会重新上传封面并新建一篇草稿,不会更新或合并已有草稿。 因此,重复推送同一篇文章会在微信中产生多篇草稿和多个封面素材。每个封面素材都会占用公众号的永久素材额度, 总上限为 10 万条。
4.3 推送记录
入口:微信 → 推送记录。每次推送生成一条记录,对应微信中的一篇草稿;支持按标题搜索、按公众号和状态筛选。 多图文记录在标题(头条标题)旁显示“多图文 N 篇”标签,鼠标悬停可查看各篇标题,发布成功后每篇标题都可点击打开对应文章。
| 状态 | 含义 | 可用操作 |
|---|---|---|
| 草稿 | 已进入微信草稿箱,尚未发布。“错误信息”列若显示以“提示:”开头的内容,说明草稿已创建但有需要注意的事项(如未设置阅读原文链接) | 发布 |
| 发布中 | 已提交发布,微信正在审核处理 | 刷新状态 |
| 已发布 | 发布成功,可点击“文章链接”列中的“查看”打开文章 | — |
| 失败 | 推送或发布失败,将鼠标悬停在“错误信息”上可查看原因 | — |
- 发布:将草稿提交给微信发布。发布只让文章获得一个永久链接(发布成功后显示在“文章链接”列), 可用于自定义菜单、自动回复等场景;文章不会出现在公众号主页和历史消息中,也不会通知粉丝。 这是微信发布接口的规则。要让粉丝在公众号中看到文章,请在“群发管理”中群发该草稿,详见第十二章。
- 刷新状态:查询发布结果。微信处理发布申请通常需要几十秒到几分钟。查询结果中可能出现的失败原因包括 “原创审核不通过”“常规失败”“平台审核不通过”“成功后用户删除所有文章”“成功后系统封禁所有文章”; 多图文审核未通过时,错误信息还会指出未通过审核的文章序号,例如“原创审核不通过,第 2 篇未通过”。
- 删除:只删除本系统的记录,不会删除微信草稿箱或已发布的内容。
记录中保存的是推送时的文章标题。即使本站文章已被删除,推送记录仍会保留。
4.4 排版样式
微信会丢弃网站的样式表,只保留正文元素上的内联样式,因此直接推送的文章在公众号中会显示为微信默认排版, 与网站上的效果不同。系统会在推送时,按公众号的设置为正文元素补充内联样式。设置入口:微信 → 公众号 → 编辑。
排版预设:
- 不处理:正文原样推送,按微信默认排版显示;
- 简洁:统一的正文字号、行距、段距,图片居中,引用块、列表、表格、代码有基础样式;
- 雅致:在“简洁”的基础上加大行距、段距,标题与引用块以微信绿点缀。
新建公众号默认“简洁”;升级前已有的公众号为“不处理”,推送效果与升级前一致,可按需切换。
自定义排版规则:可选,在预设之后应用,可覆盖预设中的样式。每条规则为“选择器 { 样式 }”,例如:
/* 正文段落 */ p { font-size: 16px; line-height: 1.8; } h2 { color: #07c160; } img { border-radius: 8px; }选择器与 CSS 相同(如
p、h2, h3、blockquote p),支持/* */注释,不支持嵌套和@规则。 元素自身已有的内联样式(如编辑器中手动设置的居中、颜色)优先级最高,不会被预设或规则覆盖。预览排版:在表单中点击“预览排版”,可用示例正文查看当前预设与规则的效果;规则中无法解析的部分会列在 输入框下方,保存时系统会拒绝含有这类问题的规则。推送窗口中每篇文章的“预览”则显示真实文章套用排版后的效果。
排版只影响推送到公众号的内容,不改变文章在本站的显示。如需更精细的版式,可在推送后到微信公众平台的草稿箱中继续编辑。
五、素材、草稿箱与已发布内容
这三个页面的数据均直接从微信获取,相关操作也会直接修改微信中的数据。请先在页面顶部选择公众号, 列表每页显示 20 条。
5.1 素材管理
- 页面包含“图片”“语音”“视频”“图文”四个选项卡,选项卡标题后显示微信中对应类型的素材数量。
- 上传素材:支持将图片、语音和视频上传为永久素材,上传类型由当前选项卡决定。图片和语音可一次选择 多个文件,系统按选择顺序逐个上传;某个文件上传失败时停止,未上传的文件保留在列表中,可修正后重试。 视频每次上传一个,需填写“视频标题”,“视频描述”可选。对话框中会提示当前类型允许的格式和大小, 不符合要求的文件在选择时即被拒绝。图文素材不能在此新建,请通过文章推送或微信公众平台创建, “图文”选项卡中会显示相应提示。
- 素材名称:图片和语音以上传时的文件名作为名称,视频以上传时填写的“视频标题”作为名称。微信不提供 修改素材名称的接口,名称在上传后不可修改;如需更名,只能删除后重新上传,重新上传会产生新的 MediaID。
- 视频详情:点击视频选项卡中的“详情”,可查看该视频在微信中的标题,并下载视频文件(下载地址由微信临时签发, 请及时使用)。微信“获取永久素材”接口对视频返回的描述为空(2026 年 9 月实测),上传时填写的视频描述在 UJCMS 和微信公众平台的素材库中均无法查看,请自行留存。每次点击“详情”都会调用一次微信接口。
- 微信对永久素材的限制:图片 10 MB 以内(bmp、png、jpeg、jpg、gif);语音 2 MB 以内、时长 60 秒以内(mp3、wma、wav、amr);视频 10 MB 以内(mp4)。每个公众号永久素材总数上限 10 万条。
- 预览:图片选项卡显示缩略图,点击缩略图可查看大图。微信素材地址设有防盗链,只能在本页面查看, 不能在网页中直接引用。
- 列表中的 MediaID 是素材标识。设置图片自动回复或在其他功能中使用素材时,需填写该标识。
- 删除:从微信服务器中删除素材,不可恢复。如果草稿或自动回复正在使用该素材,删除后将无法正常使用。
5.2 草稿箱
此页面列出公众号草稿箱中的全部草稿,包括在微信公众平台上手动创建的草稿。
- 多图文草稿只显示头条的封面和标题,标题旁的“多图文 N 篇”标签表示篇数,鼠标悬停可查看各篇标题并打开对应的网页预览。
- 网页预览:打开微信提供的临时链接,在浏览器中查看正文和排版效果。链接会在短期内失效,重新打开草稿箱页面即可获得新链接。 封面只显示在图文卡片中,正文页不显示;要查看封面效果,请在“群发管理”中使用“发送预览”(第十二章)。
- 发布:提交发布申请。如果草稿由 UJCMS 推送生成,对应推送记录会更新为“发布中”;其他来源的草稿 则会生成一条新的推送记录,标题与草稿一致,不关联本站文章。发布只生成永久链接,文章不会出现在公众号主页, 也不会通知粉丝;要展示给粉丝,请使用群发(第十二章)。
- 删除:从微信删除草稿。
- 如需编辑草稿内容,请前往微信公众平台。UJCMS 不提供公众号图文编辑器。
5.3 已发布
此页面列出通过微信发布接口发布的内容,点击标题可打开微信文章页面。这些内容只有永久链接,不会出现在公众号主页。
- 多图文内容只在列表中显示头条的封面和标题,标题旁的“多图文 N 篇”标签表示篇数,鼠标悬停可查看各篇标题并打开对应文章。
- 标记为“已删除”的内容表示该内容已从微信中删除。
- 删除:从微信中删除该条已发布内容,不可恢复。删除后,推送记录的状态不会自动更新。
- 此列表只显示通过“发布”操作发布的内容,不包含群发图文。
六、微信菜单
入口:微信 → 微信菜单。选择公众号后,点击“重新加载”获取当前菜单。 左侧编辑区中的菜单为尚未发布的草稿。添加、移除、改名等修改都只在页面上生效,需点击“发布菜单”后才会更新到公众号。 有未发布的修改时,页面会给出提示;此时“重新加载”或切换公众号会先确认再丢弃这些修改。
菜单数量:最多可设置 3 个一级菜单,每个一级菜单下最多可设置 5 个子菜单。已有子菜单的一级菜单 不能再设置跳转网页等点击操作。
菜单名称:控制台最多允许输入 16 个字符;微信另有字节长度限制,一级菜单名称不超过 16 字节, 子菜单名称不超过 60 字节,超出后无法发布。一级菜单名称建议不超过 4 个汉字,以免在微信中显示不完整。
菜单类型:
类型 需要填写 说明 跳转网页 网页链接 点击后打开链接 点击事件 事件标识(Key) 点击后,微信会向 UJCMS 发送 CLICK 事件。当前版本仅在“粉丝消息”中记录该事件,不会触发自动回复 小程序 小程序AppID、小程序页面路径、网页链接 小程序需与公众号关联;微信客户端不支持小程序时,会打开所填的网页链接 移除该菜单项:从编辑区中去掉选中的一级菜单或子菜单,只是本地修改,发布后才在公众号生效。
发布菜单:用编辑区中的菜单完整替换微信中的原有菜单。原有菜单中未保留在编辑区的部分会被删除。
删除公众号全部菜单:立即删除公众号的全部自定义菜单,包括个性化菜单,无需另行点击“发布菜单”。
如果公众号已有个性化菜单,页面会显示其数量。此页面仅支持编辑默认菜单。
微信客户端会缓存菜单,发布后可能需要等待,最长 24 小时生效。测试时可先取消关注,再重新关注以立即查看。
七、粉丝与标签
7.1 粉丝管理
入口:微信 → 粉丝管理。页面包含“全部粉丝”和“黑名单”两个选项卡,每页显示 20 人。
- 列表不显示昵称和头像:自 2021 年 12 月 27 日起,微信不再通过接口提供粉丝昵称和头像,且没有替代接口 (仅当粉丝在网页授权中主动允许时才能取得,粉丝列表无法获得)。如需区分粉丝,可使用“设置备注”, 备注最多 30 个字符,留空保存即可清除。
- 关注来源:微信记录的关注渠道,如“公众号搜索”“扫描二维码”“名片分享”“图文页内名称点击”“微信广告”“视频号”等; 微信未归类的渠道显示为“其他”;暂未识别的新渠道直接显示渠道代码。
- 打标签 / 移除标签:勾选粉丝,再选择要添加或移除的标签。微信每次最多处理 50 人,控制台每页显示 20 人, 单页操作不会超过该限制。
- 加入黑名单 / 移出黑名单:勾选粉丝后执行相应操作。加入黑名单后,粉丝仍处于关注状态,但无法收到公众号的群发和 模板消息。
- 列表按微信返回的顺序显示。OpenID 是粉丝在当前公众号下的唯一标识;系统单次最多获取 10 万个 OpenID。 因此,粉丝数超过 10 万的公众号只能查看列表中的前 10 万人。
7.2 粉丝标签
入口:微信 → 粉丝标签。
- 新增、编辑:标签名称最多 30 个字符。每个公众号最多可创建 100 个标签,每位粉丝最多可添加 20 个标签。
- 查看粉丝:查看该标签下的粉丝列表。“粉丝数”以微信返回的数量为准。
- 删除:删除标签时,粉丝关联的该标签也会一并移除。微信不允许删除粉丝数超过 10 万的标签;微信预置的标签 (如“星标组”)不能修改或删除。
群发时可以选择某个标签,将消息发送给该标签下的粉丝,详见第十二章。
八、自动回复与粉丝消息
使用这两个功能前,请先按照“配置服务器”一节的说明启用服务器配置。
8.1 自动回复规则
入口:微信 → 自动回复。选择公众号后新增规则。
| 规则类型 | 触发条件 |
|---|---|
| 关注回复 | 用户关注公众号时触发,包括扫描带参数二维码后关注 |
| 关键词回复 | 粉丝发送文本消息,且内容符合关键词规则时触发。“全匹配”要求去除首尾空白后的消息内容与关键词完全一致;“半匹配”只要求消息内容包含关键词 |
| 默认回复 | 收到文本、图片、语音、视频、位置、链接等普通消息,且未匹配到关键词规则时触发。事件不会触发默认回复 |
回复类型:
| 回复类型 | 需要填写 |
|---|---|
| 文本 | 回复内容,最多 600 个字符 |
| 图片 | 永久图片素材的 MediaID,可在“素材管理”中查看 |
| 图文 | 图文标题、图文描述、图片链接、跳转链接;系统据此生成一条单图文消息 |
匹配规则:
- 每条消息最多回复一次。关键词规则和关注回复规则按列表中的排列顺序依次匹配,匹配成功后即停止。 可拖动规则调整顺序;默认回复始终排在最后。
- 规则可启用或停用,停用后不参与匹配。
- 回复内容不完整时,系统不会发送回复,例如文本为空、未填写 MediaID,或图文缺少必填项。
- 关键词规则只匹配文本消息。除关注事件外,菜单点击、扫码、取消关注等事件均不会触发自动回复。
- 微信要求系统在收到消息后的 5 秒内返回自动回复。UJCMS 会在处理消息时直接生成回复,规则修改后立即生效。
8.2 粉丝消息
入口:微信 → 粉丝消息。此页面记录 UJCMS 通过微信回调收到的消息,以及发出的自动回复, 支持按粉丝 OpenID 搜索、按收发方向筛选。
“消息内容”列根据消息类型显示不同内容:
| 消息类型 | 记录内容 |
|---|---|
| 文本 | 消息原文 |
| 图片、语音、视频等 | 微信临时素材的 MediaID,3 天后失效,仅用于排查问题 |
| 事件 | 事件名 或 事件名:事件参数,例如 subscribe、unsubscribe、SCAN:场景值、subscribe:、CLICK:事件标识 |
| 自动回复(发送方向) | 文本内容、图片 MediaID,或 JSON 格式的图文数据 |
模板消息送达通知和群发结果通知不会显示在“粉丝消息”中,只会更新对应的发送记录或群发记录。
消息记录可手动删除,也可根据公众号设置的“日志保留天数”定时清理,详见第十三章。
九、带参数二维码
入口:微信 → 二维码。微信不提供查询二维码列表和删除二维码的接口,因此 UJCMS 会在 二维码创建成功后保存相关信息。此页面仅显示在 UJCMS 中创建并保存的二维码记录。
9.1 创建
| 类型 | 场景值 | 有效期 | 上限 |
|---|---|---|---|
| 临时二维码 | 场景值ID:1 至 4294967295 的整数,可留空,系统自动取该公众号已登记的最大场景值加一 | 30 分钟 / 1 天 / 7 天 / 30 天,默认 30 天 | 无 |
| 永久二维码 | 场景值:1 至 64 个字符 | 永久有效 | 每个公众号累计最多 10 万个,不可撤销 |
“场景值”是二维码携带的参数,扫码者看不到;粉丝扫码后,微信发给 UJCMS 的扫码事件会携带该值,可在“粉丝消息”中看到, 用于区分投放渠道或使用场景。UJCMS 根据二维码凭证(Ticket)统计扫码次数,不依赖场景值,因此临时二维码的“场景值ID”可以留空。 永久二维码不可撤销,场景值需自行填写。“名称”可填写用途或投放渠道,仅在 UJCMS 中显示,可随时修改。
9.2 查看与使用
点击“查看”打开二维码详情:
- 二维码图片:由微信实时提供,有效期内无需登录即可访问。
- 复制:复制二维码图片链接。
- 下载:在新窗口打开二维码图片,可将图片保存到本地。
- 解析地址:二维码包含的微信链接,可用于自行生成带有自定义样式的二维码图片。
9.3 扫码统计
启用服务器配置后,微信会将扫码相关事件发送给 UJCMS:
- 未关注的用户扫码并关注后,产生
subscribe事件,事件参数以qrscene_开头。 - 已关注的粉丝扫码后,产生
SCAN事件。
这两种事件都会使对应二维码记录的“扫码次数”加 1,并显示在“粉丝消息”中。未在 UJCMS 中保存记录的 二维码不计入统计。
扫码后关注公众号会触发“关注回复”规则;二维码的场景值不参与关键词匹配。
9.4 编辑与删除
- 编辑:仅支持修改名称。
- 删除:仅删除 UJCMS 中的二维码记录,无法撤销微信中的二维码。永久二维码仍然有效,并继续占用创建额度。
临时二维码过期后,列表中会显示“已过期”标记。
十、模板消息
入口:微信 → 模板消息。只有已认证的服务号可以使用模板消息。选择订阅号时,页面会显示提示, “发送”按钮不可用。
10.1 模板列表
此页面显示公众号已添加的模板(即私有模板),最多 25 个。如需添加模板或设置行业,请前往微信公众平台的 功能 → 模板消息。UJCMS 仅显示“所属行业”,不支持修改。
公众号必须先设置所属行业,模板消息的各项接口才能使用;未设置时,打开页面会提示错误码
40102。 测试号没有设置行业的页面入口,需调用微信的“设置所属行业”接口(template/)设置一次, 然后在测试号管理页面的“模板消息接口”中新增测试模板。行业每月只能修改一次。api_ set_ industry 新增测试模板时,模板内容建议采用 “字段名:{{名称.DATA}}”的格式(每行一个字段),发送时输入框会直接显示字段名。
删除:从微信公众号中删除该模板,不可恢复。
10.2 发送
找到要使用的模板,点击所在行的“发送”,按以下说明填写:
对话框顶部显示模板标题和模板内容,内容中的占位符({{名称.DATA}})以蓝色高亮,便于对照每个字段在消息中的位置。
- 接收人:点击“选择粉丝”,在列表中勾选接收人,单次最多选择 100 人。接收人必须已关注该公众号。 微信不提供粉丝昵称和头像,列表只能显示 OpenID 和备注,请先在“粉丝管理”中为粉丝设置备注或打标签: 列表左上角可按标签筛选,勾选结果在翻页、切换标签后保留。已选接收人以 OpenID 显示,设置了备注的粉丝同时显示备注。
- 模板数据:系统为模板内容中的每个占位符生成一个输入框。占位符前同一行以冒号结尾的文字 (如“预约时间:{{time4.DATA}}”中的“预约时间”)作为输入框名称,右侧以灰色显示占位符名称; 没有这样的文字时直接显示占位符名称(如
content、thing1)。占位符名称由微信或模板创建者指定,无法翻译。 微信已不再支持设置模板消息的字体颜色。 - 跳转链接:填写用户点击消息后打开的网页地址,可不填。
- 小程序AppID、小程序页面路径:填写用户点击消息后打开的小程序信息,可不填。小程序须与公众号关联; 页面路径需先填写 AppID 后才能填写;同时填写小程序信息和跳转链接时,优先打开小程序。
点击“发送”后,系统会依次向每位接收人发送模板消息。向某位接收人发送失败时,不会影响其他接收人,完成后提示 “共 N 人,成功 X 人,失败 Y 人”。
10.3 发送记录
每位接收人的发送结果都会单独保存在“发送记录”选项卡中,支持按 OpenID 搜索、按状态筛选。
| 状态 | 含义 |
|---|---|
| 已提交 | 微信已受理发送请求。未启用服务器配置时,记录会一直保持此状态 |
| 送达 | 已收到微信回调,确认消息送达 |
| 失败 | 微信拒绝发送请求,错误信息中会显示微信错误码;或微信回调反馈“用户拒收”“系统失败” |
发送记录可手动删除,也可按“日志保留天数”定时清理。
10.4 平台限制
- 模板消息仅用于服务通知,不得用于营销推广。违规使用会被微信收回接口权限。
- 默认每日最多发送 10 万次;粉丝数达到 10 万、100 万、1000 万时,额度会自动提升。实际额度以 微信开发者平台的“接口权限与额度”页面为准。
十一、微信统计
入口:微信 → 微信统计。选择公众号后,可切换选项卡查看不同类型的数据。图表按天展示。
| 选项卡 | 指标 | 可选范围 |
|---|---|---|
| 用户分析 | 新增关注、取消关注、净增关注、累计关注 | 最近 7 天 / 30 天 / 90 天 |
| 图文分析 | 阅读人数、分享人数、点赞人数、在看人数、留言条数、收藏人数、跳转原文人数、发表篇数(汇总整个公众号发表的内容,不区分单篇文章) | 最近 7 天 / 30 天 |
| 接口分析 | 调用次数、失败次数、平均耗时、最大耗时 | 最近 7 天 / 30 天 / 90 天 |
- 微信统计数据延迟一天更新:前一天的数据通常在次日上午 8 点左右发布。因此,图表的结束日期固定为昨天, 不包含今天的数据。
- 用户分析和接口分析不提供 2014 年 12 月 1 日以前的数据;图文分析使用微信的“发表内容概况”接口, 只提供 2025 年 11 月 1 日以后的数据。如果某一天没有返回数据,图表会按 0 显示,以保持日期连续。
- 图文分析中的“点赞”指文末的“赞”,“在看”指“在看”;“发表篇数”为当天发表(含群发)的文章篇数。 微信原来的图文阅读、转发统计接口已下线,因此不再提供阅读次数和分享次数。
- 使用微信统计功能需要公众号已通过微信认证。
十二、群发
入口:微信 → 群发管理。群发可将消息发送给全部粉丝,或指定标签下的粉丝,并在粉丝的微信中产生消息提醒。 使用此功能需要公众号已通过微信认证;未认证时,微信会返回错误码 48001。
12.1 群发额度
页面顶部显示当前公众号已使用群发额度的估算值:
| 类型 | 微信规则 | 页面显示 |
|---|---|---|
| 认证订阅号 | 每天可群发 1 次,向全部粉丝群发和按标签群发都占用额度 | 今日已群发 x / 1 次 |
| 认证服务号 | 每位粉丝每个自然月最多接收 4 条群发消息。向“全部粉丝”群发每月最多 4 次;“按标签”群发可多次提交,但当月已收到 4 条群发消息的粉丝不会再收到 | 本月全员群发 x / 4 次 |
页面显示的已用额度由 UJCMS 根据微信已受理的群发记录估算。在微信公众平台发起的群发也会占用额度, 但 UJCMS 无法统计这部分用量。微信不提供额度查询接口;提交群发时如返回错误码 45028,表示额度已用完。
如果公众号开启了“群发接口调用保护”,向全部粉丝群发后,需要公众号管理员在 30 分钟内到微信中确认。 管理员拒绝或超时未确认,群发结果都会显示为失败。
12.2 新建群发
选择公众号。
群发目标:选择“全部粉丝”,或选择“按标签”并指定一个标签。
消息类型:
- 图文:点击“选择草稿”,从草稿箱中选择一篇图文。也可先通过“推送公众号”将本站文章保存为草稿。 选定后窗口中显示该草稿的封面、标题和摘要,多图文显示“多图文 N 篇”标签,鼠标悬停可查看各篇标题; 点击“网页预览”可在浏览器中查看正文和排版效果。封面、标题、摘要和排版在草稿中已固定,群发时不能修改: 由“推送公众号”生成的草稿在推送时选择封面、编辑标题和摘要(见 4.2),其他草稿请在微信公众平台中编辑。 微信会对群发图文进行原创校验。“被判定为转载时继续群发”默认未勾选;未勾选时,如果文章被判定为转载, 微信会停止群发。
- 文本:输入消息内容,最多 600 个字符。
发送预览(可选):填写一位粉丝的 OpenID,点击“发送预览”,即可在该粉丝的手机上查看效果,包括图文卡片和封面。 预览不占用群发额度,预览接口每天最多调用 100 次。
点击“提交”并确认,系统会立即向微信提交群发请求。提交后无法取消;图文撤回的规则见下一节。
12.3 群发记录
| 状态 | 含义 | 可用操作 |
|---|---|---|
| 已提交 | 微信已受理,正在发送或审核 | 刷新状态、撤回(图文) |
| 发送成功 | 微信回调确认发送完成,“成功/送达”列显示成功人数和总人数;总人数中可能包含少量发送失败的接收人 | 撤回(图文) |
| 失败 | 微信拒绝提交请求,或内容未通过微信审核(涉及广告、政治、色情、版权、转载等问题),具体原因见错误信息 | — |
| 已撤回 | 已执行“撤回”,使图文失效;或刷新状态时发现该群发已在微信中删除 | — |
- 刷新状态:向微信查询群发状态。未启用服务器配置时,可通过此操作获取结果。查询结果不包含送达统计, 送达统计只能通过微信回调获取。
- 撤回:仅支持撤回图文群发,且会撤回整条群发内容。撤回后,图文页面无法访问,使用同一草稿的所有群发也会同时失效。 已收到消息的粉丝仍能看到消息卡片,已占用的群发额度不会返还。微信对撤回操作没有时间限制。
- 删除:只删除本系统的记录,不会撤回群发。失败的记录不计入额度估算。
十三、日志定时清理
可在公众号编辑表单中设置“日志保留天数”。UJCMS 每天凌晨 3:30 执行一次清理任务,规则如下:
- 设置为 0 时永久保留,这是默认值;设置为正数时,最多可保留 3650 天。
- 系统仅删除超过保留期限的消息记录和模板消息发送记录。
- 推送记录、群发记录和二维码记录不参与定时清理。
- 集群部署时,清理任务只在一个节点上执行。某个公众号清理失败不会影响其他公众号,清理结果会写入应用日志。
十四、权限与操作日志
在角色权限设置中,可展开“微信公众号”分组,按页面分配权限。每个页面包含“列表”权限及对应的操作权限:
| 页面 | 操作项 |
|---|---|
| 公众号 | 新增、编辑、删除 |
| 素材管理 | 上传素材、删除 |
| 草稿箱 | 发布、删除 |
| 已发布 | 删除 |
| 微信菜单 | 发布菜单、删除公众号全部菜单 |
| 粉丝管理 | 设置备注、打标签、黑名单 |
| 粉丝标签 | 新增、编辑、删除 |
| 自动回复 | 新增、编辑、删除 |
| 粉丝消息 | 删除 |
| 推送记录 | 推送公众号、发布、刷新状态、删除 |
| 二维码 | 新增、编辑、删除 |
| 模板消息 | 发送、删除、发送记录查看与删除 |
| 微信统计 | 列表 |
| 群发管理 | 新建群发、发送预览、刷新状态、撤回、删除 |
- 使用文章管理中的“推送公众号”菜单项,需要“推送记录 → 推送公众号”权限。
- 其他微信公众号页面都需要读取公众号列表,因此分配权限时,还需包含“公众号 → 列表”权限。 勾选素材、菜单、粉丝等页面时,控制台会自动带上此项;“推送记录”页面例外,其权限设置未自动包含该项, 请为只负责推送记录的角色手动勾选“公众号 → 列表”,否则该页顶部的公众号下拉框为空。
- 所有新增、修改、删除、发送等操作都会记录在日志 → 操作日志中,模块名称以“公众号”开头, 例如“公众号推送”“公众号群发”。
十五、常见问题
微信接口调用失败时,控制台会弹出提示,内容为错误码、微信的错误说明和处理建议,例如 “微信接口调用失败(错误码 45009:接口调用超过限制)。该接口今天的调用次数已达微信规定的上限……”。 推送记录、群发记录和模板消息发送记录中的“错误信息”采用同样的格式。下表列出常见问题及处理方法。
| 问题现象 | 可能原因 | 处理方法 |
|---|---|---|
素材管理等页面均报错,错误码为 40164 | UJCMS 服务器的公网出口 IP 未加入白名单 | 在微信开发者平台的“基础信息 → 开发密钥”中添加 API IP 白名单;集群部署需添加所有节点的公网出口 IP |
错误码 40001、40013、40125 | AppSecret 填写错误或已重置,或 AppID 填写错误 | 核对 UJCMS 公众号表单中的 AppID 和 AppSecret |
错误码 45009 | 该接口当天的调用额度已用完 | 次日再试;如需立即恢复,可调用微信的“重置 API 调用次数”接口清空计数(每个账号每月限 10 次)。迁移至微信开发者平台后,页面上不再提供清空按钮 |
错误码 47009 | 微信已下线该接口 | 升级到最新版本的 UJCMS;如已是最新版本,请向 UJCMS 反馈 |
错误码 48001 | 公众号没有相应接口权限,例如尚未认证,或订阅号使用了仅限服务号的功能 | 参照“确认公众号类型与认证状态”一节,并在微信开发者平台的“接口权限与额度”页面核实权限 |
| 在微信开发者平台提交消息推送配置时,提示 Token 校验失败 | 两端 Token 不一致、URL 不是公网可访问的地址、公众号 ID 错误、HTTPS 证书无效,或响应超过 5 秒 | 用浏览器直接打开回调 URL,正常情况下会因缺少参数返回 HTTP 400;若返回 HTTP 404 或超时,请先排查地址是否可访问,再检查 Token、证书和反向代理配置 |
| 安全模式下收不到自动回复 | 未填写 EncodingAESKey,或与微信开发者平台中的密钥不一致 | 填写正确的 EncodingAESKey 并保存 |
| 自动回复不生效 | 未启用服务器配置或规则;发送的不是文本消息,无法匹配关键词;触发了关注以外的事件;或前面的规则已优先匹配 | 先在“粉丝消息”中确认是否收到消息,再检查服务器配置、规则状态、消息类型和规则顺序 |
| 推送失败,提示“封面图片不在本站存储中” | 封面使用外链,或封面文件已被删除 | 通过本站重新上传封面后再推送 |
| 推送成功,但图文没有“阅读原文”链接,推送记录提示“未设置阅读原文链接” | 站点域名为 localhost 或内网 IP,微信不接受这类地址作为原文链接 | 在“网站设置”中填写公网域名后重新推送 |
| 推送成功,但正文图片无法显示 | 正文使用了外链图片,被微信屏蔽 | 将图片上传到本站,替换正文中的外链图片后重新推送 |
| 推送记录显示“已发布”,但在微信中打开公众号主页看不到这篇文章 | 通过发布接口发布的内容只生成永久链接,微信不会将其展示在公众号主页,也不会通知粉丝 | 点击“文章链接”列的“查看”确认文章已存在;要展示给粉丝,请在“群发管理”中群发该草稿 |
| 推送记录长时间显示“发布中” | 微信尚未处理完成 | 点击“刷新状态”查询结果 |
| 模板消息发送记录一直显示“已提交” | 未启用服务器配置,无法收到送达通知 | 启用服务器配置;未启用时,“已提交”仅表示微信已受理请求 |
模板消息发送失败,错误码为 43004 | 接收人未关注公众号 | 确认接收人已关注该公众号后再发送 |
模板消息发送失败,错误码为 40037 | 模板已在微信公众平台删除 | 重新加载模板列表 |
打开模板消息页面报错,错误码为 40102 | 公众号尚未设置所属行业 | 认证服务号在微信公众平台“功能 → 模板消息”中设置行业;测试号需调用微信的“设置所属行业”接口(template/)设置一次 |
| 粉丝列表没有昵称和头像 | 微信自 2021 年 12 月 27 日起不再通过接口提供这些信息,控制台不再显示这两列 | 使用“设置备注”区分粉丝 |
| 二维码扫码次数不增加 | 未启用服务器配置,或二维码不是在 UJCMS 中创建的 | 确认二维码在 UJCMS 中有记录,启用服务器配置后重新扫码验证 |
| 微信统计为空 | 公众号未认证,或昨天的数据尚未发布;今天的数据暂不可查 | 确认公众号已认证;昨天的数据通常在今天上午 8 点左右发布,可稍后再查 |
群发提交失败,错误码为 45028 | 群发额度已用完,包括在微信公众平台发起的群发所占用的额度 | 等待下一个额度周期 |
| 群发记录一直显示“已提交” | 未启用服务器配置 | 点击“刷新状态”查询结果;送达统计只能通过微信回调获取 |
| 群发失败,提示审核不通过或被判定为转载 | 未通过微信内容审核或原创校验 | 修改内容后重新群发;对于转载文章,可勾选“被判定为转载时继续群发” |
| 集群部署时偶尔出现接口调用失败 | 某个节点的公网出口 IP 未加入白名单。各节点分别缓存 access_token,微信允许这些凭证同时存在 | 核对所有节点的公网出口 IP,确保均已加入白名单 |