Files
cwd/docs/api/admin/telegram-notify.md
anghunk e1568f60ff feat(telegram): 新增 Telegram 机器人通知与快捷审核功能
- 新增 Telegram 通知功能,支持通过机器人接收新评论通知
- 在 Telegram 消息中提供“批准”和“删除”按钮,支持快捷审核
- 新增后台 Telegram 设置页面,支持配置 Bot Token、Chat ID 和开关
- 新增 `/api/telegram/webhook` 端点处理按钮回调
- 更新邮件通知逻辑,统一使用评论设置中的 `adminEmail` 作为收件人
- 更新相关文档,包括功能说明和 API 文档
2026-01-30 17:49:47 +08:00

1.4 KiB
Raw Blame History

Telegram 通知设置

Telegram 通知设置接口用于获取和更新 Telegram 机器人的配置,包括 Bot Token、Chat ID 以及 Webhook 设置。

所有接口都需要在请求头中携带 Bearer Token。

Authorization: Bearer <token>

1.1 获取 Telegram 配置

GET /admin/settings/telegram

获取当前的 Telegram 通知配置。

  • 方法:GET
  • 路径:/admin/settings/telegram
  • 鉴权需要Bearer Token

成功响应

  • 状态码:200
{
	"botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
	"chatId": "123456789",
	"notifyEnabled": true
}

1.2 更新 Telegram 配置

PUT /admin/settings/telegram

更新 Telegram 通知配置。

  • 方法:PUT
  • 路径:/admin/settings/telegram
  • 鉴权需要Bearer Token

请求体

{
	"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
{
	"message": "Webhook 设置成功",
	"webhookUrl": "https://your-domain.com/api/telegram/webhook"
}