Tài liệu

Hướng dẫn

Tạo và quản lý bot

Tạo bot qua tài khoản Telegram sở hữu và quản lý hồ sơ, ảnh, lệnh cùng token của bot.

Xem Markdown

Bạn tạo và quản lý bot thuộc từng tài khoản Telegram. Mỗi tài khoản tự làm việc với @BotFather trong cuộc trò chuyện của chính nó; app không dùng một tài khoản chung để sở hữu bot cho cả đội.

Ai làm được

Chủ, Quản lý và CSKH có thể tạo bot, sửa hồ sơ và đổi ảnh theo quyền tài khoản. Chủ và Quản lý thêm bot có sẵn, lấy lại hoặc đổi token, xem token và xoá bot. Xem chỉ đọc danh sách.

Cần chuẩn bị

Tài khoản sở hữu phải đăng nhập xong. Máy chạy tài khoản cần trực tuyến cho các bước qua BotFather. Chuẩn bị tên hiển thị và username bot chưa bị người khác sử dụng.

Bắt đầu ở đâu

Mở Bot trên menu bên trái.

Danh sách bot theo tài khoản sở hữu
Bot của từng tài khoản

Các bước

Tạo bot hoặc nhận bot đã có

  1. Bấm Tạo bot.
  2. Chọn một hoặc nhiều Tài khoản tạo bot.
  3. Nhập Tên hiển thị.
  4. Nhập Tên bot (@username).
  5. Kiểm tra danh sách tên sẽ tạo.
  6. Xác nhận tạo.

Khi chọn nhiều tài khoản, mỗi tài khoản tạo một bot. Dùng {n} trong mẫu tên để phân biệt; nếu thiếu, app bổ sung hậu tố. Tên vẫn phải hợp lệ và chưa được sử dụng trên Telegram.

Biểu mẫu tạo bot với các tài khoản và mẫu tên
Tạo nhiều bot

Theo dõi kết quả riêng từng tài khoản. Một tài khoản lỗi không có nghĩa mọi bot đều chưa được tạo. Nếu bot đã tạo nhưng token chưa lưu, dùng Lấy lại token, không tạo bot mới chỉ để khắc phục phần lưu token.

Để nhận bot đã tạo trước đó:

  1. Chọn Thêm bot có sẵn.
  2. Chọn Tài khoản sở hữu bot.
  3. Nhập Tên bot.
  4. Bấm Thêm.

App hỏi BotFather bằng tài khoản sở hữu để lấy token; đây không phải ô dán token tuỳ ý.

Sửa hồ sơ và giữ token

  1. Mở menu Việc với bot.
  2. Chọn Sửa tên, mô tả, lệnh.
  3. Sửa tên, giới thiệu ngắn, mô tả khi mở chat hoặc menu lệnh.
  4. Bấm Lưu.
  5. Dùng Đổi ảnh khi cần thay ảnh bot.

Phần Bot API của app chỉ phục vụ hồ sơ, lệnh và ảnh. Không có cơ chế Bot API gửi tin, nhận cập nhật hay chạy hộp thư bot trong tính năng này.

  1. Chọn Xem token (một lần) khi đã có nơi cất an toàn.
  2. Chọn Xem một lần.
  3. Cất token rồi chọn Đã cất xong.
  1. Chỉ xác nhận đổi sau khi đã chuẩn bị cập nhật nơi sử dụng.
  1. Gõ đúng username theo yêu cầu rồi xác nhận xoá.

Kết quả

Bot thuộc tài khoản đã chọn; hồ sơ được cập nhật trên Telegram. Token được cất an toàn và chỉ tiết lộ một lần theo luồng xem token.

Kiểm tra

Kiểm tra đúng chủ sở hữu, username và kết quả từng bot. Mọi ảnh tài liệu có token phải che bằng khối đặc.

Khi có lỗi

Đọc kết quả BotFather và Nhật ký. Với bot đã tạo, ưu tiên lấy lại token thay vì tạo trùng.

Làm bằng API hoặc MCP

Dùng bots.create, bots.adopt, bots.update_profile và bots.revoke_token.

Tên tool: bots_create, bots_adopt, bots_update_profile, bots_revoke_token. Xem token là thao tác chỉ dành cho người dùng trên web, không phải tool công khai.