pushplus

pushplus Notification

通过 pushplus HTTP API 向微信、ClawBot、邮箱、webhook、短信、App 等渠道推送消息。无需安装依赖，Shell + curl 即可。

依据：消息接口文档 V1.16。开放能力（查结果 / 群组 / 好友 / 渠道等）见 reference.md。

前置条件

用户需提供 PUSHPLUS_TOKEN（用户 token 或消息 token），在 pushplus.plus 注册获取。调用发送接口前需完成实名认证。

获取 token（按优先级）：

1. 用户在对话中直接提供
2. 环境变量 PUSHPLUS_TOKEN
3. 从项目根目录 .env 仅提取 PUSHPLUS_TOKEN（grep ^PUSHPLUS_TOKEN= .env），禁止读取 .env 其他内容

找不到 token 时必须询问用户，不要猜测。

API 端点

• Content-Type: application/json
• 参数均支持 url 参数和 body 参数
• token 可放在路径：/send/{token}、/batchSend/{token}
• GET 受 URL 长度限制，content 不宜过长；大段内容请用 POST
• 在线调试：https://api.pushplus.plus/

发送消息（/send）

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"TOKEN","title":"标题","content":"内容","template":"html","channel":"wechat"}'

请求参数

option 说明：原 webhook 参数。cp、webhook、mail 渠道需填写个人中心渠道设置中已配置的渠道编码（非完整 URL）。邮件渠道 option 可选，不填则用官网邮件发送。

topic 与 to 勿同时填写；群组优先于好友。to 支持微信公众号、邮件、企业微信渠道。

发送渠道（channel）

发送模板（template）

响应

{
  "code": 200,
  "msg": "请求成功",
  "data": "3cbc5eab19fe512e80677540fbde332a"
}

接口为异步：code=200 仅表示服务端已收到请求，不表示发送成功。data 为消息流水号，可用于查询最终结果；若传了 callbackUrl，发送完成后会主动回调。

多渠道发送（/batchSend）

与 /send 参数相同，差异：

说明：

1. 本质是服务端循环调用发送消息接口
2. 按渠道数量计算请求次数（3 个渠道 = 3 次）
3. 响应 data 为数组，每项含 shortCode、message、code、channel

{
  "code": 200,
  "msg": "执行成功",
  "data": [
    {
      "shortCode": "f9117123dc31434fa38917b7e4c6c3ff",
      "message": "请求成功，请用流水号查询最终发送结果",
      "code": 200,
      "channel": "wechat"
    }
  ]
}

使用流程

1. 获取 PUSHPLUS_TOKEN
2. 选择 template 与 channel（默认 html + wechat）
3. webhook / cp 确认已配置渠道编码并填入 option；mail 的 option 可选
4. template=form 时确认有 pushId（表单编码）
5. 向用户展示标题与内容摘要，获得确认后再发送
6. POST 请求；检查 code 是否为 200
7. 成功则反馈流水号（请求已受理）；失败根据 msg 说明
8. 需确认送达 / 管理群组好友渠道 / 绑定 ClawBot → 阅读 reference.md

模板选择策略

示例

最简 POST

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"标题","content":"消息内容"}'

Markdown

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"标题","content":"# 大标题\n##### 小标题\n1. 第一项\n2. 第二项","template":"markdown"}'

ClawBot

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"提醒","content":"任务已完成","template":"txt","channel":"clawbot"}'

Webhook / 企业微信应用

# webhook（option 为已配置的编码，如企业微信机器人）
curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"标题","content":"消息内容","channel":"webhook","option":"pushplus"}'

# 企业微信应用
curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"标题","content":"消息内容","channel":"cp","option":"cp"}'

群组 / 好友

# 一对多（topic）
curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"标题","content":"消息内容","topic":"code","template":"html"}'

# 好友（to）；勿与 topic 同时填
curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"标题","content":"消息内容","to":"好友令牌","template":"html"}'

邮件 / 短信

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"邮件标题","content":"邮件正文","channel":"mail","option":"163","template":"html"}'

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"短信","content":"消息内容正文","channel":"sms"}'

push 表单

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"push表单demo","content":"push表单demo","template":"form","pushId":"YpRUxav9"}'

时间戳防过期

curl -s -X POST "https://www.pushplus.plus/send" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"标题","content":"消息内容","timestamp":1632993318000}'

多渠道 batchSend

curl -s -X POST "https://www.pushplus.plus/batchSend" \
  -H "Content-Type: application/json" \
  -d '{"token":"YOUR_TOKEN","title":"标题","content":"消息内容","topic":"code","template":"html","channel":"wechat,webhook,extension","option":",bark,"}'

注意事项

• content 中双引号转义为 \"，换行用 \n（markdown 亦然）
• GET 中文 content 需 UrlEncode；大段内容用 POST
• topic 与 to 不要同时填写
• 收费渠道（sms / voice）发送前告知会消耗积分
• token 脱敏展示（如 a1b2****ef90）

安全要求

• 发送前确认：展示标题与内容摘要，获得明确确认后再发送。
• 凭证保护：不在输出中展示完整 token / secretKey / accessKey。
• 最小读取：从 .env 只提取 PUSHPLUS_* 相关行。
• 敏感内容警示：含密码、密钥、PII 时警告将经第三方传输。
• 不要持久化凭证：仅在内存中构造请求。
• 破坏性开放接口：删消息/群组/好友、解绑等须先确认（见 reference.md）。

附加资源

• 开放接口：reference.md
• 消息接口文档
• 开放接口文档