Telegram và cảnh báo quản trị

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

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

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

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

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".

Kiểm tra

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

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.

Giới hạn và lưu ý

• 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ố

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.