TG Notify - Telegram 通知 + 电话告警 + 命令下发

通用 Telegram 通知服务，支持多级告警和命令下发。当紧急告警未在指定时间内确认时，自动拨打电话。

功能

• 📨 Telegram 通知 - 通过 HTTP API 发送 TG 消息
• 🔴 多级优先级 - normal / high / critical
• 📞 电话告警 - Critical 告警未确认自动打电话（Twilio）
• 📥 命令下发 - 在 TG 发送命令控制脚本
• 🔌 易于集成 - import 即可使用的客户端 SDK

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置

cp .env.example .env
# 编辑 .env 填写你的配置

必填项：

• TG_BOT_TOKEN - Telegram Bot Token
• TG_CHAT_ID - 你的 Chat ID
• NOTIFY_API_KEY - API 密钥（自定义）

电话告警（可选）：

• TWILIO_SID / TWILIO_TOKEN - Twilio 凭证
• TWILIO_FROM - Twilio 号码
• PHONE_TO - 接收电话的号码

3. 启动服务

python server.py

发送通知

from notify_client import notify, notify_critical, call_now

# 普通通知
notify("标题", "内容", channel="price")

# 高优先级（TG 消息加红点）
notify("大额转账", "100 ETH 转出", channel="wallet", priority="high")

# 紧急告警（5分钟未确认自动打电话）
notify_critical("清算警告", "仓位即将被清算！")

# 直接打电话
call_now("服务器崩溃")

Channel 类型

Channel	Emoji	用途
price	💰	价格相关
wallet	👛	钱包/转账
trade	📈	交易相关
alert	🚨	通用告警
system	⚙️	系统通知
info	ℹ️	一般信息

接收命令

在 Telegram 发送 /target action [args] 格式的命令，脚本轮询接收。

from command_listener import CommandListener

cmd = CommandListener(target="mybot")

@cmd.on("status")
def handle_status(args):
    notify("MyBot", "运行正常")

@cmd.on("set")
def handle_set(args):
    notify("MyBot", f"设置为: {args[0]}")

cmd.start()  # 启动后台轮询

TG 命令示例：

• /mybot status → 触发 handle_status
• /mybot set 100 → 触发 handle_set，args=["100"]
• /all ping → 广播给所有脚本

API

POST /notify

发送通知到 Telegram

curl -X POST http://localhost:8000/notify \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"title": "标题", "message": "内容", "priority": "normal"}'

GET /commands

拉取命令（脚本轮询调用）

curl "http://localhost:8000/commands?target=mybot&after=0"

POST /call

直接拨打电话

curl -X POST "http://localhost:8000/call?message=紧急" \
  -H "X-API-Key: your-key"

GET /health

健康检查（无需认证）

告警流程

监控脚本检测到异常
        ↓
发送 priority=critical 通知
        ↓
  TG 收到消息（带确认按钮）
        ↓
   ┌────┴────┐
   ↓         ↓
点击确认    未点击
   ↓         ↓
取消电话   5分钟后打电话

示例

查看 examples/ 目录获取更多使用示例。

详细集成指南请参考 INTEGRATION.md

License

MIT