PushPlus 消息推送服务

功能概述

PushPlus（推送加）是一个集成了微信、短信、邮件、企业微信、钉钉、飞书等多种渠道的实时消息推送平台。

核心功能

• - 多渠道推送：支持微信公众号、邮件、短信、企业微信、钉钉、飞书、语音、App、插件等
• 多消息类型：支持文本、HTML、Markdown、JSON 等格式
• 一对多推送：支持群组消息，一次推送给多人
• 多渠道同时发送：支持一次请求同时发送到多个渠道
• 好友消息：支持向指定好友发送消息
• 模板消息：内置多种消息模板，如阿里云监控、Jenkins、支付通知等

使用时机

当用户需要以下功能时，使用此 Skill：

1. 1. 发送推送消息到微信、邮件、钉钉、飞书等渠道
2. 配置消息通知用于系统监控、定时任务通知
3. 查询推送结果或管理消息历史
4. 管理群组或消息 Token

环境变量配置

Token 获取地址：https://www.pushplus.plus/uc-dev.html

如果使用OpenAPI相关功能，需要配置安全IP地址、开放接口设置

快速开始

1. 发送消息

使用脚本发送简单消息：

bash
python3 scripts/pushplus.py -t YOUR_TOKEN -c 消息内容 --title 消息标题

或使用环境变量：

bash
export PUSHPLUSTOKEN=yourtoken
python3 scripts/pushplus.py -c 消息内容

2. 使用 Python 函数

python
from scripts.pushplus import sendmessage, sendwechatmessage, sendemail_message

发送微信消息

发送邮件

脚本使用说明

命令行参数

python3 scripts/pushplus.py [选项]

必填参数:
-t, --token PushPlus Token（也可通过环境变量 PUSHPLUS_TOKEN 设置）
-c, --content 消息内容

可选参数:
--title 消息标题
--topic 群组编码（一对多消息）
--template 消息模板 (html/txt/json/markdown/cloudMonitor/jenkins/route/pay)
--channel 推送渠道 (wechat/webhook/cp/mail/sms/extension/voice/app)
--channels 多渠道发送，逗号分隔，如 wechat,webhook,extension
--webhook Webhook 编码（已废弃，请使用 --option）
--option 渠道配置参数（原 webhook 参数，多个渠道用逗号分隔）
--options 多渠道配置参数，逗号分隔
--callback-url 回调地址
--timestamp 时间戳（毫秒）
--to 好友令牌，支持多人（逗号分隔）
--pre 预处理编码
-v, --verbose 显示详细信息

使用示例

1. 发送简单微信消息

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 这是一条测试消息

2. 发送带标题的消息

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 服务器 CPU 使用率达到 95% \
--title 系统告警

3. 发送 Markdown 格式消息

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c # 今日日报

数据统计

• - 新增用户: 100
• 活跃用户数: 1000 \

4. 发送邮件

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 这是一封测试邮件 \
--title 邮件标题 \
--channel mail

5. 发送一对多消息（群组消息）

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 这是一条群组消息 \
--title 群组通知 \
--topic GROUP_CODE

6. 发送钉钉消息

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 这是一条钉钉消息 \
--title 钉钉通知 \
--channel webhook \
--option DINGTALKWEBHOOKCODE

7. 多渠道同时发送

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 这是一条多渠道消息 \
--title 多渠道通知 \
--channels wechat,webhook,extension \
--options ,webhook_code,

8. 发送语音消息

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 这是一条语音消息 \
--title 语音通知 \
--channel voice

9. 发送 App 消息

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 这是一条 App 推送消息 \
--title App通知 \
--channel app

10. 调试模式

bash
python3 scripts/pushplus.py \
-t YOUR_TOKEN \
-c 测试消息 \
-v

Python API 函数说明

核心函数

send_message()

通用消息发送函数，支持所有参数。

python
def send_message(
token: str,
content: str,
title: Optional[str] = None,
topic: Optional[str] = None,
template: str = html,
channel: str = wechat,
webhook: Optional[str] = None, # 已废弃，请使用 option
option: Optional[str] = None,
callback_url: Optional[str] = None,
timestamp: Optional[int] = None,
to: Optional[str] = None,
pre: Optional[str] = None,
verbose: bool = False
) -> Dict[str, Any]

sendbatchmessage()

多渠道同时发送消息。

python
def sendbatchmessage(
token: str,
content: str,
channels: List[str],
title: Optional[str] = None,
topic: Optional[str] = None,
template: str = html,
options: Optional[List[str]] = None,
callback_url: Optional[str] = None,
timestamp: Optional[int] = None,
to: Optional[str] = None,
pre: Optional[str] = None,
verbose: bool = False
) -> Dict[str, Any]

便捷函数

微信消息

python
sendwechatmessage(
token: str,
content: str,
title: str = 通知,
topic: str = None
) -> Dict[str, Any]

邮件消息

python
sendemailmessage(
token: str,
content: str,
title: str,
topic: str = None
) -> Dict[str, Any]

Markdown 消息

python
sendmarkdownmessage(
token: str,
content: str,
title: str = 通知,
topic: str = None
) -> Dict[str, Any]

JSON 消息

python
sendjsonmessage(
token: str,
data: dict,
title: str = JSON通知,
topic: str = None
) -> Dict[str, Any]

钉钉/飞书/企业微信消息

python
senddingtalkmessage(
token: str,
content: str,
title: str = 通知,
webhook: str = None
) -> Dict[str, Any]

sendfeishumessage(
token: str,
content: str,
title: str = 通知,
webhook: str = None
) -> Dict[str, Any]

sendworkwechat_message(
token: str,