---
title: Telegram 與管理者警示
description: 將營運警示、客戶註冊與儲值事件傳送至 Telegram 群組、Webhook 或電子郵件，並設定顯示給客戶的支援捷徑。
url: https://nexcmp.com/zh-tw/docs/administration/telegram-notifications/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Telegram 與管理者警示 {#telegram-and-admin-alerts}

> **管理後台位置：** System › Settings › Admin alerts (`/settings/alerts`)。支援捷徑：Customers › Support › Tickets (`/support/tickets`)，**Settings** 頁籤。

## 功能 {#what-it-does}

當需要注意某些事項，以及當客戶註冊或存入款項時，NexCMP 會通知**您**（運營商）。警報會發送到一個或多個**管道**：Telegram、webhook 或電子郵件。

發送至管理者管道的事件包含：部署失敗、虛擬機器遺失、網路中斷、可用 IP 低於 30 個、即將到期的項目（1 小時警告）、Stripe 爭議、背景執行緒停止回應、叢集 RAM 超過閾值、新客戶註冊以及儲值入帳。客戶事件會持久化排入佇列，並以遞增延遲（30 秒至 1 小時）持續重試，直到 Telegram 接受為止。

## 需求 {#requirements}

| 項目 | 需求 |
|---|---|
| Telegram | 透過 **@BotFather** 建立的機器人（Token）以及應接收訊息的群組或使用者 **chat ID** |
| 網路 | 連線至 `api.telegram.org` 的對外 HTTPS |
| Webhook（替代方案） | 可接收警示負載的 HTTPS 端點 |

## 準備 Telegram {#prepare-telegram}

1. 在 Telegram 中開啟 **@BotFather**，發送 `/newbot`，選擇一個名稱；複製 **bot token** (`123456789:AA...`)。
2. 建立一個群組，將機器人加入其中，並發送任意訊息。
3. 尋找 **chat ID**：在瀏覽器中開啟 `https://api.telegram.org/bot<token>/getUpdates` 並讀取 `chat.id`（群組 ID 以 `-` 開頭）。

## 在 NexCMP 中連線 {#connect-in-nexcmp}

1. 開啟 **System › Settings › Admin alerts**。
2. 在 **Add channel** 中選擇 **Type: Telegram**，將 **Destination** 設為 chat ID，並將 **Secret (bot token)** 設為 token。點擊 **Add**。
3. 確保開關 **Send admin Telegram (VM module)** 為開啟狀態；*VM module status (read-only)* 欄位顯示「on」。

![顯示「Add channel」表單設為 Telegram 的 Admin alerts 頁面](https://nexcmp.com/zh-tw/docs/images/administration/telegram-notifications-01-channel.webp)

## 驗證 {#verify}

該頻道會顯示在 **Configured channels** 下方。觸發一個事件（例如註冊測試客戶），訊息就會送達群組。若未設定頻道，頁面會警告「Without a channel, attacks will go unnoticed」，且在日誌中 Telegram 事件只會記錄在本機。

## 客戶支援捷徑 {#support-shortcuts-for-customers}

客戶支援小工具可顯示 **Telegram** 與 **Zalo** 按鈕。在支援設定中設定前它們會保持隱藏：輸入 Telegram 的 `https://t.me/...` 連結以及 Zalo 連結或 QR 碼。僅接受 `https://` 連結。支援聊天也可以將問題與草稿回覆通知至您的 Telegram 群組——請參見 [AI Chat](https://nexcmp.com/zh-tw/docs/ai/ai-chat/)。

## 限制與注意事項 {#limits-and-notes}

- bot token 會隨頻道儲存，且不會再次顯示。
- Telegram 事件會使用第一個同時具有 destination 與 token 且已啟用的 Telegram 頻道。

## 故障排除 {#troubleshooting}

| 症狀 | 原因 | 修正方式 |
|---|---|---|
| 沒有收到訊息 | chat ID 錯誤、機器人不在群組中，或者從未向機器人發送訊息 | 透過 `getUpdates` 重新檢查 ID；請先向機器人或群組發送訊息。 |
| 運作一段時間後停止 | Token 已在 BotFather 中被撤銷 | 建立新的 token 並更新頻道。 |
| 日誌中出現 `Telegram: no channel` | 沒有啟用的 Telegram 頻道 | 如上所述新增一個。 |