Lịch sử thay đổi Telegram Bot API
Mọi thay đổi của Telegram Bot API từ phiên bản 9.0 (tháng 4/2025) đến Bot API 10.5 hiện tại (22 tháng 11, 2026), mới nhất ở trên cùng. Tên phương thức liên kết tới tài liệu tham khảo của chúng tôi kèm tham số và ví dụ; tên lớp liên kết tới tài liệu chính thức.
Bot API 10.5 Mới nhất
Phương thức mới: setMySettings
Cài đặt bot
- Thêm phương thức setMySettings, cho phép bot thay đổi cài đặt của mình, bao gồm cài đặt chế độ inline, chế độ riêng tư, khả năng được thêm vào nhóm, chế độ chủ đề diễn đàn trong chat riêng và chế độ nhận callback query.
- Thêm khả năng nhận callback query từ các nút trong tin nhắn do bot gửi với trường inline_message_id thay cho trường message trong lớp CallbackQuery, tùy theo tham số callback_query_mode của phương thức setMySettings.
- Thêm khả năng cho bot hiển thị danh sách chủ đề ở thanh bên trong chat riêng với bot bằng tham số has_topic_sidebar của phương thức setMySettings.
- Tách lớp BotFullInfo ra khỏi lớp User và đổi kiểu trả về của phương thức getMe thành BotFullInfo. Các trường chỉ được trả về trong getMe đã bị xóa khỏi lớp User.
- Thêm trường active_usernames vào lớp BotFullInfo, cho phép bot lấy danh sách tất cả username đang hoạt động của mình.
- Thêm trường inline_query_placeholder vào lớp BotFullInfo, cho phép bot lấy văn bản gợi ý (placeholder) cho truy vấn inline của mình.
- Thêm trường needs_inline_query_location vào lớp BotFullInfo, cho phép bot kiểm tra xem nó có yêu cầu vị trí của người dùng với mỗi truy vấn inline hay không.
- Thêm trường has_topic_sidebar vào lớp BotFullInfo, cho phép bot kiểm tra xem các chủ đề trong chat riêng với bot có được hiển thị ở thanh bên hay không.
Chung
- Thêm khả năng cho chủ sở hữu bot mời tối đa 10 người dùng cùng lúc vào chat riêng với bot bằng cách nhấn vào liên kết
https://t.me/botinvite/<bot_username>. Bot có thể gửi tin nhắn cho những người dùng được mời. - Thêm trường inviter vào lớp WriteAccessAllowed cho các tin nhắn dịch vụ về người dùng được chủ sở hữu bot mời vào chat riêng với bot.
- Thay trường text bằng trường blocks trong các lớp RichBlockExpandableBlockQuotation và InputRichBlockExpandableBlockQuotation, cho phép trích dẫn khối có thể mở rộng chứa các khối tùy ý.
Bot API 10.4
Phương thức mới: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
Widget
- Thêm lớp Widget và trường widget vào các lớp Message và ExternalReplyInfo cho các tin nhắn có widget HTML.
- Thêm phương thức sendWidget, cho phép bot gửi tin nhắn có widget HTML. Hiện tại, trên môi trường production, widget chỉ có thể được gửi tới chat riêng, và widget đã gửi tự động được bảo vệ nội dung nên không thể chuyển tiếp.
- Thêm phương thức sendSharedWidget, cho phép bot gửi lại các widget chia sẻ do bot tạo.
- Thêm lớp WidgetQuery và trường widget_query vào lớp Update cho các truy vấn mà widget gửi tới bot từ tin nhắn do bot gửi hoặc gửi qua bot.
- Thêm lớp SharedWidgetQuery và trường shared_widget_query vào lớp Update cho các truy vấn gửi tới bot từ tin nhắn được chuyển tiếp có widget chia sẻ.
- Thêm các lớp WidgetQueryType, WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction và WidgetQueryWallet, mô tả loại truy vấn từ widget. Một truy vấn có thể chứa dữ liệu cho bot kèm thẻ ví TON của người dùng, dữ liệu được ký bằng ví TON của người dùng, hoặc thông báo về giao dịch được gửi từ ví TON của người dùng.
- Thêm phương thức answerWidgetQuery, cho phép bot trả lời truy vấn từ widget.
- Thêm phương thức editMessageWidgetData, cho phép bot thay đổi dữ liệu của widget trong tin nhắn.
- Thêm phương thức editSharedWidgetData, cho phép bot thay đổi dữ liệu công khai của widget chia sẻ.
- Thêm các lớp InputWidgetMessageContent và InputSharedWidgetMessageContent, cho phép bot gửi widget để trả lời truy vấn inline. Hiện tại, trên môi trường production chưa thể gửi widget để trả lời truy vấn inline.
- Không thể sao chép tin nhắn widget bằng các phương thức copyMessage và copyMessages.
- Quyền can_send_other_messages trong các lớp ChatPermissions và ChatMemberRestricted giờ đây cũng cho phép gửi widget.
Tin nhắn tạm thời
- Cho phép bot gửi phản hồi tạm thời cho callback query trong mọi chat, trừ chat tin nhắn trực tiếp của kênh, bằng cách chỉ định callback_query_id mà không có receiver_user_id trong tham số ephemeral_message_parameters của các phương thức sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote và sendVoice.
- Trường receiver_user_id của lớp EphemeralMessageParameters và tham số chat_id của các phương thức nêu trên giờ là tùy chọn.
Trích dẫn từ tin nhắn rich
- Thêm trường rich_texts vào lớp TextQuote cho các trích dẫn được chọn từ một RichMessage.
- Thêm trường quote_rich_texts vào lớp ReplyParameters, cho phép bot trích dẫn tin nhắn rich.
Ví TON
- Thêm các lớp TonWalletCard, TonWalletCardSticker, TonNft và TonNftAttribute, cùng trường ton_wallet_card vào lớp ChatFullInfo.
- Thêm lớp TonWalletTransfer và trường ton_wallet_transfer vào lớp Message cho các tin nhắn dịch vụ về giao dịch chuyển tiền bằng ví TON.
- Đổi tên lớp StoryAreaPosition thành AreaPosition, vì giờ đây lớp này cũng được dùng để mô tả vị trí của sticker trên thẻ ví TON.
Giao diện chia sẻ chat
- Thêm các lớp ChatShareTheme, ChatShareThemeEmoji và ChatShareThemeUniqueGift, cùng trường share_theme vào lớp ChatFullInfo, mô tả giao diện màn hình chia sẻ liên kết tới người dùng hoặc chat.
- Thêm các lớp EmojiType, EmojiTypeEmoji và EmojiTypeCustomEmoji.
- Thêm các lớp ChatShareThemeBackdrop và ChatShareThemeBackdrops cùng phương thức getChatShareThemeBackdrops.
Quà tặng
- Thêm phương thức getUniqueGift, cho phép bot lấy thông tin về một quà tặng độc nhất theo tên.
- Thêm phương thức deleteBusinessAccountGift, cho phép bot xóa các quà tặng thường thuộc sở hữu của tài khoản doanh nghiệp được quản lý mà không nhận Telegram Stars cho chúng.
Chung
- Cho phép người dùng có gói Telegram Premium gán username phụ kết thúc bằng “agent”, “ai”, “app”, “game” hoặc “gay” cho tối đa 2 bot mình sở hữu. Các username như vậy có thể được gợi ý trong trường suggested_username của lớp KeyboardButtonRequestManagedBot.
- Thêm lớp RichTextTonAddress biểu diễn một địa chỉ trên blockchain TON trong RichMessage.
- Thêm loại “ton_address” vào lớp MessageEntity cho các địa chỉ trên blockchain TON.
- Thêm loại “bank_card_number” vào lớp MessageEntity cho số thẻ ngân hàng.
- Thêm các tham số custom_description_parse_mode và custom_description_entities vào các phương thức verifyUser và verifyChat.
- Thêm lớp PaidMessagesWaived và trường paid_messages_waived vào lớp Message cho các tin nhắn dịch vụ về việc người gửi dùng liên kết cho phép gửi tin nhắn mà không phải trả Telegram Stars.
- Thêm khả năng tạo liên kết tới các chủ đề trong chat riêng với bot theo định dạng
https://t.me/<bot_username>/<message_thread_id>. Liên kết như vậy chỉ mở chủ đề cho người dùng trong chat riêng có chủ đề đó.
Bot API 10.3
Tin nhắn rich
- Thêm lớp RichMessageButton biểu diễn một nút trong RichMessage.
- Thêm lớp RichTextButton.
- Thêm các lớp RichBlockButtons và InputRichBlockButtons.
- Thêm trường is_compact vào các lớp RichBlockTable và InputRichBlockTable.
- Thêm các lớp RichBlockExpandableBlockQuotation và InputRichBlockExpandableBlockQuotation biểu diễn một trích dẫn khối có thể mở rộng hoặc thu gọn lại.
- Thêm các lớp RichBlockDocument và InputRichBlockDocument, chứa một tệp.
- Thêm hỗ trợ liên kết dạng
tg://document?id=để tải lên tệp thông thường trong tin nhắn rich.
Tin nhắn tạm thời
- Thêm lớp EphemeralMessageParameters và thay các tham số receiver_user_id và callback_query_id trong các phương thức sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation và sendVenue bằng tham số ephemeral_message_parameters.
- Thêm tham số ephemeral_message_parameters vào phương thức sendRichMessage.
- Thêm trường replace_callback_query_message vào lớp EphemeralMessageParameters, cho phép bot hiển thị tin nhắn tạm thời thay cho tin nhắn gốc.
- Hỗ trợ tải lên tệp mới trong editEphemeralMessageMedia.
- Thêm tham số show_caption_above_media vào phương thức editEphemeralMessageCaption.
- Thêm tham số rich_message vào phương thức editEphemeralMessageText.
- Thêm trường can_send_welcome_messages vào các lớp ChatAdministratorRights và ChatMemberAdministrator.
- Thêm tham số can_send_welcome_messages vào phương thức promoteChatMember.
Reply markup
- Thêm lớp DisabledButton và trường disabled vào lớp InlineKeyboardButton.
- Thêm trường force_reply vào các lớp InlineKeyboardMarkup và ReplyKeyboardMarkup.
Chung
- Thêm các tham số can_stop và keep_on_stop vào các phương thức sendMessageDraft và sendRichMessageDraft.
- Thêm cập nhật về việc người dùng dừng tạo tin nhắn, biểu diễn bằng lớp MessageGenerationStopped và trường stopped_message_generation trong lớp Update.
- Thêm lớp CommunityChatJoined và trường community_chat_joined vào lớp Message cho các tin nhắn dịch vụ về việc tham gia một chat từ cộng đồng.
- Thêm các trường text, entities và is_private vào lớp UniqueGiftInfo.
Bot API 10.2
Phương thức mới: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
Tin nhắn rich
- Thêm lớp InputRichMessageMedia và trường media vào lớp InputRichMessage, cho phép bot chỉ định rõ media dùng trong định dạng markdown hoặc html khi gửi tin nhắn rich.
- Thêm lớp InputMediaVoiceNote, biểu diễn một tin nhắn thoại sẽ được gửi.
- Thêm lớp InputRichBlockListItem, biểu diễn một mục trong danh sách sẽ được gửi.
- Thêm các lớp InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote và InputRichBlockThinking, biểu diễn các loại khối khác nhau dùng để định dạng tin nhắn rich gửi đi.
- Thêm trường blocks vào lớp InputRichMessage, cho phép bot chỉ định định dạng tin nhắn rich bằng các thực thể khối.
Tin nhắn tạm thời
- Giới thiệu hỗ trợ tin nhắn tạm thời (Ephemeral Messages), cho phép bot gửi tin nhắn nhóm và nhận lệnh mà chỉ một người dùng cụ thể và bot nhìn thấy.
- Thêm trường is_ephemeral vào lớp BotCommand.
- Thêm trường receiver_user vào lớp Message.
- Thêm trường ephemeral_message_id vào lớp Message.
- Thêm các tham số receiver_user_id và callback_query_id vào các phương thức sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue.
- Thêm trường ephemeral_message_id vào lớp ReplyParameters, cho phép bot trả lời tin nhắn tạm thời.
- Đánh dấu trường message_id trong lớp ReplyParameters là tùy chọn nếu có trường ephemeral_message_id.
- Thêm các phương thức editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption và editEphemeralMessageReplyMarkup, cho phép bot chỉnh sửa tin nhắn tạm thời.
- Thêm phương thức deleteEphemeralMessage, cho phép bot xóa tin nhắn tạm thời.
Cộng đồng
- Giới thiệu hỗ trợ ban đầu cho Cộng đồng (Communities) - nhiều supergroup, kênh và bot được liên kết với nhau quanh một chủ đề hoặc nhóm đối tượng chung.
- Thêm lớp Community biểu diễn một cộng đồng.
- Thêm lớp CommunityChatAdded và trường community_chat_added vào lớp Message.
- Thêm lớp CommunityChatRemoved và trường community_chat_removed vào lớp Message.
- Thêm trường community vào lớp ChatFullInfo.
Chung
- Thêm cập nhật về thay đổi gói đăng ký trả phí của người dùng, biểu diễn bằng lớp BotSubscriptionUpdated và trường subscription trong lớp Update.
- Tăng cường bảo mật cho Mini App bằng cách không cho phép dùng các phương thức Mini App từ origin khác với domain gốc của Mini App. Cơ chế bảo vệ sẽ tự động được bật cho tất cả Mini App vào ngày 20/07/2026. Bạn có thể tắt cơ chế này qua Mini App @BotFather. Nếu làm vậy, bạn thừa nhận rằng bot có trách nhiệm đảm bảo Mini App không chứa liên kết tới các trang web không đáng tin cậy.
Bot API 10.1
Phương thức mới: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
Tin nhắn rich
- Thêm hỗ trợ tin nhắn rich (Rich Messages), cho phép bot gửi văn bản có cấu trúc cao và stream câu trả lời do AI tạo với định dạng phong phú liền mạch.
- Thêm các lớp RichTextBold, RichTextItalic, RichTextUnderline, RichTextStrikethrough, RichTextSpoiler, RichTextDateTime, RichTextTextMention, RichTextSubscript, RichTextSuperscript, RichTextMarked, RichTextCode, RichTextCustomEmoji, RichTextMathematicalExpression, RichTextUrl, RichTextEmailAddress, RichTextPhoneNumber, RichTextBankCardNumber, RichTextMention, RichTextHashtag, RichTextCashtag, RichTextBotCommand, RichTextAnchor, RichTextAnchorLink, RichTextReference và RichTextReferenceLink, biểu diễn các loại văn bản định dạng phong phú khác nhau.
- Thêm lớp RichText, biểu diễn văn bản định dạng phong phú.
- Thêm lớp RichBlockCaption, biểu diễn chú thích của văn bản định dạng phong phú.
- Thêm lớp RichBlockTableCell, biểu diễn một ô trong bảng.
- Thêm lớp RichBlockListItem, biểu diễn một mục trong danh sách.
- Thêm các lớp RichBlockParagraph, RichBlockSectionHeading, RichBlockPreformatted, RichBlockFooter, RichBlockDivider, RichBlockMathematicalExpression, RichBlockAnchor, RichBlockList, RichBlockBlockQuotation, RichBlockPullQuotation, RichBlockCollage, RichBlockSlideshow, RichBlockTable, RichBlockDetails, RichBlockMap, RichBlockAnimation, RichBlockAudio, RichBlockPhoto, RichBlockVideo, RichBlockVoiceNote và RichBlockThinking, biểu diễn các loại khối khác nhau trong tin nhắn định dạng phong phú.
- Thêm lớp RichBlock, biểu diễn một khối trong tin nhắn định dạng phong phú.
- Thêm lớp RichMessage, biểu diễn một tin nhắn định dạng phong phú.
- Thêm trường rich_message vào lớp Message.
- Thêm lớp InputRichMessage, mô tả một tin nhắn rich cần gửi.
- Thêm lớp InputRichMessageContent và cho phép dùng nó làm InputMessageContent trong kết quả của truy vấn inline, truy vấn khách và truy vấn Web App.
- Thêm phương thức sendRichMessage, cho phép bot gửi tin nhắn rich.
- Thêm phương thức sendRichMessageDraft, cho phép bot stream từng phần tin nhắn rich.
- Thêm tham số rich_message vào phương thức editMessageText, cho phép bot chỉnh sửa tin nhắn rich.
Truy vấn yêu cầu tham gia
- Thêm trường supports_join_request_queries vào lớp User.
- Thêm trường guard_bot vào lớp ChatFullInfo.
- Thêm trường query_id vào lớp ChatJoinRequest.
- Thêm phương thức answerChatJoinRequestQuery.
- Thêm phương thức sendChatJoinRequestWebApp.
Bình chọn
- Thêm lớp Link và trường link vào lớp PollMedia.
- Thêm lớp InputMediaLink và cho phép dùng nó làm InputPollOptionMedia.
Bot API 10.0
Phương thức mới: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
Chế độ khách
- Giới thiệu hỗ trợ chế độ khách, cho phép bot nhận một số tin nhắn nhất định và trả lời trong các chat mà bot không phải thành viên.
- Thêm trường supports_guest_queries vào lớp User.
- Thêm các trường guest_bot_caller_user và guest_bot_caller_chat vào lớp Message.
- Thêm trường guest_query_id vào lớp Message.
- Thêm trường guest_message vào lớp Update.
- Thêm lớp SentGuestMessage và phương thức answerGuestQuery.
Quản lý chat
- Thêm trường can_react_to_messages vào các lớp ChatMemberRestricted và ChatPermissions.
- Thêm tham số return_bots vào phương thức getChatAdministrators.
- Thêm phương thức deleteAllMessageReactions.
- Thêm phương thức deleteMessageReaction.
- Thêm khả năng xem một số tin nhắn do các bot khác gửi trong nhóm.
Bình chọn
- Thêm các lớp InputMediaSticker, InputMediaLocation và InputMediaVenue.
- Thêm lớp PollMedia, biểu diễn media trong bình chọn.
- Thêm trường media vào lớp Poll, cho phép bot xem media trong bình chọn.
- Thêm trường explanation_media vào lớp Poll, cho phép bot xem media trong phần giải thích của quiz.
- Thêm trường media vào lớp PollOption, cho phép bot xem media trong các lựa chọn bình chọn.
- Thêm lớp InputPollMedia và các tham số media và explanation_media vào phương thức sendPoll, cho phép bot thêm media vào bình chọn.
- Thêm lớp InputPollOptionMedia và trường media vào lớp InputPollOption, cho phép bot thêm media vào các lựa chọn bình chọn.
- Thêm trường members_only vào lớp Poll.
- Thêm tham số members_only vào phương thức sendPoll.
- Thêm trường country_codes vào lớp Poll.
- Thêm tham số country_codes vào phương thức sendPoll.
- Giảm số lựa chọn tối thiểu của bình chọn từ 2 xuống 1.
Ảnh động (Live Photo)
- Thêm lớp LivePhoto, biểu diễn một ảnh kèm video ngắn.
- Thêm lớp InputMediaLivePhoto.
- Thêm trường live_photo vào các lớp Message và ExternalReplyInfo.
- Thêm phương thức sendLivePhoto, cho phép bot gửi live photo.
- Thêm lớp PaidMediaLivePhoto, mô tả media trả phí là live photo.
- Thêm lớp InputPaidMediaLivePhoto, cho phép bot gửi live photo dưới dạng media trả phí.
- Cho phép dùng live photo trong sendMediaGroup và editMessageMedia,
Chung
- Cho phép Business Bot quản lý tài khoản người dùng không có gói Telegram Premium.
- Thêm khả năng gửi tin nhắn tới bot khác qua username nếu cả hai bot đều bật giao tiếp giữa các bot.
- Thêm khả năng trả lời bot khác từ business bot nếu business bot đã bật giao tiếp giữa các bot.
- Cho phép bot truyền văn bản rỗng trong phương thức sendMessageDraft.
- Thêm lớp BotAccessSettings và phương thức getManagedBotAccessSettings.
- Thêm phương thức setManagedBotAccessSettings.
- Thêm phương thức getUserPersonalChatMessages.
Bot API 9.6
Phương thức mới: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
Bot được quản lý
- Thêm trường can_manage_bots vào lớp User.
- Thêm lớp KeyboardButtonRequestManagedBot và trường request_managed_bot vào lớp KeyboardButton.
- Thêm lớp ManagedBotCreated và trường managed_bot_created vào lớp Message.
- Thêm cập nhật về việc tạo bot được quản lý và thay đổi token của chúng, biểu diễn bằng lớp ManagedBotUpdated và trường managed_bot trong lớp Update.
- Thêm các phương thức getManagedBotToken và replaceManagedBotToken.
- Thêm lớp PreparedKeyboardButton và phương thức savePreparedKeyboardButton, cho phép bot yêu cầu người dùng, chat và bot được quản lý từ Mini App.
- Thêm phương thức requestChat vào lớp WebApp.
- Thêm hỗ trợ liên kết
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}], cho phép bot yêu cầu tạo bot được quản lý qua liên kết.
Bình chọn
- Thêm hỗ trợ quiz có nhiều đáp án đúng.
- Thay trường correct_option_id bằng trường correct_option_ids trong lớp Poll.
- Thay tham số correct_option_id bằng tham số correct_option_ids trong phương thức sendPoll.
- Cho phép truyền allows_multiple_answers cho quiz trong phương thức sendPoll.
- Tăng thời gian tối đa để tự động đóng bình chọn lên 2628000 giây.
- Thêm trường allows_revoting vào lớp Poll.
- Thêm tham số allows_revoting vào phương thức sendPoll.
- Thêm tham số shuffle_options vào phương thức sendPoll.
- Thêm tham số allow_adding_options vào phương thức sendPoll.
- Thêm tham số hide_results_until_closes vào phương thức sendPoll.
- Thêm các trường description và description_entities vào lớp Poll.
- Thêm các tham số description, description_parse_mode và description_entities vào phương thức sendPoll.
- Thêm trường persistent_id vào lớp PollOption, biểu diễn định danh cố định của lựa chọn.
- Thêm trường option_persistent_ids vào lớp PollAnswer.
- Thêm các trường added_by_user và added_by_chat vào lớp PollOption, cho biết người dùng và chat đã thêm lựa chọn.
- Thêm trường addition_date vào lớp PollOption, cho biết ngày lựa chọn được thêm.
- Thêm lớp PollOptionAdded và trường poll_option_added vào lớp Message.
- Thêm lớp PollOptionDeleted và trường poll_option_deleted vào lớp Message.
- Thêm trường poll_option_id vào lớp ReplyParameters, cho phép bot trả lời một lựa chọn bình chọn cụ thể.
- Thêm trường reply_to_poll_option_id vào lớp Message.
- Cho phép thực thể “date_time” trong tiêu đề nhiệm vụ checklist, văn bản checklist task, TextQuote, trích dẫn ReplyParameters, sendGift và giftPremiumSubscription.
Bot API 9.5
Phương thức mới: setChatMemberTag
- Thêm loại MessageEntity “date_time”, cho phép bot hiển thị ngày giờ đã định dạng cho người dùng.
- Cho phép mọi bot dùng phương thức sendMessageDraft.
- Thêm trường tag vào các lớp ChatMemberMember và ChatMemberRestricted.
- Thêm phương thức setChatMemberTag.
- Thêm trường can_edit_tag vào các lớp ChatMemberRestricted và ChatPermissions.
- Thêm trường can_manage_tags vào các lớp ChatMemberAdministrator và ChatAdministratorRights.
- Thêm tham số can_manage_tags vào phương thức promoteChatMember.
- Thêm trường sender_tag vào lớp Message.
- Thêm trường iconCustomEmojiId vào lớp BottomButton.
Bot API 9.4
Phương thức mới: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- Cho phép bot dùng custom emoji trong tin nhắn bot gửi trực tiếp tới chat riêng, nhóm và supergroup nếu chủ sở hữu bot có gói Telegram Premium.
- Cho phép bot tạo chủ đề trong chat riêng bằng phương thức createForumTopic.
- Cho phép bot ngăn người dùng tạo và xóa chủ đề trong chat riêng qua một cài đặt mới trong Mini App @BotFather.
- Thêm trường allows_users_to_create_topics vào lớp User.
- Thêm trường icon_custom_emoji_id vào các lớp KeyboardButton và InlineKeyboardButton, cho phép bot hiển thị custom emoji trên nút nếu bot có thể dùng custom emoji trong tin nhắn.
- Thêm trường style vào các lớp KeyboardButton và InlineKeyboardButton, cho phép bot đổi màu nút.
- Thêm lớp ChatOwnerLeft và trường chat_owner_left vào lớp Message.
- Thêm lớp ChatOwnerChanged và trường chat_owner_changed vào lớp Message.
- Thêm các phương thức setMyProfilePhoto và removeMyProfilePhoto, cho phép bot quản lý ảnh đại diện của mình.
- Thêm lớp VideoQuality và trường qualities vào lớp Video, cho phép bot lấy thông tin về các chất lượng khác có sẵn của video.
- Thêm trường first_profile_audio vào lớp ChatFullInfo.
- Thêm lớp UserProfileAudios và phương thức getUserProfileAudios, cho phép bot lấy danh sách tệp âm thanh được thêm vào hồ sơ của người dùng.
- Thêm trường rarity vào lớp UniqueGiftModel.
- Thêm trường is_burned vào lớp UniqueGift.
Bot API 9.3
Phương thức mới: sendMessageDraft, getUserGifts, getChatGifts, repostStory
Chủ đề trong chat riêng
- Thêm trường has_topics_enabled vào lớp User, dùng để xác định bot có bật chế độ chủ đề diễn đàn trong chat riêng hay không.
- Thêm phương thức sendMessageDraft, cho phép stream từng phần tin nhắn tới người dùng trong khi đang tạo.
- Hỗ trợ các trường message_thread_id và is_topic_message trong lớp Message cho tin nhắn trong chat riêng có bật chế độ chủ đề diễn đàn.
- Hỗ trợ tham số message_thread_id trong chat riêng có chủ đề ở các phương thức sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage và forwardMessages, cho phép bot gửi tin nhắn tới một chủ đề cụ thể.
- Hỗ trợ tham số message_thread_id trong chat riêng ở phương thức sendChatAction, cho phép bot gửi hành động chat tới một chủ đề cụ thể trong chat riêng.
- Hỗ trợ tham số message_thread_id trong chat riêng có chủ đề ở các phương thức editForumTopic, deleteForumTopic và unpinAllForumTopicMessages, cho phép bot quản lý chủ đề trong chat riêng.
- Thêm trường is_name_implicit vào các lớp ForumTopic và ForumTopicCreated.
Quà tặng
- Thêm các phương thức getUserGifts và getChatGifts.
- Thay trường last_resale_star_count bằng các trường last_resale_currency và last_resale_amount trong lớp UniqueGiftInfo.
- Thay tham số exclude_limited bằng các tham số exclude_limited_upgradable và exclude_limited_non_upgradable trong phương thức getBusinessAccountGifts.
- Thêm giá trị “gifted_upgrade” làm giá trị có thể có của UniqueGiftInfo.origin cho tin nhắn về việc nâng cấp quà tặng được mua sau khi quà đã được gửi.
- Thêm giá trị “offer” làm giá trị có thể có của UniqueGiftInfo.origin cho tin nhắn về việc mua quà tặng qua đề nghị mua.
- Thêm trường gift_upgrade_sent vào lớp Message.
- Thêm trường gift_id vào lớp UniqueGift.
- Thêm trường is_from_blockchain vào lớp UniqueGift.
- Thêm tham số exclude_from_blockchain vào phương thức getBusinessAccountGifts để lọc bỏ các quà tặng được gán từ blockchain TON.
- Thêm các trường personal_total_count và personal_remaining_count vào lớp Gift.
- Thêm trường is_premium vào các lớp Gift và UniqueGift.
- Thêm trường is_upgrade_separate vào các lớp GiftInfo và OwnedGiftRegular.
- Thêm lớp UniqueGiftColors mô tả bảng màu cho tên người dùng, phần trả lời tin nhắn và bản xem trước liên kết dựa trên một quà tặng độc nhất.
- Thêm trường has_colors vào lớp Gift.
- Thêm trường colors vào lớp UniqueGift.
- Thêm lớp GiftBackground và trường background vào lớp Gift.
- Thêm trường unique_gift_variant_count vào lớp Gift.
- Thêm trường unique_gift_number vào các lớp GiftInfo và OwnedGiftRegular.
- Thêm trường gifts_from_channels vào lớp AcceptedGiftTypes.
Khác
- Cho phép bot tắt username chính nếu có thêm username đang hoạt động mua trên Fragment.
- Cho phép bot tắt quyền can_restrict_members trong chat kênh.
- Thêm phương thức repostStory, cho phép bot đăng lại story giữa các tài khoản doanh nghiệp khác nhau mà bot quản lý.
- Thêm lớp UserRating và trường rating vào lớp ChatFullInfo.
- Tăng giá tối đa của media trả phí lên 25000 Telegram Stars.
- Thêm trường paid_message_star_count vào lớp ChatFullInfo.
- Thêm tham số message_effect_id vào các phương thức forwardMessage và copyMessage.
- Thêm trường unique_gift_colors vào lớp ChatFullInfo.
- Thêm trường completed_by_chat vào lớp ChecklistTask.
Bot API 9.2
Phương thức mới: approveSuggestedPost, declineSuggestedPost
Checklist
- Thêm trường checklist_task_id vào lớp ReplyParameters, cho phép bot trả lời một nhiệm vụ cụ thể trong checklist.
- Thêm trường reply_to_checklist_task_id vào lớp Message.
Quà tặng
- Thêm trường publisher_chat vào các lớp Gift và UniqueGift, dùng để lấy thông tin về chat đã phát hành quà tặng.
Tin nhắn trực tiếp trong kênh
- Thêm trường is_direct_messages vào các lớp Chat và ChatFullInfo, dùng để nhận biết các supergroup được dùng làm chat tin nhắn trực tiếp của kênh.
- Thêm trường parent_chat vào lớp ChatFullInfo, cho biết chat kênh mẹ của một chat tin nhắn trực tiếp của kênh.
- Thêm lớp DirectMessagesTopic và trường direct_messages_topic vào lớp Message, mô tả một chủ đề của chat tin nhắn trực tiếp.
- Thêm tham số direct_messages_topic_id vào các phương thức sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, sendMediaGroup, copyMessage, copyMessages, forwardMessage và forwardMessages. Tham số này dùng để gửi tin nhắn tới một chủ đề của chat tin nhắn trực tiếp.
Bài đăng đề xuất
- Thêm lớp SuggestedPostParameters và tham số suggested_post_parameters vào các phương thức sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, copyMessage, forwardMessage. Tham số này dùng để gửi bài đăng đề xuất tới một chủ đề của chat tin nhắn trực tiếp.
- Thêm phương thức approveSuggestedPost, cho phép bot duyệt các bài đăng đề xuất gửi đến.
- Thêm phương thức declineSuggestedPost, cho phép bot từ chối các bài đăng đề xuất gửi đến.
- Thêm trường can_manage_direct_messages vào các lớp ChatMemberAdministrator và ChatAdministratorRights.
- Thêm tham số can_manage_direct_messages vào phương thức promoteChatMember.
- Thêm trường is_paid_post vào lớp Message, dùng để nhận biết bài đăng trả phí. Các bài đăng này không được xóa trong 24 giờ để nhận được thanh toán.
- Thêm lớp SuggestedPostPrice, mô tả giá của bài đăng đề xuất.
- Thêm lớp SuggestedPostInfo và trường suggested_post_info vào lớp Message, mô tả một bài đăng đề xuất.
- Thêm lớp SuggestedPostApproved và trường suggested_post_approved vào lớp Message, mô tả tin nhắn dịch vụ về việc duyệt bài đăng đề xuất.
- Thêm lớp SuggestedPostApprovalFailed và trường suggested_post_approval_failed vào lớp Message, mô tả tin nhắn dịch vụ về việc duyệt bài đăng đề xuất thất bại.
- Thêm lớp SuggestedPostDeclined và trường suggested_post_declined vào lớp Message, mô tả tin nhắn dịch vụ về việc từ chối bài đăng đề xuất.
- Thêm lớp SuggestedPostPaid và trường suggested_post_paid vào lớp Message, mô tả tin nhắn dịch vụ về việc thanh toán thành công cho bài đăng đề xuất.
- Thêm lớp SuggestedPostRefunded và trường suggested_post_refunded vào lớp Message, mô tả tin nhắn dịch vụ về việc hoàn tiền cho bài đăng đề xuất.
Bot API 9.1
Phương thức mới: sendChecklist, editMessageChecklist, getMyStarBalance
Checklist
- Thêm lớp ChecklistTask biểu diễn một nhiệm vụ trong checklist.
- Thêm lớp Checklist biểu diễn một checklist.
- Thêm lớp InputChecklistTask biểu diễn một nhiệm vụ cần thêm vào checklist.
- Thêm lớp InputChecklist biểu diễn một checklist cần tạo.
- Thêm trường checklist vào các lớp Message và ExternalReplyInfo, mô tả checklist trong tin nhắn.
- Thêm lớp ChecklistTasksDone và trường checklist_tasks_done vào lớp Message, mô tả tin nhắn dịch vụ về thay đổi trạng thái của các nhiệm vụ trong checklist (tức là đánh dấu đã xong/chưa xong).
- Thêm lớp ChecklistTasksAdded và trường checklist_tasks_added vào lớp Message, mô tả tin nhắn dịch vụ về việc thêm nhiệm vụ mới vào checklist.
- Thêm phương thức sendChecklist, cho phép bot gửi checklist thay mặt tài khoản doanh nghiệp.
- Thêm phương thức editMessageChecklist, cho phép bot chỉnh sửa checklist thay mặt tài khoản doanh nghiệp.
Quà tặng
- Thêm trường next_transfer_date vào các lớp OwnedGiftUnique và UniqueGiftInfo.
- Thêm trường last_resale_star_count vào lớp UniqueGiftInfo.
- Thêm “resale” làm giá trị có thể có của trường origin trong lớp UniqueGiftInfo.
Chung
- Tăng số lựa chọn tối đa trong bình chọn lên 12.
- Thêm phương thức getMyStarBalance, cho phép bot lấy số dư Telegram Stars hiện tại của mình.
- Thêm lớp DirectMessagePriceChanged và trường direct_message_price_changed vào lớp Message, mô tả tin nhắn dịch vụ về thay đổi giá của tin nhắn trực tiếp gửi tới chat kênh.
- Thêm phương thức hideKeyboard vào lớp WebApp.
Bot API 9.0
Phương thức mới: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
Tài khoản doanh nghiệp
- Thêm lớp BusinessBotRights và thay trường can_reply bằng trường rights kiểu BusinessBotRights trong lớp BusinessConnection.
- Thêm phương thức readBusinessMessage, cho phép bot đánh dấu tin nhắn đến là đã đọc thay mặt tài khoản doanh nghiệp.
- Thêm phương thức deleteBusinessMessages, cho phép bot xóa tin nhắn thay mặt tài khoản doanh nghiệp.
- Thêm phương thức setBusinessAccountName, cho phép bot thay đổi họ và tên của tài khoản doanh nghiệp được quản lý.
- Thêm phương thức setBusinessAccountUsername, cho phép bot thay đổi username của tài khoản doanh nghiệp được quản lý.
- Thêm phương thức setBusinessAccountBio, cho phép bot thay đổi tiểu sử của tài khoản doanh nghiệp được quản lý.
- Thêm lớp InputProfilePhoto, mô tả ảnh đại diện cần đặt.
- Thêm các phương thức setBusinessAccountProfilePhoto và removeBusinessAccountProfilePhoto, cho phép bot thay đổi ảnh đại diện của tài khoản doanh nghiệp được quản lý.
- Thêm phương thức setBusinessAccountGiftSettings, cho phép bot thay đổi cài đặt quyền riêng tư liên quan đến quà tặng nhận được trong tài khoản doanh nghiệp được quản lý.
- Thêm lớp StarAmount và phương thức getBusinessAccountStarBalance, cho phép bot kiểm tra số dư Telegram Stars hiện tại của tài khoản doanh nghiệp được quản lý.
- Thêm phương thức transferBusinessAccountStars, cho phép bot chuyển Telegram Stars từ số dư của tài khoản doanh nghiệp được quản lý sang số dư của chính bot để rút.
- Thêm các lớp OwnedGiftRegular, OwnedGiftUnique, OwnedGifts và phương thức getBusinessAccountGifts, cho phép bot lấy danh sách quà tặng thuộc sở hữu của tài khoản doanh nghiệp được quản lý.
- Thêm phương thức convertGiftToStars, cho phép bot đổi quà tặng mà tài khoản doanh nghiệp được quản lý nhận được thành Telegram Stars.
- Thêm phương thức upgradeGift, cho phép bot nâng cấp quà tặng thường mà tài khoản doanh nghiệp được quản lý nhận được thành quà tặng độc nhất.
- Thêm phương thức transferGift, cho phép bot chuyển nhượng quà tặng độc nhất thuộc sở hữu của tài khoản doanh nghiệp được quản lý.
- Thêm các lớp InputStoryContentPhoto và InputStoryContentVideo biểu diễn nội dung của story cần đăng.
- Thêm các lớp StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather và StoryAreaTypeUniqueGift, mô tả các vùng tương tác có thể nhấn trên story.
- Thêm phương thức postStory, cho phép bot đăng story thay mặt tài khoản doanh nghiệp được quản lý.
- Thêm phương thức editStory, cho phép bot chỉnh sửa story đã đăng trước đó thay mặt tài khoản doanh nghiệp được quản lý.
- Thêm phương thức deleteStory, cho phép bot xóa story đã đăng trước đó thay mặt tài khoản doanh nghiệp được quản lý.
Mini App
- Thêm trường DeviceStorage, cho phép Mini App dùng bộ nhớ cục bộ lâu dài trên thiết bị của người dùng.
- Thêm trường SecureStorage, cho phép Mini App dùng bộ nhớ cục bộ bảo mật trên thiết bị của người dùng cho dữ liệu nhạy cảm.
Quà tặng
- Thêm các lớp UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors và UniqueGiftBackdrop để mô tả thuộc tính của quà tặng độc nhất.
- Thêm lớp UniqueGift mô tả quà tặng đã được nâng cấp thành quà tặng độc nhất.
- Thêm lớp AcceptedGiftTypes mô tả các loại quà tặng mà người dùng hoặc chat chấp nhận.
- Thay trường can_send_gift bằng trường accepted_gift_types kiểu AcceptedGiftTypes trong lớp ChatFullInfo.
- Thêm lớp GiftInfo và trường gift vào lớp Message, mô tả tin nhắn dịch vụ về quà tặng thường đã được gửi hoặc nhận.
- Thêm lớp UniqueGiftInfo và trường unique_gift vào lớp Message, mô tả tin nhắn dịch vụ về quà tặng độc nhất đã được gửi hoặc nhận.
Telegram Premium
- Thêm phương thức giftPremiumSubscription, cho phép bot tặng người dùng gói Telegram Premium thanh toán bằng Telegram Stars.
- Thêm trường premium_subscription_duration vào lớp TransactionPartnerUser cho các giao dịch liên quan đến gói Telegram Premium do bot mua.
- Thêm trường transaction_type vào lớp TransactionPartnerUser, giúp phân biệt và xử lý mọi loại giao dịch dễ dàng hơn.
Chung
- Tăng giá tối đa của media trả phí lên 10000 Telegram Stars.
- Tăng giá tối đa cho một kỳ đăng ký lên 10000 Telegram Stars.
- Thêm lớp PaidMessagePriceChanged và trường paid_message_price_changed vào lớp Message, mô tả tin nhắn dịch vụ về thay đổi giá của tin nhắn trả phí gửi tới chat.
- Thêm trường paid_star_count vào lớp Message, chứa số Telegram Stars đã trả để gửi tin nhắn.
Các phiên bản trước
Các bản phát hành trước Bot API 9.0 được liệt kê kèm ngày phát hành. Mô tả đầy đủ có trong changelog chính thức.
- Bot API 8.3 — 12 tháng 2, 2025
- Bot API 8.2 — 1 tháng 1, 2025
- Bot API 8.1 — 4 tháng 12, 2024
- Bot API 8.0 — 17 tháng 11, 2024
- Bot API 7.11 — 31 tháng 10, 2024
- Bot API 7.10 — 6 tháng 9, 2024
- Bot API 7.9 — 14 tháng 8, 2024
- Bot API 7.8 — 31 tháng 7, 2024
- Bot API 7.7 — 7 tháng 7, 2024
- Bot API 7.6 — 1 tháng 7, 2024
- Bot API 7.5 — 18 tháng 6, 2024
- Bot API 7.4 — 28 tháng 5, 2024
- Bot API 7.3 — 6 tháng 5, 2024
- Bot API 7.2 — 31 tháng 3, 2024
- Bot API 7.1 — 16 tháng 2, 2024
- Bot API 7.0 — 29 tháng 12, 2023
- Bot API 6.9 — 22 tháng 9, 2023
- Bot API 6.8 — 18 tháng 8, 2023
- Bot API 6.7 — 21 tháng 4, 2023
- Bot API 6.6 — 9 tháng 3, 2023
- Bot API 6.5 — 3 tháng 2, 2023
- Bot API 6.4 — 30 tháng 12, 2022
- Bot API 6.3 — 5 tháng 11, 2022
- Bot API 6.2 — 12 tháng 8, 2022
- Bot API 6.1 — 20 tháng 6, 2022
- Bot API 6.0 — 16 tháng 4, 2022
- Bot API 5.7 — 31 tháng 1, 2022
- Bot API 5.6 — 30 tháng 12, 2021
- Bot API 5.5 — 7 tháng 12, 2021
- Bot API 5.4 — 5 tháng 11, 2021
- Bot API 5.3 — 25 tháng 6, 2021
- Bot API 5.2 — 26 tháng 4, 2021
- Bot API 5.1 — 9 tháng 3, 2021
- Bot API 5.0 — 4 tháng 11, 2020
- Bot API 4.9 — 4 tháng 6, 2020
- Bot API 4.8 — 24 tháng 4, 2020
- Bot API 4.7 — 30 tháng 3, 2020
- Bot API 4.6 — 23 tháng 1, 2020
- Bot API 4.5 — 31 tháng 12, 2019
- Bot API 4.4 — 29 tháng 7, 2019
- Bot API 4.3 — 31 tháng 5, 2019
- Bot API 4.2 — 14 tháng 4, 2019
- Bot API 4.1 — 27 tháng 8, 2018
- Bot API 4.0 — 26 tháng 7, 2018
- Bot API 3.6 — 13 tháng 2, 2018
- Bot API 3.5 — 17 tháng 11, 2017
- Bot API 3.4 — 11 tháng 10, 2017
- Bot API 3.3 — 23 tháng 8, 2017
- Bot API 3.2 — 21 tháng 7, 2017
- Bot API 3.1 — 30 tháng 6, 2017
- Bot API 3.0 — 18 tháng 5, 2017
- Bot API 2.3.1 — 4 tháng 12, 2016
- Bot API 2.3 — 21 tháng 11, 2016
- Bot API 2.2. — 3 tháng 10, 2016
- Bot API 2.1. — 22 tháng 5, 2016
- Bot API 2.0 — 9 tháng 4, 2016
Câu hỏi thường gặp
Phiên bản mới nhất của Telegram Bot API là gì?
Bot API 10.5, phát hành ngày 22 tháng 11, 2026. Phiên bản này có 194 phương thức.
Telegram Bot API thay đổi thường xuyên như thế nào?
Telegram thường phát hành phiên bản Bot API mới sau mỗi một đến hai tháng. Mỗi bản phát hành bổ sung phương thức và trường; một số bản còn có thay đổi không tương thích, được ghi chú trong phần mô tả.
Làm sao biết một phương thức được thêm vào khi nào?
Mở phương thức đó trong tài liệu tham khảo phương thức của chúng tôi: mục Lịch sử phiên bản cho biết bản phát hành đã thêm và các bản đã thay đổi phương thức, kèm liên kết tới trang này.