<p>The Bot API is an HTTP-based interface created for developers keen on building bots for Telegram.<br>To learn how to create and set up a bot, please consult our <ahref="https://core.telegram.org/bots"><strong>Introduction to Bots »</strong></a></p>
</blockquote>
<p>You will find all changes to our <ahref="/bots/api"><strong>Bot API</strong></a> on this page.</p>
<p>Subscribe to <ahref="https://t.me/botnews">@BotNews</a> to be the first to know about the latest updates and join the discussion in <ahref="https://t.me/bottalk">@BotTalk</a></p>
<li>Added the classes <ahref="/bots/api#startransactions">StarTransactions</a>, <ahref="/bots/api#startransaction">StarTransaction</a>, <ahref="/bots/api#transactionpartner">TransactionPartner</a> and <ahref="/bots/api#revenuewithdrawalstate">RevenueWithdrawalState</a>, containing information about Telegram Star transactions involving the bot.</li>
<li>Added the method <ahref="/bots/api#getstartransactions">getStarTransactions</a> that can be used to get the list of all Telegram Star transactions for the bot.</li>
<li>Added support for <em>callback</em> buttons in <ahref="/bots/api#inlinekeyboardmarkup">InlineKeyboardMarkup</a> for messages sent on behalf of a business account.</li>
<li>Added support for callback queries originating from a message sent on behalf of a business account.</li>
<li>Added the parameter <em>business_connection_id</em> to the methods <ahref="/bots/api#editmessagetext">editMessageText</a>, <ahref="/bots/api#editmessagemedia">editMessageMedia</a>, <ahref="/bots/api#editmessagecaption">editMessageCaption</a>, <ahref="/bots/api#editmessagelivelocation">editMessageLiveLocation</a>, <ahref="/bots/api#stopmessagelivelocation">stopMessageLiveLocation</a> and <ahref="/bots/api#editmessagereplymarkup">editMessageReplyMarkup</a>, allowing the bot to edit business messages.</li>
<li>Added the parameter <em>business_connection_id</em> to the method <ahref="/bots/api#stoppoll">stopPoll</a>, allowing the bot to stop polls it sent on behalf of a business account.</li>
<li>Added support for payments in <ahref="https://t.me/BotNews/90">Telegram Stars</a> by introducing the new currency “XTR”.</li>
<li>The parameter <em>provider_token</em> of the methods <ahref="/bots/api#sendinvoice">sendInvoice</a> and <ahref="/bots/api#createinvoicelink">createInvoiceLink</a> must be omitted for payments in <ahref="https://t.me/BotNews/90">Telegram Stars</a>.</li>
<li>The field <em>provider_token</em> in the class <ahref="/bots/api#inputinvoicemessagecontent">InputInvoiceMessageContent</a> must be omitted for payments in <ahref="https://t.me/BotNews/90">Telegram Stars</a>.</li>
<li>Added the method <ahref="/bots/api#refundstarpayment">refundStarPayment</a>.</li>
<li>Added the field <em>effect_id</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the parameter <em>message_effect_id</em> to the methods <ahref="/bots/api#sendmessage">sendMessage</a>, <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#senddocument">sendDocument</a>, <ahref="/bots/api#sendsticker">sendSticker</a>, <ahref="/bots/api#sendvideonote">sendVideoNote</a>, <ahref="/bots/api#sendvoice">sendVoice</a>, <ahref="/bots/api#sendlocation">sendLocation</a>, <ahref="/bots/api#sendvenue">sendVenue</a>, <ahref="/bots/api#sendcontact">sendContact</a>, <ahref="/bots/api#sendpoll">sendPoll</a>, <ahref="/bots/api#senddice">sendDice</a>, <ahref="/bots/api#sendinvoice">sendInvoice</a>, <ahref="/bots/api#sendgame">sendGame</a>, and <ahref="/bots/api#sendmediagroup">sendMediaGroup</a>.</li>
<li>Added the field <em>show_caption_above_media</em> to the classes <ahref="/bots/api#message">Message</a>, <ahref="/bots/api#inputmediaanimation">InputMediaAnimation</a>, <ahref="/bots/api#inputmediaphoto">InputMediaPhoto</a>, <ahref="/bots/api#inputmediavideo">InputMediaVideo</a>, <ahref="/bots/api#inlinequeryresultgif">InlineQueryResultGif</a>, <ahref="/bots/api#inlinequeryresultmpeg4gif">InlineQueryResultMpeg4Gif</a>, <ahref="/bots/api#inlinequeryresultphoto">InlineQueryResultPhoto</a>, <ahref="/bots/api#inlinequeryresultvideo">InlineQueryResultVideo</a>, <ahref="/bots/api#inlinequeryresultcachedgif">InlineQueryResultCachedGif</a>, <ahref="/bots/api#inlinequeryresultcachedmpeg4gif">InlineQueryResultCachedMpeg4Gif</a>, <ahref="/bots/api#inlinequeryresultcachedphoto">InlineQueryResultCachedPhoto</a>, and <ahref="/bots/api#inlinequeryresultcachedvideo">InlineQueryResultCachedVideo</a>.</li>
<li>Added the parameter <em>show_caption_above_media</em> to the methods <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#copymessage">copyMessage</a>, and <ahref="/bots/api#editmessagecaption">editMessageCaption</a>.</li>
<li>Added support for “expandable_blockquote” entities in received messages.</li>
<li>Added support for “expandable_blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes.</li>
<li>Allowed to explicitly specify “expandable_blockquote” entities in formatted texts.</li>
<li>Added support for <ahref="/bots/api#inlinekeyboardmarkup">InlineKeyboardMarkup</a> with <em>url</em>, <em>login_url</em>, and <em>callback_game</em> buttons for messages sent on behalf of a business account.</li>
<li>Added the field <em>via_join_request</em> to the class <ahref="/bots/api#chatmemberupdated">ChatMemberUpdated</a>.</li>
<li>Added support for live locations that can be edited indefinitely, allowing 0x7FFFFFFF to be used as <em>live_period</em>.</li>
<li>Added the parameter <em>live_period</em> to the method <ahref="/bots/api#editmessagelivelocation">editMessageLiveLocation</a>.</li>
<li>Added the field <em>question_entities</em> to the class <ahref="/bots/api#poll">Poll</a>.</li>
<li>Added the field <em>text_entities</em> to the class <ahref="/bots/api#polloption">PollOption</a>.</li>
<li>Added the parameters <em>question_parse_mode</em> and <em>question_entities</em> to the method <ahref="/bots/api#sendpoll">sendPoll</a>.</li>
<li>Added the class <ahref="/bots/api#inputpolloption">InputPollOption</a> and changed the type of the parameter <em>options</em> in the method <ahref="/bots/api#sendpoll">sendPoll</a> to Array of <ahref="/bots/api#inputpolloption">InputPollOption</a>.</li>
<li>Added the classes <ahref="/bots/api#chatbackground">ChatBackground</a>, <ahref="/bots/api#backgroundtype">BackgroundType</a>, <ahref="/bots/api#backgroundfill">BackgroundFill</a> and the field <em>chat_background_set</em> of type <ahref="/bots/api#chatbackground">ChatBackground</a> to the class <ahref="/bots/api#message">Message</a>, describing service messages about background changes.</li>
<li>Split out the class <ahref="/bots/api#chatfullinfo">ChatFullInfo</a> from the class <ahref="/bots/api#chat">Chat</a> and changed the return type of the method <ahref="/bots/api#getchat">getChat</a> to <ahref="/bots/api#chatfullinfo">ChatFullInfo</a>.</li>
<li>Added the field <em>max_reaction_count</em> to the class <ahref="/bots/api#chatfullinfo">ChatFullInfo</a>.</li>
<li>Documented that .MP3 and .M4A files can be used as voice messages.</li>
<p><strong>Integration with Business Accounts</strong></p>
<ul>
<li>Added the class <ahref="/bots/api#businessconnection">BusinessConnection</a> and updates about the connection or disconnection of the bot to a business account, represented by the field <em>business_connection</em> in the class <ahref="/bots/api#update">Update</a>.</li>
<li>Added updates about new messages in a business account connected to the bot, represented by the field <em>business_message</em> in the class <ahref="/bots/api#update">Update</a>.</li>
<li>Added updates about message edits in a business account connected to the bot, represented by the field <em>edited_business_message</em> in the class <ahref="/bots/api#update">Update</a>.</li>
<li>Added updates about message deletion in a business account connected to the bot, represented by the class <ahref="/bots/api#businessmessagesdeleted">BusinessMessagesDeleted</a> and the field <em>deleted_business_messages</em> in the class <ahref="/bots/api#update">Update</a>.</li>
<li>Added the method <ahref="/bots/api#getbusinessconnection">getBusinessConnection</a>.</li>
</ul>
<p><strong>Working on Behalf of Business Accounts</strong></p>
<ul>
<li>Added the parameter <em>business_connection_id</em> to the methods <ahref="/bots/api#sendmessage">sendMessage</a>, <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#senddocument">sendDocument</a>, <ahref="/bots/api#sendsticker">sendSticker</a>, <ahref="/bots/api#sendvideonote">sendVideoNote</a>, <ahref="/bots/api#sendvoice">sendVoice</a>, <ahref="/bots/api#sendlocation">sendLocation</a>, <ahref="/bots/api#sendvenue">sendVenue</a>, <ahref="/bots/api#sendcontact">sendContact</a>, <ahref="/bots/api#sendpoll">sendPoll</a>, <ahref="/bots/api#senddice">sendDice</a>, <ahref="/bots/api#sendgame">sendGame</a>, and <ahref="/bots/api#sendmediagroup">sendMediaGroup</a>.</li>
<li>Added the parameter <em>business_connection_id</em> to the method <ahref="/bots/api#sendchataction">sendChatAction</a>.</li>
<li>Added the field <em>business_connection_id</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the field <em>sender_business_bot</em> to the class <ahref="/bots/api#message">Message</a>.</li>
</ul>
<p><strong>Information about Business Accounts</strong></p>
<ul>
<li>Added the class <ahref="/bots/api#businessintro">BusinessIntro</a> and the field <em>business_intro</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the class <ahref="/bots/api#businesslocation">BusinessLocation</a> and the field <em>business_location</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the classes <ahref="/bots/api#businessopeninghours">BusinessOpeningHours</a> and <ahref="/bots/api#businessopeninghoursinterval">BusinessOpeningHoursInterval</a> and the field <em>business_opening_hours</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Removed the fields <em>is_animated</em> and <em>is_video</em> from the class <ahref="/bots/api#stickerset">StickerSet</a>.</li>
<li>Added the field <em>format</em> to the class <ahref="/bots/api#inputsticker">InputSticker</a>.</li>
<li>Removed the parameter <em>sticker_format</em> from the method <ahref="/bots/api#createnewstickerset">createNewStickerSet</a>.</li>
<li>Added the parameter <em>format</em> to the method <ahref="/bots/api#setstickersetthumbnail">setStickerSetThumbnail</a>.</li>
<li>Increased the maximum number of stickers in any regular and mask sticker set to 120.</li>
<li>Allowed to upload WEBM stickers using <ahref="/bots/api#sendsticker">SendSticker</a>.</li>
</ul>
<p><strong>Request Chat Improvements</strong></p>
<ul>
<li>Added the fields <em>request_name</em>, <em>request_username</em>, and <em>request_photo</em> to the class <ahref="/bots/api#keyboardbuttonrequestusers">KeyboardButtonRequestUsers</a>.</li>
<li>Added the fields <em>request_title</em>, <em>request_username</em>, and <em>request_photo</em> to the class <ahref="/bots/api#keyboardbuttonrequestchat">KeyboardButtonRequestChat</a>.</li>
<li>Added the class <em>SharedUser</em> and replaced the field <em>user_ids</em> in the class <ahref="/bots/api#usersshared">UsersShared</a> with the field <em>users</em>.</li>
<li>Added the fields <em>title</em>, <em>username</em>, and <em>photo</em> to the class <ahref="/bots/api#chatshared">ChatShared</a>.</li>
</ul>
<p><strong>Other Changes</strong></p>
<ul>
<li>Added the field <em>is_from_offline</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the field <em>can_connect_to_business</em> to the class <ahref="/bots/api#user">User</a>.</li>
<li>Added the field <em>personal_chat</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the method <ahref="/bots/api#replacestickerinset">replaceStickerInSet</a>,</li>
<li>Added the class <ahref="/bots/api#birthdate">Birthdate</a> and the field <em>birthdate</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the field <em>BiometricManager</em> to the class <ahref="/bots/webapps#initializing-mini-apps">WebApp</a>.</li>
<li>Added support for the administrator rights <em>can_post_stories</em>, <em>can_edit_stories</em>, <em>can_delete_stories</em> in supergroups.</li>
<li>Added the class <ahref="/bots/api#chatboostadded">ChatBoostAdded</a> and the field <em>boost_added</em> to the class <ahref="/bots/api#message">Message</a> for service messages about a user boosting a chat.</li>
<li>Added the field <em>sender_boost_count</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the field <em>reply_to_story</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the fields <em>chat</em> and <em>id</em> to the class <ahref="/bots/api#story">Story</a>.</li>
<li>Added the field <em>unrestrict_boost_count</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the field <em>custom_emoji_sticker_set_name</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the classes <ahref="/bots/api#reactiontypeemoji">ReactionTypeEmoji</a> and <ahref="/bots/api#reactiontypecustomemoji">ReactionTypeCustomEmoji</a> representing different types of reaction.</li>
<li>Added updates about a reaction change on a message with non-anonymous reactions, represented by the class <ahref="/bots/api#messagereactionupdated">MessageReactionUpdated</a> and the field <em>message_reaction</em> in the class <ahref="/bots/api#update">Update</a>. The bot must explicitly allow the update to receive it.</li>
<li>Added updates about reaction changes on a message with anonymous reactions, represented by the class <ahref="/bots/api#messagereactioncountupdated">MessageReactionCountUpdated</a> and the field <em>message_reaction_count</em> in the class <ahref="/bots/api#update">Update</a>. The bot must explicitly allow the update to receive it.</li>
<li>Added the method <ahref="/bots/api#setmessagereaction">setMessageReaction</a> that allows bots to react to messages.</li>
<li>Added the field <em>available_reactions</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
</ul>
<p><strong>Replies 2.0</strong></p>
<ul>
<li>Added the ability to reply to messages in other chats or forum topics.</li>
<li>Added the class <ahref="/bots/api#externalreplyinfo">ExternalReplyInfo</a> and the field <em>external_reply</em> of type <ahref="/bots/api#externalreplyinfo">ExternalReplyInfo</a> to the class <ahref="/bots/api#message">Message</a>, containing information about a message that is replied to by the current message, but can be from another chat or forum topic.</li>
<li>Added the ability to quote a part of the replied message.</li>
<li>Added the class <ahref="/bots/api#textquote">TextQuote</a> and the field <em>quote</em> of type <ahref="/bots/api#textquote">TextQuote</a> to the class <em>Message</em>, which contains the part of the replied message text or caption that is quoted in the current message.</li>
<li>Added the class <ahref="/bots/api#replyparameters">ReplyParameters</a> and replaced parameters <em>reply_to_message_id</em> and <em>allow_sending_without_reply</em> in the methods <ahref="/bots/api#copymessage">copyMessage</a>, <ahref="/bots/api#sendmessage">sendMessage</a>, <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#senddocument">sendDocument</a>, <ahref="/bots/api#sendsticker">sendSticker</a>, <ahref="/bots/api#sendvideonote">sendVideoNote</a>, <ahref="/bots/api#sendvoice">sendVoice</a>, <ahref="/bots/api#sendlocation">sendLocation</a>, <ahref="/bots/api#sendvenue">sendVenue</a>, <ahref="/bots/api#sendcontact">sendContact</a>, <ahref="/bots/api#sendpoll">sendPoll</a>, <ahref="/bots/api#senddice">sendDice</a>, <ahref="/bots/api#sendinvoice">sendInvoice</a>, <ahref="/bots/api#sendgame">sendGame</a>, and <ahref="/bots/api#sendmediagroup">sendMediaGroup</a> with the field <em>reply_parameters</em> of type <ahref="/bots/api#replyparameters">ReplyParameters</a>.</li>
<li>Allowed to explicitly specify the URL that will be used for link preview generation in outgoing text messages.</li>
<li>Allowed to position link previews above the message text.</li>
<li>Allowed to choose media size in link previews.</li>
<li>Added the class <ahref="/bots/api#linkpreviewoptions">LinkPreviewOptions</a> and replaced the parameter <em>disable_web_page_preview</em> with <em>link_preview_options</em> in the methods <ahref="/bots/api#sendmessage">sendMessage</a> and <ahref="/bots/api#editmessagetext">editMessageText</a>.</li>
<li>Replaced the field <em>disable_web_page_preview</em> with <em>link_preview_options</em> in the class <ahref="/bots/api#inputtextmessagecontent">InputTextMessageContent</a>.</li>
<li>Added the field <em>link_preview_options</em> to the class <ahref="/bots/api#message">Message</a> with information about the link preview options used to send the message.</li>
</ul>
<p><strong>Block Quotation</strong></p>
<ul>
<li>Added support for “blockquote” entities in received messages.</li>
<li>Added support for “blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes.</li>
<li>Allowed to explicitly specify “blockquote” entities in formatted texts.</li>
</ul>
<p><strong>Multiple Message Actions</strong></p>
<ul>
<li>Added the method <ahref="/bots/api#deletemessages">deleteMessages</a> to allow the deletion of multiple messages in a single request.</li>
<li>Added the method <ahref="/bots/api#forwardmessages">forwardMessages</a> for forwarding of multiple messages in a single request.</li>
<li>Added the method <ahref="/bots/api#copymessages">copyMessages</a> for copying of multiple messages in a single request.</li>
</ul>
<p><strong>Request for multiple users</strong></p>
<ul>
<li>Renamed the class <em>KeyboardButtonRequestUser</em> to <ahref="/bots/api#keyboardbuttonrequestusers">KeyboardButtonRequestUsers</a> and added the field <em>max_quantity</em> to it.</li>
<li>Renamed the field <em>request_user</em> in the class <ahref="/bots/api#keyboardbutton">KeyboardButton</a> to <em>request_users</em>. The old name will still work for backward compatibility.</li>
<li>Added the class <ahref="/bots/api#usersshared">UsersShared</a>.</li>
<li>Replaced the field <em>user_shared</em> in the class <ahref="/bots/api#message">Message</a> with the field <em>users_shared</em>.</li>
</ul>
<p><strong>Chat Boost</strong></p>
<ul>
<li>Added updates about chat boost changes, represented by the classes <ahref="/bots/api#chatboostupdated">ChatBoostUpdated</a> and <ahref="/bots/api#chatboostremoved">ChatBoostRemoved</a> and the fields <em>chat_boost</em> and <em>removed_chat_boost</em> in the class <ahref="/bots/api#update">Update</a>. The bot must be an administrator in the chat to receive these updates.</li>
<li>Added the classes <ahref="/bots/api#chatboostsourcepremium">ChatBoostSourcePremium</a>, <ahref="/bots/api#chatboostsourcegiftcode">ChatBoostSourceGiftCode</a> and <ahref="/bots/api#chatboostsourcegiveaway">ChatBoostSourceGiveaway</a>, representing different sources of a chat boost.</li>
<li>Added the method <ahref="/bots/api#getuserchatboosts">getUserChatBoosts</a> for obtaining the list of all active boosts a user has contributed to a chat.</li>
</ul>
<p><strong>Giveaway</strong></p>
<ul>
<li>Added the class <ahref="/bots/api#giveaway">Giveaway</a> and the field <em>giveaway</em> to the class <ahref="/bots/api#message">Message</a> for messages about scheduled giveaways.</li>
<li>Added the class <ahref="/bots/api#giveawaycreated">GiveawayCreated</a> and the field <em>giveaway_created</em> to the class <ahref="/bots/api#message">Message</a> for service messages about the creation of a scheduled giveaway.</li>
<li>Added the class <ahref="/bots/api#giveawaywinners">GiveawayWinners</a> and the field <em>giveaway_winners</em> to the class <ahref="/bots/api#message">Message</a> for messages about the completion of a giveaway with public winners.</li>
<li>Added the class <ahref="/bots/api#giveawaycompleted">GiveawayCompleted</a> and the field <em>giveaway_completed</em> to the class <ahref="/bots/api#message">Message</a> for service messages about the completion of a giveaway without public winners.</li>
</ul>
<p><strong>Web App Changes</strong></p>
<ul>
<li>Added the field <em>SettingsButton</em> to the class <ahref="/bots/webapps#initializing-mini-apps">WebApp</a>.</li>
<li>Added the fields <em>header_bg_color</em>, <em>accent_text_color</em>, <em>section_bg_color</em>, <em>section_header_text_color</em>, <em>subtitle_text_color</em>, <em>destructive_text_color</em> to the class <ahref="/bots/webapps#themeparams">ThemeParams</a>.</li>
<li>Web Apps no longer close when the method <em>WebApp.openTelegramLink</em> is called.</li>
</ul>
<p><strong>Other Changes</strong></p>
<ul>
<li>Added support for the fields <em>emoji_status_custom_emoji_id</em> and <em>emoji_status_expiration_date</em> in the class <ahref="/bots/api#chat">Chat</a> for non-private chats.</li>
<li>Added the fields <em>accent_color_id</em>, <em>background_custom_emoji_id</em>, <em>profile_accent_color_id</em>, and <em>profile_background_custom_emoji_id</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the field <em>has_visible_history</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the class <ahref="/bots/api#messageorigin">MessageOrigin</a> and replaced the fields <em>forward_from</em>, <em>forward_from_chat</em>, <em>forward_from_message_id</em>, <em>forward_signature</em>, <em>forward_sender_name</em>, and <em>forward_date</em> with the field <em>forward_origin</em> of type <ahref="/bots/api#messageorigin">MessageOrigin</a> in the class <ahref="/bots/api#message">Message</a>.</li>
<li>Improved documentation for the field <em>message</em> of the class <ahref="/bots/api#callbackquery">callbackQuery</a> and the field <em>pinned_message</em> of the class <ahref="/bots/api#message">Message</a> by adding the classes <ahref="/bots/api#maybeinaccessiblemessage">MaybeInaccessibleMessage</a> and <ahref="/bots/api#inaccessiblemessage">InaccessibleMessage</a>.</li>
<li>Added the new administrator privileges <em>can_post_stories</em>, <em>can_edit_stories</em> and <em>can_delete_stories</em> to the classes <ahref="/bots/api#chatmemberadministrator">ChatMemberAdministrator</a> and <ahref="/bots/api#chatadministratorrights">ChatAdministratorRights</a>.</li>
<li>Added the parameters <em>can_post_stories</em>, <em>can_edit_stories</em> and <em>can_delete_stories</em> to the method <ahref="/bots/api#promotechatmember">promoteChatMember</a>. Currently, bots have no use for these privileges besides assigning them to other administrators.</li>
<li>Added the ability to set any header color for Web App using the method <em>setHeaderColor</em>.</li>
<li>Added the field <em>CloudStorage</em> to the class <ahref="/bots/webapps#initializing-mini-apps">WebApp</a>.</li>
<li>Added the methods <em>requestWriteAccess</em> and <em>requestContact</em> to the class <ahref="/bots/webapps#initializing-mini-apps">WebApp</a>.</li>
<li>Added Web App events <em>writeAccessRequested</em> and <em>contactRequested</em>.</li>
<li>Added the fields <em>from_request</em> and <em>from_attachment_menu</em> to the class <ahref="/bots/api#writeaccessallowed">WriteAccessAllowed</a>.</li>
<li>Added the fields <em>added_to_attachment_menu</em> and <em>allows_write_to_pm</em> to the class <ahref="/bots/webapps#webappuser">WebAppUser</a>.</li>
<li>Added the field <em>story</em> to the class <ahref="/bots/api#message">Message</a> for messages with forwarded stories. Currently, it holds no information.</li>
<li>Added the field <em>voter_chat</em> to the class <ahref="/bots/api#pollanswer">PollAnswer</a>, to contain channel chat voters in <ahref="/bots/api#poll">Polls</a>. For backward compatibility, the field <em>user</em> in such objects will contain the user 136817688 (<ahref="https://t.me/Channel_Bot">@Channel_Bot</a>).</li>
<li>Added the field <em>emoji_status_expiration_date</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the method <ahref="/bots/api#unpinallgeneralforumtopicmessages">unpinAllGeneralForumTopicMessages</a>.</li>
<li>Increased to 512 characters the maximum length of the <em>startapp</em> parameter in direct Web App links.</li>
<li>Added support for launching <ahref="/bots/webapps">Web Apps</a> from inline query results by replacing the parameters <em>switch_pm_text</em> and <em>switch_pm_parameter</em> of the method <ahref="/bots/api#answerinlinequery">answerInlineQuery</a> with the parameter <em>button</em> of type <ahref="/bots/api#inlinequeryresultsbutton">InlineQueryResultsButton</a>.</li>
<li>Added the field <em>web_app_name</em> to the class <ahref="/bots/api#writeaccessallowed">WriteAccessAllowed</a>.</li>
<li>Added the field <em>switch_inline_query_chosen_chat</em> of the type <ahref="/bots/api#switchinlinequerychosenchat">SwitchInlineQueryChosenChat</a> to the class <ahref="/bots/api#inlinekeyboardbutton">InlineKeyboardButton</a>, which allows bots to switch to inline mode in a chosen chat of the given type.</li>
<li>Added the field <em>via_chat_folder_invite_link</em> to the class <ahref="/bots/api#chatmemberupdated">ChatMemberUpdated</a>.</li>
<li>Added the ability to set different bot names for different user languages using the method <ahref="/bots/api#setmyname">setMyName</a>.</li>
<li>Added the ability to get the current bot name in the given language as the class <ahref="/bots/api#botname">BotName</a> using the method <ahref="/bots/api#getmyname">getMyName</a>.</li>
<li>Added the ability to change bot settings from the bot's profile in official Telegram apps, including the ability to set animated profile photos.</li>
<li>Added the ability to specify custom emoji entities using <ahref="/bots/api#html-style">HTML</a> and <ahref="/bots/api#markdownv2-style">MarkdownV2</a> formatting options for bots that purchased additional usernames on <ahref="https://fragment.com">Fragment</a>.</li>
<li>Added the ability to set different bot descriptions for different user languages using the method <ahref="/bots/api#setmydescription">setMyDescription</a>.</li>
<li>Added the ability to get the current bot description in the given language as the class <ahref="/bots/api#botdescription">BotDescription</a> using the method <ahref="/bots/api#getmydescription">getMyDescription</a>.</li>
<li>Added the ability to set different bot short descriptions for different user languages using the method <ahref="/bots/api#setmyshortdescription">setMyShortDescription</a>.</li>
<li>Added the ability to get the current bot short description in the given language as the class <ahref="/bots/api#botshortdescription">BotShortDescription</a> using the method <ahref="/bots/api#getmyshortdescription">getMyShortDescription</a>.</li>
<li>Added the parameter <em>emoji</em> to the method <ahref="/bots/api#sendsticker">sendSticker</a> to specify an emoji for just uploaded stickers.</li>
<li>Added support for the creation of custom emoji sticker sets in <ahref="/bots/api#createnewstickerset">createNewStickerSet</a>.</li>
<li>Added the parameter <em>needs_repainting</em> to the method <ahref="/bots/api#createnewstickerset">createNewStickerSet</a> to automatically change the color of emoji based on context (e.g., use text color in messages, accent color in statuses, etc.).</li>
<li>Added the field <em>needs_repainting</em> to the class <ahref="/bots/api#sticker">Sticker</a>.</li>
<li>Replaced the parameters <em>png_sticker</em>, <em>tgs_sticker</em>, <em>webm_sticker</em>, <em>emojis</em> and <em>mask_position</em> in the method <ahref="/bots/api#addstickertoset">addStickerToSet</a> with the parameter <em>sticker</em> of the type <ahref="/bots/api#inputsticker">InputSticker</a>.</li>
<li>Added support for the creation of sticker sets with multiple initial stickers in <ahref="/bots/api#createnewstickerset">createNewStickerSet</a> by replacing the parameters <em>png_sticker</em>, <em>tgs_sticker</em>, <em>webm_sticker</em>, <em>emojis</em> and <em>mask_position</em> with the parameters <em>stickers</em> and <em>sticker_format</em>.</li>
<li>Added support for .WEBP files in <ahref="/bots/api#createnewstickerset">createNewStickerSet</a> and <ahref="/bots/api#addstickertoset">addStickerToSet</a>.</li>
<li>Added support for .WEBP, .TGS, and .WEBM files in <ahref="/bots/api#uploadstickerfile">uploadStickerFile</a> by replacing the parameter <em>png_sticker</em> in the method <ahref="/bots/api#uploadstickerfile">uploadStickerFile</a> with the parameters <em>sticker</em> and <em>sticker_format</em>.</li>
<li>Added the ability to specify search keywords for stickers added to sticker sets.</li>
<li>Added the method <ahref="/bots/api#setcustomemojistickersetthumbnail">setCustomEmojiStickerSetThumbnail</a> for editing the thumbnail of custom emoji sticker sets created by the bot.</li>
<li>Added the method <ahref="/bots/api#setstickersettitle">setStickerSetTitle</a> for editing the title of sticker sets created by the bot.</li>
<li>Added the method <ahref="/bots/api#deletestickerset">deleteStickerSet</a> for complete deletion of a given sticker set that was created by the bot.</li>
<li>Added the method <ahref="/bots/api#setstickeremojilist">setStickerEmojiList</a> for changing the list of emoji associated with a sticker.</li>
<li>Added the method <ahref="/bots/api#setstickerkeywords">setStickerKeywords</a> for changing the search keywords assigned to a sticker.</li>
<li>Added the method <ahref="/bots/api#setstickermaskposition">setStickerMaskPosition</a> for changing the <ahref="/bots/api#maskposition">mask position</a> of a mask sticker.</li>
<li>Renamed the field <em>thumb</em> in the classes <ahref="/bots/api#animation">Animation</a>, <ahref="/bots/api#audio">Audio</a>, <ahref="/bots/api#document">Document</a>, <ahref="/bots/api#sticker">Sticker</a>, <ahref="/bots/api#video">Video</a>, <ahref="/bots/api#videonote">VideoNote</a>, <ahref="/bots/api#inputmediaanimation">InputMediaAnimation</a>, <ahref="/bots/api#inputmediaaudio">InputMediaAudio</a>, <ahref="/bots/api#inputmediadocument">InputMediaDocument</a>, <ahref="/bots/api#inputmediavideo">InputMediaVideo</a>, <ahref="/bots/api#stickerset">StickerSet</a> to <em>thumbnail</em>.</li>
<li>Renamed the parameter <em>thumb</em> in the methods <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#senddocument">sendDocument</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#sendvideonote">sendVideoNote</a> to <em>thumbnail</em>.</li>
<li>Renamed the method <em>setStickerSetThumb</em> to <ahref="/bots/api#setstickersetthumbnail">setStickerSetThumbnail</a> and its parameter <em>thumb</em> to <em>thumbnail</em>.</li>
<li>Renamed the fields <em>thumb_url</em>, <em>thumb_width</em>, and <em>thumb_height</em> in the classes <ahref="/bots/api#inlinequeryresultarticle">InlineQueryResultArticle</a>, <ahref="/bots/api#inlinequeryresultcontact">InlineQueryResultContact</a>, <ahref="/bots/api#inlinequeryresultdocument">InlineQueryResultDocument</a>, <ahref="/bots/api#inlinequeryresultlocation">InlineQueryResultLocation</a>, and <ahref="/bots/api#inlinequeryresultvenue">InlineQueryResultVenue</a> to <em>thumbnail_url</em>, <em>thumbnail_width</em>, and <em>thumbnail_height</em> respectively.</li>
<li>Renamed the field <em>thumb_url</em> in the classes <ahref="/bots/api#inlinequeryresultphoto">InlineQueryResultPhoto</a> and <ahref="/bots/api#inlinequeryresultvideo">InlineQueryResultVideo</a> to <em>thumbnail_url</em>.</li>
<li>Renamed the fields <em>thumb_url</em> and <em>thumb_mime_type</em> in the classes <ahref="/bots/api#inlinequeryresultgif">InlineQueryResultGif</a>, and <ahref="/bots/api#inlinequeryresultmpeg4gif">InlineQueryResultMpeg4Gif</a> to <em>thumbnail_url</em> and <em>thumbnail_mime_type</em> respectively.</li>
<li>Added <ahref="https://telegram.org/blog/profile-pics-emoji-translations#chat-selection-for-bots">requests for users and chats</a> and support for <ahref="https://telegram.org/blog/profile-pics-emoji-translations#granular-media-permissions">granular media permissions</a>.</li>
<li>Added the class <ahref="/bots/api#keyboardbuttonrequestuser">KeyboardButtonRequestUser</a> and the field <em>request_user</em> to the class <ahref="/bots/api#keyboardbutton">KeyboardButton</a>.</li>
<li>Added the class <ahref="/bots/api#keyboardbuttonrequestchat">KeyboardButtonRequestChat</a> and the field <em>request_chat</em> to the class <ahref="/bots/api#keyboardbutton">KeyboardButton</a>.</li>
<li>Added the classes <ahref="/bots/api#usershared">UserShared</a>, <ahref="/bots/api#chatshared">ChatShared</a> and the fields <em>user_shared</em>, and <em>chat_shared</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Replaced the fields <em>can_send_media_messages</em> in the classes <ahref="/bots/api#chatmemberrestricted">ChatMemberRestricted</a> and <ahref="/bots/api#chatpermissions">ChatPermissions</a> with separate fields <em>can_send_audios</em>, <em>can_send_documents</em>, <em>can_send_photos</em>, <em>can_send_videos</em>, <em>can_send_video_notes</em>, and <em>can_send_voice_notes</em> for different media types.</li>
<li>Added the parameter <em>use_independent_chat_permissions</em> to the methods <ahref="/bots/api#restrictchatmember">restrictChatMember</a> and <ahref="/bots/api#setchatpermissions">setChatPermissions</a>.</li>
<li>Added the field <em>is_persistent</em> to the class <ahref="/bots/api#replykeyboardmarkup">ReplyKeyboardMarkup</a>, allowing to control when the keyboard is shown.</li>
<li>Added the parameter <em>has_spoiler</em> to the methods <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, and <ahref="/bots/api#sendanimation">sendAnimation</a>.</li>
<li>Added the field <em>has_spoiler</em> to the classes <ahref="/bots/api#inputmediaphoto">InputMediaPhoto</a>, <ahref="/bots/api#inputmediavideo">InputMediaVideo</a>, and <ahref="/bots/api#inputmediaanimation">InputMediaAnimation</a>.</li>
<li>Added the field <em>has_media_spoiler</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>The parameters <em>name</em> and <em>icon_custom_emoji_id</em> of the method <ahref="/bots/api#editforumtopic">editForumTopic</a> are now optional. If they are omitted, the existing values are kept.</li>
<li>Added the classes <ahref="/bots/api#forumtopicedited">ForumTopicEdited</a>, <ahref="/bots/api#generalforumtopichidden">GeneralForumTopicHidden</a>, <ahref="/bots/api#generalforumtopicunhidden">GeneralForumTopicUnhidden</a>, and <ahref="/bots/api#writeaccessallowed">WriteAccessAllowed</a> and the fields <em>forum_topic_edited</em>, <em>general_forum_topic_hidden</em>, <em>general_forum_topic_unhidden</em>, and <em>write_access_allowed</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the methods <ahref="/bots/api#editgeneralforumtopic">editGeneralForumTopic</a>, <ahref="/bots/api#closegeneralforumtopic">closeGeneralForumTopic</a>, <ahref="/bots/api#reopengeneralforumtopic">reopenGeneralForumTopic</a>, <ahref="/bots/api#hidegeneralforumtopic">hideGeneralForumTopic</a>, <ahref="/bots/api#unhidegeneralforumtopic">unhideGeneralForumTopic</a> for managing the General topic in forums.</li>
<li>Added the parameter <em>message_thread_id</em> to the method <ahref="/bots/api#sendchataction">sendChatAction</a> for sending chat actions to a specific message thread or a forum topic.</li>
<li>Added the field <em>has_hidden_members</em> to the class <ahref="/bots/api#chat">Chat</a>. Note that the method <ahref="/bots/api#getchatmember">getChatMember</a> is only guaranteed to work if the bot is an administrator in the chat.</li>
<li>Added the field <em>has_aggressive_anti_spam_enabled</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added Web App events <em>qrTextReceived</em> and <em>clipboardTextReceived</em>.</li>
<li>Added the field <em>platform</em> to the class <ahref="/bots/webapps#initializing-web-apps">WebApp</a>.</li>
<li>Added the methods <em>showScanQrPopup</em>, <em>closeScanQrPopup</em>, and <em>readTextFromClipboard</em> to the class <ahref="/bots/webapps#initializing-web-apps">WebApp</a>.</li>
<li>Added the parameter <em>options</em> to the method <em>openLink</em> of the class <ahref="/bots/webapps#initializing-web-apps">WebApp</a>.</li>
<li>Added support for <ahref="https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups">Topics in Groups</a>.</li>
<li>Added the field <em>is_forum</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the fields <em>is_topic_message</em> and <em>message_thread_id</em> to the class <ahref="/bots/api#message">Message</a> to allow detection of messages belonging to a forum topic and their message thread identifier.</li>
<li>Added the classes <ahref="/bots/api#forumtopiccreated">ForumTopicCreated</a>, <ahref="/bots/api#forumtopicclosed">ForumTopicClosed</a>, and <ahref="/bots/api#forumtopicreopened">ForumTopicReopened</a> and the fields <em>forum_topic_created</em>, <em>forum_topic_closed</em>, and <em>forum_topic_reopened</em> to the class <ahref="/bots/api#message">Message</a>. Note that service messages about forum topic creation can't be deleted with the <ahref="/bots/api#deletemessage">deleteMessage</a> method.</li>
<li>Added the field <em>can_manage_topics</em> to the classes <ahref="/bots/api#chatadministratorrights">ChatAdministratorRights</a>, <ahref="/bots/api#chatpermissions">ChatPermissions</a>, <ahref="/bots/api#chatmemberadministrator">ChatMemberAdministrator</a>, and <ahref="/bots/api#chatmemberrestricted">ChatMemberRestricted</a>.</li>
<li>Added the parameter <em>can_manage_topics</em> to the method <ahref="/bots/api#promotechatmember">promoteChatMember</a>.</li>
<li>Added the methods <ahref="/bots/api#createforumtopic">createForumTopic</a>, <ahref="/bots/api#editforumtopic">editForumTopic</a>, <ahref="/bots/api#closeforumtopic">closeForumTopic</a>, <ahref="/bots/api#reopenforumtopic">reopenForumTopic</a>, <ahref="/bots/api#deleteforumtopic">deleteForumTopic</a>, <ahref="/bots/api#unpinallforumtopicmessages">unpinAllForumTopicMessages</a>, and <ahref="/bots/api#getforumtopiciconstickers">getForumTopicIconStickers</a> for forum topic management.</li>
<li>Added the parameter <em>message_thread_id</em> to the methods <ahref="/bots/api#sendmessage">sendMessage</a>, <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#senddocument">sendDocument</a>, <ahref="/bots/api#sendsticker">sendSticker</a>, <ahref="/bots/api#sendvideonote">sendVideoNote</a>, <ahref="/bots/api#sendvoice">sendVoice</a>, <ahref="/bots/api#sendlocation">sendLocation</a>, <ahref="/bots/api#sendvenue">sendVenue</a>, <ahref="/bots/api#sendcontact">sendContact</a>, <ahref="/bots/api#sendpoll">sendPoll</a>, <ahref="/bots/api#senddice">sendDice</a>, <ahref="/bots/api#sendinvoice">sendInvoice</a>, <ahref="/bots/api#sendgame">sendGame</a>, <ahref="/bots/api#sendmediagroup">sendMediaGroup</a>, <ahref="/bots/api#copymessage">copyMessage</a>, <ahref="/bots/api#forwardmessage">forwardMessage</a> to support sending of messages to a forum topic.</li>
<li>Added support for <ahref="https://telegram.org/blog/topics-in-groups-collectible-usernames#collectible-usernames">Multiple Usernames</a> via the field <em>active_usernames</em> in the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the field <em>emoji_status_custom_emoji_id</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the <ahref="/bots/api#messageentity">MessageEntity</a> type “custom_emoji”.</li>
<li>Added the field <em>custom_emoji_id</em> to the class <ahref="/bots/api#messageentity">MessageEntity</a> for “custom_emoji” entities.</li>
<li>Added the method <ahref="/bots/api#getcustomemojistickers">getCustomEmojiStickers</a>.</li>
<li>Added the fields <em>type</em> and <em>custom_emoji_id</em> to the class <ahref="/bots/api#sticker">Sticker</a>.</li>
<li>Added the field <em>sticker_type</em> to the class <ahref="/bots/api#stickerset">StickerSet</a>, describing the type of stickers in the set.</li>
<li>The field <em>contains_masks</em> has been removed from the documentation of the class <ahref="/bots/api#stickerset">StickerSet</a>. The field is still returned in the object for backward compatibility, but new bots should use the field <em>sticker_type</em> instead.</li>
<li>Added the parameter <em>sticker_type</em> to the method <ahref="/bots/api#createnewstickerset">createNewStickerSet</a>.</li>
<li>The parameter <em>contains_masks</em> has been removed from the documentation of the method <ahref="/bots/api#createnewstickerset">createNewStickerSet</a>. The parameter will still work for backward compatibility, but new bots should use the parameter <em>sticker_type</em> instead.</li>
</ul>
<p><strong>Web App Improvements</strong></p>
<ul>
<li>Added the field <em>isClosingConfirmationEnabled</em> and the methods <em>enableClosingConfirmation</em>, <em>disableClosingConfirmation</em>, <em>showPopup</em>, <em>showAlert</em>, <em>showConfirm</em> to the class <ahref="/bots/webapps#initializing-web-apps">WebApp</a>.</li>
<li>Added the field <em>is_premium</em> to the class <ahref="/bots/webapps#webappuser">WebAppUser</a>.</li>
<li>Added the event <em>popupClosed</em>.</li>
</ul>
<p><strong>Other Changes</strong></p>
<ul>
<li>Added the field <em>has_restricted_voice_and_video_messages</em> to the class <ahref="/bots/api#chat">Chat</a> to support the <ahref="https://telegram.org/blog/custom-emoji#privacy-settings-for-voice-messages">new setting</a>.</li>
<li>Added support for photos and videos in the 'What can this bot do?' section (shown on the bot's start screen). Use <ahref="https://t.me/BotFather">BotFather</a> to set up media.</li>
</ul>
<p><strong>Web App Improvements</strong></p>
<ul>
<li>Added the fields <em>version</em>, <em>headerColor</em>, <em>backgroundColor</em>, <em>BackButton</em>, <em>HapticFeedback</em> and the methods <em>isVersionAtLeast</em>, <em>setHeaderColor</em>, <em>setBackgroundColor</em>, <em>openLink</em>, <em>openTelegramLink</em>, <em>openInvoice</em> to the class <ahref="/bots/webapps#initializing-web-apps">WebApp</a>.</li>
<li>Added the field <em>secondary_bg_color</em> to the class <ahref="/bots/webapps#themeparams">ThemeParams</a>.</li>
<li>Added the method <em>offClick</em> to the class <ahref="/bots/webapps#mainbutton">MainButton</a>.</li>
<li>Added the fields <em>chat</em>, <em>can_send_after</em> to the class <ahref="/bots/webapps#webappinitdata">WebAppInitData</a>.</li>
<li>Added the events <em>backButtonClicked</em>, <em>settingsButtonClicked</em>, <em>invoiceClosed</em>.</li>
</ul>
<p><strong>Join Requests & Payments</strong></p>
<ul>
<li>Added the fields <em>join_to_send_messages</em> and <em>join_by_request</em> to the class <ahref="/bots/api#chat">Chat</a>.</li>
<li>Added the ability to process join requests which were created <ahref="https://telegram.org/blog/700-million-and-premium#join-requests-for-public-groups">without an invite link</a>. Bots will receive a “chat_join_request” update as usual.</li>
<li>Added the method <ahref="/bots/api#createinvoicelink">createInvoiceLink</a> to generate an HTTP link for an invoice.</li>
<li>The maximum value of the field <em>file_size</em> in the classes <ahref="/bots/api#animation">Animation</a>, <ahref="/bots/api#audio">Audio</a>, <ahref="/bots/api#document">Document</a>, <ahref="/bots/api#video">Video</a>, <ahref="/bots/api#voice">Voice</a>, and <ahref="/bots/api#file">File</a> can no longer be stored in a signed 32-bit integer type. This change is necessary to support 4GB files uploaded by <ahref="https://telegram.org/blog/700-million-and-premium#telegram-premium">premium accounts</a>.</li>
<li>Added the field <em>is_premium</em> to the class <ahref="/bots/api#user">User</a>.</li>
<li>Added the field <em>premium_animation</em> to the class <ahref="/bots/api#sticker">Sticker</a>.</li>
</ul>
<p><strong>Attachment Menu Integration</strong></p>
<ul>
<li>Added the field <em>added_to_attachment_menu</em> to the class <ahref="/bots/api#user">User</a>.</li>
<li>Bots integrated in the attachment menu can now be used in groups, supergroups and channels.</li>
<li>Added support for t.me links that can be used to select the chat in which the attachment menu with the bot will be opened.</li>
</ul>
<p><strong>Other Changes</strong></p>
<ul>
<li>Added the parameter <em>secret_token</em> to the method <ahref="/bots/api#setwebhook">setWebhook</a>.</li>
<li>As previously announced, only HTTPS links are now allowed in <em>login_url</em> inline keyboard buttons.</li>
<li>Added support for <strong>Web Apps</strong>, see the <ahref="/bots/webapps">detailed manual here</a>. (<ahref="https://telegram.org/blog/notifications-bots">blog announcement</a>)</li>
<li>Added the class <ahref="/bots/api#webappinfo">WebAppInfo</a> and the fields <em>web_app</em> to the classes <ahref="/bots/api#keyboardbutton">KeyboardButton</a> and <ahref="/bots/api#inlinekeyboardbutton">InlineKeyboardButton</a>.</li>
<li>Added the class <ahref="/bots/api#sentwebappmessage">SentWebAppMessage</a> and the method <ahref="/bots/api#answerwebappquery">answerWebAppQuery</a> for sending an answer to a Web App query, which originated from an inline button of the 'web_app' type.</li>
<li>Added the class <ahref="/bots/api#webappdata">WebAppData</a> and the field <em>web_app_data</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the class <ahref="/bots/api#menubutton">MenuButton</a> and the methods <ahref="/bots/api#setchatmenubutton">setChatMenuButton</a> and <ahref="/bots/api#getchatmenubutton">getChatMenuButton</a> for managing the behavior of the bot's menu button in private chats.</li>
<li>Added the class <ahref="/bots/api#chatadministratorrights">ChatAdministratorRights</a> and the methods <ahref="/bots/api#setmydefaultadministratorrights">setMyDefaultAdministratorRights</a> and <ahref="/bots/api#getmydefaultadministratorrights">getMyDefaultAdministratorRights</a> for managing the bot's default administrator rights.</li>
<li>Added support for t.me links that can be used to add the bot to groups and channels as an administrator.</li>
<li>Added the field <em>last_synchronization_error_date</em> to the class <ahref="/bots/api#webhookinfo">WebhookInfo</a>.</li>
<li>Renamed the field <em>can_manage_voice_chats</em> to <em>can_manage_video_chats</em> in the class <ahref="/bots/api#chatmemberadministrator">ChatMemberAdministrator</a>. The old field will remain temporarily available.</li>
<li>Renamed the parameter <em>can_manage_voice_chats</em> to <em>can_manage_video_chats</em> in the method <ahref="/bots/api#promotechatmember">promoteChatMember</a>. The old parameter will remain temporarily available.</li>
<li>Renamed the fields <em>voice_chat_scheduled</em>, <em>voice_chat_started</em>, <em>voice_chat_ended</em>, and <em>voice_chat_participants_invited</em> to <em>video_chat_scheduled</em>, <em>video_chat_started</em>, <em>video_chat_ended</em>, and <em>video_chat_participants_invited</em> in the class <ahref="/bots/api#message">Message</a>. The old fields will remain temporarily available.</li>
</ul>
<hr>
<blockquote>
<p><strong><imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/> WARNING! <imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/></strong><br>After the next update, only HTTPS links will be allowed in <em>login_url</em> inline keyboard buttons.</p>
<li>Added support for <ahref="https://telegram.org/blog/video-stickers-better-reactions">Video Stickers</a>.</li>
<li>Added the field <em>is_video</em> to the classes <ahref="/bots/api#sticker">Sticker</a> and <ahref="/bots/api#stickerset">StickerSet</a>.</li>
<li>Added the parameter <em>webm_sticker</em> to the methods <ahref="/bots/api#createnewstickerset">createNewStickerSet</a> and <ahref="/bots/api#addstickertoset">addStickerToSet</a>.</li>
<li>Improved support for <ahref="https://telegram.org/blog/protected-content-delete-by-date-and-more#protected-content-in-groups-and-channels">Protected Content</a>.</li>
<li>Added the parameter <em>protect_content</em> to the methods <ahref="/bots/api#sendmessage">sendMessage</a>, <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#senddocument">sendDocument</a>, <ahref="/bots/api#sendsticker">sendSticker</a>, <ahref="/bots/api#sendvideonote">sendVideoNote</a>, <ahref="/bots/api#sendvoice">sendVoice</a>, <ahref="/bots/api#sendlocation">sendLocation</a>, <ahref="/bots/api#sendvenue">sendVenue</a>, <ahref="/bots/api#sendcontact">sendContact</a>, <ahref="/bots/api#sendpoll">sendPoll</a>, <ahref="/bots/api#senddice">sendDice</a>, <ahref="/bots/api#sendinvoice">sendInvoice</a>, <ahref="/bots/api#sendgame">sendGame</a>, <ahref="/bots/api#sendmediagroup">sendMediaGroup</a>, <ahref="/bots/api#copymessage">copyMessage</a>, <ahref="/bots/api#forwardmessage">forwardMessage</a> to allow sending messages with protected content to any chat.</li>
<li>Added support for <ahref="https://telegram.org/blog/reactions-spoilers-translations#spoilers">spoiler entities</a>, which will work in Telegram versions released after December 30, 2021. Older clients will display <em>unsupported message</em>.</li>
<li>Added new <ahref="/bots/api#messageentity">MessageEntity</a> type “spoiler”.</li>
<li>Added the ability to specify spoiler entities using <ahref="/bots/api#html-style">HTML</a> and <ahref="/bots/api#markdownv2-style">MarkdownV2</a> formatting options.</li>
<li>Bots are now allowed to contact users who sent a join request to a chat where the bot is an administrator with the <em>can_invite_users</em> administrator right – even if the user never interacted with the bot before.</li>
<li>Added support for mentioning users by their ID in inline keyboards. This will only work in Telegram versions released after December 7, 2021. Older clients will display <em>unsupported message</em>.</li>
<li>Added the methods <ahref="/bots/api#banchatsenderchat">banChatSenderChat</a> and <ahref="/bots/api#unbanchatsenderchat">unbanChatSenderChat</a> for banning and unbanning channel chats in supergroups and channels.</li>
<li>Added the field <em>has_private_forwards</em> to the class <ahref="/bots/api#chat">Chat</a> for private chats, which can be used to check the possibility of mentioning the user by their ID.</li>
<li>Added the field <em>has_protected_content</em> to the classes <ahref="/bots/api#chat">Chat</a> and <ahref="/bots/api#message">Message</a>.</li>
<li>Added the field <em>is_automatic_forward</em> to the class <ahref="/bots/api#message">Message</a>.</li>
</ul>
<p><strong>Note:</strong> After this update it will become impossible to forward messages from some chats. Use the fields <em>has_protected_content</em> in the classes <ahref="/bots/api#message">Message</a> and <ahref="/bots/api#chat">Chat</a> to check this.</p>
<p><strong>Note:</strong> After this update users are able to send messages on behalf of channels they own. Bots are expected to use the field <em>sender_chat</em> in the class <ahref="/bots/api#message">Message</a> to correctly support such messages.</p>
<p><strong>Note:</strong> As previously announced, user identifiers can now have up to 52 significant bits and require a 64-bit integer or double-precision float type to be stored safely.</p>
<li>Added the the parameter <code>creates_join_request</code> to the methods <ahref="/bots/api#createchatinvitelink">createChatInviteLink</a> and <ahref="/bots/api#editchatinvitelink">editChatInviteLink</a> for managing chat invite links that create join requests (read more about this on our <ahref="https://telegram.org/blog/shared-media-scrolling-calendar-join-requests-and-more#join-requests-for-groups-and-channels">blog</a>).</li>
<li>Added the fields <code>creates_join_request</code> and <code>pending_join_request_count</code> to the class <ahref="/bots/api#chatinvitelink">ChatInviteLink</a>.</li>
<li>Added the field <code>name</code> to the class <ahref="/bots/api#chatinvitelink">ChatInviteLink</a> and the parameters <code>name</code> to the methods <ahref="/bots/api#createchatinvitelink">createChatInviteLink</a> and <ahref="/bots/api#editchatinvitelink">editChatInviteLink</a> for managing <ahref="https://telegram.org/blog/shared-media-scrolling-calendar-join-requests-and-more#unique-names-for-invite-links">invite link names</a>.</li>
<li>Added updates about new requests to join the chat, represented by the class <ahref="/bots/api#chatjoinrequest">ChatJoinRequest</a> and the field <em>chat_join_request</em> in the <ahref="/bots/api#update">Update</a> class. The bot must be an administrator in the chat with the <em>can_invite_users</em> administrator right to receive these updates.</li>
<li>Added the methods <ahref="/bots/api#approvechatjoinrequest">approveChatJoinRequest</a> and <ahref="/bots/api#declinechatjoinrequest">declineChatJoinRequest</a> for managing requests to join the chat.</li>
<li>Added support for the <em>choose_sticker</em> action in the method <ahref="/bots/api#sendchataction">sendChatAction</a>.</li>
</ul>
<hr>
<blockquote>
<p><strong><imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/> WARNING! <imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/></strong><br>User identifiers will become bigger than <code>2^31 - 1</code> before the end of this year and it will be no longer possible to store them in a signed 32-bit integer type. User identifiers will have up to 52 significant bits, so a 64-bit integer or double-precision float type would still be safe for storing them. Please make sure that your code can correctly handle such user identifiers.</p>
<li>Bots can now show lists of commands tailored to specific situations - including localized commands for users with different languages, as well as different commands based on chat type or for specific chats, and special lists of commands for chat admins.</li>
<li>Added the class <ahref="/bots/api#botcommandscope">BotCommandScope</a>, describing the scope to which bot commands apply.</li>
<li>Added the parameters <code>scope</code> and <code>language_code</code> to the method <ahref="/bots/api#setmycommands">setMyCommands</a> to allow bots specify different commands for different chats and users.</li>
<li>Added the parameters <code>scope</code> and <code>language_code</code> to the method <ahref="/bots/api#getmycommands">getMyCommands</a>.</li>
<li>Added the method <ahref="/bots/api#deletemycommands">deleteMyCommands</a> to allow deletion of the bot's commands for the given scope and user language.</li>
<li>Improved visibility of bot commands in Telegram apps with the new 'Menu' button in chats with bots, read more on the <ahref="https://telegram.org/blog/animated-backgrounds#bot-menu">blog</a>.</li>
</ul>
<p><strong>Custom Placeholders</strong></p>
<ul>
<li>Added the ability to specify a custom input field placeholder in the classes <ahref="/bots/api#replykeyboardmarkup">ReplyKeyboardMarkup</a> and <ahref="/bots/api#forcereply">ForceReply</a>.</li>
</ul>
<p><strong>And More</strong></p>
<ul>
<li>Improved documentation of the class <ahref="/bots/api#chatmember">ChatMember</a> by splitting it into 6 subclasses.</li>
<li>Renamed the method <code>kickChatMember</code> to <ahref="/bots/api#banchatmember">banChatMember</a>. The old method name can still be used.</li>
<li>Renamed the method <code>getChatMembersCount</code> to <ahref="/bots/api#getchatmembercount">getChatMemberCount</a>. The old method name can still be used.</li>
<li>Values of the field <code>file_unique_id</code> in objects of the type <ahref="/bots/api#photosize">PhotoSize</a> and of the fields <code>small_file_unique_id</code> and <code>big_file_unique_id</code> in objects of the type <ahref="/bots/api#chatphoto">ChatPhoto</a> were changed.</li>
</ul>
<hr>
<blockquote>
<p><strong><imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/> WARNING! <imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/></strong><br>After one of the upcoming Bot API updates, user identifiers will become bigger than <code>2^31 - 1</code> and it will be no longer possible to store them in a signed 32-bit integer type. User identifiers will have up to 52 significant bits, so a 64-bit integer or double-precision float type would still be safe for storing them. Please make sure that your code can correctly handle such user identifiers.</p>
<li>Support for <ahref="https://telegram.org/blog/payments-2-0-scheduled-voice-chats">Payments 2.0</a>, see <ahref="https://core.telegram.org/bots/payments">this manual</a> for more details about the <strong>Bot Payments API</strong>.</li>
<li>Added the type <ahref="/bots/api#inputinvoicemessagecontent">InputInvoiceMessageContent</a> to support sending invoices as inline query results.</li>
<li>Allowed sending invoices to group, supergroup and channel chats.</li>
<li>Added the fields <em>max_tip_amount</em> and <em>suggested_tip_amounts</em> to the method <ahref="/bots/api#sendinvoice">sendInvoice</a> to allow adding optional tips to the payment.</li>
<li>The parameter <em>start_parameter</em> of the method <ahref="/bots/api#sendinvoice">sendInvoice</a> became optional. If the parameter isn't specified, the invoice can be paid directly from forwarded messages.</li>
<li>Added the field <em>chat_type</em> to the class <ahref="/bots/api#inlinequery">InlineQuery</a>, containing the type of the chat, from which the inline request was sent.</li>
<li>Added the type <ahref="/bots/api#voicechatscheduled">VoiceChatScheduled</a> and the field <em>voice_chat_scheduled</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Fixed an error in <ahref="/bots/api#sendchataction">sendChatAction</a> documentation to correctly mention “record_voice” and “upload_voice” instead of “record_audio” and “upload_audio” for related to voice note actions. Old action names will still work for backward compatibility.</li>
</ul>
<hr>
<blockquote>
<p><strong><imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/> WARNING! <imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/></strong><br>After the next Bot API update (Bot API 5.3) there will be a one-time change of the value of the field <code>file_unique_id</code> in objects of the type <ahref="/bots/api#photosize">PhotoSize</a> and of the fields <code>small_file_unique_id</code> and <code>big_file_unique_id</code> in objects of the type <ahref="/bots/api#chatphoto">ChatPhoto</a>.</p>
</blockquote>
<hr>
<blockquote>
<p><strong><imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/> WARNING! <imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/></strong><br>Service messages about non-bot users joining the chat will be soon removed from large groups. We recommend using the “chat_member” update as a replacement.</p>
</blockquote>
<hr>
<blockquote>
<p><strong><imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/> WARNING! <imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/></strong><br>After one of the upcoming Bot API updates, user identifiers will become bigger than <code>2^31 - 1</code> and it will be no longer possible to store them in a signed 32-bit integer type. User identifiers will have up to 52 significant bits, so a 64-bit integer or double-precision float type would still be safe for storing them. Please make sure that your code can correctly handle such user identifiers.</p>
<p><strong>Added two new update types</strong></p>
<ul>
<li>Added updates about member status changes in chats, represented by the class <ahref="/bots/api#chatmemberupdated">ChatMemberUpdated</a> and the fields <em>my_chat_member</em> and <em>chat_member</em> in the <ahref="/bots/api#update">Update</a> class. The bot must be an administrator in the chat to receive <em>chat_member</em> updates about other chat members. By default, only <em>my_chat_member</em> updates about the bot itself are received.</li>
</ul>
<p><strong>Improved Invite Links</strong></p>
<ul>
<li>Added the class <ahref="/bots/api#chatinvitelink">ChatInviteLink</a>, representing an invite link to a chat.</li>
<li>Added the method <ahref="/bots/api#createchatinvitelink">createChatInviteLink</a>, which can be used to create new invite links in addition to the primary invite link.</li>
<li>Added the method <ahref="/bots/api#editchatinvitelink">editChatInviteLink</a>, which can be used to edit non-primary invite links created by the bot.</li>
<li>Added the method <ahref="/bots/api#revokechatinvitelink">revokeChatInviteLink</a>, which can be used to revoke invite links created by the bot.</li>
</ul>
<p><strong>Voice Chat Info</strong></p>
<ul>
<li>Added the type <ahref="/bots/api#voicechatstarted">VoiceChatStarted</a> and the field <em>voice_chat_started</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the type <ahref="/bots/api#voicechatended">VoiceChatEnded</a> and the field <em>voice_chat_ended</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the type <ahref="/bots/api#voicechatparticipantsinvited">VoiceChatParticipantsInvited</a> and the field <em>voice_chat_participants_invited</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the new administrator privilege <em>can_manage_voice_chats</em> to the class <ahref="/bots/api#chatmember">ChatMember</a> and parameter <em>can_manage_voice_chats</em> to the method <ahref="/bots/api#promotechatmember">promoteChatMember</a>. For now, bots can use this privilege only for passing to other administrators.</li>
</ul>
<p><strong>And More</strong></p>
<ul>
<li>Added the type <ahref="/bots/api#messageautodeletetimerchanged">MessageAutoDeleteTimerChanged</a> and the field <em>message_auto_delete_timer_changed</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added the parameter <em>revoke_messages</em> to the method <ahref="/bots/api#kickchatmember">kickChatMember</a>, allowing to delete all messages from a group for the user who is being removed.</li>
<li>Added the new administrator privilege <em>can_manage_chat</em> to the class <ahref="/bots/api#chatmember">ChatMember</a> and parameter <em>can_manage_chat</em> to the method <ahref="/bots/api#promotechatmember">promoteChatMember</a>. This administrator right is implied by any other administrator privilege.</li>
<li>Supported the new <em>bowling</em> animation for the random <ahref="/bots/api#dice">dice</a>. Choose between different animations (dice, darts, basketball, football, bowling, slot machine) by specifying the <em>emoji</em> parameter in the method <ahref="/bots/api#senddice">sendDice</a>.</li>
</ul>
<hr>
<blockquote>
<p><strong><imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/> WARNING! <imgclass="emoji"src="//telegram.org/img/emoji/40/E29AA0.png"width="20"height="20"alt="⚠️"/></strong><br>After one of the upcoming Bot API updates, some user identifiers will become bigger than <code>2^31 - 1</code> and it will be no longer possible to store them in a signed 32-bit integer type. User identifiers will have up to 52 significant bits, so a 64-bit integer or double-precision float type would still be safe for storing them. Please make sure that your code can correctly handle such user identifiers.</p>
<p><strong>Run Your Own Bot API Server</strong></p>
<ul>
<li>Bot API source code is now available at <ahref="https://github.com/tdlib/telegram-bot-api">telegram-bot-api</a>. You can now run your <strong>own Bot API server</strong> locally, boosting your bots' performance.</li>
<li>Added the method <ahref="/bots/api#logout">logOut</a>, which can be used to log out from the cloud Bot API server before launching your bot locally. You <strong>must</strong> log out the bot before running it locally, otherwise there is no guarantee that the bot will receive all updates.</li>
<li>Added the method <ahref="/bots/api#close">close</a>, which can be used to close the bot instance before moving it from one local server to another.</li>
</ul>
<p><strong>Transfer Bot Ownership</strong></p>
<ul>
<li>You can now use <ahref="https://t.me/botfather">@BotFather</a> to transfer your existing bots to another Telegram account. </li>
</ul>
<p><strong>Webhooks</strong></p>
<ul>
<li>Added the parameter <em>ip_address</em> to the method <ahref="/bots/api#setwebhook">setWebhook</a>, allowing to bypass DNS resolving and use the specified fixed IP address to send webhook requests.</li>
<li>Added the field <em>ip_address</em> to the class <ahref="/bots/api#webhookinfo">WebhookInfo</a>, containing the current IP address used for webhook connections creation.</li>
<li>Added the ability to drop all pending updates when changing webhook URL using the parameter <em>drop_pending_updates</em> in the methods <ahref="/bots/api#setwebhook">setWebhook</a> and <ahref="/bots/api#deletewebhook">deleteWebhook</a>.</li>
</ul>
<p><strong>Working with Groups</strong></p>
<ul>
<li>The <ahref="/bots/api#getchat">getChat</a> request now returns the user's bio for private chats if available.</li>
<li>The <ahref="/bots/api#getchat">getChat</a> request now returns the identifier of the linked chat for supergroups and channels, i.e. the discussion group identifier for a channel and vice versa.</li>
<li>The <ahref="/bots/api#getchat">getChat</a> request now returns the location to which the supergroup is connected (see <ahref="https://telegram.org/blog/contacts-local-groups">Local Groups</a>). Added the class <ahref="/bots/api#chatlocation">ChatLocation</a> to represent the location.</li>
<li>Added the parameter <em>only_if_banned</em> to the method <ahref="/bots/api#unbanchatmember">unbanChatMember</a> to allow safe unban.</li>
</ul>
<p><strong>Working with Files</strong></p>
<ul>
<li>Added the field <em>file_name</em> to the classes <ahref="/bots/api#audio">Audio</a> and <ahref="/bots/api#video">Video</a>, containing the name of the original file.</li>
<li>Added the ability to disable server-side file content type detection using the parameter <em>disable_content_type_detection</em> in the method <ahref="/bots/api#senddocument">sendDocument</a> and the class <ahref="/bots/api#inputmediadocument">inputMediaDocument</a>.</li>
</ul>
<p><strong>Multiple Pinned Messages</strong></p>
<ul>
<li>Added the ability to <strong>pin messages in private chats</strong>.</li>
<li>Added the parameter <em>message_id</em> to the method <ahref="/bots/api#unpinchatmessage">unpinChatMessage</a> to allow unpinning of the specific pinned message.</li>
<li>Added the method <ahref="/bots/api#unpinallchatmessages">unpinAllChatMessages</a>, which can be used to unpin all pinned messages in a chat.</li>
</ul>
<p><strong>File Albums</strong></p>
<ul>
<li>Added support for sending and receiving audio and document albums in the method <ahref="/bots/api#sendmediagroup">sendMediaGroup</a>.</li>
</ul>
<p><strong>Live Locations</strong></p>
<ul>
<li>Added the field <em>live_period</em> to the class <ahref="/bots/api#location">Location</a>, representing a maximum period for which the live location can be updated.</li>
<li>Added support for live location <ahref="https://en.wikipedia.org/wiki/Heading_(navigation)">heading</a>: added the field <em>heading</em> to the classes <ahref="/bots/api#location">Location</a>, <ahref="/bots/api#inlinequeryresultlocation">InlineQueryResultLocation</a>, <ahref="/bots/api#inputlocationmessagecontent">InputLocationMessageContent</a> and the parameter <em>heading</em> to the methods <ahref="/bots/api#sendlocation">sendLocation</a> and <ahref="/bots/api#editmessagelivelocation">editMessageLiveLocation</a>.</li>
<li>Added support for proximity alerts in live locations: added the field <em>proximity_alert_radius</em> to the classes <ahref="/bots/api#location">Location</a>, <ahref="/bots/api#inlinequeryresultlocation">InlineQueryResultLocation</a>, <ahref="/bots/api#inputlocationmessagecontent">InputLocationMessageContent</a> and the parameter <em>proximity_alert_radius</em> to the methods <ahref="/bots/api#sendlocation">sendLocation</a> and <ahref="/bots/api#editmessagelivelocation">editMessageLiveLocation</a>.</li>
<li>Added the type <ahref="/bots/api#proximityalerttriggered">ProximityAlertTriggered</a> and the field <em>proximity_alert_triggered</em> to the class <ahref="/bots/api#message">Message</a>.</li>
<li>Added possibility to specify the horizontal accuracy of a location. Added the field <em>horizontal_accuracy</em> to the classes <ahref="/bots/api#location">Location</a>, <ahref="/bots/api#inlinequeryresultlocation">InlineQueryResultLocation</a>, <ahref="/bots/api#inputlocationmessagecontent">InputLocationMessageContent</a> and the parameter <em>horizontal_accuracy</em> to the methods <ahref="/bots/api#sendlocation">sendLocation</a> and <ahref="/bots/api#editmessagelivelocation">editMessageLiveLocation</a>.</li>
</ul>
<p><strong>Anonymous Admins</strong></p>
<ul>
<li>Added the field <em>sender_chat</em> to the class <ahref="/bots/api#message">Message</a>, containing the sender of a message which is a chat (group or channel). For backward compatibility in non-channel chats, the field <em>from</em> in such messages will contain the user 777000 for messages automatically forwarded to the discussion group and the user 1087968824 (<ahref="https://t.me/GroupAnonymousBot">@GroupAnonymousBot</a>) for messages from anonymous group administrators.</li>
<li>Added the field <em>is_anonymous</em> to the class <ahref="/bots/api#chatmember">chatMember</a>, which can be used to distinguish anonymous chat administrators.</li>
<li>Added the parameter <em>is_anonymous</em> to the method <ahref="/bots/api#promotechatmember">promoteChatMember</a>, which allows to promote anonymous chat administrators. The bot itself should have the <em>is_anonymous</em> right to do this. Despite the fact that bots can have the <em>is_anonymous</em> right, they will never appear as anonymous in the chat. Bots can use the right only for passing to other administrators.</li>
<li>Added the custom title of an anonymous message sender to the class <ahref="/bots/api#message">Message</a> as <em>author_signature</em>.</li>
</ul>
<p><strong>And More</strong></p>
<ul>
<li>Added the method <ahref="/bots/api#copymessage">copyMessage</a>, which sends a copy of any message.</li>
<li>Maximum poll question length increased to 300.</li>
<li>Added the ability to manually specify text entities instead of specifying the <em>parse_mode</em> in the classes <ahref="/bots/api#inputmediaphoto">InputMediaPhoto</a>, <ahref="/bots/api#inputmediavideo">InputMediaVideo</a>, <ahref="/bots/api#inputmediaanimation">InputMediaAnimation</a>, <ahref="/bots/api#inputmediaaudio">InputMediaAudio</a>, <ahref="/bots/api#inputmediadocument">InputMediaDocument</a>, <ahref="/bots/api#inlinequeryresultphoto">InlineQueryResultPhoto</a>, <ahref="/bots/api#inlinequeryresultgif">InlineQueryResultGif</a>, <ahref="/bots/api#inlinequeryresultmpeg4gif">InlineQueryResultMpeg4Gif</a>, <ahref="/bots/api#inlinequeryresultvideo">InlineQueryResultVideo</a>, <ahref="/bots/api#inlinequeryresultaudio">InlineQueryResultAudio</a>, <ahref="/bots/api#inlinequeryresultvoice">InlineQueryResultVoice</a>, <ahref="/bots/api#inlinequeryresultdocument">InlineQueryResultDocument</a>, <ahref="/bots/api#inlinequeryresultcachedphoto">InlineQueryResultCachedPhoto</a>, <ahref="/bots/api#inlinequeryresultcachedgif">InlineQueryResultCachedGif</a>, <ahref="/bots/api#inlinequeryresultcachedmpeg4gif">InlineQueryResultCachedMpeg4Gif</a>, <ahref="/bots/api#inlinequeryresultcachedvideo">InlineQueryResultCachedVideo</a>, <ahref="/bots/api#inlinequeryresultcachedaudio">InlineQueryResultCachedAudio</a>, <ahref="/bots/api#inlinequeryresultcachedvoice">InlineQueryResultCachedVoice</a>, <ahref="/bots/api#inlinequeryresultcacheddocument">InlineQueryResultCachedDocument</a>, <ahref="/bots/api#inputtextmessagecontent">InputTextMessageContent</a> and the methods <ahref="/bots/api#sendmessage">sendMessage</a>, <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#senddocument">sendDocument</a>, <ahref="/bots/api#sendvoice">sendVoice</a>, <ahref="/bots/api#sendpoll">sendPoll</a>, <ahref="/bots/api#editmessagetext">editMessageText</a>, <ahref="/bots/api#editmessagecaption">editMessageCaption</a>.</li>
<li>Added the fields <em>google_place_id</em> and <em>google_place_type</em> to the classes <ahref="/bots/api#venue">Venue</a>, <ahref="/bots/api#inlinequeryresultvenue">InlineQueryResultVenue</a>, <ahref="/bots/api#inputvenuemessagecontent">InputVenueMessageContent</a> and the optional parameters <em>google_place_id</em> and <em>google_place_type</em> to the method <ahref="/bots/api#sendvenue">sendVenue</a> to support Google Places as a venue API provider.</li>
<li>Added the field <em>allow_sending_without_reply</em> to the methods <ahref="/bots/api#sendmessage">sendMessage</a>, <ahref="/bots/api#sendphoto">sendPhoto</a>, <ahref="/bots/api#sendvideo">sendVideo</a>, <ahref="/bots/api#sendanimation">sendAnimation</a>, <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#senddocument">sendDocument</a>, <ahref="/bots/api#sendsticker">sendSticker</a>, <ahref="/bots/api#sendvideonote">sendVideoNote</a>, <ahref="/bots/api#sendvoice">sendVoice</a>, <ahref="/bots/api#sendlocation">sendLocation</a>, <ahref="/bots/api#sendvenue">sendVenue</a>, <ahref="/bots/api#sendcontact">sendContact</a>, <ahref="/bots/api#sendpoll">sendPoll</a>, <ahref="/bots/api#senddice">sendDice</a>, <ahref="/bots/api#sendinvoice">sendInvoice</a>, <ahref="/bots/api#sendgame">sendGame</a>, <ahref="/bots/api#sendmediagroup">sendMediaGroup</a> to allow sending messages not a as reply if the replied-to message has already been deleted.</li>
</ul>
<p><strong>And Last but not Least</strong></p>
<ul>
<li>Supported the new <strong>football</strong> and <strong>slot machine</strong> animations for the random <ahref="/bots/api#dice">dice</a>. Choose between different animations (dice, darts, basketball, football, slot machine) by specifying the <em>emoji</em> parameter in the method <ahref="/bots/api#senddice">sendDice</a>.</li>
<li>Added the new field <em>via_bot</em> to the <ahref="/bots/api#message">Message</a> object. You can now know which bot was used to send a message.</li>
<li>Supported video thumbnails for inline <ahref="/bots/api#inlinequeryresultgif">GIF</a> and <ahref="/bots/api#inlinequeryresultmpeg4gif">MPEG4</a> animations.</li>
<li>Supported the new basketball animation for the random <ahref="/bots/api#dice">dice</a>. Choose between different animations (dice, darts, basketball) by specifying the <em>emoji</em> parameter in the method <ahref="/bots/api#senddice">sendDice</a>.</li>
<li>Supported explanations for <ahref="https://telegram.org/blog/400-million#better-quizzes">Quizzes 2.0</a>. Add explanations by specifying the parameters <em>explanation</em> and <em>explanation_parse_mode</em> in the method <ahref="/bots/api#sendpoll">sendPoll</a>.</li>
<li>Added the fields <em>explanation</em> and <em>explanation_entities</em> to the <ahref="/bots/api#poll">Poll</a> object.</li>
<li>Supported timed polls that automatically close at a certain date and time. Set up by specifying the parameter <em>open_period</em> or <em>close_date</em> in the method <ahref="/bots/api#sendpoll">sendPoll</a>.</li>
<li>Added the fields <em>open_period</em> and <em>close_date</em> to the <ahref="/bots/api#poll">Poll</a> object.</li>
<li>Supported the new <ahref="https://telegram.org/blog/400-million#bullseye">darts</a> animation for the dice mini-game. Choose between the default dice animation and darts animation by specifying the parameter <em>emoji</em> in the method <ahref="/bots/api#senddice">sendDice</a>.</li>
<li>Added the field <em>emoji</em> to the <ahref="/bots/api#dice">Dice</a> object.</li>
<li>Added the method <ahref="/bots/api#senddice">sendDice</a> for sending a dice message, which will have a random value from 1 to 6. (Yes, we're aware of the <em>“proper”</em> singular of <em>die</em>. But it's awkward, and we decided to help it change. One dice at a time!)</li>
<li>Added the field <ahref="/bots/api#dice">dice</a> to the <ahref="/bots/api#message">Message</a> object.</li>
<li>Added the method <ahref="/bots/api#getmycommands">getMyCommands</a> for getting the current list of the bot's commands.</li>
<li>Added the method <ahref="/bots/api#setmycommands">setMyCommands</a> for changing the list of the bot's commands through the Bot API instead of <ahref="https://t.me/botfather">@BotFather</a>.</li>
<li>Added the ability to create animated sticker sets by specifying the parameter <em>tgs_sticker</em> instead of <em>png_sticker</em> in the method <ahref="/bots/api#createnewstickerset">createNewStickerSet</a>.</li>
<li>Added the ability to add animated stickers to sets created by the bot by specifying the parameter <em>tgs_sticker</em> instead of <em>png_sticker</em> in the method <ahref="/bots/api#addstickertoset">addStickerToSet</a>.</li>
<li>Added the field <em>thumb</em> to the <ahref="/bots/api#stickerset">StickerSet</a> object.</li>
<li>Added the ability to change thumbnails of sticker sets created by the bot using the method <ahref="/bots/api#setstickersetthumb">setStickerSetThumb</a>.</li>
<li>Added the ability to send non-anonymous, multiple answer, and quiz-style polls: added the parameters <em>is_anonymous</em>, <em>type</em>, <em>allows_multiple_answers</em>, <em>correct_option_id</em>, <em>is_closed</em> options to the method <ahref="/bots/api#sendpoll">sendPoll</a>.</li>
<li>Added the object <ahref="/bots/api#keyboardbuttonpolltype">KeyboardButtonPollType</a> and the field <em>request_poll</em> to the object <ahref="/bots/api#keyboardbutton">KeyboardButton</a>.</li>
<li>Added updates about changes of user answers in non-anonymous polls, represented by the object <ahref="/bots/api#pollanswer">PollAnswer</a> and the field <em>poll_answer</em> in the <ahref="/bots/api#update">Update</a> object. </li>
<li>Added the fields <em>total_voter_count</em>, <em>is_anonymous</em>, <em>type</em>, <em>allows_multiple_answers</em>, <em>correct_option_id</em> to the <ahref="/bots/api#poll">Poll</a> object.</li>
<li>Bots can now send polls to private chats.</li>
<li>Added more information about the bot in response to the <ahref="/bots/api#getme">getMe</a> request: added the fields <em>can_join_groups</em>, <em>can_read_all_group_messages</em> and <em>supports_inline_queries</em> to the <ahref="/bots/api#user">User</a> object.</li>
<li>Added the optional field <em>language</em> to the <ahref="/bots/api#messageentity">MessageEntity</a> object.</li>
<li>Added support for two new <ahref="/bots/api#messageentity">MessageEntity</a> types, <em>underline</em> and <em>strikethrough</em>.</li>
<li>Added support for nested <ahref="/bots/api#messageentity">MessageEntity</a> objects. Entities can now contain other entities. If two entities have common characters then one of them is fully contained inside the other.</li>
<li>Added support for nested entities and the new tags <code><u>/<ins></code> (for underlined text) and <code><s>/<strike>/<del></code> (for strikethrough text) in parse mode HTML.</li>
<li>Added a new parse mode, <ahref="/bots/api#markdownv2-style">MarkdownV2</a>, which supports nested entities and two new entities <code>__</code> (for underlined text) and <code>~</code> (for strikethrough text). Parse mode <ahref="/bots/api#markdown-style">Markdown</a> remains unchanged for backward compatibility.</li>
<li>Added the field <em>file_unique_id</em> to the objects <ahref="/bots/api#animation">Animation</a>, <ahref="/bots/api#audio">Audio</a>, <ahref="/bots/api#document">Document</a>, <ahref="/bots/api#passportfile">PassportFile</a>, <ahref="/bots/api#photosize">PhotoSize</a>, <ahref="/bots/api#sticker">Sticker</a>, <ahref="/bots/api#video">Video</a>, <ahref="/bots/api#videonote">VideoNote</a>, <ahref="/bots/api#voice">Voice</a>, <ahref="/bots/api#file">File</a> and the fields <em>small_file_unique_id</em> and <em>big_file_unique_id</em> to the object <ahref="/bots/api#chatphoto">ChatPhoto</a>. The new fields contain a unique file identifier, which is supposed to be the same over time and for different bots, but can't be used to download or reuse the file.</li>
<li>Added the field <em>custom_title</em> to the <ahref="/bots/api#chatmember">ChatMember</a> object.</li>
<li>Added the new method <ahref="/bots/api#setchatadministratorcustomtitle">setChatAdministratorCustomTitle</a> to manage the custom titles of administrators promoted by the bot.</li>
<li>Added the field <em>slow_mode_delay</em> to the <ahref="/bots/api#chat">Chat</a> object.</li>
<li>Added support for <ahref="https://telegram.org/blog/animated-stickers"><strong>animated stickers</strong></a>. New field <em>is_animated</em> in <ahref="/bots/api#sticker">Sticker</a> and <ahref="/bots/api#stickerset">StickerSet</a> objects, animated stickers can now be used in <ahref="/bots/api#sendsticker">sendSticker</a> and <ahref="/bots/api#inlinequeryresultcachedsticker">InlineQueryResultCachedSticker</a>.</li>
<li>Added support for <ahref="https://telegram.org/blog/permissions-groups-undo"><strong>default permissions</strong></a> in groups. New object <ahref="/bots/api#chatpermissions">ChatPermissions</a>, containing actions which a member can take in a chat. New field <em>permissions</em> in the <ahref="/bots/api#chat">Chat</a> object; new method <ahref="/bots/api#setchatpermissions">setChatPermissions</a>.</li>
<li>The field <em>all_members_are_administrators</em> has been removed from the documentation for the <ahref="/bots/api#chat">Chat</a> object. The field is still returned in the object for backward compatibility, but new bots should use the <em>permissions</em> field instead.</li>
<li>Added support for more permissions for group and supergroup members: added the new field <em>can_send_polls</em> to <ahref="/bots/api#chatmember">ChatMember</a> object, added <em>can_change_info</em>, <em>can_invite_users</em>, <em>can_pin_messages</em> in <ahref="/bots/api#chatmember">ChatMember</a> object for restricted users (previously available only for administrators).</li>
<li>The method <ahref="/bots/api#restrictchatmember">restrictChatMember</a> now takes the new user permissions in a single argument of the type <ahref="/bots/api#chatpermissions">ChatPermissions</a>. The old way of passing parameters will keep working for a while for backward compatibility.</li>
<li>Added <em>description</em> support for basic groups (previously available in supergroups and channel chats). You can pass a group's chat_id to <ahref="/bots/api#setchatdescription">setChatDescription</a> and receive the group's description in the <ahref="/bots/api#chat">Chat</a> object in the response to <ahref="/bots/api#getchat">getChat</a> method.</li>
<li>Added <em>invite_link</em> support for basic groups (previously available in supergroups and channel chats). You can pass a group's chat_id to <ahref="/bots/api#exportchatinvitelink">exportChatInviteLink</a> and receive the group's invite link in the <ahref="/bots/api#chat">Chat</a> object in the response to <ahref="/bots/api#getchat">getChat</a> method.</li>
<li>File identifiers from the <ahref="/bots/api#chatphoto">ChatPhoto</a> object are now invalidated and can no longer be used whenever the photo is changed.</li>
<li>All <strong>webhook requests</strong> from the Bot API are now coming from the subnets <code>149.154.160.0/20</code> and <code>91.108.4.0/22</code>. Most users won't need to do anything to continue receiving webhooks. If you control inbound access with a firewall, you may need to update your configuration. You can always find the list of actual IP addresses of servers used to send webhooks there: <ahref="/bots/webhooks"><ahref="https://core.telegram.org/bots/webhooks">https://core.telegram.org/bots/webhooks</a></a>.</li>
<li>As of the <strong>next Bot API</strong> update (<strong>version 4.5</strong>), nested <ahref="/bots/api#messageentity">MessageEntity</a> objects will be allowed in message texts and captions. Please make sure that your code can correctly handle such entities.</li>
<li>Added support for <ahref="https://telegram.org/blog/privacy-discussions-web-bots#meet-seamless-web-bots"><strong>Seamless Telegram Login</strong></a> on external websites.</li>
<li>Added the new object <ahref="/bots/api#loginurl">LoginUrl</a> and the new field <em>login_url</em> to the <ahref="/bots/api#inlinekeyboardbutton">InlineKeyboardButton</a> object which allows to <strong>automatically authorize</strong> users before they go to a URL specified by the bot. Users will be asked to confirm authorization in their Telegram app (needs version 5.7 or higher) when they press the button:</li>
<li>Added the field <code>reply_markup</code> to the <ahref="/bots/api#message">Message</a> object, containing the inline keyboard attached to the message.</li>
<li>If a message with an inline keyboard is forwarded, the forwarded message will now have an inline keyboard if the keyboard contained only <em>url</em> and <em>login_url</em> buttons or if the message was sent via a bot and the keyboard contained only <em>url</em>, <em>login_url</em>, <em>switch_inline_query</em> or <em>switch_inline_query_current_chat</em> buttons. In the latter case, <em>switch_inline_query_current_chat</em> buttons are replaced with <em>switch_inline_query</em> buttons.</li>
<li>Bots now receive the <em>edited_message</em><ahref="/bots/api#update">Update</a> even if only <em>Message.reply_markup</em> has changed.</li>
<li>Bots that have the <em>can_edit_messages</em> right in a channel can now use the method <ahref="/bots/api#editmessagereplymarkup">editMessageReplyMarkup</a> for messages written by other administrators forever without the 48 hours limit.</li>
<li>Don't forget that starting in <strong>July 2019</strong>, <strong>webhook requests</strong> from Bot API will be coming from the subnets <code>149.154.160.0/20</code> and <code>91.108.4.0/22</code>. Most users won't need to do anything to continue receiving webhooks. If you control inbound access with a firewall, you may need to update your configuration. You can always find the list of actual IP addresses of servers used to send webhooks there: <ahref="/bots/webhooks"><ahref="https://core.telegram.org/bots/webhooks">https://core.telegram.org/bots/webhooks</a></a>.</li>
<li>Added support for native polls: added the object <ahref="/bots/api#poll">Poll</a>, the methods <ahref="/bots/api#sendpoll">sendPoll</a> and <ahref="/bots/api#stoppoll">stopPoll</a> and the field <em>poll</em> in the <ahref="/bots/api#message">Message</a> and <ahref="/bots/api#update">Update</a> objects.</li>
<li>The method <ahref="/bots/api#deletemessage">deleteMessage</a> can now be used to delete messages sent by a user to the bot in private chats within 48 hours.</li>
<li>Added support for pinned messages in basic groups in addition to supergroups and channel chats: you can pass group's chat_id to <ahref="/bots/api#pinchatmessage">pinChatMessage</a> and <ahref="/bots/api#unpinchatmessage">unpinChatMessage</a>, and receive the pinned group message in <ahref="/bots/api#chat">Chat</a> object.</li>
<li>Added the field <em>is_member</em> to the <ahref="/bots/api#chatmember">ChatMember</a> object, which can be used to find whether a restricted user is a member of the chat.</li>
<li>Added the field <em>forward_sender_name</em> to the <ahref="/bots/api#message">Message</a> object, containing name of the sender who has opted to hide their account.</li>
<li>Starting in July 2019, webhook requests from Bot API will be coming from the subnets <code>149.154.160.0/20</code> and <code>91.108.4.0/22</code>. Most users won't need to do anything to continue receiving webhooks. If you control inbound access with a firewall, you may need to update your configuration. You can always find the list of actual IP addresses of servers used to send webhooks there: <ahref="/bots/webhooks"><ahref="https://core.telegram.org/bots/webhooks">https://core.telegram.org/bots/webhooks</a></a>.</li>
<li>Document thumbnails now should be inscribed in a 320x320 square instead of 90x90.</li>
<li>Added support for translated versions of documents in <ahref="/passport">Telegram Passport</a>.</li>
<li>New field <em>translation</em> in <ahref="/bots/api#encryptedpassportelement">EncryptedPassportElement</a>.</li>
<li>New errors: <ahref="/bots/api#passportelementerrortranslationfile">PassportElementErrorTranslationFile</a> and <ahref="/bots/api#passportelementerrortranslationfile">PassportElementErrorTranslationFiles</a> and <ahref="/bots/api#passportelementerrorunspecified">PassportElementErrorUnspecified</a>.</li>
<li>Added support for <ahref="https://telegram.org/blog/passport"><strong>Telegram Passport</strong></a>. See the official announcement on the <ahref="https://telegram.org/blog">blog</a> and the <ahref="https://core.telegram.org/passport">manual</a> for details.</li>
<li>Added support for <strong>editing the media content of messages</strong>: added the method <ahref="/bots/api#editmessagemedia">editMessageMedia</a> and new types <ahref="/bots/api#inputmediaanimation">InputMediaAnimation</a>, <ahref="/bots/api#inputmediaaudio">InputMediaAudio</a>, and <ahref="/bots/api#inputmediadocument">InputMediaDocument</a>.</li>
<li>Added the field <em>thumb</em> to the <ahref="/bots/api#audio">Audio</a> object to contain the thumbnail of the album cover to which the music file belongs.</li>
<li>Added support for attaching custom thumbnails to uploaded files. For animations, audios, videos and video notes, which are less than 10 MB in size, thumbnails are generated automatically.</li>
<li><code>tg://</code> URLs now can be used in inline keyboard url buttons and <code>text_link</code> message entities. </li>
<li>Added the method <ahref="/bots/api#sendanimation">sendAnimation</a>, which can be used instead of <ahref="/bots/api#senddocument">sendDocument</a> to send animations, specifying their duration, width and height.</li>
<li>Added the field <ahref="/bots/api#animation">animation</a> to the <ahref="/bots/api#message">Message</a> object. For backward compatibility, when this field is set, the <em>document</em> field will be also set.</li>
<li>Added two new <ahref="/bots/api#messageentity">MessageEntity</a> types: <em>cashtag</em> and <em>phone_number</em>.</li>
<li>Added support for Foursquare venues: added the new field <em>foursquare_type</em> to the objects <ahref="/bots/api#venue">Venue</a>, <ahref="/bots/api#inlinequeryresultvenue">InlineQueryResultVenue</a> and <ahref="/bots/api#inputvenuemessagecontent">InputVenueMessageContent</a>, and the parameter <em>foursquare_type</em> to the <ahref="/bots/api#sendvenue">sendVenue</a> method.</li>
<li>You can now create inline mentions of users, who have pressed your bot's callback buttons.</li>
<li>You can now use the <code>Retry-After</code> response header to configure the delay after which the Bot API will retry the request after an unsuccessful response from a webhook.</li>
<li>If a webhook returns the HTTP error <code>410 Gone</code> for all requests for more than 23 hours successively, it can be automatically removed.</li>
<li>Added <ahref="https://en.wikipedia.org/wiki/VCard">vCard</a> support when sharing contacts: added the field <em>vcard</em> to the objects <ahref="/bots/api#contact">Contact</a>, <ahref="/bots/api#inlinequeryresultcontact">InlineQueryResultContact</a>, <ahref="/bots/api#inputcontactmessagecontent">InputContactMessageContent</a> and the method <ahref="/bots/api#sendcontact">sendContact</a>.</li>
<li>Supported <ahref="https://core.telegram.org/bots/api#formatting-options">text formatting</a> in media captions. Specify the desired <em>parse_mode</em> (<ahref="https://core.telegram.org/bots/api#markdown-style">Markdown</a> or <ahref="https://core.telegram.org/bots/api#html-style">HTML</a>) when you provide a caption.</li>
<li>In supergroups, if the bot receives a message that is a reply, it will also receive the message to which that message is replying – even if the original message is inaccessible due to the bot's privacy settings. (In other words, replying to any message in a supergroup with a message that mentions the bot or features a command for it acts as forwarding the original message to the bot). </li>
<li>Added the new field <em>connected_website</em> to <ahref="/bots/api#message">Message</a>. The bot will receive a message with this field in a private chat when a user logs in on the bot's connected website using the <ahref="https://core.telegram.org/widgets/login">Login Widget</a> and allows sending messages from your bot.</li>
<li>Added the new parameter <em>supports_streaming</em> to the <ahref="/bots/api#sendvideo">sendVideo</a> method and a field with the same name to the <ahref="/bots/api#inputmediavideo">InputMediaVideo</a> object.</li>
<li>Added the new method <ahref="/bots/api#sendmediagroup">sendMediaGroup</a> and two kinds of <ahref="/bots/api#inputmedia">InputMedia</a> objects to support the new <ahref="https://telegram.org/blog/albums-saved-messages">albums feature</a>.</li>
<li>Added support for pinning messages in channels. <ahref="/bots/api#pinchatmessage">pinChatMessage</a> and <ahref="/bots/api#unpinchatmessage">unpinChatMessage</a> accept channels.</li>
<li>Added the new fields <em>provider_data</em>, <em>send_phone_number_to_provider</em>, <em>send_email_to_provider</em> to <ahref="/bots/api#sendinvoice">sendInvoice</a> for sharing information about the invoice with the payment provider.</li>
<li>Bots can now send and receive <ahref="https://telegram.org/blog/live-locations">Live Locations</a>. Added new field <em>live_period</em> to the <ahref="/bots/api#sendlocation">sendLocation</a> method and the <ahref="/bots/api#editmessagelivelocation">editMessageLiveLocation</a> and <ahref="/bots/api#stopmessagelivelocation">stopMessageLiveLocation</a> methods as well as the necessary objects for inline bots.</li>
<li>Bots can use the new <ahref="/bots/api#setchatstickerset">setChatStickerSet</a> and <ahref="/bots/api#deletechatstickerset">deleteChatStickerSet</a> methods to manage <ahref="https://telegram.org/blog#stickers-of-the-group">group sticker sets</a>.</li>
<li>The <ahref="/bots/api#getchat">getChat</a> request now returns the group's sticker set for supergroups if available.</li>
<li>Bots now receive entities from media captions in the new field <em>caption_entities</em> in <ahref="/bots/api#message">Message</a>.</li>
<li>Bots can now mention users via <ahref="/bots/api#formatting-options">inline mentions</a>, without using usernames.</li>
<li><ahref="/bots/api#getchat">getChat</a> now also returns pinned messages in supergroups, if present. Added the new field <em>pinned_message</em> to the <ahref="/bots/api#chat">Chat</a> object.</li>
<li>Added the new fields <em>author_signature</em> and <em>forward_signature</em> to the <ahref="/bots/api#message">Message</a> object.</li>
<li>Added the new field <em>is_bot</em> to the <ahref="/bots/api#user">User</a> object.</li>
<p><strong>Bot API 3.2</strong>. Teach your bot to handle <ahref="/bots/api#stickers">stickers and sticker sets</a>.</p>
<ul>
<li>Added new methods for working with stickers: <ahref="/bots/api#getstickerset">getStickerSet</a>, <ahref="/bots/api#uploadstickerfile">uploadStickerFile</a>, <ahref="/bots/api#createnewstickerset">createNewStickerSet</a>, <ahref="/bots/api#addstickertoset">addStickerToSet</a>, <ahref="/bots/api#setstickerpositioninset">setStickerPositionInSet</a>, and <ahref="/bots/api#deletestickerfromset">deleteStickerFromSet</a>.</li>
<li>Added the fields <em>set_name</em> and <em>mask_position</em> to the <ahref="/bots/api#sticker">Sticker</a> object, plus two new objects, <ahref="/bots/api#stickerset">StickerSet</a>, and <ahref="/bots/api#maskposition">MaskPosition</a>.</li>
<p><strong>Bot API 3.1</strong>. Build your own robotic police force for supergoups with these new methods for admin bots:</p>
<ul>
<li>Added new methods <ahref="/bots/api#restrictchatmember">restrictChatMember</a> and <ahref="/bots/api#promotechatmember">promoteChatMember</a> to manage users and admins, added new parameter <em>until_date</em> to <ahref="/bots/api#kickchatmember">kickChatMember</a> for temporary bans.</li>
<li>Added new methods <ahref="/bots/api#exportchatinvitelink">exportChatInviteLink</a>, <ahref="/bots/api#setchatphoto">setChatPhoto</a>, <ahref="/bots/api#deletechatphoto">deleteChatPhoto</a>, <ahref="/bots/api#setchattitle">setChatTitle</a>, <ahref="/bots/api#setchatdescription">setChatDescription</a>, <ahref="/bots/api#pinchatmessage">pinChatMessage</a> and <ahref="/bots/api#unpinchatmessage">unpinChatMessage</a> to manage groups and channels.</li>
<li>Added the new fields <em>photo</em>, <em>description</em> and <em>invite_link</em> to the <ahref="/bots/api#chat">Chat</a> object.</li>
<li>Added the new fields <em>until_date</em>, <em>can_be_edited</em>, <em>can_change_info</em>, <em>can_post_messages</em>, <em>can_edit_messages</em>, <em>can_delete_messages</em>, <em>can_invite_users</em>, <em>can_restrict_members</em>, <em>can_pin_messages</em>, <em>can_promote_members</em>, <em>can_send_messages</em>, <em>can_send_media_messages</em>, <em>can_send_other_messages</em> and <em>can_add_web_page_previews</em> to the <ahref="/bots/api#chatmember">ChatMember</a> object.</li>
<p>See <ahref="/bots/payments">Introduction to Bot Payments</a> for a brief overview. If you're not a developer, you may like <ahref="https://telegram.org/blog/payments">this user-friendly blog post</a> better.</p>
<ul>
<li>Your bot can now accept <ahref="/bots/api#payments">payments</a> for goods and services via Telegram. </li>
<li>Added new kinds of <ahref="/bots/api#update">updates</a>, <em>shipping_query</em> and <em>pre_checkout_query</em>, and new types of <ahref="/bots/api#message">message</a> content, <em>invoice</em> and <em>successful_payment</em>.</li>
<li>Added new methods for payments: <ahref="/bots/api#sendinvoice">sendInvoice</a>, <ahref="/bots/api#answershippingquery">answerShippingQuery</a>, and <ahref="/bots/api#answerprecheckoutquery">answerPreCheckoutQuery</a>.</li>
<li>Added a new type of button, the <strong>pay</strong> button to <ahref="/bots/api#inlinekeyboardbutton">InlineKeyboardButton</a>.</li>
</ul>
<p><strong>NEW Video Messages</strong></p>
<ul>
<li>As of Telegram v.4.0, users can send short rounded <ahref="https://telegram.org/blog/payments">video messages</a>, using an interface similar to that of voice notes.</li>
<li>Added the <ahref="/bots/api#sendvideonote">sendVideoNote</a> method, the new field <em>video_note</em> to <ahref="/bots/api#message">Message</a>, the fields <em>record_video_note</em> or <em>upload_video_note</em> to <ahref="/bots/api#sendchataction">sendChatAction</a>.</li>
</ul>
<p><strong>NEW Multilingual Bots</strong></p>
<ul>
<li>The <ahref="/bots/api#user">User</a> object now may have a <em>language_code</em> field that contains the <ahref="https://en.wikipedia.org/wiki/IETF_language_tag">IETF language tag</a> of the user's language.</li>
<li>Thanks to this, your bot can now offer localized responses to users that speak different languages.</li>
</ul>
<p><strong>More power to admin bots</strong></p>
<ul>
<li><ahref="/bots/api#unbanchatmember">unbanChatMemeber</a> now also works in channels!</li>
<li>New method <ahref="/bots/api#deletemessages">deleteMessage</a> that allows the bot to delete its own messages, as well as messages posted by other in groups and channels where the bot is an administrator.</li>
</ul>
<p><strong>Minor Changes</strong></p>
<ul>
<li>Replaced the field <em>new_chat_member</em> in <ahref="/bots/api#message">Message</a> with <em>new_chat_members</em> (the old field will still be available for a while for compatibility purposes).</li>
<li><ahref="https://core.telegram.org/bots/api#inlinekeyboardbutton">Inline keyboards</a> with <em>switch_inline_query</em> and <em>switch_inline_query_current_chat</em> can no longer be sent to channels because they are useless there.</li>
<li>New fields <em>gif_duration</em> in <ahref="/bots/api#inlinequeryresultgif">InlineQueryResultGif</a> and <em>mpeg4_duration</em> in <ahref="/bots/api#inlinequeryresultmpeg4gif">InlineQueryResultMpeg4Gif</a>.</li>
<p>Introducing <strong>Bot API 2.3.1</strong>, a nifty little update that will give you more control over how your bot gets its updates.</p>
<ul>
<li>Use the new field <em>max_connections</em> in <ahref="/bots/api#setwebhook">setWebhook</a> to optimize your bot's server load</li>
<li>Use <em>allowed_updates</em> in <ahref="/bots/api#setwebhook">setWebhook</a> and <ahref="/bots/api#getupdates">getUpdates</a> to selectively subscribe to updates of a certain type. Among other things, this allows you to stop getting updates about new posts in channels where your bot is an admin.</li>
<li><ahref="/bots/api#deletewebhook">deleteWebhook</a> moved out of <ahref="/bots/api#setwebhook">setWebhook</a> to get a whole separate method for itself.</li>
<li>Modified <ahref="/bots/faq#what-messages-will-my-bot-get"><strong>bot privacy mode</strong></a> for the sake of consistency. </li>
<li><p>Your bot can now get <strong>updates about posts in channels</strong>. Added new fields <em>channel_post</em> and <em>edited_channel_post</em> to <ahref="/bots/#update">Update</a>.</p>
</li>
<li><p>You can now update high scores to a lower value by using the new <em>force</em> parameter in <ahref="/bots/#setgamescore">setGameScore</a>. Handy for punishing <strong>cheaters</strong> or fixing errors in your game's High Score table.</p>
</li>
<li>Starting today, messages with high scores will be updated with new high scores by default. Use <em>disable_edit_message</em> in <ahref="/bots/#setgamescore">setGameScore</a> if you don't want this.</li>
<li>The <em>edit_message</em> parameter from <ahref="/bots/#setgamescore">setGameScore</a> is no longer in use. For backward compatibility, it will be taken into account for a while, unless <em>disable_edit_message</em> is passed explicitly.</li>
<li>Added the new field <em>forward_from_message_id</em> to <ahref="/bots/#message">Message</a>.</li>
<li>Added the new parameter <em>cache_time</em> to <ahref="/bots/#answercallbackquery">answerCallbackQuery</a>. Will eventually work in Telegram apps — somewhere after version 3.14, maybe 3.15.</li>
<li>Renamed <em>hide_keyboard</em> to <em>remove_keyboard</em> in <ahref="/bots/#replykeyboardremove">ReplyKeyboardRemove</a> for clarity. <em>hide_keyboard</em> will still work for a while for backward compatibility.</li>
<p><strong>Bot API 2.2.</strong><ahref="/bots/games">Introducing a new Gaming Platform!</a> See <ahref="/bots/games">this introduction</a> for a brief overview.<br>If you're not a developer, you may like <ahref="https://telegram.org/blog/games"><strong>this user-friendly blog post</strong></a> better.</p>
<ul>
<li>New tools for building <ahref="/bots/api#games"><strong>HTML5 games</strong></a>.</li>
<li>New method <ahref="/bots/api#sendgame">sendGame</a>, new object <ahref="/bots/api#inlinequeryresultgame">InlineQueryResultGame</a>, new field <em>game</em> in <ahref="/bots/api#message">Message</a>.</li>
<li>New parameter <em>url</em> in <ahref="/bots/api#answercallbackquery">answerCallbackQuery</a>. Create a game and accept the conditions using Botfather to send custom urls that open your games for the user.</li>
<li>New field <em>callback_game</em> in <ahref="/bots/api#inlinekeyboardbutton">InlineKeyboardButton</a>, new fields <em>game_short_name</em> and <em>chat_instance</em> in <ahref="/bots/api#callbackquery">CallbackQuery</a>, new object <ahref="/bots/api#callbackgame">CallbackGame</a>. </li>
<li>New methods <ahref="/bots/api#setgamescore">setGameScore</a> and <ahref="/bots/api#getgamehighscores">getGameHighScores</a>.</li>
</ul>
<p><strong>Other changes</strong></p>
<ul>
<li>Making life easier for webhook users. Added a detailed <ahref="https://core.telegram.org/bots/webhooks"><strong>Guide to All Things Webhook</strong></a> that describes every pothole you can run into on the webhook road.</li>
<li><p>New method <ahref="/bots/api#getwebhookinfo">getWebhookInfo</a> to check current webhook status.</p>
</li>
<li><p>Added the option to specify an <strong>HTTP URL</strong> for a file in all methods where <ahref="/bots/api#inputfile">InputFile</a> or <em>file_id</em> can be used (except voice messages). Telegram will get the file from the specified URL and send it to the user. Files must be smaller than 5 MB for photos and smaller than 20 MB for all other types of content.</p>
</li>
<li>Use the new <em>url</em> parameter in <ahref="/bots/api#answercallbackquery">answerCallbackQuery</a> to create buttons that open your bot with user-specific parameters.</li>
<li>Added new field <em>switch_inline_query_current_chat</em> in <ahref="/bots/api#inlinekeyboardbutton">InlineKeyboardButton</a>.</li>
<li>Added <em>caption</em> fields to <ahref="/bots/api#sendaudio">sendAudio</a>, <ahref="/bots/api#sendvoice">sendVoice</a>, <ahref="/bots/api#inlinequeryresultaudio">InlineQueryResultAudio</a>, <ahref="/bots/api#inlinequeryresultvoice">InlineQueryResultVoice</a>, <ahref="/bots/api#inlinequeryresultcachedaudio">InlineQueryResultCachedAudio</a>, and <ahref="/bots/api#inlinequeryresultcachedvoice">InlineQueryResultCachedVoice</a>.</li>
</ul>
<ul>
<li>New field <em>all_members_are_administrators</em> in the <ahref="/bots/api#chat">Chat</a> object.</li>
<li>Certain server responses may now contain the new <ahref="/bots/api#responseparameters"><em>parameters</em></a> field with expanded info on errors that occurred while processing your requests.</li>
<li><strong>Bot API 2.1.</strong> Added more tools for group administrator bots. Your bot can now get a list of administrators and members count in a group, check a user's current status (administrator, creator, left the group, kicked from the group), and leave a group.</li>
<li>Added new methods: <ahref="/bots/api#getchat">getChat</a>, <ahref="/bots/api#leavechat">leaveChat</a>, <ahref="/bots/api#getchatadministrators">getChatAdministrators</a>, <ahref="/bots/api#getchatmember">getChatMember</a>, <ahref="/bots/api#getchatmemberscount">getChatMembersCount</a>.</li>
<li>Added support for <ahref="https://telegram.org/blog/edit">edited messages</a> and <ahref="https://telegram.org/blog/edit#new-mentions">new mentions</a> from Telegram v.3.9. New fields: <em>edited_message</em> in <ahref="/bots/api#update">Update</a>, <em>edit_date</em> in <ahref="/bots/api#message">Message</a>, <em>user</em> in <ahref="/bots/api#messageentity">MessageEntity</a>. New value <em>text_mention</em> for the <em>type</em> field in <ahref="/bots/api#messageentity">MessageEntity</a>.</li>
<li>Added consistency to what messages bots get in groups and supergroups. <ahref="/bots/faq#what-messages-will-my-bot-get">See updated FAQ for details »</a></li>
<li>Added the field <em>emoji</em> to the <ahref="/bots/api#sticker">Sticker</a> object. Your bot can now know the emoji a sticker corresponds to.</li>
<li>Added the field <em>forward_from_chat</em> to the <ahref="/bots/api#message">Message</a> object for messages forwarded from channels.</li>
<p>Introducing <strong>Bot API 2.0</strong>. Check out <ahref="/bots/2-0-intro">this page</a> for a review of this major update.</p>
<ul>
<li>New <ahref="/bots/2-0-intro#new-inline-keyboards"><strong>inline keyboards</strong></a> with <strong>callback</strong> and <strong>URL buttons</strong>. Added new objects <ahref="/bots/api#inlinekeyboardmarkup">InlineKeyboardMarkup</a>, <ahref="/bots/api#inlinekeyboardbutton">InlineKeyboardButton</a> and <ahref="/bots/api#callbackquery">CallbackQuery</a>, added <em>reply_markup</em> fields to all <ahref="/bots/api#inlinequeryresult">InlineQueryResult</a> objects. Added field <em>callback_query</em> to the <ahref="/bots/api#update">Update</a> object, new method <ahref="/bots/api#answercallbackquery">answerCallbackQuery</a>.</li>
<li>Bots can now <ahref="/bots/api#updating-messages"><strong>edit</strong> their messages</a>. Added methods <ahref="/bots/api#editmessagetext">editMessageText</a>, <ahref="/bots/api#editmessagecaption">editMessageCaption</a>, <ahref="/bots/api#editmessagereplymarkup">editMessageReplyMarkup</a>.</li>
<li>Bots can request <strong>location</strong> and <strong>phone number</strong> from the user. The <em>keyboard</em> field in the object <ahref="/bots/api#replykeyboardmarkup">ReplyKeyboardMarkup</a> now supports <ahref="/bots/api#keyboardbutton">KeyboardButton</a>, a new object that can have the fields <em>request_location</em> and <em>request_contact</em>.</li>
</ul>
<p><strong>Inline bots</strong></p>
<ul>
<li>Added support for all content types available on Telegram. <strong>19 types</strong> of <ahref="/bots/api#inlinequeryresult">InlineQueryResult</a> objects are now supported.</li>
<li>Inline bots can now <strong>substitute</strong> all kinds of content with text. Added 4 types of <ahref="/bots/api#inputmessagecontent">InputMessageContent</a> objects.</li>
<li>Your inline bot can also ask users for permission to use their location. Added the new Botfather command <code>/setinlinegeo</code>, added field <em>location</em> to the <ahref="/bots/api#inlinequery">InlineQuery</a> object, added fields <em>location</em> and <em>inline_message_id</em> to the <ahref="/bots/api#choseninlineresult">ChosenInlineResult</a> object.</li>
<li>Added an easy way to <strong>switch</strong> between inline mode and a private chat with the bot – useful for settings, establishing external connections and teaching users how to use your bot in inline mode. Added parameters <em>switch_pm_text</em> and <em>switch_pm_parameter</em> to the method <ahref="/bots/api#answerinlinequery">answerInlineQuery</a>.</li>
</ul>
<p><strong>Miscellaneous</strong></p>
<ul>
<li>Added group <strong>administration</strong> tools. New methods <ahref="/bots/api#kickchatmember">kickChatMember</a> and <ahref="/bots/api#unbanchatmember">unbanChatMember</a>.</li>
<li>Added fields <em>venue</em>, <em>pinned_message</em> and <em>entities</em> to the <ahref="/bots/api#message">Message</a> object. Added new objects <ahref="/bots/api#messageentity">MessageEntity</a> and <ahref="/bots/api#venue">Venue</a>, new methods <ahref="/bots/api#sendvenue">sendVenue</a> and <ahref="/bots/api#sendcontact">sendContact</a>.</li>
<li>Renamed the fields <em>new_chat_participant</em> and <em>left_chat_participant</em> of the <ahref="/bots/api#message">Message</a> object to <em>new_chat_member</em> and <em>left_chat_member</em>.</li>
<li>Added the <em>disable_notification</em> parameter to all methods that send messages or any kind.</li>
<li>Removed backward compatibility from the method <ahref="/bots/api#sendaudio">sendAudio</a>. Voice messages now must be sent using the method <ahref="/bots/api#sendvoice">sendVoice</a>. There is no more need to specify a non-empty title or performer while sending the audio by <em>file_id</em>.</li>
<li>By the way, you can use both HTML-style and markdown-style formatting in your bot's messages to send bold, italic or fixed-width text and inline links. All official Telegram clients support this. See <ahref="/bots/api#formatting-options">Formatting options</a> for details.</li>
<li>You can now <ahref="/bots/inline#collecting-feedback">collect feedback</a> on which results provided by your inline bot get chosen by the users. Added the <code>setinlinefeedback</code> command for Botfather, new type <ahref="/bots/api#choseninlineresult">ChosenInlineResult</a>, new field <em>chosen_inline_result</em> to the <ahref="/bots/api#update">Update</a> object.</li>
<li>Added support for <ahref="/bots/inline">Inline Mode</a>, a new way for people to contact your bot by typing its username and a query in the text input field in any chat. Enable by sending <code>/setinline</code> to <ahref="https://telegram.me/botfather">@BotFather</a>.</li>
<li>New optional field <em>inline_query</em> added to the <ahref="/bots/api#update">Update</a> object.</li>
<li>Added new method <ahref="/bots/api#answerinlinequery">answerInlineQuery</a> and new objects <ahref="/bots/api#inlinequery">InlineQuery</a>, <ahref="/bots/api#inlinequeryresultarticle">InlineQueryResultArticle</a>, <ahref="/bots/api#inlinequeryresultphoto">InlineQueryResultPhoto</a>, <ahref="/bots/api#inlinequeryresultgif">InlineQueryResultGif</a>, <ahref="/bots/api#inlinequeryresultmpeg4gif">InlineQueryResultMpeg4Gif</a> and <ahref="/bots/api#inlinequeryresultvideo">InlineQueryResultVideo</a>.</li>
<li>Added support for <ahref="https://telegram.org/blog/supergroups">supergroups</a>. The <em>Type</em> field in the <ahref="/bots/api#chat">Chat</a> object can now contain 'supergroup'.</li>
<li>New optional fields added to the <ahref="/bots/api#message">Message</a> object: <em>supergroup_chat_created</em>, <em>migrate_to_chat_id</em>, <em>migrate_from_chat_id</em> and <em>channel_chat_created</em>.</li>
<li>Added initial channel support for bots (no Telegram clients support this at the moment, please wait for updates):</li>
<li>The <em>Chat</em> field in the <ahref="/bots/api#message">Message</a> is now of the new type <ahref="/bots/api#chat">Chat</a>.</li>
<li>You can now pass a channel username (in the format <code>@channelusername</code>) in the place of <em>chat_id</em> in all methods (and instead of <em>from_chat_id</em> in <ahref="/bots/api#forwardmessage">forwardMessage</a>). For this to work, the bot must be an administrator in the channel (and that's exactly what Telegram clients don't support yet — adding bots as administrators coming soon).</li>
<li>You can now <ahref="/bots/api#making-requests">pass parameters</a> using <em>application/json</em> (please note that this doesn't work for file uploads: use <em>multipart/form-data</em> to upload files).</li>
<li>Added very basic <ahref="/bots/api#using-markdown">markdown support</a>. New field <em>parse_mode</em> added to <ahref="/bots/api#sendmessage">sendMessage</a>. For the moment messages with markdown will be displayed correctly only in Telegram for <strong>Android</strong>. Other official apps will catch up soon.</li>
<li>Added support for self-signed certificates: upload your certificate using the <em>certificate</em> parameter in the <ahref="/bots/api#setwebhook">setWebhook</a> method.</li>
<li>You can now make <ahref="/bots/api#making-requests-when-getting-updates">new requests</a> when responding to webhook updates.</li>
<li>Added new type <strong><ahref="/bots/api#voice">Voice</a></strong> and new method <ahref="/bots/api#sendvoice"><strong>sendVoice</strong></a> for sending voice messages.</li>
<li>Earlier <strong><ahref="/bots/api#audio">Audio</a></strong> and <strong><ahref="/bots/api#sendaudio">sendAudio</a></strong> should now be used for sending music files. Telegram clients will show such files in the in-app music player. If you were using <ahref="/bots/api#sendaudio"><strong>sendAudio</strong></a> for your bot to send voice messages, please use <ahref="/bots/api#sendaudio"><strong>sendVoice</strong></a> instead.</li>
<li>Added optional fields <em>performer</em>, <em>title</em> to the <ahref="/bots/api#audio"><strong>Audio</strong></a> object and <ahref="/bots/api#sendaudio"><strong>sendAudio</strong></a> method.</li>
<li>Added optional field <em>voice</em> to the <ahref="/bots/api#message"><strong>Message</strong></a> object.</li>
<li>The <strong>thumb</strong> field is now optional for <ahref="/bots/api#video">Video</a>, <ahref="/bots/api#sticker">Sticker</a> and <ahref="/bots/api#document">Document</a> objects</li>
<li>The API now supports both video and photo captions. The <strong>caption</strong> field has been removed from the <ahref="/bots/api#video">Video</a> object and added to the <ahref="/bots/api#message">Message</a> object instead. </li>
<li><strong>caption</strong> and <strong>duration</strong> optional fields have been added to the <ahref="/bots/api#sendvideo">sendVideo</a> method.</li>
<li>Fixed typo: <strong>user_id</strong> in the Contact object is now correctly labeled as Integer, not String</li>
