37.0.0

[InsanusMokrassar]

THIS UPDATE CONTAINS SUPPORT OF TELEGRAM BOTS API 10.3

Bot API 10.3

Rich Messages

• Added the class RichMessageButton representing a button in a RichMessage.
• Added the class RichTextButton.
• Added the classes RichBlockButtons and InputRichBlockButtons.
• Added the field is_compact to the classes RichBlockTable and InputRichBlockTable.
• Added the classes RichBlockExpandableBlockQuotation and InputRichBlockExpandableBlockQuotation representing a block quotation, which can be expanded or collapsed back.
• Added the classes RichBlockDocument and InputRichBlockDocument, containing a file.
• Added support for links of the form tg://document?id= for general file uploads in rich messages.

Ephemeral messages

• Added the class EphemeralMessageParameters and replaced the parameters receiver_user_id and callback_query_id in the methods sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation and sendVenue with the parameter ephemeral_message_parameters.
• Added the parameter ephemeral_message_parameters to the method sendRichMessage.
• Added the field replace_callback_query_message to the class EphemeralMessageParameters, allowing bots to show an ephemeral message in place of the original message.
• Supported upload of new files in editEphemeralMessageMedia.
• Added the parameter show_caption_above_media to the method editEphemeralMessageCaption.
• Added the parameter rich_message to the method editEphemeralMessageText.
• Added the field can_send_welcome_messages to the classes ChatAdministratorRights and ChatMemberAdministrator.
• Added the parameter can_send_welcome_messages to the method promoteChatMember.

Reply markup

• Added the class DisabledButton and the field disabled to the class InlineKeyboardButton.
• Added the field force_reply to the classes InlineKeyboardMarkup and ReplyKeyboardMarkup.

General

• Added the parameters can_stop and keep_on_stop to the methods sendMessageDraft and sendRichMessageDraft.
• Added updates about user stopping message generation, represented by the class MessageGenerationStopped and the field stopped_message_generation in the class Update.
• Added the class CommunityChatJoined and the field community_chat_joined to the class Message for service messages about join of a chat from a community.
• Added the fields text, entities and is_private to the class UniqueGiftInfo.

---

Notes

Breaking changes (documented in CHANGELOG.md):

• OptionallyEphemeralSendRequest and the 13 ephemeral-capable send/reply families replace receiverUserId/callbackQueryId with ephemeralMessageParameters.
• ChatAdministratorRights gains canSendWelcomeMessages; direct same-module implementations must supply the property.
• FlowsUpdatesFilter gains messageGenerationStoppedUpdatesFlow; direct implementations must supply the flow.
• RichText gains isValidRichMessageButtonText; exhaustive when expressions over the extended rich-type sealed hierarchies must cover the Bot API 10.3 variants.

Coverage audit corrections:

• Corrected expandable-quotation Rich Markdown block HTML from <blockquote collapsed> with Markdown-formatted children to <blockquote expandable> with HTML-formatted nested text and credit.
• Added secondary live-photo photo multipart attachments to ephemeral and regular media edits, media groups, and paid media.
• Added named rich-message overloads and generic InputRichMessage/RichMessageContent aliases across both ephemeral reply families.
• Moved rich-button text validation and markup rendering into the corresponding sealed-hierarchy contracts.
• Preserved the pre-10.3 positional constructor and componentN prefix for UniqueGiftInfo; the new fields are trailing.

Deferred (follow-up):

• Official Bot API 10.3 coverage is complete: 21 of 21 items.
• Pre-existing formatter defects remain deferred in RichBlockFooter.markdown, RichBlockPullQuotation.markdown, RichBlockMap.markdown and RichBlockThinking.markdown: each formatter places Markdown-formatted nested content inside block-level HTML. The defects predate Bot API 10.3 and remain outside the current PR correction scope.

🤖 Generated with OpenAI Codex