WxPusher 应用消息

WxPusher 通过应用 Token 向已关注用户或主题订阅者推送消息。本文依据 WxPusher 官方文档整理，核验日期为 2026-09-08；未使用真实应用执行推送。

准备条件

已创建 WxPusher 应用并取得 appToken。
测试用户已关注应用，并已取得其 UID；或已经创建 Topic。
明确正文类型和摘要长度。

配置步骤

在 WxPusher 后台创建应用并设置应用信息。
引导测试用户关注应用，记录平台返回的 UID。
保存 appToken，不要暴露到前端。
使用单一 UID 发送最小文本。
需要广播时再配置 Topic，确认订阅者范围。

凭据说明

字段	必需	说明
`APP_TOKEN`	是	WxPusher 应用 Token
`UID`	按用户发送	关注应用后分配的用户标识
`TOPIC_ID`	按主题发送	已创建主题的数字标识
`contentType`	是	内容类型，按官方枚举选择

最小请求

JavaScript 示例需要 Node.js 20 或更新版本；Python 示例需要安装 requests。

curl -X POST 'https://wxpusher.zjiecode.com/api/send/message' \
  -H 'Content-Type: application/json' \
  -d '{"appToken":"APP_TOKEN","content":"通知渠道连通性测试","summary":"连通性测试","contentType":1,"uids":["UID"]}'

const response = await fetch('https://wxpusher.zjiecode.com/api/send/message', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    appToken: process.env.APP_TOKEN,
    content: '通知渠道连通性测试',
    summary: '连通性测试',
    contentType: 1,
    uids: [process.env.UID],
  }),
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

import os
import requests

response = requests.post(
    "https://wxpusher.zjiecode.com/api/send/message",
    json={
        "appToken": os.environ["APP_TOKEN"],
        "content": "通知渠道连通性测试",
        "summary": "连通性测试",
        "contentType": 1,
        "uids": [os.environ["UID"]],
    },
    timeout=15,
)
response.raise_for_status()
print(response.json())

验证结果

检查响应业务码和每个消息任务的状态，并由目标 UID 对应用户确认收到消息。批量发送时不能用总请求成功替代逐目标结果。

安全建议

appToken 只保存在服务器端。
UID、Topic 成员和消息正文可能涉及个人数据，应限制日志和后台访问。
先向测试 UID 发送，再扩大到 Topic 或批量用户。

常见问题

用户未收到：确认用户仍关注应用，UID 不是微信号、OpenID 或昵称。

内容类型错误：contentType 必须与正文格式匹配；先使用纯文本定位问题。

Topic 推送范围不符：检查 Topic ID 和订阅关系。

官方资料

WxPusher 官方文档