feat(telegram): 新增 Telegram 机器人通知与快捷审核功能

- 新增 Telegram 通知功能,支持通过机器人接收新评论通知
- 在 Telegram 消息中提供“批准”和“删除”按钮,支持快捷审核
- 新增后台 Telegram 设置页面,支持配置 Bot Token、Chat ID 和开关
- 新增 `/api/telegram/webhook` 端点处理按钮回调
- 更新邮件通知逻辑,统一使用评论设置中的 `adminEmail` 作为收件人
- 更新相关文档,包括功能说明和 API 文档
This commit is contained in:
anghunk
2026-01-30 17:49:47 +08:00
parent c4954fca89
commit e1568f60ff
16 changed files with 678 additions and 85 deletions

View File

@@ -0,0 +1,78 @@
# Telegram 通知设置
Telegram 通知设置接口用于获取和更新 Telegram 机器人的配置,包括 Bot Token、Chat ID 以及 Webhook 设置。
所有接口都需要在请求头中携带 Bearer Token。
```http
Authorization: Bearer <token>
```
## 1.1 获取 Telegram 配置
```
GET /admin/settings/telegram
```
获取当前的 Telegram 通知配置。
- 方法:`GET`
- 路径:`/admin/settings/telegram`
- 鉴权需要Bearer Token
**成功响应**
- 状态码:`200`
```json
{
"botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
"chatId": "123456789",
"notifyEnabled": true
}
```
## 1.2 更新 Telegram 配置
```
PUT /admin/settings/telegram
```
更新 Telegram 通知配置。
- 方法:`PUT`
- 路径:`/admin/settings/telegram`
- 鉴权需要Bearer Token
**请求体**
```json
{
"botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
"chatId": "123456789",
"notifyEnabled": true
}
```
## 1.3 一键设置 Webhook
```
POST /admin/settings/telegram/setup
```
自动设置 Telegram Webhook URL。此接口会使用当前 Worker 的域名构建 Webhook URL 并调用 Telegram API。
- 方法:`POST`
- 路径:`/admin/settings/telegram/setup`
- 鉴权需要Bearer Token
**成功响应**
- 状态码:`200`
```json
{
"message": "Webhook 设置成功",
"webhookUrl": "https://your-domain.com/api/telegram/webhook"
}
```