From 171c7a529f6c4c2fc7a3196b93feda2ec6a63d58 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Wed, 15 Jun 2022 14:32:57 +0000 Subject: [PATCH] Update content of files --- data/web/core.telegram.org/bots/api.html | 148 ++++++++--------- data/web/corefork.telegram.org/bots/api.html | 148 ++++++++--------- .../translations.telegram.org/en/android.html | 4 +- .../en/android/unsorted.html | 155 ++++++++++++++++++ 4 files changed, 305 insertions(+), 150 deletions(-) diff --git a/data/web/core.telegram.org/bots/api.html b/data/web/core.telegram.org/bots/api.html index 12f3c989f4..f0e55979af 100644 --- a/data/web/core.telegram.org/bots/api.html +++ b/data/web/core.telegram.org/bots/api.html @@ -140,7 +140,7 @@ To learn how to create…">

Do I need a Local Bot API Server

The majority of bots will be OK with the default configuration, running on our servers. But if you feel that you need one of these features, you're welcome to switch to your own at any time.

Getting updates

-

There are two mutually exclusive ways of receiving updates for your bot — the getUpdates method on one hand and webhooks 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.

+

There are two mutually exclusive ways of receiving updates for your bot - the getUpdates method on one hand and webhooks 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.

Regardless of which option you choose, you will receive JSON-serialized Update objects as a result.

Update

This object represents an incoming update.
At most one of the optional parameters can be present in any given update.

@@ -161,7 +161,7 @@ To learn how to create…"> message Message -Optional. New incoming message of any kind — text, photo, sticker, etc. +Optional. New incoming message of any kind - text, photo, sticker, etc. edited_message @@ -171,7 +171,7 @@ To learn how to create…"> channel_post Message -Optional. New incoming channel post of any kind — text, photo, sticker, etc. +Optional. New incoming channel post of any kind - text, photo, sticker, etc. edited_channel_post @@ -306,7 +306,7 @@ To learn how to create…"> max_connections Integer Optional -Maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to 40. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput. +The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to 40. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput. allowed_updates @@ -349,7 +349,7 @@ To learn how to create…">

getWebhookInfo

Use this method to get current webhook status. Requires no parameters. On success, returns a WebhookInfo object. If the bot is using getUpdates, will return an object with the url field empty.

WebhookInfo

-

Contains information about the current status of a webhook.

+

Describes the current status of a webhook.

@@ -397,7 +397,7 @@ To learn how to create…"> - + @@ -524,7 +524,7 @@ To learn how to create…"> - + @@ -559,7 +559,7 @@ To learn how to create…"> - + @@ -607,7 +607,7 @@ To learn how to create…"> - + @@ -652,7 +652,7 @@ To learn how to create…"> - + @@ -672,7 +672,7 @@ To learn how to create…"> - + @@ -1198,7 +1198,7 @@ To learn how to create…"> - + @@ -1517,7 +1517,7 @@ To learn how to create…"> - +
max_connections IntegerOptional. Maximum allowed number of simultaneous HTTPS connections to the webhook for update deliveryOptional. The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery
allowed_updates
has_private_forwards TrueOptional. True, if privacy settings of the other party in the private chat allows to use tg://user?id=<user_id> links only in chats with the user. Returned only in getChat.Optional. True, if privacy settings of the other party in the private chat allows to use tg://user?id=<user_id> links only in chats with the user. Returned only in getChat.
description
has_protected_content TrueOptional. True, if messages from the chat can't be forwarded to other chats. Returned only in getChat.Optional. True, if messages from the chat can't be forwarded to other chats. Returned only in getChat.
sticker_set_name
sender_chat ChatOptional. 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 from contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.Optional. 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 from contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.
date
is_automatic_forward TrueOptional. True, if the message is a channel post that was automatically forwarded to the connected discussion groupOptional. True, if the message is a channel post that was automatically forwarded to the connected discussion group
reply_to_message
has_protected_content TrueOptional. True, if the message can't be forwardedOptional. True, if the message can't be forwarded
media_group_id
mime_type StringOptional. Mime type of the file as defined by senderOptional. MIME type of the file as defined by sender
file_size
proximity_alert_radius IntegerOptional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.Optional. The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.
@@ -1570,7 +1570,7 @@ To learn how to create…">

WebAppData

-

Contains data sent from a Web App to the bot.

+

Describes data sent from a Web App to the bot.

@@ -1588,7 +1588,7 @@ To learn how to create…"> - +
button_text StringText of the web_app keyboard button, from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.Text of the web_app keyboard button from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.
@@ -1720,7 +1720,7 @@ To learn how to create…">

File

This object represents a file ready to be downloaded. The file can be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>. 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 getFile.

-

Maximum file size to download is 20 MB

+

The maximum file size to download is 20 MB

@@ -1754,7 +1754,7 @@ To learn how to create…">

WebAppInfo

-

Contains information about a Web App.

+

Describes a Web App.

@@ -1795,7 +1795,7 @@ To learn how to create…"> - + @@ -1947,12 +1947,12 @@ To learn how to create…"> - + - + @@ -2046,7 +2046,7 @@ To learn how to create…"> - + @@ -2092,7 +2092,7 @@ To learn how to create…">
  • 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.
  • Guide the user through a step-by-step process. 'Please send me your question', 'Cool, now let's add the first answer option', 'Great. Keep adding answer options, then send /done when you're ready'.
    • -

    The last option is definitely more attractive. And if you use ForceReply in your bot's questions, it will receive the user's answers even if it only receives replies, commands and mentions — without any extra work for the user.

    +

    The last option is definitely more attractive. And if you use ForceReply in your bot's questions, it will receive the user's answers even if it only receives replies, commands and mentions - without any extra work for the user.

    ChatPhoto

    This object represents a chat photo.

    @@ -2176,7 +2176,7 @@ To learn how to create…"> - + @@ -2967,7 +2967,7 @@ To learn how to create…">
    one_time_keyboard BooleanOptional. Requests clients to hide the keyboard as soon as it'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 false.Optional. Requests clients to hide the keyboard as soon as it'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 false.
    input_field_placeholder
    switch_inline_query StringOptional. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. Can be empty, in which case just the bot's username will be inserted.

    Note: This offers an easy way for users to start using your bot in inline mode when they are currently in a private chat with it. Especially useful when combined with switch_pm… actions – in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen.    		Optional. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted.

    Note: This offers an easy way for users to start using your bot in inline mode when they are currently in a private chat with it. Especially useful when combined with switch_pm… actions - in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen.
    switch_inline_query_current_chat StringOptional. If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. Can be empty, in which case only the bot's username will be inserted.

    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.    		Optional. If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted.

    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.
    callback_game
    data StringOptional. Data associated with the callback button. Be aware that the message, from which originated the query, can contain no callback buttons with this data.Optional. Data associated with the callback button. Be aware that the message originated the query can contain no callback buttons with this data.
    game_short_name
    member_limit IntegerOptional. Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999Optional. The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999
    pending_join_request_count

    ResponseParameters

    -

    Contains information about why a request was unsuccessful.

    +

    Describes why a request was unsuccessful.

    @@ -3017,7 +3017,7 @@ To learn how to create…"> - + @@ -3055,12 +3055,12 @@ To learn how to create…"> - + - + @@ -3118,12 +3118,12 @@ To learn how to create…"> - + - + @@ -3176,12 +3176,12 @@ To learn how to create…"> - + - + @@ -3234,12 +3234,12 @@ To learn how to create…"> - + - + @@ -3266,7 +3266,7 @@ To learn how to create…">

    InputFile

    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.

    Sending files

    -

    There are three ways to send files (photos, stickers, audio, media, etc.):

    +

    There are three ways to send files (photos, stickers, audio, media, etc.):

    1. If the file is already stored somewhere on the Telegram servers, you don't need to reupload it: each file object has a file_id field, simply pass this file_id as a parameter instead of uploading. There are no limits for files sent this way.
    2. 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.
      3. @@ -3376,7 +3376,7 @@ To learn how to create…">

      Formatting options

      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' messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.

      Note that Telegram clients will display an alert to the user before opening an inline link ('Open this link?' together with the full URL).

      -

      Message entities can be nested, providing following restrictions are met:
      - If two entities have common characters then one of them is fully contained inside another.
      - bold, italic, underline, strikethrough, and spoiler entities can contain and can be part of any other entities, except pre and code.
      - All other entities can't contain each other.

      +

      Message entities can be nested, providing following restrictions are met:
      - If two entities have common characters, then one of them is fully contained inside another.
      - bold, italic, underline, strikethrough, and spoiler entities can contain and can be part of any other entities, except pre and code.
      - All other entities can't contain each other.

      Links tg://user?id=<user_id> can be used to mention a user by their ID without using a username. Please note:

    - + @@ -3670,7 +3670,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3712,7 +3712,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3768,13 +3768,13 @@ pre-formatted fixed-width code block written in the Python programming language - + - + @@ -3833,7 +3833,7 @@ pre-formatted fixed-width code block written in the Python programming language
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    caption
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    thumb InputFile or StringOptional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »Optional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    thumb InputFile or StringOptional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »Optional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    thumb InputFile or StringOptional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »Optional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    thumb InputFile or StringOptional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »Optional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption photo InputFile or String YesPhoto 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's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. More info on Sending Files »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's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. More information on Sending Files »
    captionaudio InputFile or String YesAudio 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. More info on Sending Files »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. More information on Sending Files »
    captionthumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    disable_notificationdocument InputFile or String YesFile 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. More info on Sending Files »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. More information on Sending Files »
    thumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption

    sendVideo

    -

    Use this method to send video files, Telegram clients support mp4 videos (other formats may be sent as Document). On success, the sent Message is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.

    +

    Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as Document). On success, the sent Message is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.

    @@ -3854,7 +3854,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3878,7 +3878,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3958,7 +3958,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3982,7 +3982,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4056,7 +4056,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4115,7 +4115,7 @@ pre-formatted fixed-width code block written in the Python programming language
    video InputFile or String YesVideo 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. More info on Sending Files »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. More information on Sending Files »
    durationthumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    captionanimation InputFile or String YesAnimation 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. More info on Sending Files »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. More information on Sending Files »
    durationthumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    captionvoice InputFile or String YesAudio 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. More info on Sending Files »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. More information on Sending Files »
    caption

    sendVideoNote

    -

    As of v.4.0, Telegram clients support rounded square mp4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent Message is returned.

    +

    As of v.4.0, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent Message is returned.

    @@ -4136,7 +4136,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4154,7 +4154,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4382,7 +4382,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4843,7 +4843,7 @@ pre-formatted fixed-width code block written in the Python programming language
    video_note InputFile or String YesVideo 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. More info on Sending Files ». Sending video notes by a URL is currently unsupportedVideo 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. More information on Sending Files ». Sending video notes by a URL is currently unsupported
    durationthumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    disable_notificationproximity_alert_radius Integer OptionalMaximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.
    reply_markup

    getFile

    -

    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 File object is returned. The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>, where <file_path> 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 getFile again.

    +

    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 File object is returned. The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>, where <file_path> 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 getFile again.

    @@ -4858,7 +4858,7 @@ pre-formatted fixed-width code block written in the Python programming language - +
    file_id String YesFile identifier to get info aboutFile identifier to get information about
    @@ -5230,7 +5230,7 @@ pre-formatted fixed-width code block written in the Python programming language member_limit Integer Optional -Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 +The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 creates_join_request @@ -5280,7 +5280,7 @@ pre-formatted fixed-width code block written in the Python programming language member_limit Integer Optional -Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 +The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 creates_join_request @@ -5733,7 +5733,7 @@ pre-formatted fixed-width code block written in the Python programming language url String Optional -URL that will be opened by the user's client. If you have created a Game and accepted the conditions via @BotFather, specify the URL that opens your game — note that this will only work if the query comes from a callback_game button.

    Otherwise, you may use links like t.me/your_bot?start=XXXX that open your bot with a parameter. +URL that will be opened by the user's client. If you have created a Game and accepted the conditions via @BotFather, specify the URL that opens your game - note that this will only work if the query comes from a callback_game button.

    Otherwise, you may use links like t.me/your_bot?start=XXXX that open your bot with a parameter. cache_time @@ -6355,7 +6355,7 @@ pre-formatted fixed-width code block written in the Python programming language sticker InputFile or String Yes -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. More info on Sending Files » +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. More information on Sending Files » disable_notification @@ -6431,7 +6431,7 @@ pre-formatted fixed-width code block written in the Python programming language png_sticker InputFile Yes -PNG 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. More info on Sending Files » +PNG 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. More information on Sending Files » @@ -6457,7 +6457,7 @@ pre-formatted fixed-width code block written in the Python programming language name String Yes -Short name of sticker set, to be used in t.me/addstickers/ URLs (e.g., animals). Can contain only english letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in "_by_<bot_username>". <bot_username> is case insensitive. 1-64 characters. +Short name of sticker set, to be used in t.me/addstickers/ URLs (e.g., animals). Can contain only English letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in "_by_<bot_username>". <bot_username> is case insensitive. 1-64 characters. title @@ -6469,7 +6469,7 @@ pre-formatted fixed-width code block written in the Python programming language png_sticker InputFile or String Optional -PNG 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 file_id 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. More info on Sending Files » +PNG 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 file_id 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. More information on Sending Files » tgs_sticker @@ -6531,7 +6531,7 @@ pre-formatted fixed-width code block written in the Python programming language png_sticker InputFile or String Optional -PNG 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 file_id 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. More info on Sending Files » +PNG 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 file_id 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. More information on Sending Files » tgs_sticker @@ -6633,7 +6633,7 @@ pre-formatted fixed-width code block written in the Python programming language thumb InputFile or String Optional -A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id 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. More info on Sending Files ». Animated sticker set thumbnails can't be uploaded via HTTP URL. +A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id 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. More information on Sending Files ». Animated sticker set thumbnails can't be uploaded via HTTP URL. @@ -6674,7 +6674,7 @@ pre-formatted fixed-width code block written in the Python programming language chat_type String -Optional. 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 +Optional. 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 location @@ -7017,7 +7017,7 @@ pre-formatted fixed-width code block written in the Python programming language mpeg4_url String -A valid URL for the MP4 file. File size must not exceed 1MB +A valid URL for the MPEG4 file. File size must not exceed 1MB mpeg4_width @@ -7108,7 +7108,7 @@ pre-formatted fixed-width code block written in the Python programming language mime_type String -Mime type of the content of the video URL, “text/html” or “video/mp4” +MIME type of the content of the video URL, “text/html” or “video/mp4” thumb_url @@ -7349,7 +7349,7 @@ pre-formatted fixed-width code block written in the Python programming language mime_type String -Mime type of the content of the file, either “application/pdf” or “application/zip” +MIME type of the content of the file, either “application/pdf” or “application/zip” description @@ -7805,7 +7805,7 @@ pre-formatted fixed-width code block written in the Python programming language mpeg4_file_id String -A valid file identifier for the MP4 file +A valid file identifier for the MPEG4 file title @@ -8468,7 +8468,7 @@ pre-formatted fixed-width code block written in the Python programming language

    SentWebAppMessage

    -

    Contains information about an inline message sent by a Web App on behalf of a user.

    +

    Describes an inline message sent by a Web App on behalf of a user.

    @@ -8808,7 +8808,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -8932,7 +8932,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -9023,14 +9023,14 @@ pre-formatted fixed-width code block written in the Python programming language - +
    country_code StringISO 3166-1 alpha-2 country codeTwo-letter ISO 3166-1 alpha-2 country code
    state
    order_info OrderInfoOptional. Order info provided by the userOptional. Order information provided by the user
    telegram_payment_charge_id
    order_info OrderInfoOptional. Order info provided by the userOptional. Order information provided by the user

    Telegram Passport

    Telegram Passport 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 manual for details.

    PassportData

    -

    Contains information about Telegram Passport data shared with the bot by the user.

    +

    Describes Telegram Passport data shared with the bot by the user.

    @@ -9086,7 +9086,7 @@ pre-formatted fixed-width code block written in the Python programming language

    EncryptedPassportElement

    -

    Contains information about documents or other Telegram Passport elements shared with the bot by the user.

    +

    Describes documents or other Telegram Passport elements shared with the bot by the user.

    @@ -9149,7 +9149,7 @@ pre-formatted fixed-width code block written in the Python programming language

    EncryptedCredentials

    -

    Contains data required for decrypting and authenticating EncryptedPassportElement. See the Telegram Passport Documentation for a complete description of the data decryption and authentication processes.

    +

    Describes data required for decrypting and authenticating EncryptedPassportElement. See the Telegram Passport Documentation for a complete description of the data decryption and authentication processes.

    @@ -9691,7 +9691,7 @@ pre-formatted fixed-width code block written in the Python programming language

    getGameHighScores

    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 Array of GameHighScore objects.

    -

    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.

    +

    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.

    diff --git a/data/web/corefork.telegram.org/bots/api.html b/data/web/corefork.telegram.org/bots/api.html index d8612d831b..ffcdb379e8 100644 --- a/data/web/corefork.telegram.org/bots/api.html +++ b/data/web/corefork.telegram.org/bots/api.html @@ -140,7 +140,7 @@ To learn how to create…">

    Do I need a Local Bot API Server

    The majority of bots will be OK with the default configuration, running on our servers. But if you feel that you need one of these features, you're welcome to switch to your own at any time.

    Getting updates

    -

    There are two mutually exclusive ways of receiving updates for your bot — the getUpdates method on one hand and webhooks 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.

    +

    There are two mutually exclusive ways of receiving updates for your bot - the getUpdates method on one hand and webhooks 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.

    Regardless of which option you choose, you will receive JSON-serialized Update objects as a result.

    Update

    This object represents an incoming update.
    At most one of the optional parameters can be present in any given update.

    @@ -161,7 +161,7 @@ To learn how to create…"> - + @@ -171,7 +171,7 @@ To learn how to create…"> - + @@ -306,7 +306,7 @@ To learn how to create…"> - + @@ -349,7 +349,7 @@ To learn how to create…">

    getWebhookInfo

    Use this method to get current webhook status. Requires no parameters. On success, returns a WebhookInfo object. If the bot is using getUpdates, will return an object with the url field empty.

    WebhookInfo

    -

    Contains information about the current status of a webhook.

    +

    Describes the current status of a webhook.

    message MessageOptional. New incoming message of any kind — text, photo, sticker, etc.Optional. New incoming message of any kind - text, photo, sticker, etc.
    edited_message
    channel_post MessageOptional. New incoming channel post of any kind — text, photo, sticker, etc.Optional. New incoming channel post of any kind - text, photo, sticker, etc.
    edited_channel_postmax_connections Integer OptionalMaximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to 40. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput.The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to 40. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput.
    allowed_updates
    @@ -397,7 +397,7 @@ To learn how to create…"> - + @@ -524,7 +524,7 @@ To learn how to create…"> - + @@ -559,7 +559,7 @@ To learn how to create…"> - + @@ -607,7 +607,7 @@ To learn how to create…"> - + @@ -652,7 +652,7 @@ To learn how to create…"> - + @@ -672,7 +672,7 @@ To learn how to create…"> - + @@ -1198,7 +1198,7 @@ To learn how to create…"> - + @@ -1517,7 +1517,7 @@ To learn how to create…"> - +
    max_connections IntegerOptional. Maximum allowed number of simultaneous HTTPS connections to the webhook for update deliveryOptional. The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery
    allowed_updates
    has_private_forwards TrueOptional. True, if privacy settings of the other party in the private chat allows to use tg://user?id=<user_id> links only in chats with the user. Returned only in getChat.Optional. True, if privacy settings of the other party in the private chat allows to use tg://user?id=<user_id> links only in chats with the user. Returned only in getChat.
    description
    has_protected_content TrueOptional. True, if messages from the chat can't be forwarded to other chats. Returned only in getChat.Optional. True, if messages from the chat can't be forwarded to other chats. Returned only in getChat.
    sticker_set_name
    sender_chat ChatOptional. 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 from contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.Optional. 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 from contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.
    date
    is_automatic_forward TrueOptional. True, if the message is a channel post that was automatically forwarded to the connected discussion groupOptional. True, if the message is a channel post that was automatically forwarded to the connected discussion group
    reply_to_message
    has_protected_content TrueOptional. True, if the message can't be forwardedOptional. True, if the message can't be forwarded
    media_group_id
    mime_type StringOptional. Mime type of the file as defined by senderOptional. MIME type of the file as defined by sender
    file_size
    proximity_alert_radius IntegerOptional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.Optional. The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.
    @@ -1570,7 +1570,7 @@ To learn how to create…">

    WebAppData

    -

    Contains data sent from a Web App to the bot.

    +

    Describes data sent from a Web App to the bot.

    @@ -1588,7 +1588,7 @@ To learn how to create…"> - +
    button_text StringText of the web_app keyboard button, from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.Text of the web_app keyboard button from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field.
    @@ -1720,7 +1720,7 @@ To learn how to create…">

    File

    This object represents a file ready to be downloaded. The file can be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>. 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 getFile.

    -

    Maximum file size to download is 20 MB

    +

    The maximum file size to download is 20 MB

    @@ -1754,7 +1754,7 @@ To learn how to create…">

    WebAppInfo

    -

    Contains information about a Web App.

    +

    Describes a Web App.

    @@ -1795,7 +1795,7 @@ To learn how to create…"> - + @@ -1947,12 +1947,12 @@ To learn how to create…"> - + - + @@ -2046,7 +2046,7 @@ To learn how to create…"> - + @@ -2092,7 +2092,7 @@ To learn how to create…">
  • 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.
  • Guide the user through a step-by-step process. 'Please send me your question', 'Cool, now let's add the first answer option', 'Great. Keep adding answer options, then send /done when you're ready'.
    • -

    The last option is definitely more attractive. And if you use ForceReply in your bot's questions, it will receive the user's answers even if it only receives replies, commands and mentions — without any extra work for the user.

    +

    The last option is definitely more attractive. And if you use ForceReply in your bot's questions, it will receive the user's answers even if it only receives replies, commands and mentions - without any extra work for the user.

    ChatPhoto

    This object represents a chat photo.

    @@ -2176,7 +2176,7 @@ To learn how to create…"> - + @@ -2967,7 +2967,7 @@ To learn how to create…">
    one_time_keyboard BooleanOptional. Requests clients to hide the keyboard as soon as it'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 false.Optional. Requests clients to hide the keyboard as soon as it'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 false.
    input_field_placeholder
    switch_inline_query StringOptional. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. Can be empty, in which case just the bot's username will be inserted.

    Note: This offers an easy way for users to start using your bot in inline mode when they are currently in a private chat with it. Especially useful when combined with switch_pm… actions – in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen.    		Optional. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted.

    Note: This offers an easy way for users to start using your bot in inline mode when they are currently in a private chat with it. Especially useful when combined with switch_pm… actions - in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen.
    switch_inline_query_current_chat StringOptional. If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. Can be empty, in which case only the bot's username will be inserted.

    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.    		Optional. If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted.

    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.
    callback_game
    data StringOptional. Data associated with the callback button. Be aware that the message, from which originated the query, can contain no callback buttons with this data.Optional. Data associated with the callback button. Be aware that the message originated the query can contain no callback buttons with this data.
    game_short_name
    member_limit IntegerOptional. Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999Optional. The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999
    pending_join_request_count

    ResponseParameters

    -

    Contains information about why a request was unsuccessful.

    +

    Describes why a request was unsuccessful.

    @@ -3017,7 +3017,7 @@ To learn how to create…"> - + @@ -3055,12 +3055,12 @@ To learn how to create…"> - + - + @@ -3118,12 +3118,12 @@ To learn how to create…"> - + - + @@ -3176,12 +3176,12 @@ To learn how to create…"> - + - + @@ -3234,12 +3234,12 @@ To learn how to create…"> - + - + @@ -3266,7 +3266,7 @@ To learn how to create…">

    InputFile

    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.

    Sending files

    -

    There are three ways to send files (photos, stickers, audio, media, etc.):

    +

    There are three ways to send files (photos, stickers, audio, media, etc.):

    1. If the file is already stored somewhere on the Telegram servers, you don't need to reupload it: each file object has a file_id field, simply pass this file_id as a parameter instead of uploading. There are no limits for files sent this way.
    2. 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.
      3. @@ -3376,7 +3376,7 @@ To learn how to create…">

      Formatting options

      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' messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.

      Note that Telegram clients will display an alert to the user before opening an inline link ('Open this link?' together with the full URL).

      -

      Message entities can be nested, providing following restrictions are met:
      - If two entities have common characters then one of them is fully contained inside another.
      - bold, italic, underline, strikethrough, and spoiler entities can contain and can be part of any other entities, except pre and code.
      - All other entities can't contain each other.

      +

      Message entities can be nested, providing following restrictions are met:
      - If two entities have common characters, then one of them is fully contained inside another.
      - bold, italic, underline, strikethrough, and spoiler entities can contain and can be part of any other entities, except pre and code.
      - All other entities can't contain each other.

      Links tg://user?id=<user_id> can be used to mention a user by their ID without using a username. Please note:

    - + @@ -3670,7 +3670,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3712,7 +3712,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3768,13 +3768,13 @@ pre-formatted fixed-width code block written in the Python programming language - + - + @@ -3833,7 +3833,7 @@ pre-formatted fixed-width code block written in the Python programming language
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    caption
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    thumb InputFile or StringOptional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »Optional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    thumb InputFile or StringOptional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »Optional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    thumb InputFile or StringOptional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »Optional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption
    media StringFile 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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More info on Sending Files »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://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
    thumb InputFile or StringOptional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »Optional. 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption photo InputFile or String YesPhoto 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's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. More info on Sending Files »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's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. More information on Sending Files »
    captionaudio InputFile or String YesAudio 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. More info on Sending Files »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. More information on Sending Files »
    captionthumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    disable_notificationdocument InputFile or String YesFile 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. More info on Sending Files »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. More information on Sending Files »
    thumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    caption

    sendVideo

    -

    Use this method to send video files, Telegram clients support mp4 videos (other formats may be sent as Document). On success, the sent Message is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.

    +

    Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as Document). On success, the sent Message is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.

    @@ -3854,7 +3854,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3878,7 +3878,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3958,7 +3958,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -3982,7 +3982,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4056,7 +4056,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4115,7 +4115,7 @@ pre-formatted fixed-width code block written in the Python programming language
    video InputFile or String YesVideo 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. More info on Sending Files »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. More information on Sending Files »
    durationthumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    captionanimation InputFile or String YesAnimation 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. More info on Sending Files »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. More information on Sending Files »
    durationthumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    captionvoice InputFile or String YesAudio 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. More info on Sending Files »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. More information on Sending Files »
    caption

    sendVideoNote

    -

    As of v.4.0, Telegram clients support rounded square mp4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent Message is returned.

    +

    As of v.4.0, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent Message is returned.

    @@ -4136,7 +4136,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4154,7 +4154,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4382,7 +4382,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -4843,7 +4843,7 @@ pre-formatted fixed-width code block written in the Python programming language
    video_note InputFile or String YesVideo 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. More info on Sending Files ». Sending video notes by a URL is currently unsupportedVideo 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. More information on Sending Files ». Sending video notes by a URL is currently unsupported
    durationthumb InputFile or String OptionalThumbnail 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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More info on Sending Files »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's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
    disable_notificationproximity_alert_radius Integer OptionalMaximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.The maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified.
    reply_markup

    getFile

    -

    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 File object is returned. The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>, where <file_path> 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 getFile again.

    +

    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 File object is returned. The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>, where <file_path> 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 getFile again.

    @@ -4858,7 +4858,7 @@ pre-formatted fixed-width code block written in the Python programming language - +
    file_id String YesFile identifier to get info aboutFile identifier to get information about
    @@ -5230,7 +5230,7 @@ pre-formatted fixed-width code block written in the Python programming language member_limit Integer Optional -Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 +The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 creates_join_request @@ -5280,7 +5280,7 @@ pre-formatted fixed-width code block written in the Python programming language member_limit Integer Optional -Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 +The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 creates_join_request @@ -5733,7 +5733,7 @@ pre-formatted fixed-width code block written in the Python programming language url String Optional -URL that will be opened by the user's client. If you have created a Game and accepted the conditions via @BotFather, specify the URL that opens your game — note that this will only work if the query comes from a callback_game button.

    Otherwise, you may use links like t.me/your_bot?start=XXXX that open your bot with a parameter. +URL that will be opened by the user's client. If you have created a Game and accepted the conditions via @BotFather, specify the URL that opens your game - note that this will only work if the query comes from a callback_game button.

    Otherwise, you may use links like t.me/your_bot?start=XXXX that open your bot with a parameter. cache_time @@ -6355,7 +6355,7 @@ pre-formatted fixed-width code block written in the Python programming language sticker InputFile or String Yes -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. More info on Sending Files » +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. More information on Sending Files » disable_notification @@ -6431,7 +6431,7 @@ pre-formatted fixed-width code block written in the Python programming language png_sticker InputFile Yes -PNG 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. More info on Sending Files » +PNG 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. More information on Sending Files » @@ -6457,7 +6457,7 @@ pre-formatted fixed-width code block written in the Python programming language name String Yes -Short name of sticker set, to be used in t.me/addstickers/ URLs (e.g., animals). Can contain only english letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in "_by_<bot_username>". <bot_username> is case insensitive. 1-64 characters. +Short name of sticker set, to be used in t.me/addstickers/ URLs (e.g., animals). Can contain only English letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in "_by_<bot_username>". <bot_username> is case insensitive. 1-64 characters. title @@ -6469,7 +6469,7 @@ pre-formatted fixed-width code block written in the Python programming language png_sticker InputFile or String Optional -PNG 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 file_id 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. More info on Sending Files » +PNG 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 file_id 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. More information on Sending Files » tgs_sticker @@ -6531,7 +6531,7 @@ pre-formatted fixed-width code block written in the Python programming language png_sticker InputFile or String Optional -PNG 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 file_id 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. More info on Sending Files » +PNG 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 file_id 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. More information on Sending Files » tgs_sticker @@ -6633,7 +6633,7 @@ pre-formatted fixed-width code block written in the Python programming language thumb InputFile or String Optional -A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id 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. More info on Sending Files ». Animated sticker set thumbnails can't be uploaded via HTTP URL. +A PNG image with the thumbnail, must be up to 128 kilobytes in size and have width and height exactly 100px, or a TGS animation with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements, or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id 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. More information on Sending Files ». Animated sticker set thumbnails can't be uploaded via HTTP URL. @@ -6674,7 +6674,7 @@ pre-formatted fixed-width code block written in the Python programming language chat_type String -Optional. 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 +Optional. 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 location @@ -7017,7 +7017,7 @@ pre-formatted fixed-width code block written in the Python programming language mpeg4_url String -A valid URL for the MP4 file. File size must not exceed 1MB +A valid URL for the MPEG4 file. File size must not exceed 1MB mpeg4_width @@ -7108,7 +7108,7 @@ pre-formatted fixed-width code block written in the Python programming language mime_type String -Mime type of the content of the video URL, “text/html” or “video/mp4” +MIME type of the content of the video URL, “text/html” or “video/mp4” thumb_url @@ -7349,7 +7349,7 @@ pre-formatted fixed-width code block written in the Python programming language mime_type String -Mime type of the content of the file, either “application/pdf” or “application/zip” +MIME type of the content of the file, either “application/pdf” or “application/zip” description @@ -7805,7 +7805,7 @@ pre-formatted fixed-width code block written in the Python programming language mpeg4_file_id String -A valid file identifier for the MP4 file +A valid file identifier for the MPEG4 file title @@ -8468,7 +8468,7 @@ pre-formatted fixed-width code block written in the Python programming language

    SentWebAppMessage

    -

    Contains information about an inline message sent by a Web App on behalf of a user.

    +

    Describes an inline message sent by a Web App on behalf of a user.

    @@ -8808,7 +8808,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -8932,7 +8932,7 @@ pre-formatted fixed-width code block written in the Python programming language - + @@ -9023,14 +9023,14 @@ pre-formatted fixed-width code block written in the Python programming language - +
    country_code StringISO 3166-1 alpha-2 country codeTwo-letter ISO 3166-1 alpha-2 country code
    state
    order_info OrderInfoOptional. Order info provided by the userOptional. Order information provided by the user
    telegram_payment_charge_id
    order_info OrderInfoOptional. Order info provided by the userOptional. Order information provided by the user

    Telegram Passport

    Telegram Passport 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 manual for details.

    PassportData

    -

    Contains information about Telegram Passport data shared with the bot by the user.

    +

    Describes Telegram Passport data shared with the bot by the user.

    @@ -9086,7 +9086,7 @@ pre-formatted fixed-width code block written in the Python programming language

    EncryptedPassportElement

    -

    Contains information about documents or other Telegram Passport elements shared with the bot by the user.

    +

    Describes documents or other Telegram Passport elements shared with the bot by the user.

    @@ -9149,7 +9149,7 @@ pre-formatted fixed-width code block written in the Python programming language

    EncryptedCredentials

    -

    Contains data required for decrypting and authenticating EncryptedPassportElement. See the Telegram Passport Documentation for a complete description of the data decryption and authentication processes.

    +

    Describes data required for decrypting and authenticating EncryptedPassportElement. See the Telegram Passport Documentation for a complete description of the data decryption and authentication processes.

    @@ -9691,7 +9691,7 @@ pre-formatted fixed-width code block written in the Python programming language

    getGameHighScores

    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 Array of GameHighScore objects.

    -

    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.

    +

    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.

    diff --git a/data/web/translations.telegram.org/en/android.html b/data/web/translations.telegram.org/en/android.html index f2f0873881..4b5463a916 100644 --- a/data/web/translations.telegram.org/en/android.html +++ b/data/web/translations.telegram.org/en/android.html @@ -179,7 +179,7 @@

    - Android4573 + Android4623
    TranslationsSuggestionsComments

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