SignalLink — Webhook到Telegram的信号路由器

一个轻量级、开源的桥梁，用于接收webhook警报（例如来自TradingView的警报），并将其作为清晰、格式化的消息转发到Telegram机器人。无需付费服务，无需第三方订阅——只需部署和路由。

何时使用此技能

当用户想要以下操作时，使用SignalLink：

• - 将TradingView价格警报或策略信号转发到Telegram
• 将任何webhook事件（运行时间监控、CI/CD流水线、自定义警报）路由到Telegram
• 搭建自托管的交易信号通知系统
• 用免费、开源替代方案替换付费信号路由服务

设置

步骤1 — 获取Telegram机器人令牌

1. 1. 打开Telegram并给@BotFather发送消息
2. 发送/newbot并按照提示操作
3. 复制机器人令牌——格式类似123456789:ABCdef...

步骤2 — 获取您的聊天ID

1. 1. 在Telegram上给@userinfobot发送消息
2. 它会回复您的聊天ID

步骤3 — 配置环境

bash
cp .env.example .env

编辑.env文件：

env
TELEGRAMBOTTOKEN=在此处填写您的机器人令牌
TELEGRAMCHATID=在此处填写您的聊天ID
WEBHOOK_SECRET=在此处填写您的密钥 # 可选但推荐
PORT=8000

步骤4 — 运行

使用Docker（推荐）：

bash
docker compose up -d

使用Python：

bash
pip install -r requirements.txt
python -m App.main

服务器启动于http://localhost:8000

端点

使用说明

当用户要求将交易信号或webhook警报转发到Telegram时：

1. 1. 如果尚未设置，询问他们的TELEGRAMBOTTOKEN和TELEGRAMCHATID
2. 指导他们使用.env.example作为模板设置.env文件
3. 使用Docker或Python启动服务器
4. 将他们的webhook源（例如TradingView）指向http://<服务器IP>:8000/webhook
5. 可选地设置WEBHOOK_SECRET，并指示用户将其作为X-Webhook-Secret标头传递

TradingView集成

在TradingView中，将警报webhook URL设置为：

http://您的服务器IP:8000/webhook

将警报消息正文设置为JSON：

json
{
action: buy,
symbol: XAUUSD,
price: {{close}},
interval: {{interval}},
strategy: 我的策略,
sl: 2330.00,
tp: 2370.00,
lot: 0.1,
message: 信号已确认。
}

支持的有效载荷字段

测试

使用curl发送测试webhook：

bash
curl -X POST http://localhost:8000/webhook \
-H Content-Type: application/json \
-H X-Webhook-Secret: 在此处填写您的密钥 \
-d {
action: buy,
symbol: XAUUSD,
price: 2345.50,
interval: 1H,
sl: 2330.00,
tp: 2370.00
}

Telegram输出示例

🟢 买入信号

🥇 交易对： XAUUSD
💰 价格： 2345.50
⏱️ 时间框架： 1H
🧠 策略： EMA交叉

🛑 止损： 2330.00
🎯 止盈： 2370.00
📦 手数/数量： 0.1

📝 信号已确认。

─────────────────────
⚡ 由SignalLink提供支持

项目结构

SignalLink/
├── App/
│ ├── main.py # FastAPI入口点
│ ├── webhook.py # 请求处理与认证
│ ├── formatter.py # 有效载荷 → Telegram消息
│ ├── telegram.py # Telegram Bot API客户端
│ └── config.py # 环境配置
├── Examples/
│ ├── tradingview_payload.json
│ └── custom_payload.json
├── .env.example
├── requirements.txt
├── Dockerfile
└── docker-compose.yml

安全说明

• - 在生产环境中始终设置WEBHOOKSECRET以防止未经授权的请求
• 通过恒定时间比较验证密钥以防止时序攻击
• 切勿公开暴露您的TELEGRAMBOT_TOKEN