From 5814fed7651002fe03ca5698805e18cfafee22a2 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Fri, 7 Oct 2022 15:32:56 +0000 Subject: [PATCH] Update content of files --- data/web/core.telegram.org/bots/api.html | 108 +++++++++++------------ 1 file changed, 54 insertions(+), 54 deletions(-) diff --git a/data/web/core.telegram.org/bots/api.html b/data/web/core.telegram.org/bots/api.html index 09837a776b..fbf60e36dc 100644 --- a/data/web/core.telegram.org/bots/api.html +++ b/data/web/core.telegram.org/bots/api.html @@ -142,7 +142,7 @@ To learn how to create…">

See earlier changes »

Authorizing your bot

-

Each bot is given a unique authentication token when it is created. The token looks something like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11, but we'll use simply <token> in this document instead. You can learn about obtaining tokens and generating new ones in this document.

+

Each bot is given a unique authentication token when it is created. The token looks something like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11, but we'll use simply <token> in this document instead. You can learn about obtaining tokens and generating new ones in this document.

Making requests

All queries to the Telegram Bot API must be served over HTTPS and need to be presented in this form: https://api.telegram.org/bot<token>/METHOD_NAME. Like this for example:

https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getMe
@@ -515,7 +515,7 @@ To learn how to create…"> can_read_all_group_messages Boolean -Optional. True, if privacy mode is disabled for the bot. Returned only in getMe. +Optional. True, if privacy mode is disabled for the bot. Returned only in getMe. supports_inline_queries @@ -1846,7 +1846,7 @@ To learn how to create…">

ReplyKeyboardMarkup

-

This object represents a custom keyboard with reply options (see Introduction to bots for details and examples).

+

This object represents a custom keyboard with reply options (see Introduction to bots for details and examples).

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

InlineKeyboardMarkup

-

This object represents an inline keyboard that appears right next to the message it belongs to.

+

This object represents an inline keyboard that appears right next to the message it belongs to.

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

CallbackQuery

-

This object represents an incoming callback query from a callback button in an inline keyboard. If the button that originated the query was attached to a message sent by the bot, the field message will be present. If the button was attached to a message sent via the bot (in inline mode), the field inline_message_id will be present. Exactly one of the fields data or game_short_name will be present.

+

This object represents an incoming callback query from a callback button in an inline keyboard. If the button that originated the query was attached to a message sent by the bot, the field message will be present. If the button was attached to a message sent via the bot (in inline mode), the field inline_message_id will be present. Exactly one of the fields data or game_short_name will be present.

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

NOTE: After the user presses a callback button, Telegram clients will display a progress bar until you call answerCallbackQuery. It is, therefore, necessary to react by calling answerCallbackQuery even if no notification to the user is needed (e.g., without specifying any of the optional parameters).

ForceReply

-

Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply'). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode.

+

Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply'). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode.

@@ -3443,7 +3443,7 @@ To learn how to create…"> - +
reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply OptionalAdditional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.
@@ -3643,7 +3643,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -3717,7 +3717,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -3816,7 +3816,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -3902,7 +3902,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4006,7 +4006,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4104,7 +4104,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4184,7 +4184,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4258,7 +4258,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4394,7 +4394,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4462,7 +4462,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup Optional -A JSON-serialized object for a new inline keyboard. +A JSON-serialized object for a new inline keyboard. @@ -4500,7 +4500,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup Optional -A JSON-serialized object for a new inline keyboard. +A JSON-serialized object for a new inline keyboard. @@ -4598,7 +4598,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4672,7 +4672,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4794,7 +4794,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -4850,7 +4850,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -5771,7 +5771,7 @@ pre-formatted fixed-width code block written in the Python programming language

answerCallbackQuery

-

Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned.

+

Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned.

Alternatively, the user can be redirected to the specified Game URL. For this option to work, you must first create a game for your bot via @BotFather and accept the terms. Otherwise, you may use links like t.me/your_bot?start=XXXX that open your bot with a parameter.

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

setMyCommands

-

Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands. Returns True on success.

+

Use this method to change the list of the bot's commands. See this manual for more details about bot commands. Returns True on success.

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

Inline mode methods

Methods and objects used in the inline mode are described in the Inline mode section.

Updating messages

-

The following methods allow you to change an existing message in the message history instead of sending a new one with a result of an action. This is most useful for messages with inline keyboards using callback queries, but can also help reduce clutter in conversations with regular chat bots.

-

Please note, that it is currently only possible to edit messages without reply_markup or with inline keyboards.

+

The following methods allow you to change an existing message in the message history instead of sending a new one with a result of an action. This is most useful for messages with inline keyboards using callback queries, but can also help reduce clutter in conversations with regular chat bots.

+

Please note, that it is currently only possible to edit messages without reply_markup or with inline keyboards.

editMessageText

Use this method to edit text and game messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.

@@ -6056,7 +6056,7 @@ pre-formatted fixed-width code block written in the Python programming language - +
reply_markup InlineKeyboardMarkup OptionalA JSON-serialized object for an inline keyboard.A JSON-serialized object for an inline keyboard.
@@ -6112,7 +6112,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup Optional -A JSON-serialized object for an inline keyboard. +A JSON-serialized object for an inline keyboard. @@ -6156,7 +6156,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup Optional -A JSON-serialized object for a new inline keyboard. +A JSON-serialized object for a new inline keyboard. @@ -6194,7 +6194,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup Optional -A JSON-serialized object for an inline keyboard. +A JSON-serialized object for an inline keyboard. @@ -6226,7 +6226,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup Optional -A JSON-serialized object for a new message inline keyboard. +A JSON-serialized object for a new message inline keyboard. @@ -6474,7 +6474,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply Optional -Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. +Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. @@ -6844,7 +6844,7 @@ pre-formatted fixed-width code block written in the Python programming language switch_pm_parameter String Optional -Deep-linking parameter for the /start message sent to the bot when user presses the switch button. 1-64 characters, only A-Z, a-z, 0-9, _ and - are allowed.

Example: An inline bot that sends YouTube videos can ask the user to connect the bot to their YouTube account to adapt search results accordingly. To do this, it displays a 'Connect your YouTube account' button above the results, or even before showing any. The user presses the button, switches to a private chat with the bot and, in doing so, passes a start parameter that instructs the bot to return an OAuth link. Once done, the bot can offer a switch_inline button so that the user can easily return to the chat where they wanted to use the bot's inline capabilities. +Deep-linking parameter for the /start message sent to the bot when user presses the switch button. 1-64 characters, only A-Z, a-z, 0-9, _ and - are allowed.

Example: An inline bot that sends YouTube videos can ask the user to connect the bot to their YouTube account to adapt search results accordingly. To do this, it displays a 'Connect your YouTube account' button above the results, or even before showing any. The user presses the button, switches to a private chat with the bot and, in doing so, passes a start parameter that instructs the bot to return an OAuth link. Once done, the bot can offer a switch_inline button so that the user can easily return to the chat where they wanted to use the bot's inline capabilities. @@ -6907,7 +6907,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message url @@ -7010,7 +7010,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7093,7 +7093,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7176,7 +7176,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7267,7 +7267,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7335,7 +7335,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7399,7 +7399,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7552,7 +7552,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7641,7 +7641,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7710,7 +7710,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7764,7 +7764,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message @@ -7823,7 +7823,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7881,7 +7881,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7939,7 +7939,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -7977,7 +7977,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -8041,7 +8041,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -8105,7 +8105,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -8163,7 +8163,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -8217,7 +8217,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup -Optional. Inline keyboard attached to the message +Optional. Inline keyboard attached to the message input_message_content @@ -8768,7 +8768,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup Optional -A JSON-serialized object for an inline keyboard. If empty, one 'Pay total price' button will be shown. If not empty, the first button must be a Pay button. +A JSON-serialized object for an inline keyboard. If empty, one 'Pay total price' button will be shown. If not empty, the first button must be a Pay button. @@ -9826,7 +9826,7 @@ pre-formatted fixed-width code block written in the Python programming language reply_markup InlineKeyboardMarkup Optional -A JSON-serialized object for an inline keyboard. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. +A JSON-serialized object for an inline keyboard. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game.