Pushplus 多渠道消息推送

要解决什么问题

Agent 跑完任务、触发告警或生成日报后，往往还需要把结果送到人手里。自建微信企业号、邮件 SMTP、短信网关成本高，接口也不统一。Pushplus（推送加）把微信公众号、企业微信、邮件、钉钉/飞书 Webhook、短信、语音等渠道收敛到同一套 HTTP API；本技能把常用参数、渠道与返回码整理成 Agent 可直接调用的说明与客户端封装思路。

技能如何工作

使用前需在 pushplus.plus 注册并拿到 Token，关注「pushplus 推送加」公众号并完成实名认证（未实名会返回 905）。核心调用有两条路径：

• 单渠道：http://www.pushplus.plus/send（也支持 /send/{token}）
• 多渠道：http://www.pushplus.plus/batchSend，一次请求发到多个渠道

必填参数为 token 与 content；常用可选项包括 title、channel（默认 wechat）、template（html / txt / markdown / json 等）、topic（群组编码）、to（好友令牌）、option（Webhook/邮件/企业微信的渠道编码）、callbackUrl（异步结果回调）、timestamp（防过期重复推送）。

channel 覆盖微信、Webhook、企业微信应用、邮件、浏览器插件/App 等；短信与语音为积分计费。接口支持 GET/POST 等，Body 一般为 application/json。返回 code=200 只表示服务端已受理，是否送达需用流水号查询或依赖回调里的 sendStatus（0 未发送～3 失败）。

边界与注意点

• Token 安全：勿把 Token 写进公开仓库，建议用环境变量（如 PUSHPLUS_TOKEN）。
• 频率与封禁：免费版有次数上限；单日请求过多可能触发 900 账号受限，应立刻停调并做退避。
• 异步语义：重要通知建议配置 callbackUrl，不要仅凭 200 当作已送达。
• 渠道差异：topic 在 channel=webhook 时无效；向多人推送受实名/会员人数限制。
• 内容形态：短文本用 txt，报告类用 markdown，富文本用 html，结构化数据用 json，避免单条内容过长影响展示。