OpenSource/telegram-crawler
OpenSource/telegram-crawler
1
0
Fork 0
mirror of https://github.com/MarshalX/telegram-crawler.git synced 2024-12-28 07:20:31 +01:00
Code Issues Projects Releases Packages Wiki Activity

Update content of files

Browse source
This commit is contained in:
GitHub Action 2022-06-15 14:32:57 +00:00
parent 6d705f0c76
commit 171c7a529f
4 changed files with 305 additions and 150 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

148
data/web/core.telegram.org/bots/api.html
View file

@ -140,7 +140,7 @@ To learn how to create…">
<h4><a class="anchor" name="do-i-need-a-local-bot-api-server" href="#do-i-need-a-local-bot-api-server"><i class="anchor-icon"></i></a>Do I need a Local Bot API Server</h4> <h4><a class="anchor" name="do-i-need-a-local-bot-api-server" href="#do-i-need-a-local-bot-api-server"><i class="anchor-icon"></i></a>Do I need a Local Bot API Server</h4>
<p>The majority of bots will be OK with the default configuration, running on our servers. But if you feel that you need one of <a href="#using-a-local-bot-api-server">these features</a>, you&#39;re welcome to switch to your own at any time.</p> <p>The majority of bots will be OK with the default configuration, running on our servers. But if you feel that you need one of <a href="#using-a-local-bot-api-server">these features</a>, you&#39;re welcome to switch to your own at any time.</p>
<h3><a class="anchor" name="getting-updates" href="#getting-updates"><i class="anchor-icon"></i></a>Getting updates</h3> <h3><a class="anchor" name="getting-updates" href="#getting-updates"><i class="anchor-icon"></i></a>Getting updates</h3>
<p>There are two mutually exclusive ways of receiving updates for your bot — the <a href="#getupdates">getUpdates</a> method on one hand and <a href="#setwebhook">webhooks</a> on the other. Incoming updates are stored on the server until the bot receives them either way, but they will not be kept longer than 24 hours.</p> <p>There are two mutually exclusive ways of receiving updates for your bot - the <a href="#getupdates">getUpdates</a> method on one hand and <a href="#setwebhook">webhooks</a> on the other. Incoming updates are stored on the server until the bot receives them either way, but they will not be kept longer than 24 hours.</p>
<p>Regardless of which option you choose, you will receive JSON-serialized <a href="#update">Update</a> objects as a result.</p> <p>Regardless of which option you choose, you will receive JSON-serialized <a href="#update">Update</a> objects as a result.</p>
<h4><a class="anchor" name="update" href="#update"><i class="anchor-icon"></i></a>Update</h4> <h4><a class="anchor" name="update" href="#update"><i class="anchor-icon"></i></a>Update</h4>
<p>This <a href="#available-types">object</a> represents an incoming update.<br>At most <strong>one</strong> of the optional parameters can be present in any given update.</p> <p>This <a href="#available-types">object</a> represents an incoming update.<br>At most <strong>one</strong> of the optional parameters can be present in any given update.</p>
@ -161,7 +161,7 @@ To learn how to create…">
<tr> <tr>
<td>message</td> <td>message</td>
<td><a href="#message">Message</a></td> <td><a href="#message">Message</a></td>
<td><em>Optional</em>. New incoming message of any kind — text, photo, sticker, etc.</td> <td><em>Optional</em>. New incoming message of any kind - text, photo, sticker, etc.</td>
</tr> </tr>
<tr> <tr>
<td>edited_message</td> <td>edited_message</td>
@ -171,7 +171,7 @@ To learn how to create…">
<tr> <tr>
<td>channel_post</td> <td>channel_post</td>
<td><a href="#message">Message</a></td> <td><a href="#message">Message</a></td>
<td><em>Optional</em>. New incoming channel post of any kind — text, photo, sticker, etc.</td> <td><em>Optional</em>. New incoming channel post of any kind - text, photo, sticker, etc.</td>
</tr> </tr>
<tr> <tr>
<td>edited_channel_post</td> <td>edited_channel_post</td>
@ -306,7 +306,7 @@ To learn how to create…">
<td>max_connections</td> <td>max_connections</td>
<td>Integer</td> <td>Integer</td>
<td>Optional</td> <td>Optional</td>
<td>Maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to <em>40</em>. Use lower values to limit the load on your bot&#39;s server, and higher values to increase your bot&#39;s throughput.</td> <td>The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to <em>40</em>. Use lower values to limit the load on your bot&#39;s server, and higher values to increase your bot&#39;s throughput.</td>
</tr> </tr>
<tr> <tr>
<td>allowed_updates</td> <td>allowed_updates</td>
@ -349,7 +349,7 @@ To learn how to create…">
<h4><a class="anchor" name="getwebhookinfo" href="#getwebhookinfo"><i class="anchor-icon"></i></a>getWebhookInfo</h4> <h4><a class="anchor" name="getwebhookinfo" href="#getwebhookinfo"><i class="anchor-icon"></i></a>getWebhookInfo</h4>
<p>Use this method to get current webhook status. Requires no parameters. On success, returns a <a href="#webhookinfo">WebhookInfo</a> object. If the bot is using <a href="#getupdates">getUpdates</a>, will return an object with the <em>url</em> field empty.</p> <p>Use this method to get current webhook status. Requires no parameters. On success, returns a <a href="#webhookinfo">WebhookInfo</a> object. If the bot is using <a href="#getupdates">getUpdates</a>, will return an object with the <em>url</em> field empty.</p>
<h4><a class="anchor" name="webhookinfo" href="#webhookinfo"><i class="anchor-icon"></i></a>WebhookInfo</h4> <h4><a class="anchor" name="webhookinfo" href="#webhookinfo"><i class="anchor-icon"></i></a>WebhookInfo</h4>
<p>Contains information about the current status of a webhook.</p> <p>Describes the current status of a webhook.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -397,7 +397,7 @@ To learn how to create…">
<tr> <tr>
<td>max_connections</td> <td>max_connections</td>
<td>Integer</td> <td>Integer</td>
<td><em>Optional</em>. Maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery</td> <td><em>Optional</em>. The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery</td>
</tr> </tr>
<tr> <tr>
<td>allowed_updates</td> <td>allowed_updates</td>
@ -524,7 +524,7 @@ To learn how to create…">
<tr> <tr>
<td>has_private_forwards</td> <td>has_private_forwards</td>
<td>True</td> <td>True</td>
<td><em>Optional</em>. True, 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> <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>
<tr> <tr>
<td>description</td> <td>description</td>
@ -559,7 +559,7 @@ To learn how to create…">
<tr> <tr>
<td>has_protected_content</td> <td>has_protected_content</td>
<td>True</td> <td>True</td>
<td><em>Optional</em>. True, if messages from the chat can&#39;t be forwarded to other chats. Returned only in <a href="#getchat">getChat</a>.</td> <td><em>Optional</em>. <em>True</em>, if messages from the chat can&#39;t be forwarded to other chats. Returned only in <a href="#getchat">getChat</a>.</td>
</tr> </tr>
<tr> <tr>
<td>sticker_set_name</td> <td>sticker_set_name</td>
@ -607,7 +607,7 @@ To learn how to create…">
<tr> <tr>
<td>sender_chat</td> <td>sender_chat</td>
<td><a href="#chat">Chat</a></td> <td><a href="#chat">Chat</a></td>
<td><em>Optional</em>. Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, the field <em>from</em> contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.</td> <td><em>Optional</em>. Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, the field <em>from</em> contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.</td>
</tr> </tr>
<tr> <tr>
<td>date</td> <td>date</td>
@ -652,7 +652,7 @@ To learn how to create…">
<tr> <tr>
<td>is_automatic_forward</td> <td>is_automatic_forward</td>
<td>True</td> <td>True</td>
<td><em>Optional</em>. True, if the message is a channel post that was automatically forwarded to the connected discussion group</td> <td><em>Optional</em>. <em>True</em>, if the message is a channel post that was automatically forwarded to the connected discussion group</td>
</tr> </tr>
<tr> <tr>
<td>reply_to_message</td> <td>reply_to_message</td>
@ -672,7 +672,7 @@ To learn how to create…">
<tr> <tr>
<td>has_protected_content</td> <td>has_protected_content</td>
<td>True</td> <td>True</td>
<td><em>Optional</em>. True, if the message can&#39;t be forwarded</td> <td><em>Optional</em>. <em>True</em>, if the message can&#39;t be forwarded</td>
</tr> </tr>
<tr> <tr>
<td>media_group_id</td> <td>media_group_id</td>
@ -1198,7 +1198,7 @@ To learn how to create…">
<tr> <tr>
<td>mime_type</td> <td>mime_type</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. Mime type of the file as defined by sender</td> <td><em>Optional</em>. MIME type of the file as defined by sender</td>
</tr> </tr>
<tr> <tr>
<td>file_size</td> <td>file_size</td>
@ -1517,7 +1517,7 @@ To learn how to create…">
<tr> <tr>
<td>proximity_alert_radius</td> <td>proximity_alert_radius</td>
<td>Integer</td> <td>Integer</td>
<td><em>Optional</em>. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.</td> <td><em>Optional</em>. The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -1570,7 +1570,7 @@ To learn how to create…">
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="webappdata" href="#webappdata"><i class="anchor-icon"></i></a>WebAppData</h4> <h4><a class="anchor" name="webappdata" href="#webappdata"><i class="anchor-icon"></i></a>WebAppData</h4>
<p>Contains data sent from a <a href="/bots/webapps">Web App</a> to the bot.</p> <p>Describes data sent from a <a href="/bots/webapps">Web App</a> to the bot.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -1588,7 +1588,7 @@ To learn how to create…">
<tr> <tr>
<td>button_text</td> <td>button_text</td>
<td>String</td> <td>String</td>
<td>Text of the <em>web_app</em> keyboard button, from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.</td> <td>Text of the <em>web_app</em> keyboard button from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -1720,7 +1720,7 @@ To learn how to create…">
<h4><a class="anchor" name="file" href="#file"><i class="anchor-icon"></i></a>File</h4> <h4><a class="anchor" name="file" href="#file"><i class="anchor-icon"></i></a>File</h4>
<p>This object represents a file ready to be downloaded. The file can be downloaded via the link <code>https://api.telegram.org/file/bot&lt;token&gt;/&lt;file_path&gt;</code>. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling <a href="#getfile">getFile</a>.</p> <p>This object represents a file ready to be downloaded. The file can be downloaded via the link <code>https://api.telegram.org/file/bot&lt;token&gt;/&lt;file_path&gt;</code>. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling <a href="#getfile">getFile</a>.</p>
<blockquote> <blockquote>
<p>Maximum file size to download is 20 MB</p> <p>The maximum file size to download is 20 MB</p>
</blockquote> </blockquote>
<table class="table"> <table class="table">
<thead> <thead>
@ -1754,7 +1754,7 @@ To learn how to create…">
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="webappinfo" href="#webappinfo"><i class="anchor-icon"></i></a>WebAppInfo</h4> <h4><a class="anchor" name="webappinfo" href="#webappinfo"><i class="anchor-icon"></i></a>WebAppInfo</h4>
<p>Contains information about a <a href="/bots/webapps">Web App</a>.</p> <p>Describes a <a href="/bots/webapps">Web App</a>.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -1795,7 +1795,7 @@ To learn how to create…">
<tr> <tr>
<td>one_time_keyboard</td> <td>one_time_keyboard</td>
<td>Boolean</td> <td>Boolean</td>
<td><em>Optional</em>. Requests clients to hide the keyboard as soon as it&#39;s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat – the user can press a special button in the input field to see the custom keyboard again. Defaults to <em>false</em>.</td> <td><em>Optional</em>. Requests clients to hide the keyboard as soon as it&#39;s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to <em>false</em>.</td>
</tr> </tr>
<tr> <tr>
<td>input_field_placeholder</td> <td>input_field_placeholder</td>
@ -1947,12 +1947,12 @@ To learn how to create…">
<tr> <tr>
<td>switch_inline_query</td> <td>switch_inline_query</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot&#39;s username and the specified inline query in the input field. Can be empty, in which case just the bot&#39;s username will be inserted.<br><br><strong>Note:</strong> This offers an easy way for users to start using your bot in <a href="/bots/inline">inline mode</a> when they are currently in a private chat with it. Especially useful when combined with <a href="#answerinlinequery"><em>switch_pm…</em></a> actions – in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen.</td> <td><em>Optional</em>. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot&#39;s username and the specified inline query in the input field. May be empty, in which case just the bot&#39;s username will be inserted.<br><br><strong>Note:</strong> This offers an easy way for users to start using your bot in <a href="/bots/inline">inline mode</a> when they are currently in a private chat with it. Especially useful when combined with <a href="#answerinlinequery"><em>switch_pm…</em></a> actions - in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen.</td>
</tr> </tr>
<tr> <tr>
<td>switch_inline_query_current_chat</td> <td>switch_inline_query_current_chat</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. If set, pressing the button will insert the bot&#39;s username and the specified inline query in the current chat&#39;s input field. Can be empty, in which case only the bot&#39;s username will be inserted.<br><br>This offers a quick way for the user to open your bot in inline mode in the same chat – good for selecting something from multiple options.</td> <td><em>Optional</em>. If set, pressing the button will insert the bot&#39;s username and the specified inline query in the current chat&#39;s input field. May be empty, in which case only the bot&#39;s username will be inserted.<br><br>This offers a quick way for the user to open your bot in inline mode in the same chat - good for selecting something from multiple options.</td>
</tr> </tr>
<tr> <tr>
<td>callback_game</td> <td>callback_game</td>
@ -2046,7 +2046,7 @@ To learn how to create…">
<tr> <tr>
<td>data</td> <td>data</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. Data associated with the callback button. Be aware that the message, from which originated the query, can contain no callback buttons with this data.</td> <td><em>Optional</em>. Data associated with the callback button. Be aware that the message originated the query can contain no callback buttons with this data.</td>
</tr> </tr>
<tr> <tr>
<td>game_short_name</td> <td>game_short_name</td>
@ -2092,7 +2092,7 @@ To learn how to create…">
<li>Explain the user how to send a command with parameters (e.g. /newpoll question answer1 answer2). May be appealing for hardcore users but lacks modern day polish.</li> <li>Explain the user how to send a command with parameters (e.g. /newpoll question answer1 answer2). May be appealing for hardcore users but lacks modern day polish.</li>
<li>Guide the user through a step-by-step process. &#39;Please send me your question&#39;, &#39;Cool, now let&#39;s add the first answer option&#39;, &#39;Great. Keep adding answer options, then send /done when you&#39;re ready&#39;.</li> <li>Guide the user through a step-by-step process. &#39;Please send me your question&#39;, &#39;Cool, now let&#39;s add the first answer option&#39;, &#39;Great. Keep adding answer options, then send /done when you&#39;re ready&#39;.</li>
</ul> </ul>
<p>The last option is definitely more attractive. And if you use <a href="#forcereply">ForceReply</a> in your bot&#39;s questions, it will receive the user&#39;s answers even if it only receives replies, commands and mentions — without any extra work for the user.</p> <p>The last option is definitely more attractive. And if you use <a href="#forcereply">ForceReply</a> in your bot&#39;s questions, it will receive the user&#39;s answers even if it only receives replies, commands and mentions - without any extra work for the user.</p>
</blockquote> </blockquote>
<h4><a class="anchor" name="chatphoto" href="#chatphoto"><i class="anchor-icon"></i></a>ChatPhoto</h4> <h4><a class="anchor" name="chatphoto" href="#chatphoto"><i class="anchor-icon"></i></a>ChatPhoto</h4>
<p>This object represents a chat photo.</p> <p>This object represents a chat photo.</p>
@ -2176,7 +2176,7 @@ To learn how to create…">
<tr> <tr>
<td>member_limit</td> <td>member_limit</td>
<td>Integer</td> <td>Integer</td>
<td><em>Optional</em>. Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td> <td><em>Optional</em>. The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td>
</tr> </tr>
<tr> <tr>
<td>pending_join_request_count</td> <td>pending_join_request_count</td>
@ -2967,7 +2967,7 @@ To learn how to create…">
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="responseparameters" href="#responseparameters"><i class="anchor-icon"></i></a>ResponseParameters</h4> <h4><a class="anchor" name="responseparameters" href="#responseparameters"><i class="anchor-icon"></i></a>ResponseParameters</h4>
<p>Contains information about why a request was unsuccessful.</p> <p>Describes why a request was unsuccessful.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -3017,7 +3017,7 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3055,12 +3055,12 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3118,12 +3118,12 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3176,12 +3176,12 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3234,12 +3234,12 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3266,7 +3266,7 @@ To learn how to create…">
<h4><a class="anchor" name="inputfile" href="#inputfile"><i class="anchor-icon"></i></a>InputFile</h4> <h4><a class="anchor" name="inputfile" href="#inputfile"><i class="anchor-icon"></i></a>InputFile</h4>
<p>This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.</p> <p>This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.</p>
<h4><a class="anchor" name="sending-files" href="#sending-files"><i class="anchor-icon"></i></a>Sending files</h4> <h4><a class="anchor" name="sending-files" href="#sending-files"><i class="anchor-icon"></i></a>Sending files</h4>
<p> There are three ways to send files (photos, stickers, audio, media, etc.):</p> <p>There are three ways to send files (photos, stickers, audio, media, etc.):</p>
<ol> <ol>
<li>If the file is already stored somewhere on the Telegram servers, you don&#39;t need to reupload it: each file object has a <strong>file_id</strong> field, simply pass this <strong>file_id</strong> as a parameter instead of uploading. There are <strong>no limits</strong> for files sent this way.</li> <li>If the file is already stored somewhere on the Telegram servers, you don&#39;t need to reupload it: each file object has a <strong>file_id</strong> field, simply pass this <strong>file_id</strong> as a parameter instead of uploading. There are <strong>no limits</strong> for files sent this way.</li>
<li>Provide Telegram with an HTTP URL for the file to be sent. Telegram will download and send the file. 5 MB max size for photos and 20 MB max for other types of content.</li> <li>Provide Telegram with an HTTP URL for the file to be sent. Telegram will download and send the file. 5 MB max size for photos and 20 MB max for other types of content.</li>
@ -3376,7 +3376,7 @@ To learn how to create…">
<h4><a class="anchor" name="formatting-options" href="#formatting-options"><i class="anchor-icon"></i></a>Formatting options</h4> <h4><a class="anchor" name="formatting-options" href="#formatting-options"><i class="anchor-icon"></i></a>Formatting options</h4>
<p>The Bot API supports basic formatting for messages. You can use bold, italic, underlined, strikethrough, and spoiler text, as well as inline links and pre-formatted code in your bots&#39; messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.</p> <p>The Bot API supports basic formatting for messages. You can use bold, italic, underlined, strikethrough, and spoiler text, as well as inline links and pre-formatted code in your bots&#39; messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.</p>
<p>Note that Telegram clients will display an <strong>alert</strong> to the user before opening an inline link (&#39;Open this link?&#39; together with the full URL).</p> <p>Note that Telegram clients will display an <strong>alert</strong> to the user before opening an inline link (&#39;Open this link?&#39; together with the full URL).</p>
<p>Message entities can be nested, providing following restrictions are met:<br>- If two entities have common characters then one of them is fully contained inside another.<br>- <em>bold</em>, <em>italic</em>, <em>underline</em>, <em>strikethrough</em>, and <em>spoiler</em> entities can contain and can be part of any other entities, except <em>pre</em> and <em>code</em>.<br>- All other entities can&#39;t contain each other.</p> <p>Message entities can be nested, providing following restrictions are met:<br>- If two entities have common characters, then one of them is fully contained inside another.<br>- <em>bold</em>, <em>italic</em>, <em>underline</em>, <em>strikethrough</em>, and <em>spoiler</em> entities can contain and can be part of any other entities, except <em>pre</em> and <em>code</em>.<br>- All other entities can&#39;t contain each other.</p>
<p>Links <code>tg://user?id=&lt;user_id&gt;</code> can be used to mention a user by their ID without using a username. Please note:</p> <p>Links <code>tg://user?id=&lt;user_id&gt;</code> can be used to mention a user by their ID without using a username. Please note:</p>
<ul> <ul>
<li>These links will work <strong>only</strong> if they are used inside an inline link or in an inline keyboard button. For example, they will not work, when used in a message text.</li> <li>These links will work <strong>only</strong> if they are used inside an inline link or in an inline keyboard button. For example, they will not work, when used in a message text.</li>
@ -3595,7 +3595,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>photo</td> <td>photo</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo&#39;s width and height must not exceed 10000 in total. Width and height ratio must be at most 20. <a href="#sending-files">More info on Sending Files »</a></td> <td>Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo&#39;s width and height must not exceed 10000 in total. Width and height ratio must be at most 20. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3670,7 +3670,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>audio</td> <td>audio</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3712,7 +3712,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>disable_notification</td> <td>disable_notification</td>
@ -3768,13 +3768,13 @@ pre-formatted fixed-width code block written in the Python programming language
<td>document</td> <td>document</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3833,7 +3833,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="sendvideo" href="#sendvideo"><i class="anchor-icon"></i></a>sendVideo</h4> <h4><a class="anchor" name="sendvideo" href="#sendvideo"><i class="anchor-icon"></i></a>sendVideo</h4>
<p>Use this method to send video files, Telegram clients support mp4 videos (other formats may be sent as <a href="#document">Document</a>). On success, the sent <a href="#message">Message</a> is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.</p> <p>Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as <a href="#document">Document</a>). On success, the sent <a href="#message">Message</a> is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -3854,7 +3854,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>video</td> <td>video</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>duration</td> <td>duration</td>
@ -3878,7 +3878,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3958,7 +3958,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>animation</td> <td>animation</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>duration</td> <td>duration</td>
@ -3982,7 +3982,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -4056,7 +4056,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>voice</td> <td>voice</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -4115,7 +4115,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="sendvideonote" href="#sendvideonote"><i class="anchor-icon"></i></a>sendVideoNote</h4> <h4><a class="anchor" name="sendvideonote" href="#sendvideonote"><i class="anchor-icon"></i></a>sendVideoNote</h4>
<p>As of <a href="https://telegram.org/blog/video-messages-and-telescope">v.4.0</a>, Telegram clients support rounded square mp4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent <a href="#message">Message</a> is returned.</p> <p>As of <a href="https://telegram.org/blog/video-messages-and-telescope">v.4.0</a>, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent <a href="#message">Message</a> is returned.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -4136,7 +4136,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>video_note</td> <td>video_note</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a>. Sending video notes by a URL is currently unsupported</td> <td>Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a>. Sending video notes by a URL is currently unsupported</td>
</tr> </tr>
<tr> <tr>
<td>duration</td> <td>duration</td>
@ -4154,7 +4154,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>disable_notification</td> <td>disable_notification</td>
@ -4382,7 +4382,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>proximity_alert_radius</td> <td>proximity_alert_radius</td>
<td>Integer</td> <td>Integer</td>
<td>Optional</td> <td>Optional</td>
<td>Maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.</td> <td>The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.</td>
</tr> </tr>
<tr> <tr>
<td>reply_markup</td> <td>reply_markup</td>
@ -4843,7 +4843,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="getfile" href="#getfile"><i class="anchor-icon"></i></a>getFile</h4> <h4><a class="anchor" name="getfile" href="#getfile"><i class="anchor-icon"></i></a>getFile</h4>
<p>Use this method to get basic info about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a <a href="#file">File</a> object is returned. The file can then be downloaded via the link <code>https://api.telegram.org/file/bot&lt;token&gt;/&lt;file_path&gt;</code>, where <code>&lt;file_path&gt;</code> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling <a href="#getfile">getFile</a> again.</p> <p>Use this method to get basic information about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a <a href="#file">File</a> object is returned. The file can then be downloaded via the link <code>https://api.telegram.org/file/bot&lt;token&gt;/&lt;file_path&gt;</code>, where <code>&lt;file_path&gt;</code> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling <a href="#getfile">getFile</a> again.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -4858,7 +4858,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>file_id</td> <td>file_id</td>
<td>String</td> <td>String</td>
<td>Yes</td> <td>Yes</td>
<td>File identifier to get info about</td> <td>File identifier to get information about</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -5230,7 +5230,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>member_limit</td> <td>member_limit</td>
<td>Integer</td> <td>Integer</td>
<td>Optional</td> <td>Optional</td>
<td>Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td> <td>The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td>
</tr> </tr>
<tr> <tr>
<td>creates_join_request</td> <td>creates_join_request</td>
@ -5280,7 +5280,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>member_limit</td> <td>member_limit</td>
<td>Integer</td> <td>Integer</td>
<td>Optional</td> <td>Optional</td>
<td>Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td> <td>The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td>
</tr> </tr>
<tr> <tr>
<td>creates_join_request</td> <td>creates_join_request</td>
@ -5733,7 +5733,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>url</td> <td>url</td>
<td>String</td> <td>String</td>
<td>Optional</td> <td>Optional</td>
<td>URL that will be opened by the user&#39;s client. If you have created a <a href="#game">Game</a> and accepted the conditions via <a href="https://t.me/botfather">@BotFather</a>, specify the URL that opens your game — note that this will only work if the query comes from a <a href="#inlinekeyboardbutton"><em>callback_game</em></a> button.<br><br>Otherwise, you may use links like <code>t.me/your_bot?start=XXXX</code> that open your bot with a parameter.</td> <td>URL that will be opened by the user&#39;s client. If you have created a <a href="#game">Game</a> and accepted the conditions via <a href="https://t.me/botfather">@BotFather</a>, specify the URL that opens your game - note that this will only work if the query comes from a <a href="#inlinekeyboardbutton"><em>callback_game</em></a> button.<br><br>Otherwise, you may use links like <code>t.me/your_bot?start=XXXX</code> that open your bot with a parameter.</td>
</tr> </tr>
<tr> <tr>
<td>cache_time</td> <td>cache_time</td>
@ -6355,7 +6355,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>sticker</td> <td>sticker</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>disable_notification</td> <td>disable_notification</td>
@ -6431,7 +6431,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>png_sticker</td> <td>png_sticker</td>
<td><a href="#inputfile">InputFile</a></td> <td><a href="#inputfile">InputFile</a></td>
<td>Yes</td> <td>Yes</td>
<td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. <a href="#sending-files">More info on Sending Files »</a></td> <td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -6457,7 +6457,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>name</td> <td>name</td>
<td>String</td> <td>String</td>
<td>Yes</td> <td>Yes</td>
<td>Short name of sticker set, to be used in <code>t.me/addstickers/</code> URLs (e.g., <em>animals</em>). Can contain only english letters, digits and underscores. Must begin with a letter, can&#39;t contain consecutive underscores and must end in <code>&quot;_by_&lt;bot_username&gt;&quot;</code>. <code>&lt;bot_username&gt;</code> is case insensitive. 1-64 characters.</td> <td>Short name of sticker set, to be used in <code>t.me/addstickers/</code> URLs (e.g., <em>animals</em>). Can contain only English letters, digits and underscores. Must begin with a letter, can&#39;t contain consecutive underscores and must end in <code>&quot;_by_&lt;bot_username&gt;&quot;</code>. <code>&lt;bot_username&gt;</code> is case insensitive. 1-64 characters.</td>
</tr> </tr>
<tr> <tr>
<td>title</td> <td>title</td>
@ -6469,7 +6469,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>png_sticker</td> <td>png_sticker</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>tgs_sticker</td> <td>tgs_sticker</td>
@ -6531,7 +6531,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>png_sticker</td> <td>png_sticker</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>tgs_sticker</td> <td>tgs_sticker</td>
@ -6633,7 +6633,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>A <strong>PNG</strong> image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a <strong>TGS</strong> animation with the thumbnail up to 32 kilobytes in size; see <a href="https://core.telegram.org/stickers#animated-sticker-requirements"><a href="https://core.telegram.org/stickers#animated-sticker-requirements">https://core.telegram.org/stickers#animated-sticker-requirements</a></a> for animated sticker technical requirements, or a <strong>WEBM</strong> video with the thumbnail up to 32 kilobytes in size; 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 video sticker technical requirements. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a>. Animated sticker set thumbnails can&#39;t be uploaded via HTTP URL.</td> <td>A <strong>PNG</strong> image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a <strong>TGS</strong> animation with the thumbnail up to 32 kilobytes in size; see <a href="https://core.telegram.org/stickers#animated-sticker-requirements"><a href="https://core.telegram.org/stickers#animated-sticker-requirements">https://core.telegram.org/stickers#animated-sticker-requirements</a></a> for animated sticker technical requirements, or a <strong>WEBM</strong> video with the thumbnail up to 32 kilobytes in size; 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 video sticker technical requirements. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a>. Animated sticker set thumbnails can&#39;t be uploaded via HTTP URL.</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -6674,7 +6674,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>chat_type</td> <td>chat_type</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. Type of the chat, from which the inline query was sent. Can be either “sender” for a private chat with the inline query sender, “private”, “group”, “supergroup”, or “channel”. The chat type should be always known for requests sent from official clients and most third-party clients, unless the request was sent from a secret chat</td> <td><em>Optional</em>. Type of the chat from which the inline query was sent. Can be either “sender” for a private chat with the inline query sender, “private”, “group”, “supergroup”, or “channel”. The chat type should be always known for requests sent from official clients and most third-party clients, unless the request was sent from a secret chat</td>
</tr> </tr>
<tr> <tr>
<td>location</td> <td>location</td>
@ -7017,7 +7017,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>mpeg4_url</td> <td>mpeg4_url</td>
<td>String</td> <td>String</td>
<td>A valid URL for the MP4 file. File size must not exceed 1MB</td> <td>A valid URL for the MPEG4 file. File size must not exceed 1MB</td>
</tr> </tr>
<tr> <tr>
<td>mpeg4_width</td> <td>mpeg4_width</td>
@ -7108,7 +7108,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>mime_type</td> <td>mime_type</td>
<td>String</td> <td>String</td>
<td>Mime type of the content of the video URL, “text/html” or “video/mp4”</td> <td>MIME type of the content of the video URL, “text/html” or “video/mp4”</td>
</tr> </tr>
<tr> <tr>
<td>thumb_url</td> <td>thumb_url</td>
@ -7349,7 +7349,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>mime_type</td> <td>mime_type</td>
<td>String</td> <td>String</td>
<td>Mime type of the content of the file, either “application/pdf” or “application/zip”</td> <td>MIME type of the content of the file, either “application/pdf” or “application/zip”</td>
</tr> </tr>
<tr> <tr>
<td>description</td> <td>description</td>
@ -7805,7 +7805,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>mpeg4_file_id</td> <td>mpeg4_file_id</td>
<td>String</td> <td>String</td>
<td>A valid file identifier for the MP4 file</td> <td>A valid file identifier for the MPEG4 file</td>
</tr> </tr>
<tr> <tr>
<td>title</td> <td>title</td>
@ -8468,7 +8468,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="sentwebappmessage" href="#sentwebappmessage"><i class="anchor-icon"></i></a>SentWebAppMessage</h4> <h4><a class="anchor" name="sentwebappmessage" href="#sentwebappmessage"><i class="anchor-icon"></i></a>SentWebAppMessage</h4>
<p>Contains information about an inline message sent by a <a href="/bots/webapps">Web App</a> on behalf of a user.</p> <p>Describes an inline message sent by a <a href="/bots/webapps">Web App</a> on behalf of a user.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -8808,7 +8808,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>country_code</td> <td>country_code</td>
<td>String</td> <td>String</td>
<td>ISO 3166-1 alpha-2 country code</td> <td>Two-letter ISO 3166-1 alpha-2 country code</td>
</tr> </tr>
<tr> <tr>
<td>state</td> <td>state</td>
@ -8932,7 +8932,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>order_info</td> <td>order_info</td>
<td><a href="#orderinfo">OrderInfo</a></td> <td><a href="#orderinfo">OrderInfo</a></td>
<td><em>Optional</em>. Order info provided by the user</td> <td><em>Optional</em>. Order information provided by the user</td>
</tr> </tr>
<tr> <tr>
<td>telegram_payment_charge_id</td> <td>telegram_payment_charge_id</td>
@ -9023,14 +9023,14 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>order_info</td> <td>order_info</td>
<td><a href="#orderinfo">OrderInfo</a></td> <td><a href="#orderinfo">OrderInfo</a></td>
<td><em>Optional</em>. Order info provided by the user</td> <td><em>Optional</em>. Order information provided by the user</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
<h3><a class="anchor" name="telegram-passport" href="#telegram-passport"><i class="anchor-icon"></i></a>Telegram Passport</h3> <h3><a class="anchor" name="telegram-passport" href="#telegram-passport"><i class="anchor-icon"></i></a>Telegram Passport</h3>
<p><strong>Telegram Passport</strong> is a unified authorization method for services that require personal identification. Users can upload their documents once, then instantly share their data with services that require real-world ID (finance, ICOs, etc.). Please see the <a href="/passport">manual</a> for details.</p> <p><strong>Telegram Passport</strong> is a unified authorization method for services that require personal identification. Users can upload their documents once, then instantly share their data with services that require real-world ID (finance, ICOs, etc.). Please see the <a href="/passport">manual</a> for details.</p>
<h4><a class="anchor" name="passportdata" href="#passportdata"><i class="anchor-icon"></i></a>PassportData</h4> <h4><a class="anchor" name="passportdata" href="#passportdata"><i class="anchor-icon"></i></a>PassportData</h4>
<p>Contains information about Telegram Passport data shared with the bot by the user.</p> <p>Describes Telegram Passport data shared with the bot by the user.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -9086,7 +9086,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="encryptedpassportelement" href="#encryptedpassportelement"><i class="anchor-icon"></i></a>EncryptedPassportElement</h4> <h4><a class="anchor" name="encryptedpassportelement" href="#encryptedpassportelement"><i class="anchor-icon"></i></a>EncryptedPassportElement</h4>
<p>Contains information about documents or other Telegram Passport elements shared with the bot by the user.</p> <p>Describes documents or other Telegram Passport elements shared with the bot by the user.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -9149,7 +9149,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="encryptedcredentials" href="#encryptedcredentials"><i class="anchor-icon"></i></a>EncryptedCredentials</h4> <h4><a class="anchor" name="encryptedcredentials" href="#encryptedcredentials"><i class="anchor-icon"></i></a>EncryptedCredentials</h4>
<p>Contains data required for decrypting and authenticating <a href="#encryptedpassportelement">EncryptedPassportElement</a>. See the <a href="https://core.telegram.org/passport#receiving-information">Telegram Passport Documentation</a> for a complete description of the data decryption and authentication processes.</p> <p>Describes data required for decrypting and authenticating <a href="#encryptedpassportelement">EncryptedPassportElement</a>. See the <a href="https://core.telegram.org/passport#receiving-information">Telegram Passport Documentation</a> for a complete description of the data decryption and authentication processes.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -9691,7 +9691,7 @@ pre-formatted fixed-width code block written in the Python programming language
<h4><a class="anchor" name="getgamehighscores" href="#getgamehighscores"><i class="anchor-icon"></i></a>getGameHighScores</h4> <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. On success, returns an <em>Array</em> of <a href="#gamehighscore">GameHighScore</a> objects.</p>
<blockquote> <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 his neighbors are not among them. Please note that this behavior is subject to change.</p> <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> </blockquote>
<table class="table"> <table class="table">
<thead> <thead>

148
data/web/corefork.telegram.org/bots/api.html
View file

@ -140,7 +140,7 @@ To learn how to create…">
<h4><a class="anchor" name="do-i-need-a-local-bot-api-server" href="#do-i-need-a-local-bot-api-server"><i class="anchor-icon"></i></a>Do I need a Local Bot API Server</h4> <h4><a class="anchor" name="do-i-need-a-local-bot-api-server" href="#do-i-need-a-local-bot-api-server"><i class="anchor-icon"></i></a>Do I need a Local Bot API Server</h4>
<p>The majority of bots will be OK with the default configuration, running on our servers. But if you feel that you need one of <a href="#using-a-local-bot-api-server">these features</a>, you&#39;re welcome to switch to your own at any time.</p> <p>The majority of bots will be OK with the default configuration, running on our servers. But if you feel that you need one of <a href="#using-a-local-bot-api-server">these features</a>, you&#39;re welcome to switch to your own at any time.</p>
<h3><a class="anchor" name="getting-updates" href="#getting-updates"><i class="anchor-icon"></i></a>Getting updates</h3> <h3><a class="anchor" name="getting-updates" href="#getting-updates"><i class="anchor-icon"></i></a>Getting updates</h3>
<p>There are two mutually exclusive ways of receiving updates for your bot — the <a href="#getupdates">getUpdates</a> method on one hand and <a href="#setwebhook">webhooks</a> on the other. Incoming updates are stored on the server until the bot receives them either way, but they will not be kept longer than 24 hours.</p> <p>There are two mutually exclusive ways of receiving updates for your bot - the <a href="#getupdates">getUpdates</a> method on one hand and <a href="#setwebhook">webhooks</a> on the other. Incoming updates are stored on the server until the bot receives them either way, but they will not be kept longer than 24 hours.</p>
<p>Regardless of which option you choose, you will receive JSON-serialized <a href="#update">Update</a> objects as a result.</p> <p>Regardless of which option you choose, you will receive JSON-serialized <a href="#update">Update</a> objects as a result.</p>
<h4><a class="anchor" name="update" href="#update"><i class="anchor-icon"></i></a>Update</h4> <h4><a class="anchor" name="update" href="#update"><i class="anchor-icon"></i></a>Update</h4>
<p>This <a href="#available-types">object</a> represents an incoming update.<br>At most <strong>one</strong> of the optional parameters can be present in any given update.</p> <p>This <a href="#available-types">object</a> represents an incoming update.<br>At most <strong>one</strong> of the optional parameters can be present in any given update.</p>
@ -161,7 +161,7 @@ To learn how to create…">
<tr> <tr>
<td>message</td> <td>message</td>
<td><a href="#message">Message</a></td> <td><a href="#message">Message</a></td>
<td><em>Optional</em>. New incoming message of any kind — text, photo, sticker, etc.</td> <td><em>Optional</em>. New incoming message of any kind - text, photo, sticker, etc.</td>
</tr> </tr>
<tr> <tr>
<td>edited_message</td> <td>edited_message</td>
@ -171,7 +171,7 @@ To learn how to create…">
<tr> <tr>
<td>channel_post</td> <td>channel_post</td>
<td><a href="#message">Message</a></td> <td><a href="#message">Message</a></td>
<td><em>Optional</em>. New incoming channel post of any kind — text, photo, sticker, etc.</td> <td><em>Optional</em>. New incoming channel post of any kind - text, photo, sticker, etc.</td>
</tr> </tr>
<tr> <tr>
<td>edited_channel_post</td> <td>edited_channel_post</td>
@ -306,7 +306,7 @@ To learn how to create…">
<td>max_connections</td> <td>max_connections</td>
<td>Integer</td> <td>Integer</td>
<td>Optional</td> <td>Optional</td>
<td>Maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to <em>40</em>. Use lower values to limit the load on your bot&#39;s server, and higher values to increase your bot&#39;s throughput.</td> <td>The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to <em>40</em>. Use lower values to limit the load on your bot&#39;s server, and higher values to increase your bot&#39;s throughput.</td>
</tr> </tr>
<tr> <tr>
<td>allowed_updates</td> <td>allowed_updates</td>
@ -349,7 +349,7 @@ To learn how to create…">
<h4><a class="anchor" name="getwebhookinfo" href="#getwebhookinfo"><i class="anchor-icon"></i></a>getWebhookInfo</h4> <h4><a class="anchor" name="getwebhookinfo" href="#getwebhookinfo"><i class="anchor-icon"></i></a>getWebhookInfo</h4>
<p>Use this method to get current webhook status. Requires no parameters. On success, returns a <a href="#webhookinfo">WebhookInfo</a> object. If the bot is using <a href="#getupdates">getUpdates</a>, will return an object with the <em>url</em> field empty.</p> <p>Use this method to get current webhook status. Requires no parameters. On success, returns a <a href="#webhookinfo">WebhookInfo</a> object. If the bot is using <a href="#getupdates">getUpdates</a>, will return an object with the <em>url</em> field empty.</p>
<h4><a class="anchor" name="webhookinfo" href="#webhookinfo"><i class="anchor-icon"></i></a>WebhookInfo</h4> <h4><a class="anchor" name="webhookinfo" href="#webhookinfo"><i class="anchor-icon"></i></a>WebhookInfo</h4>
<p>Contains information about the current status of a webhook.</p> <p>Describes the current status of a webhook.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -397,7 +397,7 @@ To learn how to create…">
<tr> <tr>
<td>max_connections</td> <td>max_connections</td>
<td>Integer</td> <td>Integer</td>
<td><em>Optional</em>. Maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery</td> <td><em>Optional</em>. The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery</td>
</tr> </tr>
<tr> <tr>
<td>allowed_updates</td> <td>allowed_updates</td>
@ -524,7 +524,7 @@ To learn how to create…">
<tr> <tr>
<td>has_private_forwards</td> <td>has_private_forwards</td>
<td>True</td> <td>True</td>
<td><em>Optional</em>. True, 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> <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>
<tr> <tr>
<td>description</td> <td>description</td>
@ -559,7 +559,7 @@ To learn how to create…">
<tr> <tr>
<td>has_protected_content</td> <td>has_protected_content</td>
<td>True</td> <td>True</td>
<td><em>Optional</em>. True, if messages from the chat can&#39;t be forwarded to other chats. Returned only in <a href="#getchat">getChat</a>.</td> <td><em>Optional</em>. <em>True</em>, if messages from the chat can&#39;t be forwarded to other chats. Returned only in <a href="#getchat">getChat</a>.</td>
</tr> </tr>
<tr> <tr>
<td>sticker_set_name</td> <td>sticker_set_name</td>
@ -607,7 +607,7 @@ To learn how to create…">
<tr> <tr>
<td>sender_chat</td> <td>sender_chat</td>
<td><a href="#chat">Chat</a></td> <td><a href="#chat">Chat</a></td>
<td><em>Optional</em>. Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, the field <em>from</em> contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.</td> <td><em>Optional</em>. Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, the field <em>from</em> contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.</td>
</tr> </tr>
<tr> <tr>
<td>date</td> <td>date</td>
@ -652,7 +652,7 @@ To learn how to create…">
<tr> <tr>
<td>is_automatic_forward</td> <td>is_automatic_forward</td>
<td>True</td> <td>True</td>
<td><em>Optional</em>. True, if the message is a channel post that was automatically forwarded to the connected discussion group</td> <td><em>Optional</em>. <em>True</em>, if the message is a channel post that was automatically forwarded to the connected discussion group</td>
</tr> </tr>
<tr> <tr>
<td>reply_to_message</td> <td>reply_to_message</td>
@ -672,7 +672,7 @@ To learn how to create…">
<tr> <tr>
<td>has_protected_content</td> <td>has_protected_content</td>
<td>True</td> <td>True</td>
<td><em>Optional</em>. True, if the message can&#39;t be forwarded</td> <td><em>Optional</em>. <em>True</em>, if the message can&#39;t be forwarded</td>
</tr> </tr>
<tr> <tr>
<td>media_group_id</td> <td>media_group_id</td>
@ -1198,7 +1198,7 @@ To learn how to create…">
<tr> <tr>
<td>mime_type</td> <td>mime_type</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. Mime type of the file as defined by sender</td> <td><em>Optional</em>. MIME type of the file as defined by sender</td>
</tr> </tr>
<tr> <tr>
<td>file_size</td> <td>file_size</td>
@ -1517,7 +1517,7 @@ To learn how to create…">
<tr> <tr>
<td>proximity_alert_radius</td> <td>proximity_alert_radius</td>
<td>Integer</td> <td>Integer</td>
<td><em>Optional</em>. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.</td> <td><em>Optional</em>. The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -1570,7 +1570,7 @@ To learn how to create…">
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="webappdata" href="#webappdata"><i class="anchor-icon"></i></a>WebAppData</h4> <h4><a class="anchor" name="webappdata" href="#webappdata"><i class="anchor-icon"></i></a>WebAppData</h4>
<p>Contains data sent from a <a href="/bots/webapps">Web App</a> to the bot.</p> <p>Describes data sent from a <a href="/bots/webapps">Web App</a> to the bot.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -1588,7 +1588,7 @@ To learn how to create…">
<tr> <tr>
<td>button_text</td> <td>button_text</td>
<td>String</td> <td>String</td>
<td>Text of the <em>web_app</em> keyboard button, from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.</td> <td>Text of the <em>web_app</em> keyboard button from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -1720,7 +1720,7 @@ To learn how to create…">
<h4><a class="anchor" name="file" href="#file"><i class="anchor-icon"></i></a>File</h4> <h4><a class="anchor" name="file" href="#file"><i class="anchor-icon"></i></a>File</h4>
<p>This object represents a file ready to be downloaded. The file can be downloaded via the link <code>https://api.telegram.org/file/bot&lt;token&gt;/&lt;file_path&gt;</code>. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling <a href="#getfile">getFile</a>.</p> <p>This object represents a file ready to be downloaded. The file can be downloaded via the link <code>https://api.telegram.org/file/bot&lt;token&gt;/&lt;file_path&gt;</code>. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling <a href="#getfile">getFile</a>.</p>
<blockquote> <blockquote>
<p>Maximum file size to download is 20 MB</p> <p>The maximum file size to download is 20 MB</p>
</blockquote> </blockquote>
<table class="table"> <table class="table">
<thead> <thead>
@ -1754,7 +1754,7 @@ To learn how to create…">
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="webappinfo" href="#webappinfo"><i class="anchor-icon"></i></a>WebAppInfo</h4> <h4><a class="anchor" name="webappinfo" href="#webappinfo"><i class="anchor-icon"></i></a>WebAppInfo</h4>
<p>Contains information about a <a href="/bots/webapps">Web App</a>.</p> <p>Describes a <a href="/bots/webapps">Web App</a>.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -1795,7 +1795,7 @@ To learn how to create…">
<tr> <tr>
<td>one_time_keyboard</td> <td>one_time_keyboard</td>
<td>Boolean</td> <td>Boolean</td>
<td><em>Optional</em>. Requests clients to hide the keyboard as soon as it&#39;s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat – the user can press a special button in the input field to see the custom keyboard again. Defaults to <em>false</em>.</td> <td><em>Optional</em>. Requests clients to hide the keyboard as soon as it&#39;s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to <em>false</em>.</td>
</tr> </tr>
<tr> <tr>
<td>input_field_placeholder</td> <td>input_field_placeholder</td>
@ -1947,12 +1947,12 @@ To learn how to create…">
<tr> <tr>
<td>switch_inline_query</td> <td>switch_inline_query</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot&#39;s username and the specified inline query in the input field. Can be empty, in which case just the bot&#39;s username will be inserted.<br><br><strong>Note:</strong> This offers an easy way for users to start using your bot in <a href="/bots/inline">inline mode</a> when they are currently in a private chat with it. Especially useful when combined with <a href="#answerinlinequery"><em>switch_pm…</em></a> actions – in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen.</td> <td><em>Optional</em>. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot&#39;s username and the specified inline query in the input field. May be empty, in which case just the bot&#39;s username will be inserted.<br><br><strong>Note:</strong> This offers an easy way for users to start using your bot in <a href="/bots/inline">inline mode</a> when they are currently in a private chat with it. Especially useful when combined with <a href="#answerinlinequery"><em>switch_pm…</em></a> actions - in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen.</td>
</tr> </tr>
<tr> <tr>
<td>switch_inline_query_current_chat</td> <td>switch_inline_query_current_chat</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. If set, pressing the button will insert the bot&#39;s username and the specified inline query in the current chat&#39;s input field. Can be empty, in which case only the bot&#39;s username will be inserted.<br><br>This offers a quick way for the user to open your bot in inline mode in the same chat – good for selecting something from multiple options.</td> <td><em>Optional</em>. If set, pressing the button will insert the bot&#39;s username and the specified inline query in the current chat&#39;s input field. May be empty, in which case only the bot&#39;s username will be inserted.<br><br>This offers a quick way for the user to open your bot in inline mode in the same chat - good for selecting something from multiple options.</td>
</tr> </tr>
<tr> <tr>
<td>callback_game</td> <td>callback_game</td>
@ -2046,7 +2046,7 @@ To learn how to create…">
<tr> <tr>
<td>data</td> <td>data</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. Data associated with the callback button. Be aware that the message, from which originated the query, can contain no callback buttons with this data.</td> <td><em>Optional</em>. Data associated with the callback button. Be aware that the message originated the query can contain no callback buttons with this data.</td>
</tr> </tr>
<tr> <tr>
<td>game_short_name</td> <td>game_short_name</td>
@ -2092,7 +2092,7 @@ To learn how to create…">
<li>Explain the user how to send a command with parameters (e.g. /newpoll question answer1 answer2). May be appealing for hardcore users but lacks modern day polish.</li> <li>Explain the user how to send a command with parameters (e.g. /newpoll question answer1 answer2). May be appealing for hardcore users but lacks modern day polish.</li>
<li>Guide the user through a step-by-step process. &#39;Please send me your question&#39;, &#39;Cool, now let&#39;s add the first answer option&#39;, &#39;Great. Keep adding answer options, then send /done when you&#39;re ready&#39;.</li> <li>Guide the user through a step-by-step process. &#39;Please send me your question&#39;, &#39;Cool, now let&#39;s add the first answer option&#39;, &#39;Great. Keep adding answer options, then send /done when you&#39;re ready&#39;.</li>
</ul> </ul>
<p>The last option is definitely more attractive. And if you use <a href="#forcereply">ForceReply</a> in your bot&#39;s questions, it will receive the user&#39;s answers even if it only receives replies, commands and mentions — without any extra work for the user.</p> <p>The last option is definitely more attractive. And if you use <a href="#forcereply">ForceReply</a> in your bot&#39;s questions, it will receive the user&#39;s answers even if it only receives replies, commands and mentions - without any extra work for the user.</p>
</blockquote> </blockquote>
<h4><a class="anchor" name="chatphoto" href="#chatphoto"><i class="anchor-icon"></i></a>ChatPhoto</h4> <h4><a class="anchor" name="chatphoto" href="#chatphoto"><i class="anchor-icon"></i></a>ChatPhoto</h4>
<p>This object represents a chat photo.</p> <p>This object represents a chat photo.</p>
@ -2176,7 +2176,7 @@ To learn how to create…">
<tr> <tr>
<td>member_limit</td> <td>member_limit</td>
<td>Integer</td> <td>Integer</td>
<td><em>Optional</em>. Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td> <td><em>Optional</em>. The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td>
</tr> </tr>
<tr> <tr>
<td>pending_join_request_count</td> <td>pending_join_request_count</td>
@ -2967,7 +2967,7 @@ To learn how to create…">
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="responseparameters" href="#responseparameters"><i class="anchor-icon"></i></a>ResponseParameters</h4> <h4><a class="anchor" name="responseparameters" href="#responseparameters"><i class="anchor-icon"></i></a>ResponseParameters</h4>
<p>Contains information about why a request was unsuccessful.</p> <p>Describes why a request was unsuccessful.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -3017,7 +3017,7 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3055,12 +3055,12 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3118,12 +3118,12 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3176,12 +3176,12 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3234,12 +3234,12 @@ To learn how to create…">
<tr> <tr>
<td>media</td> <td>media</td>
<td>String</td> <td>String</td>
<td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://&lt;file_attach_name&gt;” to upload a new one using multipart/form-data under &lt;file_attach_name&gt; name. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td><em>Optional</em>. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3266,7 +3266,7 @@ To learn how to create…">
<h4><a class="anchor" name="inputfile" href="#inputfile"><i class="anchor-icon"></i></a>InputFile</h4> <h4><a class="anchor" name="inputfile" href="#inputfile"><i class="anchor-icon"></i></a>InputFile</h4>
<p>This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.</p> <p>This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.</p>
<h4><a class="anchor" name="sending-files" href="#sending-files"><i class="anchor-icon"></i></a>Sending files</h4> <h4><a class="anchor" name="sending-files" href="#sending-files"><i class="anchor-icon"></i></a>Sending files</h4>
<p> There are three ways to send files (photos, stickers, audio, media, etc.):</p> <p>There are three ways to send files (photos, stickers, audio, media, etc.):</p>
<ol> <ol>
<li>If the file is already stored somewhere on the Telegram servers, you don&#39;t need to reupload it: each file object has a <strong>file_id</strong> field, simply pass this <strong>file_id</strong> as a parameter instead of uploading. There are <strong>no limits</strong> for files sent this way.</li> <li>If the file is already stored somewhere on the Telegram servers, you don&#39;t need to reupload it: each file object has a <strong>file_id</strong> field, simply pass this <strong>file_id</strong> as a parameter instead of uploading. There are <strong>no limits</strong> for files sent this way.</li>
<li>Provide Telegram with an HTTP URL for the file to be sent. Telegram will download and send the file. 5 MB max size for photos and 20 MB max for other types of content.</li> <li>Provide Telegram with an HTTP URL for the file to be sent. Telegram will download and send the file. 5 MB max size for photos and 20 MB max for other types of content.</li>
@ -3376,7 +3376,7 @@ To learn how to create…">
<h4><a class="anchor" name="formatting-options" href="#formatting-options"><i class="anchor-icon"></i></a>Formatting options</h4> <h4><a class="anchor" name="formatting-options" href="#formatting-options"><i class="anchor-icon"></i></a>Formatting options</h4>
<p>The Bot API supports basic formatting for messages. You can use bold, italic, underlined, strikethrough, and spoiler text, as well as inline links and pre-formatted code in your bots&#39; messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.</p> <p>The Bot API supports basic formatting for messages. You can use bold, italic, underlined, strikethrough, and spoiler text, as well as inline links and pre-formatted code in your bots&#39; messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.</p>
<p>Note that Telegram clients will display an <strong>alert</strong> to the user before opening an inline link (&#39;Open this link?&#39; together with the full URL).</p> <p>Note that Telegram clients will display an <strong>alert</strong> to the user before opening an inline link (&#39;Open this link?&#39; together with the full URL).</p>
<p>Message entities can be nested, providing following restrictions are met:<br>- If two entities have common characters then one of them is fully contained inside another.<br>- <em>bold</em>, <em>italic</em>, <em>underline</em>, <em>strikethrough</em>, and <em>spoiler</em> entities can contain and can be part of any other entities, except <em>pre</em> and <em>code</em>.<br>- All other entities can&#39;t contain each other.</p> <p>Message entities can be nested, providing following restrictions are met:<br>- If two entities have common characters, then one of them is fully contained inside another.<br>- <em>bold</em>, <em>italic</em>, <em>underline</em>, <em>strikethrough</em>, and <em>spoiler</em> entities can contain and can be part of any other entities, except <em>pre</em> and <em>code</em>.<br>- All other entities can&#39;t contain each other.</p>
<p>Links <code>tg://user?id=&lt;user_id&gt;</code> can be used to mention a user by their ID without using a username. Please note:</p> <p>Links <code>tg://user?id=&lt;user_id&gt;</code> can be used to mention a user by their ID without using a username. Please note:</p>
<ul> <ul>
<li>These links will work <strong>only</strong> if they are used inside an inline link or in an inline keyboard button. For example, they will not work, when used in a message text.</li> <li>These links will work <strong>only</strong> if they are used inside an inline link or in an inline keyboard button. For example, they will not work, when used in a message text.</li>
@ -3595,7 +3595,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>photo</td> <td>photo</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo&#39;s width and height must not exceed 10000 in total. Width and height ratio must be at most 20. <a href="#sending-files">More info on Sending Files »</a></td> <td>Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo&#39;s width and height must not exceed 10000 in total. Width and height ratio must be at most 20. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3670,7 +3670,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>audio</td> <td>audio</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3712,7 +3712,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>disable_notification</td> <td>disable_notification</td>
@ -3768,13 +3768,13 @@ pre-formatted fixed-width code block written in the Python programming language
<td>document</td> <td>document</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3833,7 +3833,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="sendvideo" href="#sendvideo"><i class="anchor-icon"></i></a>sendVideo</h4> <h4><a class="anchor" name="sendvideo" href="#sendvideo"><i class="anchor-icon"></i></a>sendVideo</h4>
<p>Use this method to send video files, Telegram clients support mp4 videos (other formats may be sent as <a href="#document">Document</a>). On success, the sent <a href="#message">Message</a> is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.</p> <p>Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as <a href="#document">Document</a>). On success, the sent <a href="#message">Message</a> is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -3854,7 +3854,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>video</td> <td>video</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>duration</td> <td>duration</td>
@ -3878,7 +3878,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -3958,7 +3958,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>animation</td> <td>animation</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>duration</td> <td>duration</td>
@ -3982,7 +3982,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -4056,7 +4056,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>voice</td> <td>voice</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Audio file to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>caption</td> <td>caption</td>
@ -4115,7 +4115,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="sendvideonote" href="#sendvideonote"><i class="anchor-icon"></i></a>sendVideoNote</h4> <h4><a class="anchor" name="sendvideonote" href="#sendvideonote"><i class="anchor-icon"></i></a>sendVideoNote</h4>
<p>As of <a href="https://telegram.org/blog/video-messages-and-telescope">v.4.0</a>, Telegram clients support rounded square mp4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent <a href="#message">Message</a> is returned.</p> <p>As of <a href="https://telegram.org/blog/video-messages-and-telescope">v.4.0</a>, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent <a href="#message">Message</a> is returned.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -4136,7 +4136,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>video_note</td> <td>video_note</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a>. Sending video notes by a URL is currently unsupported</td> <td>Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a>. Sending video notes by a URL is currently unsupported</td>
</tr> </tr>
<tr> <tr>
<td>duration</td> <td>duration</td>
@ -4154,7 +4154,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More info on Sending Files »</a></td> <td>Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail&#39;s width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can&#39;t be reused and can be only uploaded as a new file, so you can pass “attach://&lt;file_attach_name&gt;” if the thumbnail was uploaded using multipart/form-data under &lt;file_attach_name&gt;. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>disable_notification</td> <td>disable_notification</td>
@ -4382,7 +4382,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>proximity_alert_radius</td> <td>proximity_alert_radius</td>
<td>Integer</td> <td>Integer</td>
<td>Optional</td> <td>Optional</td>
<td>Maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.</td> <td>The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.</td>
</tr> </tr>
<tr> <tr>
<td>reply_markup</td> <td>reply_markup</td>
@ -4843,7 +4843,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="getfile" href="#getfile"><i class="anchor-icon"></i></a>getFile</h4> <h4><a class="anchor" name="getfile" href="#getfile"><i class="anchor-icon"></i></a>getFile</h4>
<p>Use this method to get basic info about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a <a href="#file">File</a> object is returned. The file can then be downloaded via the link <code>https://api.telegram.org/file/bot&lt;token&gt;/&lt;file_path&gt;</code>, where <code>&lt;file_path&gt;</code> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling <a href="#getfile">getFile</a> again.</p> <p>Use this method to get basic information about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a <a href="#file">File</a> object is returned. The file can then be downloaded via the link <code>https://api.telegram.org/file/bot&lt;token&gt;/&lt;file_path&gt;</code>, where <code>&lt;file_path&gt;</code> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling <a href="#getfile">getFile</a> again.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -4858,7 +4858,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>file_id</td> <td>file_id</td>
<td>String</td> <td>String</td>
<td>Yes</td> <td>Yes</td>
<td>File identifier to get info about</td> <td>File identifier to get information about</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -5230,7 +5230,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>member_limit</td> <td>member_limit</td>
<td>Integer</td> <td>Integer</td>
<td>Optional</td> <td>Optional</td>
<td>Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td> <td>The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td>
</tr> </tr>
<tr> <tr>
<td>creates_join_request</td> <td>creates_join_request</td>
@ -5280,7 +5280,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>member_limit</td> <td>member_limit</td>
<td>Integer</td> <td>Integer</td>
<td>Optional</td> <td>Optional</td>
<td>Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td> <td>The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999</td>
</tr> </tr>
<tr> <tr>
<td>creates_join_request</td> <td>creates_join_request</td>
@ -5733,7 +5733,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>url</td> <td>url</td>
<td>String</td> <td>String</td>
<td>Optional</td> <td>Optional</td>
<td>URL that will be opened by the user&#39;s client. If you have created a <a href="#game">Game</a> and accepted the conditions via <a href="https://t.me/botfather">@BotFather</a>, specify the URL that opens your game — note that this will only work if the query comes from a <a href="#inlinekeyboardbutton"><em>callback_game</em></a> button.<br><br>Otherwise, you may use links like <code>t.me/your_bot?start=XXXX</code> that open your bot with a parameter.</td> <td>URL that will be opened by the user&#39;s client. If you have created a <a href="#game">Game</a> and accepted the conditions via <a href="https://t.me/botfather">@BotFather</a>, specify the URL that opens your game - note that this will only work if the query comes from a <a href="#inlinekeyboardbutton"><em>callback_game</em></a> button.<br><br>Otherwise, you may use links like <code>t.me/your_bot?start=XXXX</code> that open your bot with a parameter.</td>
</tr> </tr>
<tr> <tr>
<td>cache_time</td> <td>cache_time</td>
@ -6355,7 +6355,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>sticker</td> <td>sticker</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Yes</td> <td>Yes</td>
<td>Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td>Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>disable_notification</td> <td>disable_notification</td>
@ -6431,7 +6431,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>png_sticker</td> <td>png_sticker</td>
<td><a href="#inputfile">InputFile</a></td> <td><a href="#inputfile">InputFile</a></td>
<td>Yes</td> <td>Yes</td>
<td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. <a href="#sending-files">More info on Sending Files »</a></td> <td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -6457,7 +6457,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>name</td> <td>name</td>
<td>String</td> <td>String</td>
<td>Yes</td> <td>Yes</td>
<td>Short name of sticker set, to be used in <code>t.me/addstickers/</code> URLs (e.g., <em>animals</em>). Can contain only english letters, digits and underscores. Must begin with a letter, can&#39;t contain consecutive underscores and must end in <code>&quot;_by_&lt;bot_username&gt;&quot;</code>. <code>&lt;bot_username&gt;</code> is case insensitive. 1-64 characters.</td> <td>Short name of sticker set, to be used in <code>t.me/addstickers/</code> URLs (e.g., <em>animals</em>). Can contain only English letters, digits and underscores. Must begin with a letter, can&#39;t contain consecutive underscores and must end in <code>&quot;_by_&lt;bot_username&gt;&quot;</code>. <code>&lt;bot_username&gt;</code> is case insensitive. 1-64 characters.</td>
</tr> </tr>
<tr> <tr>
<td>title</td> <td>title</td>
@ -6469,7 +6469,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>png_sticker</td> <td>png_sticker</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>tgs_sticker</td> <td>tgs_sticker</td>
@ -6531,7 +6531,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>png_sticker</td> <td>png_sticker</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a></td> <td><strong>PNG</strong> image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a></td>
</tr> </tr>
<tr> <tr>
<td>tgs_sticker</td> <td>tgs_sticker</td>
@ -6633,7 +6633,7 @@ pre-formatted fixed-width code block written in the Python programming language
<td>thumb</td> <td>thumb</td>
<td><a href="#inputfile">InputFile</a> or String</td> <td><a href="#inputfile">InputFile</a> or String</td>
<td>Optional</td> <td>Optional</td>
<td>A <strong>PNG</strong> image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a <strong>TGS</strong> animation with the thumbnail up to 32 kilobytes in size; see <a href="https://core.telegram.org/stickers#animated-sticker-requirements"><a href="https://core.telegram.org/stickers#animated-sticker-requirements">https://core.telegram.org/stickers#animated-sticker-requirements</a></a> for animated sticker technical requirements, or a <strong>WEBM</strong> video with the thumbnail up to 32 kilobytes in size; 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 video sticker technical requirements. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More info on Sending Files »</a>. Animated sticker set thumbnails can&#39;t be uploaded via HTTP URL.</td> <td>A <strong>PNG</strong> image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a <strong>TGS</strong> animation with the thumbnail up to 32 kilobytes in size; see <a href="https://core.telegram.org/stickers#animated-sticker-requirements"><a href="https://core.telegram.org/stickers#animated-sticker-requirements">https://core.telegram.org/stickers#animated-sticker-requirements</a></a> for animated sticker technical requirements, or a <strong>WEBM</strong> video with the thumbnail up to 32 kilobytes in size; 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 video sticker technical requirements. Pass a <em>file_id</em> as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. <a href="#sending-files">More information on Sending Files »</a>. Animated sticker set thumbnails can&#39;t be uploaded via HTTP URL.</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -6674,7 +6674,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>chat_type</td> <td>chat_type</td>
<td>String</td> <td>String</td>
<td><em>Optional</em>. Type of the chat, from which the inline query was sent. Can be either “sender” for a private chat with the inline query sender, “private”, “group”, “supergroup”, or “channel”. The chat type should be always known for requests sent from official clients and most third-party clients, unless the request was sent from a secret chat</td> <td><em>Optional</em>. Type of the chat from which the inline query was sent. Can be either “sender” for a private chat with the inline query sender, “private”, “group”, “supergroup”, or “channel”. The chat type should be always known for requests sent from official clients and most third-party clients, unless the request was sent from a secret chat</td>
</tr> </tr>
<tr> <tr>
<td>location</td> <td>location</td>
@ -7017,7 +7017,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>mpeg4_url</td> <td>mpeg4_url</td>
<td>String</td> <td>String</td>
<td>A valid URL for the MP4 file. File size must not exceed 1MB</td> <td>A valid URL for the MPEG4 file. File size must not exceed 1MB</td>
</tr> </tr>
<tr> <tr>
<td>mpeg4_width</td> <td>mpeg4_width</td>
@ -7108,7 +7108,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>mime_type</td> <td>mime_type</td>
<td>String</td> <td>String</td>
<td>Mime type of the content of the video URL, “text/html” or “video/mp4”</td> <td>MIME type of the content of the video URL, “text/html” or “video/mp4”</td>
</tr> </tr>
<tr> <tr>
<td>thumb_url</td> <td>thumb_url</td>
@ -7349,7 +7349,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>mime_type</td> <td>mime_type</td>
<td>String</td> <td>String</td>
<td>Mime type of the content of the file, either “application/pdf” or “application/zip”</td> <td>MIME type of the content of the file, either “application/pdf” or “application/zip”</td>
</tr> </tr>
<tr> <tr>
<td>description</td> <td>description</td>
@ -7805,7 +7805,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>mpeg4_file_id</td> <td>mpeg4_file_id</td>
<td>String</td> <td>String</td>
<td>A valid file identifier for the MP4 file</td> <td>A valid file identifier for the MPEG4 file</td>
</tr> </tr>
<tr> <tr>
<td>title</td> <td>title</td>
@ -8468,7 +8468,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="sentwebappmessage" href="#sentwebappmessage"><i class="anchor-icon"></i></a>SentWebAppMessage</h4> <h4><a class="anchor" name="sentwebappmessage" href="#sentwebappmessage"><i class="anchor-icon"></i></a>SentWebAppMessage</h4>
<p>Contains information about an inline message sent by a <a href="/bots/webapps">Web App</a> on behalf of a user.</p> <p>Describes an inline message sent by a <a href="/bots/webapps">Web App</a> on behalf of a user.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -8808,7 +8808,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>country_code</td> <td>country_code</td>
<td>String</td> <td>String</td>
<td>ISO 3166-1 alpha-2 country code</td> <td>Two-letter ISO 3166-1 alpha-2 country code</td>
</tr> </tr>
<tr> <tr>
<td>state</td> <td>state</td>
@ -8932,7 +8932,7 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>order_info</td> <td>order_info</td>
<td><a href="#orderinfo">OrderInfo</a></td> <td><a href="#orderinfo">OrderInfo</a></td>
<td><em>Optional</em>. Order info provided by the user</td> <td><em>Optional</em>. Order information provided by the user</td>
</tr> </tr>
<tr> <tr>
<td>telegram_payment_charge_id</td> <td>telegram_payment_charge_id</td>
@ -9023,14 +9023,14 @@ pre-formatted fixed-width code block written in the Python programming language
<tr> <tr>
<td>order_info</td> <td>order_info</td>
<td><a href="#orderinfo">OrderInfo</a></td> <td><a href="#orderinfo">OrderInfo</a></td>
<td><em>Optional</em>. Order info provided by the user</td> <td><em>Optional</em>. Order information provided by the user</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
<h3><a class="anchor" name="telegram-passport" href="#telegram-passport"><i class="anchor-icon"></i></a>Telegram Passport</h3> <h3><a class="anchor" name="telegram-passport" href="#telegram-passport"><i class="anchor-icon"></i></a>Telegram Passport</h3>
<p><strong>Telegram Passport</strong> is a unified authorization method for services that require personal identification. Users can upload their documents once, then instantly share their data with services that require real-world ID (finance, ICOs, etc.). Please see the <a href="/passport">manual</a> for details.</p> <p><strong>Telegram Passport</strong> is a unified authorization method for services that require personal identification. Users can upload their documents once, then instantly share their data with services that require real-world ID (finance, ICOs, etc.). Please see the <a href="/passport">manual</a> for details.</p>
<h4><a class="anchor" name="passportdata" href="#passportdata"><i class="anchor-icon"></i></a>PassportData</h4> <h4><a class="anchor" name="passportdata" href="#passportdata"><i class="anchor-icon"></i></a>PassportData</h4>
<p>Contains information about Telegram Passport data shared with the bot by the user.</p> <p>Describes Telegram Passport data shared with the bot by the user.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -9086,7 +9086,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="encryptedpassportelement" href="#encryptedpassportelement"><i class="anchor-icon"></i></a>EncryptedPassportElement</h4> <h4><a class="anchor" name="encryptedpassportelement" href="#encryptedpassportelement"><i class="anchor-icon"></i></a>EncryptedPassportElement</h4>
<p>Contains information about documents or other Telegram Passport elements shared with the bot by the user.</p> <p>Describes documents or other Telegram Passport elements shared with the bot by the user.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -9149,7 +9149,7 @@ pre-formatted fixed-width code block written in the Python programming language
</tbody> </tbody>
</table> </table>
<h4><a class="anchor" name="encryptedcredentials" href="#encryptedcredentials"><i class="anchor-icon"></i></a>EncryptedCredentials</h4> <h4><a class="anchor" name="encryptedcredentials" href="#encryptedcredentials"><i class="anchor-icon"></i></a>EncryptedCredentials</h4>
<p>Contains data required for decrypting and authenticating <a href="#encryptedpassportelement">EncryptedPassportElement</a>. See the <a href="https://core.telegram.org/passport#receiving-information">Telegram Passport Documentation</a> for a complete description of the data decryption and authentication processes.</p> <p>Describes data required for decrypting and authenticating <a href="#encryptedpassportelement">EncryptedPassportElement</a>. See the <a href="https://core.telegram.org/passport#receiving-information">Telegram Passport Documentation</a> for a complete description of the data decryption and authentication processes.</p>
<table class="table"> <table class="table">
<thead> <thead>
<tr> <tr>
@ -9691,7 +9691,7 @@ pre-formatted fixed-width code block written in the Python programming language
<h4><a class="anchor" name="getgamehighscores" href="#getgamehighscores"><i class="anchor-icon"></i></a>getGameHighScores</h4> <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. On success, returns an <em>Array</em> of <a href="#gamehighscore">GameHighScore</a> objects.</p>
<blockquote> <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 his neighbors are not among them. Please note that this behavior is subject to change.</p> <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> </blockquote>
<table class="table"> <table class="table">
<thead> <thead>

4
data/web/translations.telegram.org/en/android.html
View file

@ -179,7 +179,7 @@
</div></nav> </div></nav>
<section class="content clearfix"> <section class="content clearfix">
<section class="tr-content"><h3 class="tr-header"> <section class="tr-content"><h3 class="tr-header">
<a href="/en/" class="tr-back"></a>Android<span class="tr-header-counter">4573</span> <a href="/en/" class="tr-back"></a>Android<span class="tr-header-counter">4623</span>
<div class="tr-header-tabs"><span class="tr-header-tab"><a href="/en/android/recent/translations">Translations</a></span><span class="tr-header-tab"><a href="/en/android/recent/suggestions">Suggestions</a></span><span class="tr-header-tab"><a href="/en/android/recent/comments">Comments</a></span></div> <div class="tr-header-tabs"><span class="tr-header-tab"><a href="/en/android/recent/translations">Translations</a></span><span class="tr-header-tab"><a href="/en/android/recent/suggestions">Suggestions</a></span><span class="tr-header-tab"><a href="/en/android/recent/comments">Comments</a></span></div>
</h3> </h3>
<section class="tr-sections clearfix"> <section class="tr-sections clearfix">
@ -236,7 +236,7 @@
</div><div class="tr-section-col col-lg-4 col-xs-6"> </div><div class="tr-section-col col-lg-4 col-xs-6">
<div class="tr-section-wrap"><a href="/en/android/unsorted/" class="tr-section"> <div class="tr-section-wrap"><a href="/en/android/unsorted/" class="tr-section">
<div class="tr-section-cover cover0"></div> <div class="tr-section-cover cover0"></div>
<div class="tr-section-caption">Unsorted (730)</div> <div class="tr-section-caption">Unsorted (780)</div>
</a></div> </a></div>
</div> </div>
</section></section> </section></section>

155
data/web/translations.telegram.org/en/android/unsorted.html
View file

@ -5,6 +5,9 @@
"AccAutoDeleteTimer": [ "AccAutoDeleteTimer": [
"Auto-delete timer" "Auto-delete timer"
], ],
"AccDescrBrushType": [
"Brush type"
],
"AccDescrCloseMenu": [ "AccDescrCloseMenu": [
"Close menu" "Close menu"
], ],
@ -20,12 +23,19 @@
"AccDescrMirror": [ "AccDescrMirror": [
"Mirror" "Mirror"
], ],
"AccDescrMsgPlayed": [
"Played"
],
"AccDescrMsgSending": [ "AccDescrMsgSending": [
"Sending" "Sending"
], ],
"AccDescrMsgSendingError": [ "AccDescrMsgSendingError": [
"Sending error" "Sending error"
], ],
"AccDescrNumberOfReplies": [
"Has <mark class=\"token\">%1$d</mark> reply",
"Has <mark class=\"token\">%1$d</mark> replies"
],
"AccDescrNumberOfViews": [ "AccDescrNumberOfViews": [
"Viewed <mark class=\"token\">%1$d</mark> time", "Viewed <mark class=\"token\">%1$d</mark> time",
"Viewed <mark class=\"token\">%1$d</mark> times" "Viewed <mark class=\"token\">%1$d</mark> times"
@ -33,9 +43,18 @@
"AccDescrOpenMenu2": [ "AccDescrOpenMenu2": [
"Open menu" "Open menu"
], ],
"AccDescrPaint": [
"Paint"
],
"AccDescrPersonHasSeen": [
"<mark class=\"token\">%1$s</mark> has seen"
],
"AccDescrPipMode": [ "AccDescrPipMode": [
"Picture-in-Picture mode" "Picture-in-Picture mode"
], ],
"AccDescrPlaceText": [
"Place text"
],
"AccDescrPlayerDuration": [ "AccDescrPlayerDuration": [
"<mark class=\"token\">%1$s</mark> of <mark class=\"token\">%2$s</mark>" "<mark class=\"token\">%1$s</mark> of <mark class=\"token\">%2$s</mark>"
], ],
@ -45,6 +64,9 @@
"AccDescrQuizExplanation": [ "AccDescrQuizExplanation": [
"Explanation" "Explanation"
], ],
"AccDescrReactedWith": [
"<mark class=\"token\">%1$s</mark> reacted with <mark class=\"token\">%2$s</mark>"
],
"AccDescrReactionMentionDown": [ "AccDescrReactionMentionDown": [
"Go to next unread reactions" "Go to next unread reactions"
], ],
@ -196,6 +218,10 @@
"Alert": [ "Alert": [
"Show Notifications" "Show Notifications"
], ],
"AllNPhotos": [
"",
"All <mark class=\"token\">%1$d</mark> photos"
],
"AllowBackgroundActivityInfoOneUIAboveS": [ "AllowBackgroundActivityInfoOneUIAboveS": [
"This will improve reliability for incoming notifications and Telegram calls. Go to your device's Settings &gt; Battery and select **Optimized** or **Unrestricted**." "This will improve reliability for incoming notifications and Telegram calls. Go to your device's Settings &gt; Battery and select **Optimized** or **Unrestricted**."
], ],
@ -324,12 +350,18 @@
"BotAlreadyAddedToAttachMenu": [ "BotAlreadyAddedToAttachMenu": [
"This bot is already added to your attachment menu." "This bot is already added to your attachment menu."
], ],
"BotCantOpenAttachMenuBot": [
"This bot can't be opened in chats with bots."
],
"BotCantOpenAttachMenuChannel": [ "BotCantOpenAttachMenuChannel": [
"This bot can't be opened in channels." "This bot can't be opened in channels."
], ],
"BotCantOpenAttachMenuGroup": [ "BotCantOpenAttachMenuGroup": [
"This bot can't be opened in groups." "This bot can't be opened in groups."
], ],
"BotCantOpenAttachMenuUser": [
"This bot can't be opened in chats with users."
],
"BotMessagePreview": [ "BotMessagePreview": [
"Message Preview" "Message Preview"
], ],
@ -357,6 +389,9 @@
"BotWebViewFileChooserTitle": [ "BotWebViewFileChooserTitle": [
"Choose a file" "Choose a file"
], ],
"BotWebViewSettings": [
"Settings"
],
"BotsMenuTitle": [ "BotsMenuTitle": [
"Menu" "Menu"
], ],
@ -408,12 +443,18 @@
"ChannelBlockedUsers": [ "ChannelBlockedUsers": [
"Removed users" "Removed users"
], ],
"ChannelCantOpenPrivate2": [
"Sorry, this channel is private."
],
"ChannelDeleteAlert": [ "ChannelDeleteAlert": [
"Deleting this channel will remove all subscribers and all posts will be lost. Delete the channel anyway?" "Deleting this channel will remove all subscribers and all posts will be lost. Delete the channel anyway?"
], ],
"ChannelDeleteInfo": [ "ChannelDeleteInfo": [
"This will delete all messages in the channel for all subscribers." "This will delete all messages in the channel for all subscribers."
], ],
"ChannelJoinRequest": [
"APPLY TO JOIN GROUP"
],
"ChannelMessageAlbum": [ "ChannelMessageAlbum": [
"<mark class=\"token\">%1$s</mark> posted an album" "<mark class=\"token\">%1$s</mark> posted an album"
], ],
@ -540,6 +581,15 @@
"ChooseRecordVideo": [ "ChooseRecordVideo": [
"Record video" "Record video"
], ],
"ChooseStickerMyStickerSets": [
"My sticker sets"
],
"ChooseStickerNoResultsFound": [
"No results found for \"<mark class=\"token\">%1$s</mark>\""
],
"ChooseStickerSetHeader": [
"Choose sticker set"
],
"ChooseTimeForAutoDelete": [ "ChooseTimeForAutoDelete": [
"Choose time for auto-delete" "Choose time for auto-delete"
], ],
@ -549,9 +599,19 @@
"ClearForAll": [ "ClearForAll": [
"Clear for all" "Clear for all"
], ],
"ClearRecentStickersAlertTitle": [
"Clear recent stickers"
],
"ClearSearch": [ "ClearSearch": [
"Clear search history?" "Clear search history?"
], ],
"ClearSearchAlertPartial": [
"Do you want to remove this chat from your search history?",
"Do you want to remove these <mark class=\"token\">%1$d</mark> chats from your search history?"
],
"ClearSearchAlertPartialTitle": [
"Remove from search history"
],
"ColorPickerBackground": [ "ColorPickerBackground": [
"Background" "Background"
], ],
@ -604,6 +664,9 @@
"DebugMenuDisableSmoothKeyboard": [ "DebugMenuDisableSmoothKeyboard": [
"Disable smooth keyboard" "Disable smooth keyboard"
], ],
"DebugMenuDisableWebViewDebug": [
"Disable WebView debug"
],
"DebugMenuEnableCamera": [ "DebugMenuEnableCamera": [
"Enable in-app camera" "Enable in-app camera"
], ],
@ -613,6 +676,9 @@
"DebugMenuEnableSmoothKeyboard": [ "DebugMenuEnableSmoothKeyboard": [
"Enable smooth keyboard" "Enable smooth keyboard"
], ],
"DebugMenuWebViewDebugDisabled": [
"Debug disabled!"
],
"December": [ "December": [
"December" "December"
], ],
@ -861,6 +927,12 @@
"ForwardAnotherChat": [ "ForwardAnotherChat": [
"Forward to another chat" "Forward to another chat"
], ],
"ForwardGroupMedia": [
"Forward media"
],
"ForwardGroupMediaMessage": [
"Would you like to forward..."
],
"ForwardingFromNameAndMessage": [ "ForwardingFromNameAndMessage": [
"<mark class=\"token\">%s</mark>: <mark class=\"token\">%s</mark>" "<mark class=\"token\">%s</mark>: <mark class=\"token\">%s</mark>"
], ],
@ -963,6 +1035,27 @@
"InvalidFormatError": [ "InvalidFormatError": [
"Invalid format" "Invalid format"
], ],
"InviteToGroupErrorMessageDouble": [
"Sorry, you can't add **<mark class=\"token\">%1$s</mark>** and **<mark class=\"token\">%2$s</mark>** to groups because of their privacy settings."
],
"InviteToGroupErrorMessageMultipleAll": [
"Sorry, you can't add these users to groups because of their privacy settings."
],
"InviteToGroupErrorMessageMultipleSome": [
"Sorry, you can't add some of these users to groups because of their privacy settings."
],
"InviteToGroupErrorMessageSingle": [
"Sorry, you can't add **<mark class=\"token\">%1$s</mark>** to groups because of **<mark class=\"token\">%1$s</mark>**'s privacy settings."
],
"InviteToGroupErrorTitleSomeUsers": [
"Can't add some users"
],
"InviteToGroupErrorTitleTheseUsers": [
"Can't add these users"
],
"InviteToGroupErrorTitleThisUser": [
"Can't add this user"
],
"IsEnjoyngAnimations": [ "IsEnjoyngAnimations": [
"<mark class=\"token\">%1$s</mark> is **oo** watching <mark class=\"token\">%2$s</mark>" "<mark class=\"token\">%1$s</mark> is **oo** watching <mark class=\"token\">%2$s</mark>"
], ],
@ -988,6 +1081,10 @@
"LastSeenDateFormatted": [ "LastSeenDateFormatted": [
"last seen <mark class=\"token\">%1$s</mark>" "last seen <mark class=\"token\">%1$s</mark>"
], ],
"LeaveCommunities": [
"Leave community",
"Leave <mark class=\"token\">%d</mark> communities"
],
"LinkCopiedPrivate": [ "LinkCopiedPrivate": [
"Link copied to clipboard. This link will only work for members of this chat." "Link copied to clipboard. This link will only work for members of this chat."
], ],
@ -1159,6 +1256,9 @@
"NoOneJoined": [ "NoOneJoined": [
"No one joined" "No one joined"
], ],
"NoPhoneFound": [
"There is no Telegram account with this phone number."
],
"NoPlacesFound": [ "NoPlacesFound": [
"No places found" "No places found"
], ],
@ -1171,6 +1271,9 @@
"NoReplies": [ "NoReplies": [
"No replies here yet..." "No replies here yet..."
], ],
"NoResultFoundFor": [
"No results found for \"<mark class=\"token\">%s</mark>\"."
],
"NoSharedGifSecret": [ "NoSharedGifSecret": [
"GIFs from this chat will be shown here." "GIFs from this chat will be shown here."
], ],
@ -1186,6 +1289,9 @@
"NoVotesQuiz": [ "NoVotesQuiz": [
"Nobody answered" "Nobody answered"
], ],
"NoWordsRecognized": [
"No words recognized."
],
"NobodyViewed": [ "NobodyViewed": [
"Nobody viewed" "Nobody viewed"
], ],
@ -1339,12 +1445,21 @@
"PaymentEmailToProvider": [ "PaymentEmailToProvider": [
"Email address will be passed to <mark class=\"token\">%1$s</mark> as billing info." "Email address will be passed to <mark class=\"token\">%1$s</mark> as billing info."
], ],
"PaymentInvoiceLinkInvalid": [
"Invalid invoice"
],
"PaymentPhoneToProvider": [ "PaymentPhoneToProvider": [
"Phone will be passed to <mark class=\"token\">%1$s</mark> as billing info." "Phone will be passed to <mark class=\"token\">%1$s</mark> as billing info."
], ],
"PaymentSuccessfullyPaidNoItem": [ "PaymentSuccessfullyPaidNoItem": [
"You successfully transferred <mark class=\"token\">%1$s</mark> to <mark class=\"token\">%2$s</mark>" "You successfully transferred <mark class=\"token\">%1$s</mark> to <mark class=\"token\">%2$s</mark>"
], ],
"PaymentSuccessfullyPaidNoItemRecurrent": [
"You successfully transferred <mark class=\"token\">%1$s</mark> to <mark class=\"token\">%2$s</mark> and allowed future recurrent payments"
],
"PaymentSuccessfullyPaidRecurrent": [
"You successfully transferred <mark class=\"token\">%1$s</mark> to <mark class=\"token\">%2$s</mark> for <mark class=\"token\">%3$s</mark> and allowed future recurrent payments"
],
"PaymentTransactionMessage2": [ "PaymentTransactionMessage2": [
"Transfer **<mark class=\"token\">%1$s</mark>** to the <mark class=\"token\">%2$s</mark> bot for **<mark class=\"token\">%3$s</mark>**?" "Transfer **<mark class=\"token\">%1$s</mark>** to the <mark class=\"token\">%2$s</mark> bot for **<mark class=\"token\">%3$s</mark>**?"
], ],
@ -1620,12 +1735,18 @@
"QuizWrongAnswerInfo": [ "QuizWrongAnswerInfo": [
"You missed the correct option." "You missed the correct option."
], ],
"RateTranscription": [
"Rate transcription"
],
"RecordingVideoStatus": [ "RecordingVideoStatus": [
"recording a video..." "recording a video..."
], ],
"RegisterText": [ "RegisterText": [
"Enter your first and last name" "Enter your first and last name"
], ],
"RemoveGroupStickerSet": [
"Remove Group Sticker Set"
],
"RemovedFromRecent": [ "RemovedFromRecent": [
"Sticker was removed from Recent" "Sticker was removed from Recent"
], ],
@ -1644,6 +1765,15 @@
"RequestSmsButton": [ "RequestSmsButton": [
"Get the code via SMS" "Get the code via SMS"
], ],
"ResetCustomNotifications": [
"Reset to default settings"
],
"ResetCustomNotificationsAlert": [
"Are you sure you want to reset notification settings to default?"
],
"ResetCustomNotificationsAlertTitle": [
"Reset notifications"
],
"ResetNotificationsAlertTitle": [ "ResetNotificationsAlertTitle": [
"Reset all notifications" "Reset all notifications"
], ],
@ -1662,12 +1792,22 @@
"RestorePasswordResetPassword": [ "RestorePasswordResetPassword": [
"RESET PASSWORD" "RESET PASSWORD"
], ],
"RevokeLinks": [
"Revoke link",
"Revoke <mark class=\"token\">%d</mark> links"
],
"Revoked": [ "Revoked": [
"Revoked" "Revoked"
], ],
"RoamingUsage": [ "RoamingUsage": [
"Roaming Data Usage" "Roaming Data Usage"
], ],
"SaveGroupMedia": [
"Save media"
],
"SaveGroupMediaMessage": [
"Would you like to save..."
],
"ScheduleWhenOnline": [ "ScheduleWhenOnline": [
"Send when <mark class=\"token\">%1$s</mark> comes online" "Send when <mark class=\"token\">%1$s</mark> comes online"
], ],
@ -1729,6 +1869,9 @@
"SetAdminsAllInfo": [ "SetAdminsAllInfo": [
"All members can add new members, pin messages, edit name and photo of the group." "All members can add new members, pin messages, edit name and photo of the group."
], ],
"SetAsGroupStickerSet": [
"Set as Group Sticker Set"
],
"SetNewPassword": [ "SetNewPassword": [
"Set a new password" "Set a new password"
], ],
@ -1774,6 +1917,9 @@
"ShowAsList": [ "ShowAsList": [
"Show as list" "Show as list"
], ],
"ShowMoreStickers": [
"Show More Stickers"
],
"ShowStickers": [ "ShowStickers": [
"Show stickers" "Show stickers"
], ],
@ -1929,12 +2075,21 @@
"ThisIsYou": [ "ThisIsYou": [
"this is you" "this is you"
], ],
"ThisMedia": [
"This media"
],
"ThisPhoto": [
"This photo"
],
"TooLargeError": [ "TooLargeError": [
"Too large" "Too large"
], ],
"TooManyCommunitiesHintCreate": [ "TooManyCommunitiesHintCreate": [
"Sorry, you are a member of too many groups or channels. Please leave some before creating a new one." "Sorry, you are a member of too many groups or channels. Please leave some before creating a new one."
], ],
"TranscriptionReportSent": [
"Thank you for your feedback."
],
"TranslateMore": [ "TranslateMore": [
"Translate more..." "Translate more..."
], ],