通知與機器人

概覽

milmil 可以透過 Telegram、Discord 同埋通用 Webhook 傳送推播通知並接受互動式機器人指令。兩項功能均喺 設定 > 通知 入面設定。

每個平台卡片有兩個獨立開關：

• 推播通知 — 下載、錯誤同埋系統事件嘅單向提醒
• 機器人指令 — 互動式指令，如 /schedule、/search、/downloads

你可以為每個平台啟用其中一個或者兩個。

Telegram 設定

1. 建立機器人

1. 開啟 Telegram 搜尋 @BotFather
2. 傳送 /newbot
3. 輸入顯示名稱（如 milmil）
4. 輸入以 bot 結尾嘅使用者名稱（如 milmil_media_bot）
5. BotFather 會回覆一個 Bot Token — 複製佢

2. 攞你嘅 Chat ID

1. 向你嘅新機器人傳送任意訊息
2. 喺瀏覽器入面開啟：https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
3. 搵到 "chat":{"id": 123456789} — 嗰個數字就係你嘅 Chat ID

3. 喺 milmil 入面設定

1. 前往 設定 > 通知 > Telegram
2. 貼上 Bot Token
3. 輸入 Chat ID
4. 啟用 推播通知 同/或者 機器人指令
5. 撳 儲存

Webhook 模式（選用）

預設情況下機器人用長輪詢（喺 NAT/防火牆後面都係得嘅）。如果你嘅伺服器有公開 URL，可以切換到 Webhook 模式以攞更低延遲：

1. 輸入 Webhook URL（如 https://your-domain.com/api/v1/bot/telegram/webhook）
2. 機器人會自動向 Telegram 註冊 Webhook

留空則用輪詢。

允許的 Chat ID

限制哪啲 Telegram 聊天可以向機器人傳送指令。輸入逗號分隔嘅 Chat ID。留空則只允許已設定嘅 Chat ID。

Discord 設定

推播通知（Webhook）

1. 喺你嘅 Discord 伺服器入面，前往 伺服器設定 > 整合 > Webhooks
2. 撳 新建 Webhook，命名（如 milmil），揀頻道
3. 撳 複製 Webhook URL
4. 喺 milmil 入面：設定 > 通知 > Discord，啟用 推播通知
5. 貼上 Webhook URL，儲存

機器人指令（斜線指令）

1. 前往 Discord 開發者入口網站
2. 撳 新建應用程式，命名為 milmil
3. 前往 Bot 分頁，撳 新增 Bot
4. 複製 Bot Token
5. 前往 OAuth2 > URL Generator，揀範圍：bot、applications.commands
6. 揀權限：Send Messages、Embed Links、Use Slash Commands
7. 複製產生嘅 URL 並開啟佢，將機器人邀請到你嘅伺服器
8. 喺 General Information 分頁複製 Application ID
9. 喺 milmil 入面：設定 > 通知 > Discord，啟用 機器人指令
10. 貼上 Bot Token 同埋 Application ID，儲存

允許的 Guild ID

限制哪啲 Discord 伺服器可以用機器人。輸入逗號分隔嘅伺服器 ID。留空則允許所有伺服器。

Webhook（通用）

用於自訂整合（Slack、ntfy、Gotify、Pushover 等）：

1. 喺設定入面啟用 Webhook
2. 輸入目標 URL
3. 可選設定 HMAC Secret 用於簽章驗證
4. 事件以 JSON POST 方式傳送，附帶 X-Signature-256 標頭

酬載格式

{
  "type": "download.completed",
  "title": "Download Complete",
  "message": "Frieren S2E03",
  "severity": "success",
  "metadata": {
    "anime_name": "Frieren",
    "episode": "03",
    "subgroup": "LoliHouse"
  }
}

事件路由

用平台卡片下方嘅事件路由矩陣設定哪啲事件傳送到哪啲平台。

機器人指令

啟用咗機器人指令之後，以下指令可以用：

指令支援內嵌按鈕，可以快速執行訂閱、暫停下載同埋睇詳情等操作。