v10.3 185 phương thức
Trang chủ Tài liệu Tester Mini App Góp ý
VI

Tài liệu Telegram Bot API tương tác: Swagger & OpenAPI 3.1

Telegram Bot API Swagger là tài liệu Telegram Bot API tương tác: bản mô tả OpenAPI 3.1 cho cả 185 phương thức của Bot API 10.3, chia thành 19 tag và hiển thị bằng Swagger UI. Mỗi phương thức liệt kê tham số kèm kiểu dữ liệu và dấu bắt buộc, có link tới tài liệu chính thức và gọi thử được ngay với token bot của bạn.

Cách dùng tài liệu Telegram Bot API trên Swagger

  1. Lấy token bot từ @BotFather; xem cách lấy token bot Telegram.
  2. Bấm Authorize và dán token. Request được gửi tới https://api.telegram.org/bot<token>/METHOD_NAME, nên nếu khối server hiển thị biến token, hãy điền cả vào đó.
  3. Mở một tag (nhóm phương thức) hoặc thu hẹp danh sách bằng ô lọc.
  4. Chọn phương thức, bấm Try it out, sửa JSON body (với sendMessage là chat_id và text) rồi bấm Execute.
  5. Kiểm tra mã trạng thái, response body, thời gian xử lý request và lệnh curl được tạo sẵn.

Khi nào nên dùng Swagger

Lưu ý: "Try it out" gửi request thật — sendMessage gửi tin nhắn thật và deleteWebhook xóa webhook thật. Hãy thử nghiệm với một bot test.

Telegram Bot API tiếng Việt: tra cứu từng phương thức

Nếu muốn đọc tài liệu Telegram Bot API bằng tiếng Việt, hãy mở tài liệu tham khảo phương thức: mỗi phương thức có một trang riêng với bảng tham số, kiểu dữ liệu, giá trị trả về và ví dụ curl, Python, JavaScript. Nếu mới bắt đầu, hãy đọc cách tạo bot Telegram trước.

Bảo mật

Swagger chạy hoàn toàn trong trình duyệt. Request đi thẳng từ trang tới api.telegram.org, nên token và dữ liệu API của bạn không đi qua máy chủ của chúng tôi. Nếu token vẫn bị lộ, hãy thu hồi bằng /revoke trong @BotFather.

Cần form tham số theo kiểu dữ liệu, long polling và lịch sử update? Hãy dùng Bot API Tester. Đang làm Mini App? Test API Telegram.WebApp bằng Mini App Tester.

Câu hỏi thường gặp

Telegram Bot API có đặc tả OpenAPI không?

Telegram công bố tài liệu Bot API trên core.telegram.org. Trang này cung cấp bản mô tả OpenAPI 3.1 độc lập cho cả 185 phương thức của Bot API 10.3, hiển thị bằng Swagger UI; đây không phải sản phẩm chính thức của Telegram.

Làm sao Authorize trong Telegram Bot API Swagger?

Bấm Authorize và dán token nhận từ @BotFather; nếu khối server có biến token, hãy điền cả vào đó. Khi đó request được gửi tới https://api.telegram.org/bot<token>/METHOD_NAME trực tiếp từ trình duyệt của bạn.

Try it out có gửi request thật không?

Có. Nút Execute gọi Bot API thật bằng token của bạn, nên các phương thức như sendMessage, deleteMessage, setWebhook hay logOut đều có tác dụng thật. Hãy dùng một bot test khi thử nghiệm.

Tài liệu này dùng phiên bản Bot API nào?

Bot API 10.3 (ngày 24/8/2026): cả 185 phương thức trong 19 tag, gồm cả rich message và tin nhắn tạm thời (ephemeral), mỗi phương thức đều có link tới tài liệu chính thức.

Có tài liệu Telegram Bot API tiếng Việt không?

Có. Ngoài trang Swagger này, site còn có tài liệu tham khảo phương thức bằng tiếng Việt: mỗi phương thức một trang với bảng tham số và ví dụ curl, Python, JavaScript. Tài liệu chính thức trên core.telegram.org chỉ có tiếng Anh.

Nên dùng Swagger hay Bot API Tester?

Dùng Swagger để tra cứu, so sánh schema của request và sao chép lệnh curl. Dùng Bot API Tester khi cần form tham số theo kiểu dữ liệu, long polling kèm lịch sử update và kiểm tra token nhanh.