Telegram Bot API Tester

Bot API Tester giúp bạn test bot Telegram online ngay trên trình duyệt: dán token của bot, chọn một trong 185 phương thức của Bot API 10.3, điền form tham số và nhận phản hồi JSON tức thì. Đây là công cụ Telegram Bot API online miễn phí để kiểm tra token bot Telegram, thử gửi tin nhắn hay gỡ lỗi request mà không cần viết code hay cài Postman.

Cách test bot Telegram bằng Bot API Tester

1. Lấy token từ @BotFather bằng lệnh /newbot (xem cách lấy token bot Telegram).
2. Dán token vào ô token. Token được lưu trong localStorage của trình duyệt.
3. Chạy getMe. Token hợp lệ sẽ trả về đối tượng User của bot; 401 Unauthorized nghĩa là token sai hoặc đã bị thu hồi.
4. Chọn phương thức trong 19 danh mục hoặc qua ô tìm kiếm, hoặc mở thẳng bằng hash trên URL, ví dụ telegram-bot-api-tester.html#sendMessage.
5. Điền tham số (tham số bắt buộc được đánh dấu) rồi bấm Thực thi hoặc nhấn Ctrl+Enter.
6. Xem kết quả trong trình xem JSON có thể thu gọn và sao chép phần bạn cần.

Những việc thường làm với tester

• Kiểm tra token bot Telegram. getMe chính là công cụ kiểm tra token: chỉ một lệnh gọi là biết token có hợp lệ không và thuộc về bot nào.
• Tìm chat ID. Bấm Bắt đầu để chạy long polling, nhắn cho bot một tin rồi đọc message.chat.id trong lịch sử update (lưu 100 update gần nhất). Chi tiết trong bài chat ID Telegram lấy ở đâu.
• Thử tin nhắn và định dạng. Test sendMessage với parse_mode, bàn phím inline và xem trước liên kết trước khi viết code; xem bài API gửi tin nhắn Telegram.
• Quản lý webhook. Gọi setWebhook, getWebhookInfo và deleteWebhook theo hướng dẫn webhook Telegram bot.
• Khám phá Bot API 10.x. Rich message, tin nhắn tạm thời (ephemeral) và join request query có sẵn bên cạnh các phương thức quen thuộc, gọi được ngay với token của bạn.

Vì getUpdates không hoạt động khi bot đang dùng webhook, lúc bắt đầu long polling tester sẽ gọi deleteWebhook trước (các update đang chờ vẫn được giữ lại). Nếu bot production chạy bằng webhook, hãy đặt lại bằng setWebhook khi test xong.

Bảo mật: token chỉ nằm trong trình duyệt của bạn

Tester là một trang tĩnh, không có backend riêng. Token được lưu trong localStorage của trình duyệt và mọi request đi thẳng từ trình duyệt tới api.telegram.org (máy chủ này hỗ trợ CORS). Token và dữ liệu API của bạn không bao giờ đi qua máy chủ của chúng tôi. Dù vậy, khi thử nghiệm, dùng một bot test riêng vẫn là lựa chọn an toàn nhất.

Công cụ và tài liệu khác

Xem đặc tả OpenAPI 3.1 của từng phương thức trong Swagger, test JavaScript API Telegram.WebApp bằng Mini App Tester, hoặc mở tài liệu tham khảo phương thức để xem tham số và ví dụ curl, Python, JavaScript.