Telegram和管理员警报
后台位置: System › Settings › Admin alerts(
/settings/alerts)。客服快捷方式:Customers › Support › Tickets(/support/tickets),标签页Settings。
功能说明
当需要关注某些事务,或有客户注册、充值到账时,NexCMP会通知你——运营商。警报会发送到一个或多个通道:Telegram、Webhook或电子邮箱。
发送至管理员通道的事件包括:部署失败、虚拟机丢失、网络中断、可用IP低于30个、即将到期的项目(1小时警告)、Stripe争议、工作进程挂掉、集群内存超过阈值、新客户注册以及充值到账。客户事件将被持久化排队,并以递增的延迟(30秒至1小时不等)进行重试,直到Telegram接受它们。
前提条件
| 项目 | 要求 |
|---|---|
| Telegram | 使用**@BotFather创建的机器人(Token)以及应接收消息的群组或用户的Chat ID** |
| 网络 | 出站HTTPS连接至api.telegram.org |
| 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 链接或二维码。仅接受 https:// 链接。支持聊天还可以向您的 Telegram 群组发送问题和草稿答复——参见 AI Chat。
限制与注意事项
- bot token 与通道一起存储,之后将不再显示。
- Telegram 事件使用同时具有目标和 token 的首个已启用的 Telegram 通道。
故障排查
| 症状 | 原因 | 解决办法 |
|---|---|---|
| 无消息到达 | 聊天 ID 错误、机器人不在群组中,或者从未向机器人发送过消息 | 使用 getUpdates 重新检查 ID;请先向机器人或群组发送一条消息。 |
| 正常工作一段时间后停止 | Token 在 BotFather 中被撤销 | 创建一个新 token 并更新通道。 |
日志中的 Telegram: no channel | 没有已启用的 Telegram 通道 | 按上述方法添加一个。 |