---
title: Telegram和管理员警报
description: 将操作警报、客户注册和充值事件发送到Telegram群组、Webhook或电子邮箱，并设置向客户展示的客服快捷方式。
url: https://nexcmp.com/zh-cn/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争议、工作进程挂掉、集群内存超过阈值、新客户注册以及充值到账。客户事件将被持久化排队，并以递增的延迟（30秒至1小时不等）进行重试，直到Telegram接受它们。

## 前提条件 {#requirements}

| 项目 | 要求 |
|---|---|
| Telegram | 使用**@BotFather**创建的机器人（Token）以及应接收消息的群组或用户的**Chat ID** |
| 网络 | 出站HTTPS连接至`api.telegram.org` |
| 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 的管理员警报页面](https://nexcmp.com/zh-cn/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 链接或二维码。仅接受 `https://` 链接。支持聊天还可以向您的 Telegram 群组发送问题和草稿答复——参见 [AI Chat](https://nexcmp.com/zh-cn/docs/ai/ai-chat/)。

## 限制与注意事项 {#limits-and-notes}

- bot token 与通道一起存储，之后将不再显示。
- Telegram 事件使用同时具有目标和 token 的首个已启用的 Telegram 通道。

## 故障排查 {#troubleshooting}

| 症状 | 原因 | 解决办法 |
|---|---|---|
| 无消息到达 | 聊天 ID 错误、机器人不在群组中，或者从未向机器人发送过消息 | 使用 `getUpdates` 重新检查 ID；请先向机器人或群组发送一条消息。 |
| 正常工作一段时间后停止 | Token 在 BotFather 中被撤销 | 创建一个新 token 并更新通道。 |
| 日志中的 `Telegram: no channel` | 没有已启用的 Telegram 通道 | 按上述方法添加一个。 |