Telegram Bot API 更新日志
Telegram Bot API 从 9.0 版(2025 年 4 月)到当前 Bot API 10.5(2026年11月22日)的全部变更,最新版本在前。方法名链接到我们的参考文档,包含参数和示例;类名链接到官方文档。
Bot API 10.5 最新
新方法: setMySettings
机器人设置
- 新增方法 setMySettings,机器人可以更改自身设置,包括内联模式设置、隐私模式、能否被添加到群组、私聊中的论坛话题模式,以及接收回调查询的模式。
- 根据方法 setMySettings 的参数 callback_query_mode,机器人所发消息中按钮的回调查询可以在类 CallbackQuery 中携带字段 inline_message_id,而不是字段 message。
- 机器人可以通过方法 setMySettings 的参数 has_topic_sidebar,在与机器人的私聊中以侧边栏显示话题列表。
- 从类 User 中拆分出类 BotFullInfo,并将方法 getMe 的返回类型改为 BotFullInfo。原先仅在 getMe 中返回的字段已从类 User 中移除。
- 在类 BotFullInfo 中新增字段 active_usernames,机器人可以获取自己所有有效用户名的列表。
- 在类 BotFullInfo 中新增字段 inline_query_placeholder,机器人可以获取自己的内联查询占位文本。
- 在类 BotFullInfo 中新增字段 needs_inline_query_location,机器人可以检查自己是否在每次内联查询时请求用户位置。
- 在类 BotFullInfo 中新增字段 has_topic_sidebar,机器人可以检查与机器人私聊中的话题是否显示在侧边栏中。
常规
- 机器人所有者可以通过链接
https://t.me/botinvite/<bot_username>一次邀请最多 10 位用户进入与机器人的私聊。机器人可以向被邀请的用户发送消息。 - 在类 WriteAccessAllowed 中新增字段 inviter,用于机器人所有者邀请用户进入与机器人私聊时的服务消息。
- 在类 RichBlockExpandableBlockQuotation 和 InputRichBlockExpandableBlockQuotation 中,将字段 text 替换为字段 blocks,可展开引用块现在可以包含任意块。
Bot API 10.4
新方法: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
小组件
- 新增类 Widget,并在类 Message 和 ExternalReplyInfo 中新增字段 widget,用于包含 HTML widgets 的消息。
- 新增方法 sendWidget,机器人可以发送带 HTML 小组件的消息。目前在生产环境中,小组件只能发送到私聊,且发送的小组件自动受内容保护,因此无法转发。
- 新增方法 sendSharedWidget,机器人可以再次发送由自己创建的共享小组件。
- 新增类 WidgetQuery,并在类 Update 中新增字段 widget_query,用于机器人发送或通过机器人发送的消息中的小组件向机器人发出的查询。
- 新增类 SharedWidgetQuery,并在类 Update 中新增字段 shared_widget_query,用于从包含共享小组件的转发消息向机器人发出的查询。
- 新增类 WidgetQueryType、WidgetQueryTypeData、WidgetQueryTypeSignData、WidgetQueryTypeSentTransaction 和 WidgetQueryWallet,用于描述来自小组件的查询类型。查询可以包含发给机器人的数据及用户的 TON 钱包卡片、由用户 TON 钱包签名的数据,或用户 TON 钱包所发交易的通知。
- 新增方法 answerWidgetQuery,机器人可以响应来自小组件的查询。
- 新增方法 editMessageWidgetData,机器人可以更改消息中小组件的数据。
- 新增方法 editSharedWidgetData,机器人可以更改共享小组件的公开数据。
- 新增类 InputWidgetMessageContent 和 InputSharedWidgetMessageContent,机器人可以在响应内联查询时发送小组件。目前在生产环境中,暂不支持在响应内联查询时发送小组件。
- 小组件消息无法通过方法 copyMessage 和 copyMessages 复制。
- 类 ChatPermissions 和 ChatMemberRestricted 中的权限 can_send_other_messages 现在也允许发送小组件。
临时消息
- 在方法 sendMessage、sendRichMessage、sendAnimation、sendAudio、sendContact、sendDocument、sendLivePhoto、sendLocation、sendPhoto、sendSticker、sendVenue、sendVideo、sendVideoNote 和 sendVoice 的参数 ephemeral_message_parameters 中指定 callback_query_id 而不指定 receiver_user_id,机器人即可在除频道私信聊天外的任意聊天中以临时消息回复回调查询。
- 类 EphemeralMessageParameters 的字段 receiver_user_id 和上述方法的参数 chat_id 现为可选。
引用富文本消息
- 在类 TextQuote 中新增字段 rich_texts,用于从 RichMessage 中选取的引用。
- 在类 ReplyParameters 中新增字段 quote_rich_texts,机器人可以引用富文本消息。
TON 钱包
- 新增类 TonWalletCard、TonWalletCardSticker、TonNft 和 TonNftAttribute,并在类 ChatFullInfo 中新增字段 ton_wallet_card。
- 新增类 TonWalletTransfer,并在类 Message 中新增字段 ton_wallet_transfer,用于 TON 钱包转账的服务消息。
- 将类 StoryAreaPosition 重命名为 AreaPosition,因为它现在也用于描述 TON 钱包卡片上贴纸的位置。
聊天分享主题
- 新增类 ChatShareTheme、ChatShareThemeEmoji 和 ChatShareThemeUniqueGift,并在类 ChatFullInfo 中新增字段 share_theme,用于描述分享用户或聊天链接页面的主题。
- 新增类 EmojiType、EmojiTypeEmoji 和 EmojiTypeCustomEmoji。
- 新增类 ChatShareThemeBackdrop 和 ChatShareThemeBackdrops,以及方法 getChatShareThemeBackdrops。
礼物
- 新增方法 getUniqueGift,机器人可以按名称获取唯一礼物的信息。
- 新增方法 deleteBusinessAccountGift,机器人可以删除托管商业账户拥有的普通礼物,且不会因此获得 Telegram Stars。
常规
- 拥有 Telegram Premium 订阅的用户可以为自己拥有的最多 2 个机器人设置以 “agent”、“ai”、“app”、“game” 或 “gay” 结尾的附加用户名。此类用户名可以通过类 KeyboardButtonRequestManagedBot 的字段 suggested_username 推荐。
- 新增类 RichTextTonAddress,表示 RichMessage 中的 TON 区块链地址。
- 在类 MessageEntity 中新增类型 “ton_address”,用于 TON 区块链地址。
- 在类 MessageEntity 中新增类型 “bank_card_number”,用于银行卡号。
- 在方法 verifyUser 和 verifyChat 中新增参数 custom_description_parse_mode 和 custom_description_entities。
- 新增类 PaidMessagesWaived,并在类 Message 中新增字段 paid_messages_waived,用于发送者使用免付 Telegram Stars 发消息链接时的服务消息。
- 支持以
https://t.me/<bot_username>/<message_thread_id>格式创建指向与机器人私聊中话题的链接。此类链接只会为该话题所在私聊的用户打开话题。
Bot API 10.3
富文本消息
- 新增类 RichMessageButton,表示 RichMessage 中的按钮。
- 新增类 RichTextButton。
- 新增类 RichBlockButtons 和 InputRichBlockButtons。
- 在类 RichBlockTable 和 InputRichBlockTable 中新增字段 is_compact。
- 新增类 RichBlockExpandableBlockQuotation 和 InputRichBlockExpandableBlockQuotation,表示可展开和收起的引用块。
- 新增类 RichBlockDocument 和 InputRichBlockDocument,用于包含文件。
- 富文本消息中支持
tg://document?id=形式的链接,用于上传普通文件。
临时消息
- 新增类 EphemeralMessageParameters,并在方法 sendMessage、sendAnimation、sendAudio、sendDocument、sendLivePhoto、sendPhoto、sendSticker、sendVideo、sendVideoNote、sendVoice、sendContact、sendLocation 和 sendVenue 中将参数 receiver_user_id 和 callback_query_id 替换为参数 ephemeral_message_parameters。
- 在方法 sendRichMessage 中新增参数 ephemeral_message_parameters。
- 在类 EphemeralMessageParameters 中新增字段 replace_callback_query_message,机器人可以用临时消息替换原消息显示。
- editEphemeralMessageMedia 支持上传新文件。
- 在方法 editEphemeralMessageCaption 中新增参数 show_caption_above_media。
- 在方法 editEphemeralMessageText 中新增参数 rich_message。
- 在类 ChatAdministratorRights 和 ChatMemberAdministrator 中新增字段 can_send_welcome_messages。
- 在方法 promoteChatMember 中新增参数 can_send_welcome_messages。
回复标记
- 新增类 DisabledButton,并在类 InlineKeyboardButton 中新增字段 disabled。
- 在类 InlineKeyboardMarkup 和 ReplyKeyboardMarkup 中新增字段 force_reply。
常规
- 在方法 sendMessageDraft 和 sendRichMessageDraft 中新增参数 can_stop 和 keep_on_stop。
- 新增用户停止消息生成的更新,由类 MessageGenerationStopped 和类 Update 中的字段 stopped_message_generation 表示。
- 新增类 CommunityChatJoined,并在类 Message 中新增字段 community_chat_joined,用于从社区加入聊天的服务消息。
- 在类 UniqueGiftInfo 中新增字段 text、entities 和 is_private。
Bot API 10.2
新方法: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
富文本消息
- 新增类 InputRichMessageMedia,并在类 InputRichMessage 中新增字段 media,机器人在发送富文本消息时可以显式指定 markdown 或 html 格式中使用的媒体。
- 新增类 InputMediaVoiceNote,表示要发送的语音消息。
- 新增类 InputRichBlockListItem,表示要发送的列表项。
- 新增类 InputRichBlockParagraph、InputRichBlockSectionHeading、InputRichBlockPreformatted、InputRichBlockFooter、InputRichBlockDivider、InputRichBlockMathematicalExpression、InputRichBlockAnchor、InputRichBlockList、InputRichBlockBlockQuotation、InputRichBlockPullQuotation、InputRichBlockCollage、InputRichBlockSlideshow、InputRichBlockTable、InputRichBlockDetails、InputRichBlockMap、InputRichBlockAnimation、InputRichBlockAudio、InputRichBlockPhoto、InputRichBlockVideo、InputRichBlockVoiceNote 和 InputRichBlockThinking,表示可用于格式化待发送富文本消息的各类块。
- 在类 InputRichMessage 中新增字段 blocks,机器人可以通过块实体指定富文本消息的格式。
临时消息
- 引入对 Ephemeral Messages 的支持,机器人可以在群组中发送仅对特定用户和机器人可见的消息,并接收此类命令。
- 在类 BotCommand 中新增字段 is_ephemeral。
- 在类 Message 中新增字段 receiver_user。
- 在类 Message 中新增字段 ephemeral_message_id。
- 在方法 sendMessage、sendAnimation、sendAudio、sendDocument、sendLivePhoto、sendPhoto、sendSticker、sendVideo、sendVideoNote、sendVoice、sendContact、sendLocation、sendVenue 中新增参数 receiver_user_id 和 callback_query_id。
- 在类 ReplyParameters 中新增字段 ephemeral_message_id,机器人可以回复临时消息。
- 当存在字段 ephemeral_message_id 时,类 ReplyParameters 中的字段 message_id 改为可选。
- 新增方法 editEphemeralMessageText、editEphemeralMessageMedia、editEphemeralMessageCaption 和 editEphemeralMessageReplyMarkup,机器人可以编辑临时消息。
- 新增方法 deleteEphemeralMessage,机器人可以删除临时消息。
社区
- 初步支持社区:围绕共同主题或受众关联在一起的多个超级群组、频道和机器人。
- 新增类 Community,表示一个社区。
- 新增类 CommunityChatAdded,并在类 Message 中新增字段 community_chat_added。
- 新增类 CommunityChatRemoved,并在类 Message 中新增字段 community_chat_removed。
- 在类 ChatFullInfo 中新增字段 community。
常规
- 新增用户付费订阅变更的更新,由类 BotSubscriptionUpdated 和类 Update 中的字段 subscription 表示。
- 加强 Mini App 的安全性:禁止从与 Mini App 原始域名不同的来源调用 Mini App 方法。该保护将于 2026 年 7 月 20 日对所有 Mini App 自动启用。你可以在 @BotFather Mini App 中关闭此保护;这样做即表示你确认由机器人负责确保 Mini App 中不含指向不可信网站的链接。
Bot API 10.1
新方法: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
富文本消息
- 新增对 Rich Messages 的支持,机器人可以发送高度结构化的文本,并以无缝的富文本格式流式输出 AI 生成的回复。
- 新增类 RichTextBold、RichTextItalic、RichTextUnderline、RichTextStrikethrough、RichTextSpoiler、RichTextDateTime、RichTextTextMention、RichTextSubscript、RichTextSuperscript、RichTextMarked、RichTextCode、RichTextCustomEmoji、RichTextMathematicalExpression、RichTextUrl、RichTextEmailAddress、RichTextPhoneNumber、RichTextBankCardNumber、RichTextMention、RichTextHashtag、RichTextCashtag、RichTextBotCommand、RichTextAnchor、RichTextAnchorLink、RichTextReference 和 RichTextReferenceLink,表示不同类型的富文本。
- 新增类 RichText,表示富文本。
- 新增类 RichBlockCaption,表示富文本的说明文字。
- 新增类 RichBlockTableCell,表示表格中的单元格。
- 新增类 RichBlockListItem,表示列表中的一项。
- 新增类 RichBlockParagraph、RichBlockSectionHeading、RichBlockPreformatted、RichBlockFooter、RichBlockDivider、RichBlockMathematicalExpression、RichBlockAnchor、RichBlockList、RichBlockBlockQuotation、RichBlockPullQuotation、RichBlockCollage、RichBlockSlideshow、RichBlockTable、RichBlockDetails、RichBlockMap、RichBlockAnimation、RichBlockAudio、RichBlockPhoto、RichBlockVideo、RichBlockVoiceNote 和 RichBlockThinking,表示富文本消息中不同类型的块。
- 新增类 RichBlock,表示富文本消息中的块。
- 新增类 RichMessage,表示富文本消息。
- 在类 Message 中新增字段 rich_message。
- 新增类 InputRichMessage,描述要发送的富文本消息。
- 新增类 InputRichMessageContent,并允许在内联查询、访客查询和 Web App 查询的结果中将其用作 InputMessageContent。
- 新增方法 sendRichMessage,机器人可以发送富文本消息。
- 新增方法 sendRichMessageDraft,机器人可以流式发送部分富文本消息。
- 在方法 editMessageText 中新增参数 rich_message,机器人可以编辑富文本消息。
入群申请查询
- 在类 User 中新增字段 supports_join_request_queries。
- 在类 ChatFullInfo 中新增字段 guard_bot。
- 在类 ChatJoinRequest 中新增字段 query_id。
- 新增方法 answerChatJoinRequestQuery。
- 新增方法 sendChatJoinRequestWebApp。
投票
- 新增类 Link,并在类 PollMedia 中新增字段 link。
- 新增类 InputMediaLink,并允许将其用作 InputPollOptionMedia。
Bot API 10.0
新方法: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
访客模式
- 引入对 guest mode 的支持,机器人可以在自己不是成员的聊天中接收特定消息并发出回复。
- 在类 User 中新增字段 supports_guest_queries。
- 在类 Message 中新增字段 guest_bot_caller_user 和 guest_bot_caller_chat。
- 在类 Message 中新增字段 guest_query_id。
- 在类 Update 中新增字段 guest_message。
- 新增类 SentGuestMessage 和方法 answerGuestQuery。
聊天管理
- 在类 ChatMemberRestricted 和 ChatPermissions 中新增字段 can_react_to_messages。
- 在方法 getChatAdministrators 中新增参数 return_bots。
- 新增方法 deleteAllMessageReactions。
- 新增方法 deleteMessageReaction。
- 机器人可以在群组中看到其他机器人发送的部分消息。
投票
- 新增类 InputMediaSticker、InputMediaLocation 和 InputMediaVenue。
- 新增类 PollMedia,表示投票中的媒体。
- 在类 Poll 中新增字段 media,机器人可以查看投票中的媒体。
- 在类 Poll 中新增字段 explanation_media,机器人可以查看测验解析中的媒体。
- 在类 PollOption 中新增字段 media,机器人可以查看投票选项中的媒体。
- 新增类 InputPollMedia,并在方法 sendPoll 中新增参数 media 和 explanation_media,机器人可以在投票中添加媒体。
- 新增类 InputPollOptionMedia,并在类 InputPollOption 中新增字段 media,机器人可以在投票选项中添加媒体。
- 在类 Poll 中新增字段 members_only。
- 在方法 sendPoll 中新增参数 members_only。
- 在类 Poll 中新增字段 country_codes。
- 在方法 sendPoll 中新增参数 country_codes。
- 投票选项的最少数量从 2 个降至 1 个。
实况照片
- 新增类 LivePhoto,表示带有短视频的照片。
- 新增类 InputMediaLivePhoto。
- 在类 Message 和 ExternalReplyInfo 中新增字段 live_photo。
- 新增方法 sendLivePhoto,机器人可以发送实况照片。
- 新增类 PaidMediaLivePhoto,描述包含实况照片的付费媒体。
- 新增类 InputPaidMediaLivePhoto,机器人可以将实况照片作为付费媒体发送。
- 允许在 sendMediaGroup 和 editMessageMedia 中使用实况照片。
常规
- 商业机器人无需 Telegram Premium 订阅即可管理用户账户。
- 如果双方机器人都启用了机器人间通信,可以通过用户名向其他机器人发送消息。
- 如果商业机器人启用了机器人间通信,可以从商业机器人回复其他机器人。
- 允许在方法 sendMessageDraft 中传入空文本。
- 新增类 BotAccessSettings 和方法 getManagedBotAccessSettings。
- 新增方法 setManagedBotAccessSettings。
- 新增方法 getUserPersonalChatMessages。
Bot API 9.6
新方法: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
托管机器人
- 在类 User 中新增字段 can_manage_bots。
- 新增类 KeyboardButtonRequestManagedBot,并在类 KeyboardButton 中新增字段 request_managed_bot。
- 新增类 ManagedBotCreated,并在类 Message 中新增字段 managed_bot_created。
- 新增托管机器人创建及其 Token 变更的更新,由类 ManagedBotUpdated 和类 Update 中的字段 managed_bot 表示。
- 新增方法 getManagedBotToken 和 replaceManagedBotToken。
- 新增类 PreparedKeyboardButton 和方法 savePreparedKeyboardButton,机器人可以从 Mini App 中请求用户、聊天和托管机器人。
- 在类 WebApp 中新增方法 requestChat。
- 支持
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}]链接,机器人可以通过链接请求创建托管机器人。
投票
- 支持有多个正确答案的测验。
- 在类 Poll 中,将字段 correct_option_id 替换为字段 correct_option_ids。
- 在方法 sendPoll 中,将参数 correct_option_id 替换为参数 correct_option_ids。
- 在方法 sendPoll 中允许为测验传入 allows_multiple_answers。
- 投票自动关闭的最长时间增加到 2628000 秒。
- 在类 Poll 中新增字段 allows_revoting。
- 在方法 sendPoll 中新增参数 allows_revoting。
- 在方法 sendPoll 中新增参数 shuffle_options。
- 在方法 sendPoll 中新增参数 allow_adding_options。
- 在方法 sendPoll 中新增参数 hide_results_until_closes。
- 在类 Poll 中新增字段 description 和 description_entities。
- 在方法 sendPoll 中新增参数 description、description_parse_mode 和 description_entities。
- 在类 PollOption 中新增字段 persistent_id,表示选项的持久标识符。
- 在类 PollAnswer 中新增字段 option_persistent_ids。
- 在类 PollOption 中新增字段 added_by_user 和 added_by_chat,表示添加该选项的用户和聊天。
- 在类 PollOption 中新增字段 addition_date,表示选项的添加日期。
- 新增类 PollOptionAdded,并在类 Message 中新增字段 poll_option_added。
- 新增类 PollOptionDeleted,并在类 Message 中新增字段 poll_option_deleted。
- 在类 ReplyParameters 中新增字段 poll_option_id,机器人可以回复特定的投票选项。
- 在类 Message 中新增字段 reply_to_poll_option_id。
- 允许在 checklist 标题、checklist task 文本、TextQuote、ReplyParameters 引用、sendGift 和 giftPremiumSubscription 中使用 “date_time” 实体。
Bot API 9.5
新方法: setChatMemberTag
- 新增 MessageEntity 类型 “date_time”,机器人可以向用户显示格式化的日期和时间。
- 所有机器人均可使用方法 sendMessageDraft。
- 在类 ChatMemberMember 和 ChatMemberRestricted 中新增字段 tag。
- 新增方法 setChatMemberTag。
- 在类 ChatMemberRestricted 和 ChatPermissions 中新增字段 can_edit_tag。
- 在类 ChatMemberAdministrator 和 ChatAdministratorRights 中新增字段 can_manage_tags。
- 在方法 promoteChatMember 中新增参数 can_manage_tags。
- 在类 Message 中新增字段 sender_tag。
- 在类 BottomButton 中新增字段 iconCustomEmojiId。
Bot API 9.4
新方法: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- 如果机器人所有者拥有 Telegram Premium 订阅,机器人可以在直接发送到私聊、群组和超级群组的消息中使用自定义表情。
- 机器人可以使用方法 createForumTopic 在私聊中创建话题。
- 机器人可以通过 @BotFather Mini App 中的新设置,禁止用户在私聊中创建和删除话题。
- 在类 User 中新增字段 allows_users_to_create_topics。
- 在类 KeyboardButton 和 InlineKeyboardButton 中新增字段 icon_custom_emoji_id,如果机器人可以在消息中使用自定义表情,即可在按钮上显示自定义表情。
- 在类 KeyboardButton 和 InlineKeyboardButton 中新增字段 style,机器人可以更改按钮颜色。
- 新增类 ChatOwnerLeft,并在类 Message 中新增字段 chat_owner_left。
- 新增类 ChatOwnerChanged,并在类 Message 中新增字段 chat_owner_changed。
- 新增方法 setMyProfilePhoto 和 removeMyProfilePhoto,机器人可以管理自己的头像。
- 新增类 VideoQuality,并在类 Video 中新增字段 qualities,机器人可以获取视频其他可用画质的信息。
- 在类 ChatFullInfo 中新增字段 first_profile_audio。
- 新增类 UserProfileAudios 和方法 getUserProfileAudios,机器人可以获取用户添加到个人资料中的音频列表。
- 在类 UniqueGiftModel 中新增字段 rarity。
- 在类 UniqueGift 中新增字段 is_burned。
Bot API 9.3
新方法: sendMessageDraft, getUserGifts, getChatGifts, repostStory
私聊中的话题
- 在类 User 中新增字段 has_topics_enabled,可用于判断机器人是否在私聊中启用了论坛话题模式。
- 新增方法 sendMessageDraft,可以在生成消息的同时将部分内容流式发送给用户。
- 对于启用了论坛话题模式的私聊中的消息,类 Message 支持字段 message_thread_id 和 is_topic_message。
- 方法 sendMessage、sendPhoto、sendVideo、sendAnimation、sendAudio、sendDocument、sendPaidMedia、sendSticker、sendVideoNote、sendVoice、sendLocation、sendVenue、sendContact、sendPoll、sendDice、sendInvoice、sendGame、sendMediaGroup、copyMessage、copyMessages、forwardMessage 和 forwardMessages 在带话题的私聊中支持参数 message_thread_id,机器人可以向指定话题发送消息。
- 方法 sendChatAction 在私聊中支持参数 message_thread_id,机器人可以向私聊中的指定话题发送聊天动作。
- 方法 editForumTopic、deleteForumTopic 和 unpinAllForumTopicMessages 在带话题的私聊中支持参数 message_thread_id,机器人可以管理私聊中的话题。
- 在类 ForumTopic 和 ForumTopicCreated 中新增字段 is_name_implicit。
礼物
- 新增方法 getUserGifts 和 getChatGifts。
- 在类 UniqueGiftInfo 中,将字段 last_resale_star_count 替换为字段 last_resale_currency 和 last_resale_amount。
- 在方法 getBusinessAccountGifts 中,将参数 exclude_limited 替换为参数 exclude_limited_upgradable 和 exclude_limited_non_upgradable。
- UniqueGiftInfo.origin 新增可能值 “gifted_upgrade”,用于礼物在送出后才被购买升级的消息。
- UniqueGiftInfo.origin 新增可能值 “offer”,用于通过购买报价购得礼物的消息。
- 在类 Message 中新增字段 gift_upgrade_sent。
- 在类 UniqueGift 中新增字段 gift_id。
- 在类 UniqueGift 中新增字段 is_from_blockchain。
- 在方法 getBusinessAccountGifts 中新增参数 exclude_from_blockchain,用于过滤从 TON 区块链分配的礼物。
- 在类 Gift 中新增字段 personal_total_count 和 personal_remaining_count。
- 在类 Gift 和 UniqueGift 中新增字段 is_premium。
- 在类 GiftInfo 和 OwnedGiftRegular 中新增字段 is_upgrade_separate。
- 新增类 UniqueGiftColors,描述基于唯一礼物的用户名称、消息回复和链接预览的配色方案。
- 在类 Gift 中新增字段 has_colors。
- 在类 UniqueGift 中新增字段 colors。
- 新增类 GiftBackground,并在类 Gift 中新增字段 background。
- 在类 Gift 中新增字段 unique_gift_variant_count。
- 在类 GiftInfo 和 OwnedGiftRegular 中新增字段 unique_gift_number。
- 在类 AcceptedGiftTypes 中新增字段 gifts_from_channels。
其他
- 如果机器人拥有在 Fragment 上购买的其他有效用户名,可以停用其主用户名。
- 机器人可以在频道中停用权限 can_restrict_members。
- 新增方法 repostStory,机器人可以在其管理的不同商业账户之间转发动态。
- 新增类 UserRating,并在类 ChatFullInfo 中新增字段 rating。
- 付费媒体的最高价格提高到 25000 Telegram Stars。
- 在类 ChatFullInfo 中新增字段 paid_message_star_count。
- 在方法 forwardMessage 和 copyMessage 中新增参数 message_effect_id。
- 在类 ChatFullInfo 中新增字段 unique_gift_colors。
- 在类 ChecklistTask 中新增字段 completed_by_chat。
Bot API 9.2
新方法: approveSuggestedPost, declineSuggestedPost
清单
- 在类 ReplyParameters 中新增字段 checklist_task_id,机器人可以回复清单中的特定任务。
- 在类 Message 中新增字段 reply_to_checklist_task_id。
礼物
- 在类 Gift 和 UniqueGift 中新增字段 publisher_chat,可用于获取发布礼物的聊天的信息。
频道私信
- 在类 Chat 和 ChatFullInfo 中新增字段 is_direct_messages,可用于识别用作频道私信聊天的超级群组。
- 在类 ChatFullInfo 中新增字段 parent_chat,表示频道私信聊天所属的父频道。
- 新增类 DirectMessagesTopic,并在类 Message 中新增字段 direct_messages_topic,描述私信聊天中的话题。
- 在方法 sendMessage、sendPhoto、sendVideo、sendAnimation、sendAudio、sendDocument、sendPaidMedia、sendSticker、sendVideoNote、sendVoice、sendLocation、sendVenue、sendContact、sendDice、sendInvoice、sendMediaGroup、copyMessage、copyMessages、forwardMessage 和 forwardMessages 中新增参数 direct_messages_topic_id。该参数可用于向私信聊天话题发送消息。
投稿帖子
- 新增类 SuggestedPostParameters,并在方法 sendMessage、sendPhoto、sendVideo、sendAnimation、sendAudio、sendDocument、sendPaidMedia、sendSticker、sendVideoNote、sendVoice、sendLocation、sendVenue、sendContact、sendDice、sendInvoice、copyMessage、forwardMessage 中新增参数 suggested_post_parameters。该参数可用于向私信聊天话题发送投稿帖子。
- 新增方法 approveSuggestedPost,机器人可以批准收到的投稿帖子。
- 新增方法 declineSuggestedPost,机器人可以拒绝收到的投稿帖子。
- 在类 ChatMemberAdministrator 和 ChatAdministratorRights 中新增字段 can_manage_direct_messages。
- 在方法 promoteChatMember 中新增参数 can_manage_direct_messages。
- 在类 Message 中新增字段 is_paid_post,可用于识别付费帖子。此类帖子在 24 小时内不得删除,否则无法收到付款。
- 新增类 SuggestedPostPrice,描述投稿帖子的价格。
- 新增类 SuggestedPostInfo,并在类 Message 中新增字段 suggested_post_info,描述投稿帖子。
- 新增类 SuggestedPostApproved,并在类 Message 中新增字段 suggested_post_approved,描述投稿帖子获批的服务消息。
- 新增类 SuggestedPostApprovalFailed,并在类 Message 中新增字段 suggested_post_approval_failed,描述投稿帖子批准失败的服务消息。
- 新增类 SuggestedPostDeclined,并在类 Message 中新增字段 suggested_post_declined,描述投稿帖子被拒绝的服务消息。
- 新增类 SuggestedPostPaid,并在类 Message 中新增字段 suggested_post_paid,描述投稿帖子付款成功的服务消息。
- 新增类 SuggestedPostRefunded,并在类 Message 中新增字段 suggested_post_refunded,描述投稿帖子退款的服务消息。
Bot API 9.1
新方法: sendChecklist, editMessageChecklist, getMyStarBalance
清单
- 新增类 ChecklistTask,表示清单中的任务。
- 新增类 Checklist,表示清单。
- 新增类 InputChecklistTask,表示要添加到清单的任务。
- 新增类 InputChecklist,表示要创建的清单。
- 在类 Message 和 ExternalReplyInfo 中新增字段 checklist,描述消息中的清单。
- 新增类 ChecklistTasksDone,并在类 Message 中新增字段 checklist_tasks_done,描述清单任务状态变更(即标记为已完成/未完成)的服务消息。
- 新增类 ChecklistTasksAdded,并在类 Message 中新增字段 checklist_tasks_added,描述向清单添加新任务的服务消息。
- 新增方法 sendChecklist,机器人可以代表商业账户发送清单。
- 新增方法 editMessageChecklist,机器人可以代表商业账户编辑清单。
礼物
- 在类 OwnedGiftUnique 和 UniqueGiftInfo 中新增字段 next_transfer_date。
- 在类 UniqueGiftInfo 中新增字段 last_resale_star_count。
- 类 UniqueGiftInfo 的字段 origin 新增可能值 “resale”。
常规
- 投票选项的最大数量增加到 12 个。
- 新增方法 getMyStarBalance,机器人可以获取自己当前的 Telegram Stars 余额。
- 新增类 DirectMessagePriceChanged,并在类 Message 中新增字段 direct_message_price_changed,描述发送到频道的私信价格变更的服务消息。
- 在类 WebApp 中新增方法 hideKeyboard。
Bot API 9.0
新方法: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
商业账户
- 新增类 BusinessBotRights,并在类 BusinessConnection 中将字段 can_reply 替换为类型为 BusinessBotRights 的字段 rights。
- 新增方法 readBusinessMessage,机器人可以代表商业账户将收到的消息标记为已读。
- 新增方法 deleteBusinessMessages,机器人可以代表商业账户删除消息。
- 新增方法 setBusinessAccountName,机器人可以更改托管商业账户的名字和姓氏。
- 新增方法 setBusinessAccountUsername,机器人可以更改托管商业账户的用户名。
- 新增方法 setBusinessAccountBio,机器人可以更改托管商业账户的个人简介。
- 新增类 InputProfilePhoto,描述要设置的头像。
- 新增方法 setBusinessAccountProfilePhoto 和 removeBusinessAccountProfilePhoto,机器人可以更改托管商业账户的头像。
- 新增方法 setBusinessAccountGiftSettings,机器人可以更改托管商业账户中与接收礼物相关的隐私设置。
- 新增类 StarAmount 和方法 getBusinessAccountStarBalance,机器人可以查看托管商业账户当前的 Telegram Stars 余额。
- 新增方法 transferBusinessAccountStars,机器人可以将 Telegram Stars 从托管商业账户的余额转入自己的余额以便提现。
- 新增类 OwnedGiftRegular、OwnedGiftUnique、OwnedGifts 和方法 getBusinessAccountGifts,机器人可以获取托管商业账户拥有的礼物列表。
- 新增方法 convertGiftToStars,机器人可以将托管商业账户收到的礼物兑换为 Telegram Stars。
- 新增方法 upgradeGift,机器人可以将托管商业账户收到的普通礼物升级为唯一礼物。
- 新增方法 transferGift,机器人可以转让托管商业账户拥有的唯一礼物。
- 新增类 InputStoryContentPhoto 和 InputStoryContentVideo,表示要发布的动态内容。
- 新增类 StoryArea、StoryAreaPosition、LocationAddress、StoryAreaTypeLocation、StoryAreaTypeSuggestedReaction、StoryAreaTypeLink、StoryAreaTypeWeather 和 StoryAreaTypeUniqueGift,描述动态中可点击的活动区域。
- 新增方法 postStory,机器人可以代表托管商业账户发布动态。
- 新增方法 editStory,机器人可以编辑此前代表托管商业账户发布的动态。
- 新增方法 deleteStory,机器人可以删除此前代表托管商业账户发布的动态。
Mini App
- 新增字段 DeviceStorage,Mini App 可以在用户设备上使用持久化本地存储。
- 新增字段 SecureStorage,Mini App 可以在用户设备上使用安全本地存储保存敏感数据。
礼物
- 新增类 UniqueGiftModel、UniqueGiftSymbol、UniqueGiftBackdropColors 和 UniqueGiftBackdrop,用于描述唯一礼物的属性。
- 新增类 UniqueGift,描述已升级为唯一礼物的礼物。
- 新增类 AcceptedGiftTypes,描述用户或聊天接受的礼物类型。
- 在类 ChatFullInfo 中,将字段 can_send_gift 替换为类型为 AcceptedGiftTypes 的字段 accepted_gift_types。
- 新增类 GiftInfo,并在类 Message 中新增字段 gift,描述发送或收到普通礼物的服务消息。
- 新增类 UniqueGiftInfo,并在类 Message 中新增字段 unique_gift,描述发送或收到唯一礼物的服务消息。
Telegram Premium
- 新增方法 giftPremiumSubscription,机器人可以向用户赠送以 Telegram Stars 支付的 Telegram Premium 订阅。
- 在类 TransactionPartnerUser 中新增字段 premium_subscription_duration,用于涉及机器人购买的 Telegram Premium 订阅的交易。
- 在类 TransactionPartnerUser 中新增字段 transaction_type,便于区分和处理所有交易类型。
常规
- 付费媒体的最高价格提高到 10000 Telegram Stars。
- 订阅周期的最高价格提高到 10000 Telegram Stars。
- 新增类 PaidMessagePriceChanged,并在类 Message 中新增字段 paid_message_price_changed,描述发送到聊天的付费消息价格变更的服务消息。
- 在类 Message 中新增字段 paid_star_count,包含发送该消息所支付的 Telegram Stars 数量。
更早版本
Bot API 9.0 之前的版本仅列出发布日期,完整说明请查看官方更新日志。
- Bot API 8.3 — 2025年2月12日
- Bot API 8.2 — 2025年1月1日
- Bot API 8.1 — 2024年12月4日
- Bot API 8.0 — 2024年11月17日
- Bot API 7.11 — 2024年10月31日
- Bot API 7.10 — 2024年9月6日
- Bot API 7.9 — 2024年8月14日
- Bot API 7.8 — 2024年7月31日
- Bot API 7.7 — 2024年7月7日
- Bot API 7.6 — 2024年7月1日
- Bot API 7.5 — 2024年6月18日
- Bot API 7.4 — 2024年5月28日
- Bot API 7.3 — 2024年5月6日
- Bot API 7.2 — 2024年3月31日
- Bot API 7.1 — 2024年2月16日
- Bot API 7.0 — 2023年12月29日
- Bot API 6.9 — 2023年9月22日
- Bot API 6.8 — 2023年8月18日
- Bot API 6.7 — 2023年4月21日
- Bot API 6.6 — 2023年3月9日
- Bot API 6.5 — 2023年2月3日
- Bot API 6.4 — 2022年12月30日
- Bot API 6.3 — 2022年11月5日
- Bot API 6.2 — 2022年8月12日
- Bot API 6.1 — 2022年6月20日
- Bot API 6.0 — 2022年4月16日
- Bot API 5.7 — 2022年1月31日
- Bot API 5.6 — 2021年12月30日
- Bot API 5.5 — 2021年12月7日
- Bot API 5.4 — 2021年11月5日
- Bot API 5.3 — 2021年6月25日
- Bot API 5.2 — 2021年4月26日
- Bot API 5.1 — 2021年3月9日
- Bot API 5.0 — 2020年11月4日
- Bot API 4.9 — 2020年6月4日
- Bot API 4.8 — 2020年4月24日
- Bot API 4.7 — 2020年3月30日
- Bot API 4.6 — 2020年1月23日
- Bot API 4.5 — 2019年12月31日
- Bot API 4.4 — 2019年7月29日
- Bot API 4.3 — 2019年5月31日
- Bot API 4.2 — 2019年4月14日
- Bot API 4.1 — 2018年8月27日
- Bot API 4.0 — 2018年7月26日
- Bot API 3.6 — 2018年2月13日
- Bot API 3.5 — 2017年11月17日
- Bot API 3.4 — 2017年10月11日
- Bot API 3.3 — 2017年8月23日
- Bot API 3.2 — 2017年7月21日
- Bot API 3.1 — 2017年6月30日
- Bot API 3.0 — 2017年5月18日
- Bot API 2.3.1 — 2016年12月4日
- Bot API 2.3 — 2016年11月21日
- Bot API 2.2. — 2016年10月3日
- Bot API 2.1. — 2016年5月22日
- Bot API 2.0 — 2016年4月9日
常见问题
Telegram Bot API 的最新版本是什么?
Bot API 10.5,发布于 2026年11月22日,共有 194 个方法。
Telegram Bot API 多久更新一次?
Telegram 通常每一到两个月发布一个新的 Bot API 版本。每个版本都会新增方法和字段;部分版本还包含不兼容变更,会在说明中标注。
如何查看某个方法是在哪个版本中新增的?
在我们的方法参考中打开该方法:“版本历史”部分会显示新增该方法的版本以及修改过它的版本,并附有指向本页的链接。