--- title: "Kết nối một bot Telegram" description: "Tạo bot bằng @BotFather, dán token vào console, rồi kiểm tra webhook mà máy chủ tự đăng ký giúp bạn cho kênh Telegram vừa dựng." updated: "2026-08-28" audience: [administrator] source: "https://helpdesk-docs.svr1.feedapp.click/kenh/ket-noi-telegram" --- Telegram là kênh ngoài ít thao tác nhất: một token từ @BotFather là toàn bộ phần khai báo, phần webhook do máy chủ tự lo. ## Mục tiêu [#mục-tiêu] Một kênh Telegram nhận được tin khách nhắn cho bot, cùng một đường dẫn bạn gửi cho khách để họ mở cuộc trò chuyện. ## Trước khi bắt đầu [#trước-khi-bắt-đầu] * Một tài khoản được phép ghi trên kênh — chi tiết ở [Vai trò và quyền theo tính năng](/khai-niem/vai-tro-va-quyen). * Một tài khoản Telegram để nói chuyện với @BotFather, là dịch vụ của bên thứ ba. * Địa chỉ công khai của máy chủ phải là địa chỉ Telegram gọi tới được. Đây là việc của người triển khai, xem callout dưới. > **Cảnh báo:** Telegram chỉ nhận HTTPS ở cổng 443, 80, 88 hoặc 8443, và không đăng ký được > một địa chỉ localhost. Địa chỉ đó nằm ở biến môi trường `API_PUBLIC_URL`, > thuộc phần vận hành và mô tả trong tệp `README.md` của bản cài đặt. Trên máy > phát triển hãy dùng một tunnel công khai. ## Các bước [#các-bước] 1. Mở ứng dụng Telegram, nhắn cho **@BotFather** và gửi lệnh `/newbot`. 2. Đặt tên hiển thị và username cho bot. BotFather trả lại một token dạng `123456789:AAE...`; giữ nó kín như một mật khẩu. 3. Về console, ở cột trái bấm **Kênh**, bấm **Thêm Kênh**, rồi chọn ô **Telegram**. 4. Điền **Tên kênh** và dán token vào ô **Bot token**. ![Bước Hồ sơ cốt lõi của kênh Telegram với ô Tên kênh, ô Bot token đang trống kèm gợi ý định dạng, và hai dòng ghi chú về @BotFather và webhook tự đăng ký](https://helpdesk-docs.svr1.feedapp.click/images/docs/kenh/ket-noi-telegram/04-dan-bot-token.vi.webp) *Bước hai của kênh Telegram chỉ hỏi tên kênh và bot token.* 5. Bật **Bật lời chào kênh** nếu muốn bot tự chào khách, rồi bấm **Tạo tiện ích**. 6. Màn **Thành công!** hiện khối **Chia sẻ cho khách hàng** kèm đường dẫn `t.me` và mã QR. Giữ lại đường dẫn đó, vì Telegram không có mã nhúng nào. 7. Bấm **Đi đến Kênh**, mở kênh vừa tạo và chọn tab **Cấu hình Telegram**. 8. Ở mục **Webhook**, đọc thẻ trạng thái. **Đã đăng ký** nghĩa là Telegram đã nhận địa chỉ của máy chủ. 9. Mỗi khi địa chỉ công khai của máy chủ thay đổi, quay lại đây và bấm **Đăng ký lại webhook**. ## Kiểm chứng [#kiểm-chứng] Tab **Cấu hình Telegram** hiển thị **Tên bot** và **Bot ID** đúng như BotFather đã cấp, còn thẻ webhook đọc **Đã đăng ký** kèm thời điểm đăng ký. Mở đường dẫn `t.me` của bot trên một máy khác, bấm bắt đầu rồi gửi một câu. Câu đó phải hiện trong hàng đợi **Trò chuyện** trong vài giây, và câu trả lời từ console phải về tới Telegram. ## Sự cố thường gặp [#sự-cố-thường-gặp] | Hiện tượng | Nguyên nhân | Cách xử lý | | ------------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------- | | Tạo kênh thất bại ngay khi bấm | Token sai, có khoảng trắng thừa, hoặc đã bị thu hồi | Xin token mới từ @BotFather rồi dán lại | | Thẻ webhook là **Thất bại**, kèm câu của Telegram | Địa chỉ công khai không phải HTTPS ở cổng Telegram chấp nhận | Nhờ người triển khai sửa `API_PUBLIC_URL`, rồi bấm **Đăng ký lại webhook** | | Thẻ là **Chưa đăng ký** | Kênh đã tạo nhưng lần đăng ký đầu chưa chạy xong | Bấm **Đăng ký lại webhook** | | Khách nhắn mà không có gì về | Webhook vẫn trỏ địa chỉ cũ sau khi máy chủ đổi địa chỉ | Bấm **Đăng ký lại webhook** rồi thử lại | | Gửi hỏng: khách hàng đã chặn bot | Khách đã chặn từ phía Telegram | Không xử lý được từ console; liên hệ khách bằng kênh khác | | Gửi hỏng: bot không nhắn trước được | Telegram cấm bot mở cuộc trò chuyện | Gửi đường dẫn `t.me` để khách nhắn trước | | Không tìm thấy ô để đổi token | Token được mã hoá ở máy chủ và không gửi xuống trình duyệt | Nối lại bot bằng một kênh mới | ## Tiếp theo [#tiếp-theo] * [Theo dõi và khắc phục kênh mất kết nối](/kenh/suc-khoe-ket-noi) * [Kết nối hòm thư IMAP/SMTP](/kenh/ket-noi-email) * [Các kênh được hỗ trợ](/kenh)