История изменений Telegram Bot API
Все изменения Telegram Bot API от версии 9.0 (апрель 2025) до актуальной Bot API 10.5 (22 ноября 2026 г.), новые сверху. Названия методов ведут в наш справочник с параметрами и примерами, названия классов — в официальную документацию.
Bot API 10.5 Последняя
Новые методы: setMySettings
Настройки бота
- Добавлен метод setMySettings, позволяющий боту менять свои настройки: параметры инлайн-режима, режим приватности, возможность добавления в группы, режим тем в личных чатах и способ получения callback-запросов.
- Добавлена возможность получать callback-запросы от кнопок в сообщениях бота с полем inline_message_id вместо поля message в классе CallbackQuery — в зависимости от параметра callback_query_mode метода setMySettings.
- Боты могут показывать список тем в боковой панели личного чата с ботом — параметр has_topic_sidebar метода setMySettings.
- Класс BotFullInfo выделен из класса User, а метод getMe теперь возвращает BotFullInfo. Поля, которые возвращались только в getMe, удалены из класса User.
- В класс BotFullInfo добавлено поле active_usernames — список всех активных username бота.
- В класс BotFullInfo добавлено поле inline_query_placeholder — плейсхолдер бота для инлайн-запросов.
- В класс BotFullInfo добавлено поле needs_inline_query_location, показывающее, запрашивает ли бот геопозицию пользователя при каждом инлайн-запросе.
- В класс BotFullInfo добавлено поле has_topic_sidebar, показывающее, отображаются ли темы в личных чатах с ботом в боковой панели.
Общее
- Владелец бота может пригласить до 10 пользователей сразу в личный чат с ботом по ссылке
https://t.me/botinvite/<bot_username>. Бот может отправлять сообщения приглашённым пользователям. - В класс WriteAccessAllowed добавлено поле inviter для сервисных сообщений о пользователях, которых владелец бота пригласил в личный чат с ботом.
- В классах RichBlockExpandableBlockQuotation и InputRichBlockExpandableBlockQuotation поле text заменено полем blocks: сворачиваемые цитаты теперь могут содержать любые блоки.
Bot API 10.4
Новые методы: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
Виджеты
- Добавлен класс Widget, а в классы Message и ExternalReplyInfo — поле widget для сообщений с HTML-виджетами.
- Добавлен метод 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.
- Право can_send_other_messages в классах ChatPermissions и ChatMemberRestricted теперь разрешает и отправку виджетов.
Эфемерные сообщения
- Боты могут отправлять эфемерные ответы на callback-запросы в любом чате, кроме чатов личных сообщений каналов: для этого в параметре ephemeral_message_parameters указывается callback_query_id без receiver_user_id. Это работает в методах sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote и sendVoice.
- Поле receiver_user_id класса EphemeralMessageParameters и параметр chat_id перечисленных методов стали необязательными.
Цитаты из rich-сообщений
- В класс TextQuote добавлено поле rich_texts для цитат, выбранных из RichMessage.
- В класс ReplyParameters добавлено поле quote_rich_texts, позволяющее цитировать rich-сообщения.
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 своим ботам дополнительные username, оканчивающиеся на “agent”, “ai”, “app”, “game” или “gay”. Такие username можно предложить в поле suggested_username класса KeyboardButtonRequestManagedBot.
- Добавлен класс RichTextTonAddress, представляющий адрес в блокчейне TON в RichMessage.
- В класс 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
Rich-сообщения
- Добавлен класс RichMessageButton, представляющий кнопку в RichMessage.
- Добавлен класс RichTextButton.
- Добавлены классы RichBlockButtons и InputRichBlockButtons.
- В классы RichBlockTable и InputRichBlockTable добавлено поле is_compact.
- Добавлены классы RichBlockExpandableBlockQuotation и InputRichBlockExpandableBlockQuotation, представляющие цитату, которую можно развернуть и снова свернуть.
- Добавлены классы RichBlockDocument и InputRichBlockDocument, содержащие файл.
- В rich-сообщениях поддерживаются ссылки вида
tg://document?id=для загрузки произвольных файлов.
Эфемерные сообщения
- Добавлен класс EphemeralMessageParameters; параметры receiver_user_id и callback_query_id в методах sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation и sendVenue заменены параметром 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 и поле stopped_message_generation в классе Update.
- Добавлен класс CommunityChatJoined, а в класс Message — поле community_chat_joined для сервисных сообщений о вступлении в чат из сообщества.
- В класс UniqueGiftInfo добавлены поля text, entities и is_private.
Bot API 10.2
Новые методы: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
Rich-сообщения
- Добавлен класс InputRichMessageMedia, а в класс InputRichMessage — поле media: при отправке rich-сообщения бот может явно указать медиа, используемые в разметке 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, представляющие разные типы блоков для форматирования исходящего rich-сообщения.
- В класс InputRichMessage добавлено поле blocks, позволяющее задавать разметку rich-сообщения блоками.
Эфемерные сообщения
- Добавлена поддержка эфемерных сообщений: боты могут отправлять в группах сообщения и получать команды, которые видят только конкретный пользователь и бот.
- В класс 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, позволяющее отвечать на эфемерные сообщения.
- Поле message_id в классе ReplyParameters стало необязательным, если указано поле ephemeral_message_id.
- Добавлены методы editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption и editEphemeralMessageReplyMarkup для редактирования эфемерных сообщений.
- Добавлен метод deleteEphemeralMessage для удаления эфемерных сообщений.
Сообщества
- Добавлена начальная поддержка сообществ — нескольких супергрупп, каналов и ботов, объединённых общей темой или аудиторией.
- Добавлен класс Community, представляющий сообщество.
- Добавлен класс CommunityChatAdded, а в класс Message — поле community_chat_added.
- Добавлен класс CommunityChatRemoved, а в класс Message — поле community_chat_removed.
- В класс ChatFullInfo добавлено поле community.
Общее
- Добавлены апдейты об изменении платной подписки пользователя: класс BotSubscriptionUpdated и поле subscription в классе Update.
- Усилена безопасность Mini Apps: методы Mini App больше нельзя вызывать с origin, отличного от исходного домена Mini App. Защита автоматически включится для всех Mini Apps 20 июля 2026 года. Отключить её можно в Mini App @BotFather; в этом случае бот сам отвечает за то, чтобы в Mini App не было ссылок на недоверенные сайты.
Bot API 10.1
Новые методы: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
Rich-сообщения
- Добавлена поддержка rich-сообщений: боты могут отправлять сложно структурированный текст и стримить ответы ИИ с полноценным форматированием.
- Добавлены классы 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, представляющие разные типы блоков в rich-сообщении.
- Добавлен класс RichBlock, представляющий блок в rich-сообщении.
- Добавлен класс RichMessage, представляющий rich-сообщение.
- В класс Message добавлено поле rich_message.
- Добавлен класс InputRichMessage, описывающий rich-сообщение для отправки.
- Добавлен класс InputRichMessageContent; его можно использовать как InputMessageContent в результатах инлайн-, гостевых и Web App-запросов.
- Добавлен метод sendRichMessage для отправки rich-сообщений.
- Добавлен метод sendRichMessageDraft для потоковой отправки частичных rich-сообщений.
- В метод editMessageText добавлен параметр rich_message, позволяющий редактировать rich-сообщения.
Запросы по заявкам на вступление
- В класс 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
Гостевой режим
- Добавлена поддержка гостевого режима: боты могут получать определённые сообщения и отвечать на них в чатах, участниками которых не являются.
- В класс 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.
Live-фото
- Добавлен класс LivePhoto, представляющий фото с коротким видео.
- Добавлен класс InputMediaLivePhoto.
- В классы Message и ExternalReplyInfo добавлено поле live_photo.
- Добавлен метод sendLivePhoto для отправки live-фото.
- Добавлен класс PaidMediaLivePhoto, описывающий платное медиа с live-фото.
- Добавлен класс InputPaidMediaLivePhoto, позволяющий отправлять live-фото как платное медиа.
- Live-фото можно использовать в sendMediaGroup и editMessageMedia.
Общее
- Бизнес-боты могут управлять аккаунтами пользователей без подписки Telegram Premium.
- Боты могут писать другим ботам по username, если у обоих включено общение «бот — бот».
- Бизнес-бот может отвечать другим ботам, если у него включено общение «бот — бот».
- В методе 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.
- Добавлены апдейты о создании управляемых ботов и смене их токена: класс ManagedBotUpdated и поле managed_bot в классе Update.
- Добавлены методы getManagedBotToken и replaceManagedBotToken.
- Добавлены класс PreparedKeyboardButton и метод savePreparedKeyboardButton, позволяющие запрашивать пользователей, чаты и управляемых ботов из Mini Apps.
- В класс 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.
- Сущности “date_time” разрешены в заголовке чек-листа, тексте задачи чек-листа, в TextQuote, в цитате ReplyParameters, а также в sendGift и giftPremiumSubscription.
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.
- Боты могут запретить пользователям создавать и удалять темы в личных чатах — это новая настройка в Mini App @BotFather.
- В класс 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_thread_id и is_topic_message класса Message поддерживаются для сообщений в личных чатах с включённым режимом тем.
- Параметр message_thread_id поддерживается в личных чатах с темами в методах 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 — бот может управлять темами в личных чатах.
- В классы 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.
- Добавлено возможное значение “gifted_upgrade” поля UniqueGiftInfo.origin для сообщений об улучшении подарка, оплаченном после его отправки.
- Добавлено возможное значение “offer” поля UniqueGiftInfo.origin для сообщений о покупке подарка через предложение о покупке.
- В класс 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.
Прочее
- Боты могут отключить основной username, если у них есть дополнительные активные username, купленные на 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.
- Добавлено возможное значение “resale” поля origin в классе UniqueGiftInfo.
Общее
- Максимальное число вариантов ответа в опросе увеличено до 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 заменено полем rights типа BusinessBotRights.
- Добавлен метод readBusinessMessage, позволяющий отмечать входящие сообщения как прочитанные от имени бизнес-аккаунта.
- Добавлен метод deleteBusinessMessages, позволяющий удалять сообщения от имени бизнес-аккаунта.
- Добавлен метод setBusinessAccountName, позволяющий менять имя и фамилию управляемого бизнес-аккаунта.
- Добавлен метод setBusinessAccountUsername, позволяющий менять username управляемого бизнес-аккаунта.
- Добавлен метод setBusinessAccountBio, позволяющий менять описание (bio) управляемого бизнес-аккаунта.
- Добавлен класс 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 Apps
- Добавлено поле DeviceStorage, позволяющее Mini Apps использовать постоянное локальное хранилище на устройстве пользователя.
- Добавлено поле SecureStorage, позволяющее Mini Apps хранить конфиденциальные данные в защищённом локальном хранилище на устройстве пользователя.
Подарки
- Добавлены классы UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors и UniqueGiftBackdrop, описывающие свойства уникального подарка.
- Добавлен класс UniqueGift, описывающий подарок, улучшенный до уникального.
- Добавлен класс AcceptedGiftTypes, описывающий типы подарков, которые принимает пользователь или чат.
- В классе ChatFullInfo поле can_send_gift заменено полем accepted_gift_types типа AcceptedGiftTypes.
- Добавлен класс GiftInfo, а в класс Message — поле gift для сервисного сообщения об отправленном или полученном обычном подарке.
- Добавлен класс UniqueGiftInfo, а в класс Message — поле unique_gift для сервисного сообщения об отправленном или полученном уникальном подарке.
Telegram Premium
- Добавлен метод giftPremiumSubscription, позволяющий подарить пользователю подписку Telegram Premium с оплатой в Telegram Stars.
- В класс 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 приведены с датами. Их полные описания — в официальном changelog.
- Bot API 8.3 — 12 февраля 2025 г.
- Bot API 8.2 — 1 января 2025 г.
- Bot API 8.1 — 4 декабря 2024 г.
- Bot API 8.0 — 17 ноября 2024 г.
- Bot API 7.11 — 31 октября 2024 г.
- Bot API 7.10 — 6 сентября 2024 г.
- Bot API 7.9 — 14 августа 2024 г.
- Bot API 7.8 — 31 июля 2024 г.
- Bot API 7.7 — 7 июля 2024 г.
- Bot API 7.6 — 1 июля 2024 г.
- Bot API 7.5 — 18 июня 2024 г.
- Bot API 7.4 — 28 мая 2024 г.
- Bot API 7.3 — 6 мая 2024 г.
- Bot API 7.2 — 31 марта 2024 г.
- Bot API 7.1 — 16 февраля 2024 г.
- Bot API 7.0 — 29 декабря 2023 г.
- Bot API 6.9 — 22 сентября 2023 г.
- Bot API 6.8 — 18 августа 2023 г.
- Bot API 6.7 — 21 апреля 2023 г.
- Bot API 6.6 — 9 марта 2023 г.
- Bot API 6.5 — 3 февраля 2023 г.
- Bot API 6.4 — 30 декабря 2022 г.
- Bot API 6.3 — 5 ноября 2022 г.
- Bot API 6.2 — 12 августа 2022 г.
- Bot API 6.1 — 20 июня 2022 г.
- Bot API 6.0 — 16 апреля 2022 г.
- Bot API 5.7 — 31 января 2022 г.
- Bot API 5.6 — 30 декабря 2021 г.
- Bot API 5.5 — 7 декабря 2021 г.
- Bot API 5.4 — 5 ноября 2021 г.
- Bot API 5.3 — 25 июня 2021 г.
- Bot API 5.2 — 26 апреля 2021 г.
- Bot API 5.1 — 9 марта 2021 г.
- Bot API 5.0 — 4 ноября 2020 г.
- Bot API 4.9 — 4 июня 2020 г.
- Bot API 4.8 — 24 апреля 2020 г.
- Bot API 4.7 — 30 марта 2020 г.
- Bot API 4.6 — 23 января 2020 г.
- Bot API 4.5 — 31 декабря 2019 г.
- Bot API 4.4 — 29 июля 2019 г.
- Bot API 4.3 — 31 мая 2019 г.
- Bot API 4.2 — 14 апреля 2019 г.
- Bot API 4.1 — 27 августа 2018 г.
- Bot API 4.0 — 26 июля 2018 г.
- Bot API 3.6 — 13 февраля 2018 г.
- Bot API 3.5 — 17 ноября 2017 г.
- Bot API 3.4 — 11 октября 2017 г.
- Bot API 3.3 — 23 августа 2017 г.
- Bot API 3.2 — 21 июля 2017 г.
- Bot API 3.1 — 30 июня 2017 г.
- Bot API 3.0 — 18 мая 2017 г.
- Bot API 2.3.1 — 4 декабря 2016 г.
- Bot API 2.3 — 21 ноября 2016 г.
- Bot API 2.2. — 3 октября 2016 г.
- Bot API 2.1. — 22 мая 2016 г.
- Bot API 2.0 — 9 апреля 2016 г.
Частые вопросы
Какая последняя версия Telegram Bot API?
Bot API 10.5, вышла 22 ноября 2026 г.. В ней 194 методов.
Как часто меняется Telegram Bot API?
Обычно Telegram выпускает новую версию Bot API раз в один-два месяца. Каждый релиз добавляет методы и поля; некоторые релизы содержат и ломающие изменения — они отмечены в описаниях.
Как узнать, когда появился метод?
Откройте метод в нашем справочнике: в разделе «История версий» указан релиз, в котором он появился, и релизы, в которых он менялся, со ссылками на эту страницу.