---
title: Telegram và cảnh báo quản trị
description: Gửi cảnh báo vận hành, sự kiện nạp tiền và đăng ký qua Telegram, webhook hoặc email, đồng thời thiết lập shortcut hỗ trợ hiển thị cho khách.
url: https://nexcmp.com/vi/docs/administration/telegram-notifications/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Telegram và cảnh báo quản trị {#telegram-and-admin-alerts}

> **Vị trí trong admin:** System › Settings › Admin alerts (`/settings/alerts`). Phím tắt hỗ trợ: Customers › Support › Tickets (`/support/tickets`), tab **Settings**.

## Chức năng {#what-it-does}

NexCMP thông báo cho **bạn** — đơn vị vận hành — khi có vấn đề cần chú ý, cũng như khi khách hàng đăng ký hoặc nạp tiền thành công. Cảnh báo được gửi tới một hoặc nhiều **kênh**: Telegram, webhook hoặc e-mail.

Các sự kiện gửi đến kênh quản trị viên bao gồm: triển khai thất bại, mất VM, mạng ngừng hoạt động, IP trống dưới 30, dịch vụ sắp hết hạn (cảnh báo trước 1 giờ), tranh chấp Stripe, worker dừng hoạt động, RAM cụm vượt ngưỡng, khách hàng mới đăng ký và tiền nạp đã ghi nhận. Sự kiện khách hàng được lưu hàng đợi bền vững và thử lại với độ trễ tăng dần (từ 30 giây đến tối đa 1 giờ) cho đến khi Telegram chấp nhận.

## Yêu cầu {#requirements}

| Hạng mục | Yêu cầu |
|---|---|
| Telegram | Bot được tạo bằng **@BotFather** (token) và **chat ID** của nhóm hoặc người dùng cần nhận tin nhắn |
| Mạng | HTTPS chiều đi tới `api.telegram.org` |
| Webhook (thay thế) | Một endpoint HTTPS tiếp nhận payload cảnh báo |

## Chuẩn bị Telegram {#prepare-telegram}

1. Trên Telegram, mở **@BotFather**, gửi `/newbot`, chọn một tên; sao chép **bot token** (`123456789:AA...`).
2. Tạo một nhóm, thêm bot vào nhóm và gửi một tin nhắn bất kỳ.
3. Tìm **chat ID**: mở `https://api.telegram.org/bot<token>/getUpdates` trong trình duyệt và xem `chat.id` (ID nhóm bắt đầu bằng `-`).

## Kết nối trong NexCMP {#connect-in-nexcmp}

1. Mở **System › Settings › Admin alerts**.
2. Trong **Add channel**, chọn **Type: Telegram**, đặt **Destination** thành chat ID và **Secret (bot token)** thành token đó. Nhấp vào **Add**.
3. Đảm bảo nút chuyển **Send admin Telegram (VM module)** đang bật; dòng *VM module status (read-only)* hiển thị "on".

![Trang Admin alerts với biểu mẫu Add channel được đặt thành Telegram](https://nexcmp.com/vi/docs/images/administration/telegram-notifications-01-channel.webp)

## Kiểm tra {#verify}

Kênh sẽ xuất hiện dưới mục **Configured channels**. Hãy kích hoạt một sự kiện (ví dụ đăng ký khách hàng thử nghiệm) và tin nhắn sẽ được gửi đến nhóm. Nếu chưa cấu hình kênh nào, trang sẽ cảnh báo "Without a channel, attacks will go unnoticed" và trong log, các sự kiện Telegram sẽ chỉ được ghi lại cục bộ.

## Lối tắt hỗ trợ cho khách hàng {#support-shortcuts-for-customers}

Widget hỗ trợ khách hàng có thể hiển thị các nút **Telegram** và **Zalo**. Các nút này sẽ ẩn cho đến khi được cấu hình trong cài đặt hỗ trợ: nhập liên kết `https://t.me/...` cho Telegram và liên kết Zalo hoặc mã QR. Chỉ chấp nhận liên kết `https://`. Khung chat hỗ trợ cũng có thể thông báo cho nhóm Telegram của bạn câu hỏi kèm câu trả lời bản nháp — xem [AI Chat](https://nexcmp.com/vi/docs/ai/ai-chat/).

## Giới hạn và lưu ý {#limits-and-notes}

- Bot token được lưu cùng với kênh và sẽ không bao giờ hiển thị lại.
- Các sự kiện Telegram sử dụng kênh Telegram đang bật đầu tiên có đủ destination và token.

## Xử lý sự cố {#troubleshooting}

| Hiện tượng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Không nhận được tin nhắn | Sai chat ID, bot chưa vào nhóm hoặc chưa từng gửi tin nhắn cho bot | Kiểm tra lại ID bằng `getUpdates`; gửi tin nhắn cho bot hoặc nhóm trước. |
| Hoạt động một thời gian rồi ngừng | Token đã bị thu hồi trong BotFather | Tạo token mới và cập nhật lại kênh. |
| `Telegram: no channel` trong log | Chưa có kênh Telegram nào được bật | Thêm một kênh như hướng dẫn ở trên. |