Subscribe to @BotNews to be the first to know about the latest updates and join the discussion in @BotTalk
2024
+May 28, 2024
+Bot API 7.4
+-
+
- Added support for payments in Telegram Stars by introducing the new currency “XTR”. +
- The parameter provider_token of the methods sendInvoice and createInvoiceLink must be omitted for payments in Telegram Stars. +
- The field provider_token in the class InputInvoiceMessageContent must be omitted for payments in Telegram Stars. +
- Added the method refundStarPayment. +
- Added the field effect_id to the class Message. +
- Added the parameter message_effect_id to the methods sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, and sendMediaGroup. +
- Added the field show_caption_above_media to the classes Message, InputMediaAnimation, InputMediaPhoto, InputMediaVideo, InlineQueryResultGif, InlineQueryResultMpeg4Gif, InlineQueryResultPhoto, InlineQueryResultVideo, InlineQueryResultCachedGif, InlineQueryResultCachedMpeg4Gif, InlineQueryResultCachedPhoto, and InlineQueryResultCachedVideo. +
- Added the parameter show_caption_above_media to the methods sendAnimation, sendPhoto, sendVideo, copyMessage, and editMessageCaption. +
- Added support for “expandable_blockquote” entities in received messages. +
- Added support for “expandable_blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes. +
- Allowed to explicitly specify “expandable_blockquote” entities in formatted texts. +
May 6, 2024
Bot API 7.3
-
diff --git a/data/web/core.telegram.org/bots/api.html b/data/web/core.telegram.org/bots/api.html
index c064efe7c4..54895c75dd 100644
--- a/data/web/core.telegram.org/bots/api.html
+++ b/data/web/core.telegram.org/bots/api.html
@@ -53,6 +53,21 @@ To learn how to create…">
- Added support for payments in Telegram Stars by introducing the new currency “XTR”. +
- The parameter provider_token of the methods sendInvoice and createInvoiceLink must be omitted for payments in Telegram Stars. +
- The field provider_token in the class InputInvoiceMessageContent must be omitted for payments in Telegram Stars. +
- Added the method refundStarPayment. +
- Added the field effect_id to the class Message. +
- Added the parameter message_effect_id to the methods sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, and sendMediaGroup. +
- Added the field show_caption_above_media to the classes Message, InputMediaAnimation, InputMediaPhoto, InputMediaVideo, InlineQueryResultGif, InlineQueryResultMpeg4Gif, InlineQueryResultPhoto, InlineQueryResultVideo, InlineQueryResultCachedGif, InlineQueryResultCachedMpeg4Gif, InlineQueryResultCachedPhoto, and InlineQueryResultCachedVideo. +
- Added the parameter show_caption_above_media to the methods sendAnimation, sendPhoto, sendVideo, copyMessage, and editMessageCaption. +
- Added support for “expandable_blockquote” entities in received messages. +
- Added support for “expandable_blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes. +
- Allowed to explicitly specify “expandable_blockquote” entities in formatted texts. +
- These links will work only if they are used inside an inline link or in an inline keyboard button. For example, they will not work, when used in a message text. @@ -5911,16 +5957,22 @@ pre-formatted fixed-width code block written in the Python programming language ``` >Block quotation started >Block quotation continued ->The last line of the block quotation** ->The second block quotation started right after the previous\r ->The third block quotation started right after the previous +>Block quotation continued +>Block quotation continued +>The last line of the block quotation +**>The expandable block quotation started right after the previous block quotation +>It is separated from the previous block quotation by an empty bold entity +>Expandable block quotation continued +>Hidden by default part of the expandable block quotation started +>Expandable block quotation continued +>The last line of the expandable block quotation with the expandability mark||
- Any character with code between 1 and 126 inclusively can be escaped anywhere with a preceding '\' character, in which case it is treated as an ordinary character and not a part of the markup. This implies that '\' character usually must be escaped with a preceding '\' character.
- Inside
preandcodeentities, all '`' and '\' characters must be escaped with a preceding '\' character. - Inside the
(...)part of the inline link and custom emoji definition, all ')' and '\' must be escaped with a preceding '\' character. - In all other places characters '_', '*', '[', ']', '(', ')', '~', '`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!' must be escaped with the preceding character '\'. -
- In case of ambiguity between
italicandunderlineentities__is always greadily treated from left to right as beginning or end ofunderlineentity, so instead of___italic underline___use___italic underline_\r__, where\ris a character with code 13, which will be ignored.
+ - In case of ambiguity between
italicandunderlineentities__is always greadily treated from left to right as beginning or end of anunderlineentity, so instead of___italic underline___use___italic underline_**__, adding an empty bold entity as a separator. - A valid emoji must be provided as an alternative value for the custom emoji. The emoji will be shown instead of the custom emoji in places where a custom emoji cannot be displayed (e.g., system notifications) or if the message is forwarded by a non-premium user. It is recommended to use the emoji from the emoji field of the custom emoji sticker.
- Custom emoji entities can only be used by bots that purchased additional usernames on Fragment.
- Only the tags mentioned above are currently supported. @@ -5966,7 +6019,7 @@ pre-formatted fixed-width code block written in the Python programming language
- Entities must not be nested, use parse mode MarkdownV2 instead. -
- There is no way to specify “underline”, “strikethrough”, “spoiler”, “blockquote” and “custom_emoji” entities, use parse mode MarkdownV2 instead. +
- There is no way to specify “underline”, “strikethrough”, “spoiler”, “blockquote”, “expandable_blockquote” and “custom_emoji” entities, use parse mode MarkdownV2 instead.
- To escape characters '_', '*', '`', '[' outside of an entity, prepend the characters '\' before them.
- Escaping inside entities is not allowed, so entity must be closed first and reopened again: use
_snake_\__case_for italicsnake_caseand*2*\**2=4*for bold2*2=4.
+Subscribe to @BotNews to be the first to know about the latest updates and join the discussion in @BotTalk
May 28, 2024
+Bot API 7.4
+-
+
May 6, 2024
Bot API 7.3
-
@@ -1043,6 +1058,11 @@ To learn how to create…">
@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers)@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers)KeyboardButton
-This object represents one button of the reply keyboard. For simple text buttons, String can be used instead of this object to specify the button text. The optional fields web_app, request_users, request_chat, request_contact, request_location, and request_poll are mutually exclusive.
+This object represents one button of the reply keyboard. At most one of the optional fields must be used to specify type of the button. For simple text buttons, String can be used instead of this object to specify the button text.
InlineKeyboardButton
-This object represents one button of an inline keyboard. You must use exactly one of the optional fields.
+This object represents one button of an inline keyboard. Exactly one of the optional fields must be used to specify type of the button.
| pay | Boolean | -Optional. Specify True, to send a Pay button. NOTE: This type of button must always be the first button in the first row and can only be used in invoice messages. |
+Optional. Specify True, to send a Pay button. Substrings “ ” and “XTR” in the buttons's text will be replaced with a Telegram Star icon.NOTE: This type of button must always be the first button in the first row and can only be used in invoice messages. |
Formatting options
The Bot API supports basic formatting for messages. You can use bold, italic, underlined, strikethrough, spoiler text, block quotations as well as inline links and pre-formatted code in your bots' messages. Telegram clients will render them accordingly. You can specify text entities directly, or use 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.
- blockquote entities can't be nested.
- 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.
- blockquote and expandable_blockquote entities can't be nested.
- All other entities can't contain each other.
Links tg://user?id=<user_id> can be used to mention a user by their identifier without using a username. Please note:
Please note:
Please note:
Please note:
US$ 1.45 pass max_tip_amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0US$ 1.45 pass max_tip_amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in Telegram Stars.US$ 1.45 pass max_tip_amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0US$ 1.45 pass max_tip_amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in Telegram Stars.US$ 1.45 pass max_tip_amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0US$ 1.45 pass max_tip_amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in Telegram Stars.refundStarPayment
+Refunds a successful payment in Telegram Stars. Returns True on success.
+| Parameter | +Type | +Required | +Description | +
|---|---|---|---|
| user_id | +Integer | +Yes | +Identifier of the user whose payment will be refunded | +
| telegram_payment_charge_id | +String | +Yes | +Telegram payment identifier | +
LabeledPrice
This object represents a portion of the price for goods or services.
| currency | String | -Three-letter ISO 4217 currency code | +Three-letter ISO 4217 currency code, or “XTR” for payments in Telegram Stars |
| total_amount | @@ -12646,7 +12879,7 @@ pre-formatted fixed-width code block written in the Python programming language|||
| currency | String | -Three-letter ISO 4217 currency code | +Three-letter ISO 4217 currency code, or “XTR” for payments in Telegram Stars |
| total_amount | @@ -12737,7 +12970,7 @@ pre-formatted fixed-width code block written in the Python programming language|||
| currency | String | -Three-letter ISO 4217 currency code | +Three-letter ISO 4217 currency code, or “XTR” for payments in Telegram Stars |
| total_amount | @@ -13314,6 +13547,12 @@ pre-formatted fixed-width code block written in the Python programming languageProtects the contents of the sent message from forwarding and saving | ||
| message_effect_id | +String | +Optional | +Unique identifier of the message effect to be added to the message | +
| reply_parameters | ReplyParameters | Optional |