Історія змін Telegram Bot API
Усі зміни Telegram Bot API від версії 9.0 (квітень 2025) до поточної Bot API 10.5 (22 листопада 2026 р.), від найновіших. Назви методів ведуть на наш довідник із параметрами й прикладами, назви класів — на офіційну документацію.
Bot API 10.5 Остання
Нові методи: setMySettings
Налаштування бота
- Додано метод setMySettings, що дає змогу ботам змінювати свої налаштування: inline-режим, режим конфіденційності, можливість додавання до груп, режим тем форуму в приватних чатах і режим отримання callback-запитів.
- Додано можливість отримувати callback-запити від кнопок у повідомленнях, надісланих ботом, із полем inline_message_id замість поля message у класі CallbackQuery — залежно від параметра callback_query_mode методу setMySettings.
- Додано можливість показувати список тем на бічній панелі в приватних чатах із ботом за допомогою параметра has_topic_sidebar методу setMySettings.
- Клас BotFullInfo виокремлено з класу User, а тип значення, що повертає метод getMe, змінено на BotFullInfo. Поля, які поверталися лише в getMe, вилучено з класу User.
- Додано поле active_usernames до класу BotFullInfo, що дає змогу боту отримати список усіх своїх активних юзернеймів.
- Додано поле inline_query_placeholder до класу BotFullInfo, що дає змогу боту отримати свій плейсхолдер для inline-запитів.
- Додано поле needs_inline_query_location до класу BotFullInfo, що дає змогу боту перевірити, чи запитує він геолокацію користувача з кожним inline-запитом.
- Додано поле has_topic_sidebar до класу BotFullInfo, що дає змогу боту перевірити, чи показуються теми в приватних чатах із ботом на бічній панелі.
Загальне
- Власники ботів тепер можуть запрошувати до 10 користувачів одночасно в приватні чати з ботом за посиланням
https://t.me/botinvite/<bot_username>. Бот може надсилати повідомлення запрошеним користувачам. - Додано поле inviter до класу WriteAccessAllowed для службових повідомлень про користувачів, яких власник бота запросив у приватний чат із ботом.
- Поле text замінено полем blocks у класах RichBlockExpandableBlockQuotation і InputRichBlockExpandableBlockQuotation, тож розгортувані цитати можуть містити довільні блоки.
Bot API 10.4
Нові методи: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
Віджети
- Додано клас Widget і поле widget до класів Message і ExternalReplyInfo для повідомлень з HTML-віджетами.
- Додано метод sendWidget, що дає змогу ботам надсилати повідомлення з HTML-віджетами. Наразі в робочому середовищі віджети можна надсилати лише в приватні чати, а надіслані віджети автоматично мають захищений вміст, тому їх не можна пересилати.
- Додано метод sendSharedWidget, що дає змогу ботам повторно надсилати створені ними спільні віджети.
- Додано клас WidgetQuery і поле widget_query до класу Update для запитів, які віджети надсилають боту з повідомлень, надісланих ботом або через бота.
- Додано клас SharedWidgetQuery і поле shared_widget_query до класу Update для запитів, що надходять боту з пересланих повідомлень зі спільними віджетами.
- Додано класи WidgetQueryType, WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction і WidgetQueryWallet, що описують тип запиту від віджета. Запит може містити дані для бота разом із карткою TON-гаманця користувача, дані, підписані TON-гаманцем користувача, або сповіщення про транзакцію, надіслану з TON-гаманця користувача.
- Додано метод answerWidgetQuery, що дає змогу ботам відповідати на запити від віджетів.
- Додано метод editMessageWidgetData, що дає змогу ботам змінювати дані віджета в повідомленні.
- Додано метод editSharedWidgetData, що дає змогу ботам змінювати публічні дані спільного віджета.
- Додано класи InputWidgetMessageContent і InputSharedWidgetMessageContent, що дають змогу ботам надсилати віджети у відповідь на inline-запити. Наразі в робочому середовищі віджети не можна надсилати у відповідь на inline-запити.
- Повідомлення з віджетами не можна копіювати методами copyMessage і copyMessages.
- Право can_send_other_messages у класах ChatPermissions і ChatMemberRestricted тепер також дозволяє надсилати віджети.
Ефемерні повідомлення
- Боти тепер можуть надсилати ефемерні відповіді на callback-запити в будь-якому чаті, крім чатів особистих повідомлень каналу, якщо вказати callback_query_id без receiver_user_id у параметрі ephemeral_message_parameters методів sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote і sendVoice.
- Поле receiver_user_id класу EphemeralMessageParameters і параметр chat_id зазначених методів тепер необов’язкові.
Цитати з rich-повідомлень
- Додано поле rich_texts до класу TextQuote для цитат, вибраних із RichMessage.
- Додано поле quote_rich_texts до класу ReplyParameters, що дає змогу ботам цитувати rich-повідомлення.
TON-гаманець
- Додано класи TonWalletCard, TonWalletCardSticker, TonNft і TonNftAttribute, а також поле ton_wallet_card до класу ChatFullInfo.
- Додано клас TonWalletTransfer і поле ton_wallet_transfer до класу Message для службових повідомлень про перекази з TON-гаманцем.
- Клас StoryAreaPosition перейменовано на AreaPosition, оскільки тепер він також описує розташування стікерів на картках TON-гаманця.
Теми поширення чату
- Додано класи ChatShareTheme, ChatShareThemeEmoji і ChatShareThemeUniqueGift, а також поле share_theme до класу ChatFullInfo, що описують тему екрана поширення посилання на користувача або чат.
- Додано класи EmojiType, EmojiTypeEmoji і EmojiTypeCustomEmoji.
- Додано класи ChatShareThemeBackdrop і ChatShareThemeBackdrops та метод getChatShareThemeBackdrops.
Подарунки
- Додано метод getUniqueGift, що дає змогу ботам отримати інформацію про унікальний подарунок за його назвою.
- Додано метод deleteBusinessAccountGift, що дає змогу ботам видаляти звичайні подарунки керованого бізнес-акаунта без отримання за них Telegram Stars.
Загальне
- Користувачі з підпискою Telegram Premium тепер можуть призначати до 2 своїх ботів додаткові юзернейми із закінченням «agent», «ai», «app», «game» або «gay». Такі юзернейми можна запропонувати в полі suggested_username класу KeyboardButtonRequestManagedBot.
- Додано клас RichTextTonAddress, що представляє адресу в блокчейні TON у RichMessage.
- Додано тип «ton_address» до класу MessageEntity для адрес у блокчейні TON.
- Додано тип «bank_card_number» до класу MessageEntity для номерів банківських карток.
- Додано параметри custom_description_parse_mode і custom_description_entities до методів verifyUser і verifyChat.
- Додано клас PaidMessagesWaived і поле paid_messages_waived до класу Message для службових повідомлень про те, що відправник скористався посиланням, яке дає змогу надсилати повідомлення без оплати в Telegram Stars.
- Додано можливість створювати посилання на теми в приватних чатах із ботом у форматі
https://t.me/<bot_username>/<message_thread_id>. Таке посилання відкриває тему лише для того користувача, у приватному чаті з яким ця тема існує.
Bot API 10.3
Rich-повідомлення
- Додано клас RichMessageButton, що представляє кнопку в RichMessage.
- Додано клас RichTextButton.
- Додано класи RichBlockButtons і InputRichBlockButtons.
- Додано поле is_compact до класів RichBlockTable і InputRichBlockTable.
- Додано класи RichBlockExpandableBlockQuotation і InputRichBlockExpandableBlockQuotation, що представляють блокову цитату, яку можна розгорнути й знову згорнути.
- Додано класи RichBlockDocument і InputRichBlockDocument, що містять файл.
- Додано підтримку посилань виду
tg://document?id=для завантаження довільних файлів у rich-повідомленнях.
Ефемерні повідомлення
- Додано клас EphemeralMessageParameters; параметри receiver_user_id і callback_query_id у методах sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation і sendVenue замінено параметром ephemeral_message_parameters.
- Додано параметр ephemeral_message_parameters до методу sendRichMessage.
- Додано поле replace_callback_query_message до класу EphemeralMessageParameters, що дає змогу ботам показувати ефемерне повідомлення замість початкового.
- Додано підтримку завантаження нових файлів у editEphemeralMessageMedia.
- Додано параметр show_caption_above_media до методу editEphemeralMessageCaption.
- Додано параметр rich_message до методу editEphemeralMessageText.
- Додано поле can_send_welcome_messages до класів ChatAdministratorRights і ChatMemberAdministrator.
- Додано параметр can_send_welcome_messages до методу promoteChatMember.
Клавіатури та кнопки
- Додано клас DisabledButton і поле disabled до класу InlineKeyboardButton.
- Додано поле force_reply до класів InlineKeyboardMarkup і ReplyKeyboardMarkup.
Загальне
- Додано параметри can_stop і keep_on_stop до методів sendMessageDraft і sendRichMessageDraft.
- Додано оновлення про те, що користувач зупинив генерацію повідомлення, — клас MessageGenerationStopped і поле stopped_message_generation у класі Update.
- Додано клас CommunityChatJoined і поле community_chat_joined до класу Message для службових повідомлень про вступ до чату зі спільноти.
- Додано поля text, entities і is_private до класу UniqueGiftInfo.
Bot API 10.2
Нові методи: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
Rich-повідомлення
- Додано клас InputRichMessageMedia і поле media до класу InputRichMessage, що дає змогу ботам явно вказувати медіа, використані у форматуванні markdown або html, під час надсилання rich-повідомлення.
- Додано клас InputMediaVoiceNote, що представляє голосове повідомлення для надсилання.
- Додано клас InputRichBlockListItem, що представляє елемент списку для надсилання.
- Додано класи InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote і InputRichBlockThinking, що представляють різні типи блоків для форматування вихідного rich-повідомлення.
- Додано поле blocks до класу InputRichMessage, що дає змогу ботам задавати форматування rich-повідомлення через блокові сутності.
Ефемерні повідомлення
- Додано підтримку ефемерних повідомлень: боти можуть надсилати в групах повідомлення й отримувати команди, які бачать лише конкретний користувач і бот.
- Додано поле is_ephemeral до класу BotCommand.
- Додано поле receiver_user до класу Message.
- Додано поле ephemeral_message_id до класу Message.
- Додано параметри receiver_user_id і callback_query_id до методів sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue.
- Додано поле ephemeral_message_id до класу ReplyParameters, що дає змогу ботам відповідати на ефемерні повідомлення.
- Поле message_id у класі ReplyParameters позначено як необов’язкове, якщо присутнє поле ephemeral_message_id.
- Додано методи editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption і editEphemeralMessageReplyMarkup, що дають змогу ботам редагувати ефемерні повідомлення.
- Додано метод deleteEphemeralMessage, що дає змогу ботам видаляти ефемерні повідомлення.
Спільноти
- Додано початкову підтримку спільнот — кількох супергруп, каналів і ботів, об’єднаних спільною темою або аудиторією.
- Додано клас Community, що представляє спільноту.
- Додано клас CommunityChatAdded і поле community_chat_added до класу Message.
- Додано клас CommunityChatRemoved і поле community_chat_removed до класу Message.
- Додано поле community до класу ChatFullInfo.
Загальне
- Додано оновлення про зміни платної підписки користувача — клас BotSubscriptionUpdated і поле subscription у класі Update.
- Посилено безпеку Mini App: методи Mini App більше не можна викликати з джерел (origin), відмінних від початкового домену Mini App. Захист буде автоматично ввімкнено для всіх Mini App 20 липня 2026 року. Відмовитися від захисту можна в Mini App @BotFather. У такому разі ви визнаєте, що бот сам відповідає за те, щоб Mini App не містив посилань на ненадійні сайти.
Bot API 10.1
Нові методи: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
Rich-повідомлення
- Додано підтримку 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, що представляють різні типи форматованого rich-тексту.
- Додано клас RichText, що представляє форматований rich-текст.
- Додано клас RichBlockCaption, що представляє підпис до форматованого rich-тексту.
- Додано клас 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-повідомлення.
- Додано поле rich_message до класу Message.
- Додано клас InputRichMessage, що описує rich-повідомлення для надсилання.
- Додано клас InputRichMessageContent; його можна використовувати як InputMessageContent у результатах inline-, гостьових і Web App-запитів.
- Додано метод sendRichMessage, що дає змогу ботам надсилати rich-повідомлення.
- Додано метод sendRichMessageDraft, що дає змогу ботам транслювати rich-повідомлення частинами.
- Додано параметр rich_message до методу editMessageText, що дає змогу ботам редагувати rich-повідомлення.
Запити на вступ
- Додано поле supports_join_request_queries до класу User.
- Додано поле guard_bot до класу ChatFullInfo.
- Додано поле query_id до класу ChatJoinRequest.
- Додано метод answerChatJoinRequestQuery.
- Додано метод sendChatJoinRequestWebApp.
Опитування
- Додано клас Link і поле link до класу PollMedia.
- Додано клас InputMediaLink; його можна використовувати як InputPollOptionMedia.
Bot API 10.0
Нові методи: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
Гостьовий режим
- Додано підтримку гостьового режиму: боти можуть отримувати певні повідомлення й відповідати на них у чатах, учасниками яких вони не є.
- Додано поле supports_guest_queries до класу User.
- Додано поля guest_bot_caller_user і guest_bot_caller_chat до класу Message.
- Додано поле guest_query_id до класу Message.
- Додано поле guest_message до класу Update.
- Додано клас SentGuestMessage і метод answerGuestQuery.
Керування чатами
- Додано поле can_react_to_messages до класів ChatMemberRestricted і ChatPermissions.
- Додано параметр return_bots до методу getChatAdministrators.
- Додано метод deleteAllMessageReactions.
- Додано метод deleteMessageReaction.
- Додано можливість бачити в групах певні повідомлення, надіслані іншими ботами.
Опитування
- Додано класи InputMediaSticker, InputMediaLocation і InputMediaVenue.
- Додано клас PollMedia, що представляє медіа в опитуванні.
- Додано поле media до класу Poll, що дає змогу ботам бачити медіа в опитуваннях.
- Додано поле explanation_media до класу Poll, що дає змогу ботам бачити медіа в поясненнях до вікторин.
- Додано поле media до класу PollOption, що дає змогу ботам бачити медіа у варіантах відповіді.
- Додано клас InputPollMedia і параметри media та explanation_media до методу sendPoll, що дає змогу ботам додавати медіа до опитувань.
- Додано клас InputPollOptionMedia і поле media до класу InputPollOption, що дає змогу ботам додавати медіа до варіантів відповіді.
- Додано поле members_only до класу Poll.
- Додано параметр members_only до методу sendPoll.
- Додано поле country_codes до класу Poll.
- Додано параметр country_codes до методу sendPoll.
- Мінімальну кількість варіантів відповіді в опитуванні зменшено з 2 до 1.
Живі фото
- Додано клас LivePhoto, що представляє фото з коротким відео.
- Додано клас InputMediaLivePhoto.
- Додано поле live_photo до класів Message і ExternalReplyInfo.
- Додано метод sendLivePhoto, що дає змогу ботам надсилати живі фото.
- Додано клас PaidMediaLivePhoto, що описує платне медіа з живим фото.
- Додано клас InputPaidMediaLivePhoto, що дає змогу ботам надсилати живі фото як платне медіа.
- Живі фото тепер можна використовувати в sendMediaGroup і editMessageMedia.
Загальне
- Бізнес-боти тепер можуть керувати акаунтами користувачів без підписки Telegram Premium.
- Додано можливість надсилати повідомлення іншим ботам за юзернеймом, якщо обидва боти ввімкнули взаємодію між ботами.
- Додано можливість відповідати іншим ботам від імені бізнес-бота, якщо бізнес-бот увімкнув взаємодію між ботами.
- Боти тепер можуть передавати порожній текст у метод sendMessageDraft.
- Додано клас BotAccessSettings і метод getManagedBotAccessSettings.
- Додано метод setManagedBotAccessSettings.
- Додано метод getUserPersonalChatMessages.
Bot API 9.6
Нові методи: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
Керовані боти
- Додано поле can_manage_bots до класу User.
- Додано клас KeyboardButtonRequestManagedBot і поле request_managed_bot до класу KeyboardButton.
- Додано клас ManagedBotCreated і поле managed_bot_created до класу Message.
- Додано оновлення про створення керованих ботів і зміну їхнього токена — клас ManagedBotUpdated і поле managed_bot у класі Update.
- Додано методи getManagedBotToken і replaceManagedBotToken.
- Додано клас PreparedKeyboardButton і метод savePreparedKeyboardButton, що дають змогу ботам запитувати користувачів, чати й керованих ботів із Mini App.
- Додано метод requestChat до класу WebApp.
- Додано підтримку посилань
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}], що дають змогу ботам запитувати створення керованого бота за посиланням.
Опитування
- Додано підтримку вікторин із кількома правильними відповідями.
- Поле correct_option_id замінено полем correct_option_ids у класі Poll.
- Параметр correct_option_id замінено параметром correct_option_ids у методі sendPoll.
- Тепер можна передавати allows_multiple_answers для вікторин у методі sendPoll.
- Максимальний час до автоматичного закриття опитування збільшено до 2628000 секунд.
- Додано поле allows_revoting до класу Poll.
- Додано параметр allows_revoting до методу sendPoll.
- Додано параметр shuffle_options до методу sendPoll.
- Додано параметр allow_adding_options до методу sendPoll.
- Додано параметр hide_results_until_closes до методу sendPoll.
- Додано поля description і description_entities до класу Poll.
- Додано параметри description, description_parse_mode і description_entities до методу sendPoll.
- Додано поле persistent_id до класу PollOption — постійний ідентифікатор варіанта відповіді.
- Додано поле option_persistent_ids до класу PollAnswer.
- Додано поля added_by_user і added_by_chat до класу PollOption, що вказують користувача й чат, які додали варіант відповіді.
- Додано поле addition_date до класу PollOption — дата додавання варіанта відповіді.
- Додано клас PollOptionAdded і поле poll_option_added до класу Message.
- Додано клас PollOptionDeleted і поле poll_option_deleted до класу Message.
- Додано поле poll_option_id до класу ReplyParameters, що дає змогу ботам відповідати на конкретний варіант відповіді в опитуванні.
- Додано поле reply_to_poll_option_id до класу Message.
- Сутності «date_time» тепер дозволені в заголовку чек-листа, тексті завдання чек-листа, TextQuote, цитаті ReplyParameters, sendGift і giftPremiumSubscription.
Bot API 9.5
Нові методи: setChatMemberTag
- Додано тип MessageEntity «date_time», що дає змогу ботам показувати користувачу відформатовані дату й час.
- Метод sendMessageDraft тепер доступний усім ботам.
- Додано поле tag до класів ChatMemberMember і ChatMemberRestricted.
- Додано метод setChatMemberTag.
- Додано поле can_edit_tag до класів ChatMemberRestricted і ChatPermissions.
- Додано поле can_manage_tags до класів ChatMemberAdministrator і ChatAdministratorRights.
- Додано параметр can_manage_tags до методу promoteChatMember.
- Додано поле sender_tag до класу Message.
- Додано поле iconCustomEmojiId до класу BottomButton.
Bot API 9.4
Нові методи: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- Боти тепер можуть використовувати кастомні емодзі в повідомленнях, які бот надсилає безпосередньо в приватні чати, групи й супергрупи, якщо власник бота має підписку Telegram Premium.
- Боти тепер можуть створювати теми в приватних чатах методом createForumTopic.
- Боти тепер можуть заборонити користувачам створювати й видаляти теми в приватних чатах за допомогою нового налаштування в Mini App @BotFather.
- Додано поле allows_users_to_create_topics до класу User.
- Додано поле icon_custom_emoji_id до класів KeyboardButton і InlineKeyboardButton, що дає змогу ботам показувати кастомні емодзі на кнопках, якщо вони можуть використовувати кастомні емодзі в повідомленні.
- Додано поле style до класів KeyboardButton і InlineKeyboardButton, що дає змогу ботам змінювати колір кнопок.
- Додано клас ChatOwnerLeft і поле chat_owner_left до класу Message.
- Додано клас ChatOwnerChanged і поле chat_owner_changed до класу Message.
- Додано методи setMyProfilePhoto і removeMyProfilePhoto, що дають змогу ботам керувати своїм фото профілю.
- Додано клас VideoQuality і поле qualities до класу Video, що дає змогу ботам отримувати інформацію про інші доступні якості відео.
- Додано поле first_profile_audio до класу ChatFullInfo.
- Додано клас UserProfileAudios і метод getUserProfileAudios, що дають змогу ботам отримати список аудіо, доданих до профілю користувача.
- Додано поле rarity до класу UniqueGiftModel.
- Додано поле is_burned до класу UniqueGift.
Bot API 9.3
Нові методи: sendMessageDraft, getUserGifts, getChatGifts, repostStory
Теми в приватних чатах
- Додано поле has_topics_enabled до класу User, за яким можна визначити, чи ввімкнено для бота режим тем форуму в приватних чатах.
- Додано метод 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, що дає змогу ботам керувати темами в приватних чатах.
- Додано поле is_name_implicit до класів ForumTopic і ForumTopicCreated.
Подарунки
- Додано методи getUserGifts і getChatGifts.
- Поле last_resale_star_count замінено полями last_resale_currency і last_resale_amount у класі UniqueGiftInfo.
- Параметр exclude_limited замінено параметрами exclude_limited_upgradable і exclude_limited_non_upgradable у методі getBusinessAccountGifts.
- Додано значення «gifted_upgrade» як можливе значення UniqueGiftInfo.origin для повідомлень про покращення подарунка, оплачене після його надсилання.
- Додано значення «offer» як можливе значення UniqueGiftInfo.origin для повідомлень про купівлю подарунка через пропозицію купівлі.
- Додано поле gift_upgrade_sent до класу Message.
- Додано поле gift_id до класу UniqueGift.
- Додано поле is_from_blockchain до класу UniqueGift.
- Додано параметр exclude_from_blockchain до методу getBusinessAccountGifts, щоб відфільтровувати подарунки, призначені з блокчейну TON.
- Додано поля personal_total_count і personal_remaining_count до класу Gift.
- Додано поле is_premium до класів Gift і UniqueGift.
- Додано поле is_upgrade_separate до класів GiftInfo і OwnedGiftRegular.
- Додано клас UniqueGiftColors, що описує колірну схему імені користувача, відповідей на повідомлення та попереднього перегляду посилань на основі унікального подарунка.
- Додано поле has_colors до класу Gift.
- Додано поле colors до класу UniqueGift.
- Додано клас GiftBackground і поле background до класу Gift.
- Додано поле unique_gift_variant_count до класу Gift.
- Додано поле unique_gift_number до класів GiftInfo і OwnedGiftRegular.
- Додано поле gifts_from_channels до класу AcceptedGiftTypes.
Інше
- Боти тепер можуть вимкнути основний юзернейм, якщо мають додаткові активні юзернейми, придбані на Fragment.
- Боти тепер можуть вимкнути право can_restrict_members у каналах.
- Додано метод repostStory, що дає змогу ботам репостити історії між різними бізнес-акаунтами, якими вони керують.
- Додано клас UserRating і поле rating до класу ChatFullInfo.
- Максимальну ціну платного медіа збільшено до 25000 Telegram Stars.
- Додано поле paid_message_star_count до класу ChatFullInfo.
- Додано параметр message_effect_id до методів forwardMessage і copyMessage.
- Додано поле unique_gift_colors до класу ChatFullInfo.
- Додано поле completed_by_chat до класу ChecklistTask.
Bot API 9.2
Нові методи: approveSuggestedPost, declineSuggestedPost
Чек-листи
- Додано поле checklist_task_id до класу ReplyParameters, що дає змогу ботам відповідати на конкретне завдання чек-листа.
- Додано поле reply_to_checklist_task_id до класу Message.
Подарунки
- Додано поле publisher_chat до класів Gift і UniqueGift, за яким можна отримати інформацію про чат, що опублікував подарунок.
Особисті повідомлення в каналах
- Додано поле is_direct_messages до класів Chat і ChatFullInfo, за яким можна визначити супергрупи, що слугують чатами особистих повідомлень каналу.
- Додано поле parent_chat до класу ChatFullInfo, що вказує батьківський канал для чату особистих повідомлень каналу.
- Додано клас DirectMessagesTopic і поле direct_messages_topic до класу Message, що описують тему чату особистих повідомлень.
- Додано параметр direct_messages_topic_id до методів sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, sendMediaGroup, copyMessage, copyMessages, forwardMessage і forwardMessages. За допомогою цього параметра можна надіслати повідомлення в тему чату особистих повідомлень.
Запропоновані пости
- Додано клас SuggestedPostParameters і параметр suggested_post_parameters до методів sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, copyMessage, forwardMessage. За допомогою цього параметра можна надіслати запропонований пост у тему чату особистих повідомлень.
- Додано метод approveSuggestedPost, що дає змогу ботам схвалювати вхідні запропоновані пости.
- Додано метод declineSuggestedPost, що дає змогу ботам відхиляти вхідні запропоновані пости.
- Додано поле can_manage_direct_messages до класів ChatMemberAdministrator і ChatAdministratorRights.
- Додано параметр can_manage_direct_messages до методу promoteChatMember.
- Додано поле is_paid_post до класу Message, за яким можна визначити платні пости. Такі пости не можна видаляти протягом 24 годин, щоб отримати оплату.
- Додано клас SuggestedPostPrice, що описує ціну запропонованого поста.
- Додано клас SuggestedPostInfo і поле suggested_post_info до класу Message, що описують запропонований пост.
- Додано клас SuggestedPostApproved і поле suggested_post_approved до класу Message, що описують службове повідомлення про схвалення запропонованого поста.
- Додано клас SuggestedPostApprovalFailed і поле suggested_post_approval_failed до класу Message, що описують службове повідомлення про невдале схвалення запропонованого поста.
- Додано клас SuggestedPostDeclined і поле suggested_post_declined до класу Message, що описують службове повідомлення про відхилення запропонованого поста.
- Додано клас SuggestedPostPaid і поле suggested_post_paid до класу Message, що описують службове повідомлення про успішну оплату запропонованого поста.
- Додано клас SuggestedPostRefunded і поле suggested_post_refunded до класу Message, що описують службове повідомлення про повернення коштів за запропонований пост.
Bot API 9.1
Нові методи: sendChecklist, editMessageChecklist, getMyStarBalance
Чек-листи
- Додано клас ChecklistTask, що представляє завдання в чек-листі.
- Додано клас Checklist, що представляє чек-лист.
- Додано клас InputChecklistTask, що представляє завдання для додавання до чек-листа.
- Додано клас InputChecklist, що представляє чек-лист для створення.
- Додано поле checklist до класів Message і ExternalReplyInfo, що описує чек-лист у повідомленні.
- Додано клас ChecklistTasksDone і поле checklist_tasks_done до класу Message, що описують службове повідомлення про зміну статусу завдань у чек-листі (тобто позначення як виконаних/невиконаних).
- Додано клас ChecklistTasksAdded і поле checklist_tasks_added до класу Message, що описують службове повідомлення про додавання нових завдань до чек-листа.
- Додано метод sendChecklist, що дає змогу ботам надсилати чек-лист від імені бізнес-акаунта.
- Додано метод editMessageChecklist, що дає змогу ботам редагувати чек-лист від імені бізнес-акаунта.
Подарунки
- Додано поле next_transfer_date до класів OwnedGiftUnique і UniqueGiftInfo.
- Додано поле last_resale_star_count до класу UniqueGiftInfo.
- Додано «resale» як можливе значення поля origin у класі UniqueGiftInfo.
Загальне
- Максимальну кількість варіантів відповіді в опитуванні збільшено до 12.
- Додано метод getMyStarBalance, що дає змогу ботам отримати поточний баланс Telegram Stars.
- Додано клас DirectMessagePriceChanged і поле direct_message_price_changed до класу Message, що описують службове повідомлення про зміну ціни особистих повідомлень у канал.
- Додано метод hideKeyboard до класу WebApp.
Bot API 9.0
Нові методи: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
Бізнес-акаунти
- Додано клас BusinessBotRights; поле can_reply у класі BusinessConnection замінено полем rights типу BusinessBotRights.
- Додано метод 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, що описує типи подарунків, які приймає користувач або чат.
- Поле can_send_gift у класі ChatFullInfo замінено полем accepted_gift_types типу AcceptedGiftTypes.
- Додано клас GiftInfo і поле gift до класу Message, що описують службове повідомлення про надісланий або отриманий звичайний подарунок.
- Додано клас UniqueGiftInfo і поле unique_gift до класу Message, що описують службове повідомлення про надісланий або отриманий унікальний подарунок.
Telegram Premium
- Додано метод giftPremiumSubscription, що дає змогу ботам дарувати користувачу підписку Telegram Premium з оплатою в Telegram Stars.
- Додано поле premium_subscription_duration до класу TransactionPartnerUser для транзакцій із підпискою Telegram Premium, придбаною ботом.
- Додано поле transaction_type до класу TransactionPartnerUser, що спрощує розрізнення та обробку всіх типів транзакцій.
Загальне
- Максимальну ціну платного медіа збільшено до 10000 Telegram Stars.
- Максимальну ціну за період підписки збільшено до 10000 Telegram Stars.
- Додано клас PaidMessagePriceChanged і поле paid_message_price_changed до класу Message, що описують службове повідомлення про зміну ціни платних повідомлень у чаті.
- Додано поле paid_star_count до класу Message, що містить кількість Telegram Stars, сплачених за надсилання повідомлення.
Попередні версії
Релізи до Bot API 9.0 наведено з датами. Їхній повний опис є в офіційній історії змін.
- 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 раз на один-два місяці. Кожен реліз додає методи й поля; деякі релізи також містять несумісні зміни, які позначено в описах.
Як дізнатися, коли додали метод?
Відкрийте метод у нашому довіднику методів: у розділі «Історія версій» указано реліз, у якому його додали, і релізи, що його змінювали, з посиланнями на цю сторінку.