BotTele

Kết nối bot Telegram

Mỗi cửa hàng trên BotTele Store cần một bot Telegram riêng để nhận đơn và giao hàng tự động. Bài này hướng dẫn bạn tạo bot, kết nối vào dashboard, và xử lý các sự cố thường gặp.

Tạo bot trong @BotFather

Mở Telegram và tìm kiếm @BotFather. Gửi lệnh /newbot, nhập tên hiển thị cho bot (vd. 'Shop Claude Pro'), sau đó nhập username kết thúc bằng '_bot' (vd. 'shopclaudepro_bot'). @BotFather sẽ trả về một token dạng '123456789:ABC...'.

Giữ token bí mật như mật khẩu. Ai có token là có thể điều khiển bot của bạn. BotTele Store lưu token dưới dạng mã hoá AES-256-GCM.
Chat @BotFather hiển thị token bot mới
Màn hình @BotFather trả về token sau khi tạo bot thành công.

Dán token vào Telegram Connector

Trong dashboard, chọn Telegram Connector ở thanh điều hướng bên trái. Dán token vừa copy từ @BotFather vào ô 'Bot Token', rồi bấm Kết nối.

Quá trình xác minh thường mất vài giây. Nếu thành công, trạng thái chuyển sang 'Bot đang hoạt động' và tên bot sẽ hiển thị ngay bên dưới.

Kiểm tra trạng thái bot

Trang Telegram Connector hiển thị một trong ba trạng thái: 'Bot đang hoạt động' (xanh lá), 'Chưa kết nối' (xám), hoặc 'Lỗi xác thực' (đỏ). Bạn nên kiểm tra lại trang này sau khi đổi token hoặc sau thời gian dài không dùng.

Nếu bot không phản hồi lệnh /start từ Telegram, hãy kiểm tra trạng thái ở đây trước khi tìm nguyên nhân khác.

Đổi hoặc tháo bot

Để đổi sang bot khác, vào Telegram Connector → bấm Tháo kết nối → dán token mới → Kết nối. Các đơn hàng đang chờ xử lý không bị ảnh hưởng, nhưng bot cũ sẽ ngừng nhận lệnh ngay lập tức.

Sau khi tháo, khách hàng nhắn vào bot cũ sẽ không nhận được phản hồi. Thông báo cho khách trước khi chuyển đổi nếu cửa hàng đang hoạt động.

Khắc phục sự cố thường gặp

  • Lỗi 'Unauthorized': Token sai hoặc đã bị thu hồi — tạo token mới trong @BotFather bằng lệnh /revoke.
  • Bot không nhận lệnh: Kiểm tra trạng thái Telegram Connector. Thử Tháo và Kết nối lại.
  • Bot phản hồi chậm: Có thể do Telegram đang bảo trì. Chờ vài phút rồi thử lại.
  • Token bị lộ: Thu hồi ngay trong @BotFather (/revoke), rồi tạo và cập nhật token mới trong vòng vài phút.