Dự án và kênh
Tạo dự án, kết nối bot và theo dõi trạng thái. Nhiều kênh, đổi token, tạm dừng và khôi phục bot bị đóng băng.
Trên trang này
Dự án tập hợp cài đặt, phản ứng và dữ liệu của một bot hoặc dịch vụ. Kênh kết nối dự án với nơi khách hàng liên lạc: một bot Telegram, cửa sổ chat trên website hoặc ứng dụng nhắn tin khác. Ví dụ, một trường học có thể dùng một dự án với hai kênh: Telegram và website.
Tạo dự án trong Dự án, sau đó thêm kênh. Để kết nối Telegram, bạn cần token do @BotFather cấp – khóa dùng để quản lý bot. Bạn có thể chuyển giữa các dự án ở phía trên trang quản trị.
Bot không chỉ dùng được với Telegram. Bạn có thể kết nối WhatsApp và VK, rồi dùng chung các phản ứng cho các ứng dụng nhắn tin. Xem Kênh và hướng dẫn WhatsApp.
Kết nối bot
- Nếu chưa có dự án, mở Dự án và nhấn Thêm dự án. Trên thẻ dự án, nhấn Thêm kênh và chọn Telegram. Với bot đầu tiên, bạn cũng có thể dùng trình hướng dẫn ban đầu.
- Dán token từ @BotFather, rồi nhấn Kiểm tra. GetMyBot hiển thị
@usernameđược tìm thấy để bạn xác nhận token thuộc đúng bot. - Nhấn Kết nối. Token được mã hóa khi lưu và bot bắt đầu nhận cập nhật ngay.
Sau khi kết nối, Telegram xuất hiện trên thẻ dự án cùng các kênh khác. Thẻ này hiển thị tên dự án, @username của bot, số người dùng, số phản ứng đang hoạt động và số yêu cầu hôm nay. Số dư yêu cầu nằm ở Thanh toán hoặc Thống kê.
Nhiều bot
Một tài khoản có thể quản lý nhiều dự án và bot; số lượng tùy theo giới hạn “số bot tối đa” của gói dịch vụ. Chuyển dự án ở đầu trang hoặc trong Dự án. Các mục Phản ứng, Trò chuyện và Thống kê sẽ hiển thị dữ liệu của dự án đang chọn.
Bot nhận tin nhắn như thế nào?
Sau khi kết nối, GetMyBot tự nhận sự kiện từ Telegram: tin nhắn, lượt nhấn nút, thành viên tham gia cuộc trò chuyện và thanh toán. Bạn không cần cấu hình riêng việc nhận tin, chỉ cần token còn hiệu lực. Tùy cài đặt máy chủ, Telegram sẽ gửi sự kiện đến địa chỉ của nền tảng (webhook), hoặc nền tảng thường xuyên hỏi Telegram để lấy sự kiện (long polling).
Bật và tắt bot
Mỗi bot có trạng thái bật / tắt trong thẻ Trạng thái bot ở Cài đặt. Bot đã tắt không phản hồi tin nhắn. Thay đổi có hiệu lực ngay, không cần kết nối lại.
Trạng thái dự án và tình trạng kênh
Trong Dự án, dự án có trạng thái riêng: Đang hoạt động, Tạm dừng hoặc Đóng băng. Đây không phải phép kiểm tra việc Telegram đã giao tin hay chưa. Mỗi kênh có nhãn riêng: Trực tuyến, Không có tín hiệu, Đã cấu hình, Đã tắt hoặc Dự án không hoạt động. Vì vậy, dự án đang hoạt động với chat trên web nhưng không có Telegram vẫn không bị coi là đã dừng.
Nếu dự án đang hoạt động có đúng một kênh Telegram đã bật, nhãn Trực tuyến cho biết tiến trình phục vụ bot vừa ghi nhận tín hiệu. Nếu không có tín hiệu mới, nhãn là Không có tín hiệu. Khi có nhiều kênh Telegram đã bật, nhãn là Đã cấu hình, vì tín hiệu chung của dự án không thể quy chắc cho từng kênh. Với kênh khác Telegram, Đã cấu hình nghĩa là kênh đã kết nối, không phải cam kết mọi tin nhắn đều đã được giao.
Nếu bạn đã cấp token mới trong @BotFather (Bot Settings → Revoke / New token), hãy cập nhật nó trong Cài đặt → Kênh → Telegram 🔑. Token mới phải thuộc về cùng một bot (khớp theo ID nội bộ Telegram) — nhờ đó tất cả phản ứng, người đăng ký và dữ liệu được bảo toàn. Nếu kênh Telegram không hiển thị, hãy chọn «Thay token» trong cùng cửa sổ.
Trong thực tế:
- Nhãn có độ trễ. Sau khi kết nối hoặc khởi động lại nền tảng, nhãn “Trực tuyến” có thể xuất hiện trong khoảng thời gian nêu trên, không nhất thiết ngay lập tức.
- Nếu “Không có tín hiệu” kéo dài hơn vài phút trong khi kênh Telegram đã bật, hãy kiểm tra token và thẻ Tình trạng bot ở Cài đặt. Dự án vẫn đang hoạt động cho đến khi bạn tạm dừng hoặc nền tảng đóng băng vì gói dịch vụ.
- Dấu hiệu này dùng chung giữa các tiến trình, không phụ thuộc máy chủ nào trả lời yêu cầu của bạn. Với nhiều kênh Telegram, nó không chứng minh từng kênh đều sẵn sàng.
Khi bot ngoại tuyến
Mỗi phút, nền tảng kiểm tra lại các dấu hiệu hoạt động. Nếu một bot đã bật không có dấu hiệu nào còn mới, nền tảng mở một sự cố, xác định nguyên nhân một lần rồi tự thử đưa bot hoạt động trở lại.
Có bốn nguyên nhân, đều được hiển thị trong thẻ Tình trạng bot ở Cài đặt:
- Webhook: Telegram không giao cập nhật đến địa chỉ của nền tảng; nền tảng đăng ký lại địa chỉ đó.
- Token đã bị thu hồi:
getMetrả về 401. Nền tảng không thể khắc phục bằng khởi động lại. Hãy tạo token mới trong @BotFather và nhập tại Đổi token. - Không có máy chủ phục vụ bot: không có tiến trình nào xử lý cập nhật, nên nền tảng khởi động lại bot.
- Chưa xác định được nguyên nhân: Telegram không trả lời phép kiểm tra.
Việc khởi động lại làm đúng những gì nút Đồng bộ hóa làm: kiểm tra token qua getMe và đăng ký lại webhook. Các lần thử cách nhau ngày càng lâu. Mỗi lần thử đều có trong nhật ký khởi động lại của sự cố, với thời gian, kết quả và thông báo lỗi nếu thất bại. Thẻ cũng cho biết lúc thử tiếp theo.
Nếu bot im lặng quá ngưỡng trong thẻ Tình trạng bot (mặc định 5 phút), chủ sở hữu nhận thông báo “Bot ngoại tuyến” trong chuông thông báo và qua email. Các cuộc trò chuyện được chọn nhận thông báo sẽ có tin nhắn từ chính bot. Mỗi sự cố chỉ có một thông báo ngoại tuyến. Khi dấu hiệu hoạt động trở lại, có thông báo “Bot đã trực tuyến trở lại” cùng thời gian gián đoạn. Lịch sử sự cố, thời lượng và nguyên nhân vẫn nằm trong cùng thẻ.
Đóng băng do gói dịch vụ
Ngoài trạng thái bật / tắt, bot có thể bị đóng băng. Đây là việc nền tảng tự thực hiện khi gói hiện tại không còn đủ chỗ cho số bot đã kết nối, không phải nút người dùng tự bật. Có đúng hai nguyên nhân:
- Vượt giới hạn bot: bạn chuyển sang gói cho phép ít bot hơn số đang kết nối.
- Gói trả phí không được gia hạn: gói trả phí hết hạn, gói miễn phí với giới hạn của nó có hiệu lực.
Bot bị đóng băng không nhận tin nhắn; việc nhận cập nhật thực sự bị tắt. Dữ liệu, phản ứng và người đăng ký vẫn được giữ nguyên, nên có thể khôi phục.
Cách khôi phục: thanh toán gói cho phép đủ số bot. Ngay khi gói trả phí có hiệu lực, bot tự hoạt động lại theo thứ tự cũ nhất trước, cho đến khi dùng hết giới hạn. Bạn không thể chọn bot nào được khôi phục trước. Nếu cần một thứ tự khác, hãy xóa những kết nối thừa trước khi thanh toán.
Việc đóng băng toàn bộ tài khoản là trạng thái khác: mọi bot và lượt gửi hàng loạt đều tạm dừng, còn trang quản trị hiển thị biểu ngữ “Tài khoản bị đóng băng”. Chỉ bộ phận hỗ trợ mới gỡ được. Xem Thanh toán và số dư.
Hồ sơ và đồng bộ hóa
Nút Đồng bộ hóa trong Cài đặt lấy lại tên bot từ Telegram, chẳng hạn sau khi bạn đổi tên trong @BotFather. Ảnh đại diện của bot được cập nhật tự động.
Đổi token
Nếu tạo lại token trong @BotFather (Bot Settings → Revoke / New token), hãy nhập token mới trong Cài đặt → Đổi token. Token mới phải thuộc đúng bot cũ, nghĩa là ID nội bộ Telegram phải trùng. Nhờ vậy, phản ứng, người đăng ký và dữ liệu vẫn được giữ.
Chuyển bot sang tài khoản khác
Cài đặt → Đổi chủ sở hữu gửi lời mời chuyển dự án tới email của một tài khoản GetMyBot khác. Lời mời có hiệu lực 72 giờ. Trước khi người nhận chấp nhận, dự án vẫn thuộc bạn và bạn có thể hủy lời mời. Khi họ chấp nhận, chủ sở hữu đổi và bạn mất quyền truy cập dự án. Hãy dùng chức năng này khi bàn giao cho khách hàng hoặc đồng nghiệp.
Mẫu bot
Mẫu là bản chụp cài đặt bot và tất cả phản ứng để áp dụng cho bot khác:
- Tạo mẫu trong Cài đặt: lưu bot hiện tại thành mẫu có tên.
- Áp dụng mẫu: thay cài đặt của bot được chọn bằng cài đặt từ mẫu và thêm các phản ứng của mẫu vào các phản ứng hiện có.
Chức năng này hữu ích khi cần triển khai cùng một loại bot cho nhiều dự án.
Cài đặt giải pháp có sẵn từ danh mục
Danh mục giải pháp có sẵn dùng trình hướng dẫn cài đặt. Nhập các tham số, kiểm tra tính tương thích và kết nối cần thiết, rồi xem danh sách tài nguyên sẽ được tạo. Sau khi cài đặt, hoàn tất những bước còn lại và thử kịch bản bằng một yêu cầu mẫu.
Trình hướng dẫn này khác với việc áp dụng bản chụp bot ở phần trên. Kiểm tra trước khi cài đặt sẽ nêu tham số hoặc tính năng còn thiếu. Việc đánh dấu một bước là đã hoàn thành không xác nhận dịch vụ bên ngoài đã hoạt động.
Chỉ số của giải pháp có sẵn
Chọn khoảng thời gian để đánh giá giải pháp đã cài đặt. Nếu muốn so sánh, chọn chế độ khả dụng và kiểm tra cỡ mẫu cùng kết quả chẩn đoán. Thiếu dữ liệu và không có phép so sánh là hai tình huống khác với kết quả bằng không.
Tiếp theo
- Cài đặt, nhóm và quyền truy cập: cách bot hoạt động, vai trò, mẫu và token API.
- Cơ bản về phản ứng: thiết lập cách bot hoạt động.
- Nhập từ sambot: chuyển bot đã có.
- Thanh toán và số dư: gói dịch vụ và giới hạn số bot.