Telegram 與管理者警示
管理後台位置： System › Settings › Admin alerts (
/settings/alerts)。支援捷徑：Customers › Support › Tickets (/support/tickets)，Settings 頁籤。
功能
當需要注意某些事項，以及當客戶註冊或存入款項時，NexCMP 會通知您（運營商）。警報會發送到一個或多個管道：Telegram、webhook 或電子郵件。
發送至管理者管道的事件包含：部署失敗、虛擬機器遺失、網路中斷、可用 IP 低於 30 個、即將到期的項目（1 小時警告）、Stripe 爭議、背景執行緒停止回應、叢集 RAM 超過閾值、新客戶註冊以及儲值入帳。客戶事件會持久化排入佇列，並以遞增延遲（30 秒至 1 小時）持續重試，直到 Telegram 接受為止。
需求
| 項目 | 需求 |
|---|---|
| Telegram | 透過 @BotFather 建立的機器人（Token）以及應接收訊息的群組或使用者 chat ID |
| 網路 | 連線至 api.telegram.org 的對外 HTTPS |
| Webhook（替代方案） | 可接收警示負載的 HTTPS 端點 |
準備 Telegram
- 在 Telegram 中開啟 @BotFather，發送
/newbot，選擇一個名稱；複製 bot token (123456789:AA...)。 - 建立一個群組，將機器人加入其中，並發送任意訊息。
- 尋找 chat ID：在瀏覽器中開啟
https://api.telegram.org/bot<token>/getUpdates並讀取chat.id（群組 ID 以-開頭）。
在 NexCMP 中連線
- 開啟 System › Settings › Admin alerts。
- 在 Add channel 中選擇 Type: Telegram，將 Destination 設為 chat ID，並將 Secret (bot token) 設為 token。點擊 Add。
- 確保開關 Send admin Telegram (VM module) 為開啟狀態；VM module status (read-only) 欄位顯示「on」。
驗證
該頻道會顯示在 Configured channels 下方。觸發一個事件（例如註冊測試客戶），訊息就會送達群組。若未設定頻道，頁面會警告「Without a channel, attacks will go unnoticed」，且在日誌中 Telegram 事件只會記錄在本機。
客戶支援捷徑
客戶支援小工具可顯示 Telegram 與 Zalo 按鈕。在支援設定中設定前它們會保持隱藏：輸入 Telegram 的 https://t.me/... 連結以及 Zalo 連結或 QR 碼。僅接受 https:// 連結。支援聊天也可以將問題與草稿回覆通知至您的 Telegram 群組——請參見 AI Chat。
限制與注意事項
- bot token 會隨頻道儲存，且不會再次顯示。
- Telegram 事件會使用第一個同時具有 destination 與 token 且已啟用的 Telegram 頻道。
故障排除
| 症狀 | 原因 | 修正方式 |
|---|---|---|
| 沒有收到訊息 | chat ID 錯誤、機器人不在群組中，或者從未向機器人發送訊息 | 透過 getUpdates 重新檢查 ID；請先向機器人或群組發送訊息。 |
| 運作一段時間後停止 | Token 已在 BotFather 中被撤銷 | 建立新的 token 並更新頻道。 |
日誌中出現 Telegram: no channel | 沒有啟用的 Telegram 頻道 | 如上所述新增一個。 |