feat: add telegram webhook registration
This commit is contained in:
1 parent
dd28f3c0cb
commit
9a1bc6b8dc
4 files changed
+185
-4
No files matched your search
@@ -0,0 +1,28 @@
|
||||
# Telegram Webhook 部署
|
||||
|
||||
## 环境变量
|
||||
|
||||
```bash
|
||||
export TELEGRAM_ENABLED=true
|
||||
export TELEGRAM_BOT_TOKEN='BotFather签发的Token'
|
||||
export TELEGRAM_AUDIT_CHAT_ID='审核群Chat ID'
|
||||
export TELEGRAM_WEBHOOK_URL='https://pay.example.com/api/telegram/webhook'
|
||||
export TELEGRAM_WEBHOOK_SECRET='使用字母数字下划线连字符组成的随机值'
|
||||
export TELEGRAM_ALLOWED_USER_IDS='123456789,987654321'
|
||||
```
|
||||
|
||||
`TELEGRAM_WEBHOOK_URL` 必须是公网可访问的 HTTPS 地址,并由反向代理转发到后端
|
||||
`POST /api/telegram/webhook`。不要把 Bot Token 或 Webhook Secret 写入仓库、日志或前端配置。
|
||||
|
||||
## 注册与检查
|
||||
|
||||
1. 使用管理员账号进入“Telegram 审核记录”页面。
|
||||
2. 点击“Webhook 设置”,页面会先查询 Telegram 当前状态。
|
||||
3. 点击“按配置重新注册”后,后端使用环境变量调用 Telegram `setWebhook`。
|
||||
4. 确认页面显示“已注册”,且“当前地址”和“配置地址”一致。
|
||||
|
||||
注册操作仅订阅 `callback_query`,并同时设置 `secret_token`。Telegram 回调时,系统会校验
|
||||
`X-Telegram-Bot-Api-Secret-Token` 请求头。所有 Telegram HTTP 调用的连接和读取超时均为 60 秒。
|
||||
|
||||
部署后应创建一条测试归集审核,确认消息可以发送、授权用户可以审核、未授权用户被拒绝,且
|
||||
`pending_update_count` 不持续增长。
|
||||
Reference in new issue
Block a user