Cấu hình thông báo Telegram
Thiết lập bot Telegram báo tin nhắn mới, hội thoại, phân công và sự cố kênh cho quản trị viên; chọn nơi nhận, sửa mẫu tin và kiểm tra gửi thử.
1. Mở cấu hình thông báo#
Thông báo Telegram giúp quản trị viên nhận cảnh báo trên điện thoại khi rời ChatHub. Bot gửi thông báo được cấu hình độc lập với kênh Telegram dùng để trò chuyện với khách trong Hộp thư. Bạn không cần thêm bot thông báo vào danh sách Kênh.
- 1
Đăng nhập ChatHub bằng tài khoản có quyền xem và quản lý cài đặt hệ thống.
- 2
Mở Quản trị ở thanh trên cùng → Cài đặt → Thông báo Telegram ở cột trái. Đường dẫn trực tiếp là /settings?tab=notifications trên tên miền ChatHub của bạn.
- 3
Chuẩn bị một bot Telegram riêng, token của bot và Chat ID của cá nhân hoặc nhóm quản trị sẽ nhận thông báo.
2. Chuẩn bị bot gửi thông báo#
- 1
Mở @BotFather theo liên kết bên dưới, kiểm tra đúng tên và dấu xác minh. Bấm START BOT để mở trong Telegram.
- 2
Trong Telegram, gửi /newbot cho BotFather rồi làm theo yêu cầu đặt tên và username cho bot mới.
- 3
Sao chép token BotFather cấp để nhập vào ChatHub. Không dùng API ID/API Hash của Telegram cá nhân hay mật khẩu tài khoản Telegram.
- 4
Mở cuộc trò chuyện với bot vừa tạo và bấm Start hoặc gửi /start. Nếu nhận vào nhóm quản trị, thêm chính bot này vào nhóm và bảo đảm bot được gửi tin.
Telegram: hướng dẫn tạo bot với BotFather ↗
3. Xác định Chat ID nhận thông báo#
- 1
Nhận cá nhân: mở @userinfobot theo gợi ý trong ChatHub, bấm Start trong Telegram và lấy ID tài khoản của bạn từ phản hồi. Đây là bot bên thứ ba; không gửi token bot hoặc nội dung khách hàng cho nó.
- 2
Dùng ID đó làm nơi nhận, đồng thời bảo đảm bạn đã nhắn /start cho bot thông báo vừa tạo. Chỉ mở userinfobot chưa đủ để bot thông báo nhắn được cho bạn.
- 3
Nhận theo nhóm: lấy đúng Chat ID của nhóm từ quản trị viên nhóm; ID nhóm có dấu trừ ở đầu. Không dùng ID cá nhân hoặc tên hiển thị của nhóm thay thế.
- 4
Nếu quản trị viên cần tra ID nhóm bằng Bot API: sau khi thêm bot vào nhóm, gửi một lệnh dành cho bot trong nhóm, đọc message.chat.id trong bản cập nhật getUpdates bằng công cụ API nội bộ tin cậy. Không dán token vào website tra ID bên ngoài. getUpdates không dùng đồng thời với webhook đang hoạt động.
- 5
Nhận ở nhiều nơi: ngăn cách các Chat ID bằng dấu phẩy, ví dụ 123456789, -100123456789. Giữ nguyên dấu trừ của ID nhóm.
Mở userinfobot để xem ID cá nhân ↗
4. Điền token, nơi nhận chung và công tắc tổng#
- 1
Token bot: dán đầy đủ token do BotFather cấp. Nếu đã lưu token, ô Token bot (đã lưu) để trống sẽ giữ token hiện có; chỉ điền khi cần thay bot hoặc cập nhật token.
- 2
Chat ID nhận chung: nhập ít nhất một nơi nhận. Đây là nơi nhận mặc định của các loại thông báo chưa đặt Chat ID riêng, đồng thời là nơi nhận tin gửi thử.
- 3
Bật thông báo Telegram khi muốn nhận cảnh báo tự động. Khi bật và lưu, bắt buộc có token bot và Chat ID nhận chung, kể cả khi đã đặt nơi nhận riêng cho từng loại.
- 4
Nếu muốn kiểm tra kết nối trước, bạn có thể giữ công tắc tổng tắt, lưu token cùng Chat ID nhận chung rồi dùng Gửi thử. Sau khi thử xong, bật công tắc và Lưu để bắt đầu nhận tự động.
Token được mã hóa trên máy chủ và không hiển thị lại sau khi lưu. Nhãn Đã cấu hình chỉ cho biết đã lưu token, không chứng minh bot gửi được tin. Muốn tạm dừng cảnh báo tự động, tắt Bật thông báo Telegram rồi Lưu; cấu hình vẫn được giữ.
5. Chọn sự kiện, nơi nhận riêng và mẫu tin#
Trong Từng loại thông báo, mỗi loại có công tắc riêng. Bật một loại sẽ hiện Chat ID riêng và Nội dung tin nhắn để tùy chỉnh. Tắt loại đó sẽ ẩn hai trường và dừng gửi loại đó sau khi lưu; công tắc tổng vẫn quyết định có gửi tự động hay không.
Tin nhắn mới: khi khách gửi tin vào kênh. Biến hỗ trợ: {contact} là tên khách, {channel} là tên kênh, {preview} là phần văn bản xem trước tối đa 200 ký tự; tin chỉ có tệp/ảnh có thể không có phần văn bản xem trước.
Hội thoại mới: khi khách bắt chuyện lần đầu hoặc mở lại hội thoại đã đóng. Biến hỗ trợ: {contact}, {channel}.
Phân công hội thoại: khi giao hội thoại cho nhân viên hoặc đội. Biến hỗ trợ: {contact}, {assignee}; {assignee} là tên người hoặc đội được giao. Gỡ phân công không gửi loại thông báo này.
- 1
Chọn các loại cần nhận. Ví dụ, nếu chỉ cần báo tin nhắn và tình trạng kênh, có thể tắt Hội thoại mới hoặc Phân công hội thoại để giảm số thông báo.
- 2
Để trống Chat ID riêng nếu dùng nơi nhận chung. Nếu điền, danh sách riêng thay thế nơi nhận chung cho loại đó, không tự gửi thêm tới danh sách chung. Có thể nhập nhiều ID, ngăn bằng dấu phẩy.
- 3
Sửa Nội dung tin nhắn dựa trên mẫu có sẵn. Ví dụ cho Tin nhắn mới: 💬 {contact} vừa nhắn qua {channel}, xuống dòng rồi thêm {preview}.
- 4
Giữ đúng tên biến và dấu ngoặc nhọn, chỉ dùng các biến được gợi ý dưới từng ô. Nội dung gửi dạng văn bản thường, không định dạng HTML/Markdown. Để trống nội dung rồi lưu nếu muốn dùng câu mặc định.
Kênh mất kết nối: báo khi kênh rớt nhiều lần liên tiếp và cần kiểm tra. Kênh kết nối lại: báo khi kênh từng bị báo hỏng kết nối trở lại. Cả hai loại chỉ hỗ trợ biến {channel}.
6. Lưu cấu hình và gửi thử#
- 1
Rà lại token, tất cả nơi nhận và các công tắc rồi bấm Lưu ở cuối biểu mẫu. Chờ thông báo “Đã lưu cấu hình thông báo Telegram.”
- 2
Trong Gửi tin thử, bấm Gửi thử. Nút này gửi một tin thật bằng token đã lưu tới các Chat ID nhận chung, kể cả khi công tắc tổng đang tắt.
- 3
Đọc kết quả và mở Telegram ở từng nơi nhận để kiểm tra. Khi thành công, ChatHub báo đã gửi tới số chat tương ứng; tin thử không dùng mẫu tin riêng của từng sự kiện.
- 4
Nếu đã đặt Chat ID riêng, kiểm tra thêm bằng một sự kiện thực tế phù hợp sau khi bật và lưu cấu hình. Thành công khi gửi thử tới nơi nhận chung chưa xác nhận các nơi nhận riêng đều hoạt động.
7. Xử lý lỗi và kiểm tra lại#
Không mở được Cài đặt hoặc không lưu/gửi thử được: kiểm tra tài khoản có quyền quản lý cài đặt hệ thống (settings.manage). Quyền này cần để mở trang Cài đặt, lưu cấu hình và gửi thử.
Token không hợp lệ hoặc thiếu cấu hình: nhập đầy đủ token từ BotFather và Chat ID nhận chung. Token có đúng định dạng vẫn có thể đã bị thu hồi; cần gửi thử để kiểm chứng.
Chat ID không hợp lệ: dùng ID số, giữ dấu trừ của nhóm và phân cách nhiều nơi nhận bằng dấu phẩy. Không nhập số điện thoại, tên hiển thị hoặc link t.me vào trường này.
Telegram từ chối: kiểm tra token còn hiệu lực, đã /start đúng bot thông báo, bot không bị chặn và vẫn ở trong nhóm với quyền gửi tin. Đọc chi tiết lỗi dưới kết quả gửi thử để xác định chat cần sửa.
Không gọi được tới Telegram: kiểm tra kết nối Internet, DNS và tường lửa của máy chủ chạy ChatHub tới api.telegram.org, rồi thử lại.
Gửi thử được nhưng không nhận cảnh báo tự động: kiểm tra đã bật và lưu công tắc tổng cùng công tắc của loại đó; xác nhận sự kiện mới thực sự xảy ra và Chat ID riêng không trỏ sang nơi khác. Thiếu phần xem trước với tin chỉ có tệp/ảnh có thể là bình thường.