Update content of files

This commit is contained in:
GitHub Action 2022-08-12 14:05:31 +00:00
parent 49fd430ad6
commit 42f76fb1c5

View file

@ -53,6 +53,29 @@ To learn how to create…">
<blockquote>
<p>Subscribe to <a href="https://t.me/botnews">@BotNews</a> to be the first to know about the latest updates and join the discussion in <a href="https://t.me/bottalk">@BotTalk</a></p>
</blockquote>
<h4><a class="anchor" name="august-12-2022" href="#august-12-2022"><i class="anchor-icon"></i></a>August 12, 2022</h4>
<p><strong>Bot API 6.2</strong></p>
<p><strong>Custom Emoji Support</strong></p>
<ul>
<li>Added the <a href="#messageentity">MessageEntity</a> type “custom_emoji”.</li>
<li>Added the field <em>custom_emoji_id</em> to the class <a href="#messageentity">MessageEntity</a> for “custom_emoji” entities.</li>
<li>Added the method <a href="#getcustomemojistickers">getCustomEmojiStickers</a>.</li>
<li>Added the fields <em>type</em> and <em>custom_emoji_id</em> to the class <a href="#sticker">Sticker</a>.</li>
<li>Added the field <em>sticker_type</em> to the class <a href="#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 <a href="#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 <a href="#createnewstickerset">createNewStickerSet</a>.</li>
<li>The parameter <em>contains_masks</em> has been removed from the documentation of the method <a href="#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 <a href="/bots/webapps#initializing-web-apps">WebApp</a>.</li>
<li>Added the field <em>is_premium</em> to the class <a href="/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 <a href="#chat">Chat</a> to support the <a href="https://telegram.org/blog/custom-emoji#privacy-settings-for-voice-messages">new setting</a>.</li>
</ul>
<h4><a class="anchor" name="june-20-2022" href="#june-20-2022"><i class="anchor-icon"></i></a>June 20, 2022</h4>
<p><strong>Bot API 6.1</strong></p>
<p><strong>Media in Descriptions</strong></p>
@ -117,15 +140,6 @@ To learn how to create…">
<li>Added the field <em>is_video</em> to the classes <a href="#sticker">Sticker</a> and <a href="#stickerset">StickerSet</a>.</li>
<li>Added the parameter <em>webm_sticker</em> to the methods <a href="#createnewstickerset">createNewStickerSet</a> and <a href="#addstickertoset">addStickerToSet</a>.</li>
</ul>
<h4><a class="anchor" name="december-30-2021" href="#december-30-2021"><i class="anchor-icon"></i></a>December 30, 2021</h4>
<p><strong>Bot API 5.6</strong></p>
<ul>
<li>Improved support for <a href="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 <a href="#sendmessage">sendMessage</a>, <a href="#sendphoto">sendPhoto</a>, <a href="#sendvideo">sendVideo</a>, <a href="#sendanimation">sendAnimation</a>, <a href="#sendaudio">sendAudio</a>, <a href="#senddocument">sendDocument</a>, <a href="#sendsticker">sendSticker</a>, <a href="#sendvideonote">sendVideoNote</a>, <a href="#sendvoice">sendVoice</a>, <a href="#sendlocation">sendLocation</a>, <a href="#sendvenue">sendVenue</a>, <a href="#sendcontact">sendContact</a>, <a href="#sendpoll">sendPoll</a>, <a href="#senddice">sendDice</a>, <a href="#sendinvoice">sendInvoice</a>, <a href="#sendgame">sendGame</a>, <a href="#sendmediagroup">sendMediaGroup</a>, <a href="#copymessage">copyMessage</a>, <a href="#forwardmessage">forwardMessage</a> to allow sending messages with protected content to any chat.</li>
<li>Added support for <a href="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 <a href="#messageentity">MessageEntity</a> type “spoiler”.</li>
<li>Added the ability to specify spoiler entities using <a href="#html-style">HTML</a> and <a href="#markdownv2-style">MarkdownV2</a> formatting options.</li>
</ul>
<p><strong><a href="/bots/api-changelog">See earlier changes »</a></strong></p>
<h3><a class="anchor" name="authorizing-your-bot" href="#authorizing-your-bot"><i class="anchor-icon"></i></a>Authorizing your bot</h3>
<p>Each bot is given a unique authentication token <a href="/bots#6-botfather">when it is created</a>. The token looks something like <code>123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11</code>, but we&#39;ll use simply <strong>&lt;token&gt;</strong> in this document instead. You can learn about obtaining tokens and generating new ones in <a href="https://core.telegram.org/bots#6-botfather">this document</a>.</p>
@ -255,7 +269,7 @@ To learn how to create…">
</tbody>
</table>
<h4><a class="anchor" name="getupdates" href="#getupdates"><i class="anchor-icon"></i></a>getUpdates</h4>
<p>Use this method to receive incoming updates using long polling (<a href="https://en.wikipedia.org/wiki/Push_technology#Long_polling">wiki</a>). An Array of <a href="#update">Update</a> objects is returned.</p>
<p>Use this method to receive incoming updates using long polling (<a href="https://en.wikipedia.org/wiki/Push_technology#Long_polling">wiki</a>). Returns an Array of <a href="#update">Update</a> objects.</p>
<table class="table">
<thead>
<tr>
@ -567,6 +581,11 @@ To learn how to create…">
<td><em>Optional</em>. <em>True</em>, if privacy settings of the other party in the private chat allows to use <code>tg://user?id=&lt;user_id&gt;</code> links only in chats with the user. Returned only in <a href="#getchat">getChat</a>.</td>
</tr>
<tr>
<td>has_restricted_voice_and_video_messages</td>
<td>True</td>
<td><em>Optional</em>. <em>True</em>, if the privacy settings of the other party restrict sending voice and video note messages in the private chat. Returned only in <a href="#getchat">getChat</a>.</td>
</tr>
<tr>
<td>join_to_send_messages</td>
<td>True</td>
<td><em>Optional</em>. <em>True</em>, if users need to join the supergroup before they can send messages. Returned only in <a href="#getchat">getChat</a>.</td>
@ -973,7 +992,7 @@ To learn how to create…">
<tr>
<td>type</td>
<td>String</td>
<td>Type of the entity. Currently, can be “mention” (<code>@username</code>), “hashtag” (<code>#hashtag</code>), “cashtag” (<code>$USD</code>), “bot_command” (<code>/start@jobs_bot</code>), “url” (<code>https://telegram.org</code>), “email” (<code>do-not-reply@telegram.org</code>), “phone_number” (<code>+1-212-555-0123</code>), “bold” (<strong>bold text</strong>), “italic” (<em>italic text</em>), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users <a href="https://telegram.org/blog/edit#new-mentions">without usernames</a>)</td>
<td>Type of the entity. Currently, can be “mention” (<code>@username</code>), “hashtag” (<code>#hashtag</code>), “cashtag” (<code>$USD</code>), “bot_command” (<code>/start@jobs_bot</code>), “url” (<code>https://telegram.org</code>), “email” (<code>do-not-reply@telegram.org</code>), “phone_number” (<code>+1-212-555-0123</code>), “bold” (<strong>bold text</strong>), “italic” (<em>italic text</em>), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users <a href="https://telegram.org/blog/edit#new-mentions">without usernames</a>), “custom_emoji” (for inline custom emoji stickers)</td>
</tr>
<tr>
<td>offset</td>
@ -1000,6 +1019,11 @@ To learn how to create…">
<td>String</td>
<td><em>Optional</em>. For “pre” only, the programming language of the entity text</td>
</tr>
<tr>
<td>custom_emoji_id</td>
<td>String</td>
<td><em>Optional</em>. For “custom_emoji” only, unique identifier of the custom emoji. Use <a href="#getcustomemojistickers">getCustomEmojiStickers</a> to get full information about the sticker</td>
</tr>
</tbody>
</table>
<h4><a class="anchor" name="photosize" href="#photosize"><i class="anchor-icon"></i></a>PhotoSize</h4>
@ -3145,7 +3169,7 @@ To learn how to create…">
<tr>
<td>supports_streaming</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if the uploaded video is suitable for streaming</td>
<td><em>Optional</em>. Pass <em>True</em> if the uploaded video is suitable for streaming</td>
</tr>
</tbody>
</table>
@ -3413,7 +3437,7 @@ To learn how to create…">
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -3544,7 +3568,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody>
</table>
<h4><a class="anchor" name="copymessage" href="#copymessage"><i class="anchor-icon"></i></a>copyMessage</h4>
<p>Use this method to copy messages of any kind. Service messages and invoice messages can&#39;t be copied. The method is analogous to the method <a href="#forwardmessage">forwardMessage</a>, but the copied message doesn&#39;t have a link to the original message. Returns the <a href="#messageid">MessageId</a> of the sent message on success.</p>
<p>Use this method to copy messages of any kind. Service messages and invoice messages can&#39;t be copied. A quiz <a href="#poll">poll</a> can be copied only if the value of the field <em>correct_option_id</em> is known to the bot. The method is analogous to the method <a href="#forwardmessage">forwardMessage</a>, but the copied message doesn&#39;t have a link to the original message. Returns the <a href="#messageid">MessageId</a> of the sent message on success.</p>
<table class="table">
<thead>
<tr>
@ -3613,7 +3637,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -3687,7 +3711,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -3786,7 +3810,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -3872,7 +3896,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -3952,7 +3976,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>supports_streaming</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the uploaded video is suitable for streaming</td>
<td>Pass <em>True</em> if the uploaded video is suitable for streaming</td>
</tr>
<tr>
<td>disable_notification</td>
@ -3976,7 +4000,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -4074,7 +4098,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -4154,7 +4178,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -4228,7 +4252,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -4284,7 +4308,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
</tbody>
</table>
@ -4364,7 +4388,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -4568,7 +4592,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -4642,7 +4666,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -4740,7 +4764,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>is_closed</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the poll needs to be immediately closed. This can be useful for poll preview.</td>
<td>Pass <em>True</em> if the poll needs to be immediately closed. This can be useful for poll preview.</td>
</tr>
<tr>
<td>disable_notification</td>
@ -4764,7 +4788,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -4820,7 +4844,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -5049,67 +5073,67 @@ pre-formatted fixed-width code block written in the Python programming language
<td>is_anonymous</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator&#39;s presence in the chat is hidden</td>
<td>Pass <em>True</em> if the administrator&#39;s presence in the chat is hidden</td>
</tr>
<tr>
<td>can_manage_chat</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege</td>
<td>Pass <em>True</em> if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege</td>
</tr>
<tr>
<td>can_post_messages</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can create channel posts, channels only</td>
<td>Pass <em>True</em> if the administrator can create channel posts, channels only</td>
</tr>
<tr>
<td>can_edit_messages</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can edit messages of other users and can pin messages, channels only</td>
<td>Pass <em>True</em> if the administrator can edit messages of other users and can pin messages, channels only</td>
</tr>
<tr>
<td>can_delete_messages</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can delete messages of other users</td>
<td>Pass <em>True</em> if the administrator can delete messages of other users</td>
</tr>
<tr>
<td>can_manage_video_chats</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can manage video chats</td>
<td>Pass <em>True</em> if the administrator can manage video chats</td>
</tr>
<tr>
<td>can_restrict_members</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can restrict, ban or unban chat members</td>
<td>Pass <em>True</em> if the administrator can restrict, ban or unban chat members</td>
</tr>
<tr>
<td>can_promote_members</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by him)</td>
<td>Pass <em>True</em> if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by him)</td>
</tr>
<tr>
<td>can_change_info</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can change chat title, photo and other settings</td>
<td>Pass <em>True</em> if the administrator can change chat title, photo and other settings</td>
</tr>
<tr>
<td>can_invite_users</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can invite new users to the chat</td>
<td>Pass <em>True</em> if the administrator can invite new users to the chat</td>
</tr>
<tr>
<td>can_pin_messages</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the administrator can pin messages, supergroups only</td>
<td>Pass <em>True</em> if the administrator can pin messages, supergroups only</td>
</tr>
</tbody>
</table>
@ -5544,7 +5568,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>disable_notification</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats.</td>
<td>Pass <em>True</em> if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats.</td>
</tr>
</tbody>
</table>
@ -5635,7 +5659,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody>
</table>
<h4><a class="anchor" name="getchatadministrators" href="#getchatadministrators"><i class="anchor-icon"></i></a>getChatAdministrators</h4>
<p>Use this method to get a list of administrators in a chat. On success, returns an Array of <a href="#chatmember">ChatMember</a> objects that contains information about all chat administrators except other bots. If the chat is a group or a supergroup and no administrators were appointed, only the creator will be returned.</p>
<p>Use this method to get a list of administrators in a chat, which aren&#39;t bots. Returns an Array of <a href="#chatmember">ChatMember</a> objects.</p>
<table class="table">
<thead>
<tr>
@ -5852,7 +5876,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody>
</table>
<h4><a class="anchor" name="getmycommands" href="#getmycommands"><i class="anchor-icon"></i></a>getMyCommands</h4>
<p>Use this method to get the current list of the bot&#39;s commands for the given scope and user language. Returns Array of <a href="#botcommand">BotCommand</a> on success. If commands aren&#39;t set, an empty list is returned.</p>
<p>Use this method to get the current list of the bot&#39;s commands for the given scope and user language. Returns an Array of <a href="#botcommand">BotCommand</a> objects. If commands aren&#39;t set, an empty list is returned.</p>
<table class="table">
<thead>
<tr>
@ -6256,6 +6280,11 @@ pre-formatted fixed-width code block written in the Python programming language
<td>Unique identifier for this file, which is supposed to be the same over time and for different bots. Can&#39;t be used to download or reuse the file.</td>
</tr>
<tr>
<td>type</td>
<td>String</td>
<td>Type of the sticker, currently one of “regular”, “mask”, “custom_emoji”. The type of the sticker is independent from its format, which is determined by the fields <em>is_animated</em> and <em>is_video</em>.</td>
</tr>
<tr>
<td>width</td>
<td>Integer</td>
<td>Sticker width</td>
@ -6293,7 +6322,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr>
<td>premium_animation</td>
<td><a href="#file">File</a></td>
<td><em>Optional</em>. Premium animation for the sticker, if the sticker is premium</td>
<td><em>Optional</em>. For premium regular stickers, premium animation for the sticker</td>
</tr>
<tr>
<td>mask_position</td>
@ -6301,6 +6330,11 @@ pre-formatted fixed-width code block written in the Python programming language
<td><em>Optional</em>. For mask stickers, the position where the mask should be placed</td>
</tr>
<tr>
<td>custom_emoji_id</td>
<td>String</td>
<td><em>Optional</em>. For custom emoji stickers, unique identifier of the custom emoji</td>
</tr>
<tr>
<td>file_size</td>
<td>Integer</td>
<td><em>Optional</em>. File size in bytes</td>
@ -6329,6 +6363,11 @@ pre-formatted fixed-width code block written in the Python programming language
<td>Sticker set title</td>
</tr>
<tr>
<td>sticker_type</td>
<td>String</td>
<td>Type of stickers in the set, currently one of “regular”, “mask”, “custom_emoji”</td>
</tr>
<tr>
<td>is_animated</td>
<td>Boolean</td>
<td><em>True</em>, if the sticker set contains <a href="https://telegram.org/blog/animated-stickers">animated stickers</a></td>
@ -6339,11 +6378,6 @@ pre-formatted fixed-width code block written in the Python programming language
<td><em>True</em>, if the sticker set contains <a href="https://telegram.org/blog/video-stickers-better-reactions">video stickers</a></td>
</tr>
<tr>
<td>contains_masks</td>
<td>Boolean</td>
<td><em>True</em>, if the sticker set contains masks</td>
</tr>
<tr>
<td>stickers</td>
<td>Array of <a href="#sticker">Sticker</a></td>
<td>List of all set stickers</td>
@ -6434,7 +6468,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -6464,6 +6498,26 @@ pre-formatted fixed-width code block written in the Python programming language
</tr>
</tbody>
</table>
<h4><a class="anchor" name="getcustomemojistickers" href="#getcustomemojistickers"><i class="anchor-icon"></i></a>getCustomEmojiStickers</h4>
<p>Use this method to get information about custom emoji stickers by their identifiers. Returns an Array of <a href="#sticker">Sticker</a> objects.</p>
<table class="table">
<thead>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>custom_emoji_ids</td>
<td>Array of String</td>
<td>Yes</td>
<td>List of custom emoji identifiers. At most 200 custom emoji identifiers can be specified.</td>
</tr>
</tbody>
</table>
<h4><a class="anchor" name="uploadstickerfile" href="#uploadstickerfile"><i class="anchor-icon"></i></a>uploadStickerFile</h4>
<p>Use this method to upload a .PNG file with a sticker for later use in <em>createNewStickerSet</em> and <em>addStickerToSet</em> methods (can be used multiple times). Returns the uploaded <a href="#file">File</a> on success.</p>
<table class="table">
@ -6539,18 +6593,18 @@ pre-formatted fixed-width code block written in the Python programming language
<td><strong>WEBM</strong> video with the sticker, uploaded using multipart/form-data. See <a href="https://core.telegram.org/stickers#video-sticker-requirements"><a href="https://core.telegram.org/stickers#video-sticker-requirements">https://core.telegram.org/stickers#video-sticker-requirements</a></a> for technical requirements</td>
</tr>
<tr>
<td>sticker_type</td>
<td>String</td>
<td>Optional</td>
<td>Type of stickers in the set, pass “regular” or “mask”. Custom emoji sticker sets can&#39;t be created via the Bot API at the moment. By default, a regular sticker set is created.</td>
</tr>
<tr>
<td>emojis</td>
<td>String</td>
<td>Yes</td>
<td>One or more emoji corresponding to the sticker</td>
</tr>
<tr>
<td>contains_masks</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if a set of mask stickers should be created</td>
</tr>
<tr>
<td>mask_position</td>
<td><a href="#maskposition">MaskPosition</a></td>
<td>Optional</td>
@ -6772,7 +6826,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>is_personal</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query</td>
<td>Pass <em>True</em> if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query</td>
</tr>
<tr>
<td>next_offset</td>
@ -6863,7 +6917,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr>
<td>hide_url</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if you don&#39;t want the URL to be shown in the message</td>
<td><em>Optional</em>. Pass <em>True</em> if you don&#39;t want the URL to be shown in the message</td>
</tr>
<tr>
<td>description</td>
@ -8423,37 +8477,37 @@ pre-formatted fixed-width code block written in the Python programming language
<tr>
<td>need_name</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if you require the user&#39;s full name to complete the order</td>
<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s full name to complete the order</td>
</tr>
<tr>
<td>need_phone_number</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if you require the user&#39;s phone number to complete the order</td>
<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s phone number to complete the order</td>
</tr>
<tr>
<td>need_email</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if you require the user&#39;s email address to complete the order</td>
<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s email address to complete the order</td>
</tr>
<tr>
<td>need_shipping_address</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if you require the user&#39;s shipping address to complete the order</td>
<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s shipping address to complete the order</td>
</tr>
<tr>
<td>send_phone_number_to_provider</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if the user&#39;s phone number should be sent to provider</td>
<td><em>Optional</em>. Pass <em>True</em> if the user&#39;s phone number should be sent to provider</td>
</tr>
<tr>
<td>send_email_to_provider</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if the user&#39;s email address should be sent to provider</td>
<td><em>Optional</em>. Pass <em>True</em> if the user&#39;s email address should be sent to provider</td>
</tr>
<tr>
<td>is_flexible</td>
<td>Boolean</td>
<td><em>Optional</em>. Pass <em>True</em>, if the final price depends on the shipping method</td>
<td><em>Optional</em>. Pass <em>True</em> if the final price depends on the shipping method</td>
</tr>
</tbody>
</table>
@ -8648,43 +8702,43 @@ pre-formatted fixed-width code block written in the Python programming language
<td>need_name</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if you require the user&#39;s full name to complete the order</td>
<td>Pass <em>True</em> if you require the user&#39;s full name to complete the order</td>
</tr>
<tr>
<td>need_phone_number</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if you require the user&#39;s phone number to complete the order</td>
<td>Pass <em>True</em> if you require the user&#39;s phone number to complete the order</td>
</tr>
<tr>
<td>need_email</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if you require the user&#39;s email address to complete the order</td>
<td>Pass <em>True</em> if you require the user&#39;s email address to complete the order</td>
</tr>
<tr>
<td>need_shipping_address</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if you require the user&#39;s shipping address to complete the order</td>
<td>Pass <em>True</em> if you require the user&#39;s shipping address to complete the order</td>
</tr>
<tr>
<td>send_phone_number_to_provider</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the user&#39;s phone number should be sent to provider</td>
<td>Pass <em>True</em> if the user&#39;s phone number should be sent to provider</td>
</tr>
<tr>
<td>send_email_to_provider</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the user&#39;s email address should be sent to provider</td>
<td>Pass <em>True</em> if the user&#39;s email address should be sent to provider</td>
</tr>
<tr>
<td>is_flexible</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the final price depends on the shipping method</td>
<td>Pass <em>True</em> if the final price depends on the shipping method</td>
</tr>
<tr>
<td>disable_notification</td>
@ -8708,7 +8762,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -8812,43 +8866,43 @@ pre-formatted fixed-width code block written in the Python programming language
<td>need_name</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if you require the user&#39;s full name to complete the order</td>
<td>Pass <em>True</em> if you require the user&#39;s full name to complete the order</td>
</tr>
<tr>
<td>need_phone_number</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if you require the user&#39;s phone number to complete the order</td>
<td>Pass <em>True</em> if you require the user&#39;s phone number to complete the order</td>
</tr>
<tr>
<td>need_email</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if you require the user&#39;s email address to complete the order</td>
<td>Pass <em>True</em> if you require the user&#39;s email address to complete the order</td>
</tr>
<tr>
<td>need_shipping_address</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if you require the user&#39;s shipping address to complete the order</td>
<td>Pass <em>True</em> if you require the user&#39;s shipping address to complete the order</td>
</tr>
<tr>
<td>send_phone_number_to_provider</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the user&#39;s phone number should be sent to the provider</td>
<td>Pass <em>True</em> if the user&#39;s phone number should be sent to the provider</td>
</tr>
<tr>
<td>send_email_to_provider</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the user&#39;s email address should be sent to the provider</td>
<td>Pass <em>True</em> if the user&#39;s email address should be sent to the provider</td>
</tr>
<tr>
<td>is_flexible</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the final price depends on the shipping method</td>
<td>Pass <em>True</em> if the final price depends on the shipping method</td>
</tr>
</tbody>
</table>
@ -8874,7 +8928,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>ok</td>
<td>Boolean</td>
<td>Yes</td>
<td>Specify <em>True</em> if delivery to the specified address is possible and False if there are any problems (for example, if delivery to the specified address is not possible)</td>
<td>Pass <em>True</em> if delivery to the specified address is possible and <em>False</em> if there are any problems (for example, if delivery to the specified address is not possible)</td>
</tr>
<tr>
<td>shipping_options</td>
@ -8886,7 +8940,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>error_message</td>
<td>String</td>
<td>Optional</td>
<td>Required if <em>ok</em> is False. Error message in human readable form that explains why it is impossible to complete the order (e.g. &quot;Sorry, delivery to your desired address is unavailable&#39;). Telegram will display this message to the user.</td>
<td>Required if <em>ok</em> is <em>False</em>. Error message in human readable form that explains why it is impossible to complete the order (e.g. &quot;Sorry, delivery to your desired address is unavailable&#39;). Telegram will display this message to the user.</td>
</tr>
</tbody>
</table>
@ -9766,7 +9820,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>allow_sending_without_reply</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the message should be sent even if the specified replied-to message is not found</td>
<td>Pass <em>True</em> if the message should be sent even if the specified replied-to message is not found</td>
</tr>
<tr>
<td>reply_markup</td>
@ -9849,13 +9903,13 @@ pre-formatted fixed-width code block written in the Python programming language
<td>force</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters</td>
<td>Pass <em>True</em> if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters</td>
</tr>
<tr>
<td>disable_edit_message</td>
<td>Boolean</td>
<td>Optional</td>
<td>Pass <em>True</em>, if the game message should not be automatically edited to include the current scoreboard</td>
<td>Pass <em>True</em> if the game message should not be automatically edited to include the current scoreboard</td>
</tr>
<tr>
<td>chat_id</td>
@ -9878,7 +9932,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody>
</table>
<h4><a class="anchor" name="getgamehighscores" href="#getgamehighscores"><i class="anchor-icon"></i></a>getGameHighScores</h4>
<p>Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in a game. On success, returns an <em>Array</em> of <a href="#gamehighscore">GameHighScore</a> objects.</p>
<p>Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in a game. Returns an Array of <a href="#gamehighscore">GameHighScore</a> objects.</p>
<blockquote>
<p>This method will currently return scores for the target user, plus two of their closest neighbors on each side. Will also return the top three users if the user and their neighbors are not among them. Please note that this behavior is subject to change.</p>
</blockquote>