Botapi 10.2

[coder2020official]

July 14, 2026
Bot API 10.2

Rich Messages

• Added the class InputRichMessageMedia and the field media to the class InputRichMessage, allowing bots to explicitly specify media used in markdown or html formatting when sending a rich message.
• Added the class InputMediaVoiceNote, representing a voice message to be sent.
• Added the class InputRichBlockListItem, which represents an item in a list to be sent.
• Added the classes InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote and InputRichBlockThinking, which represent different types of blocks available to format an outgoing rich message.
• Added the field blocks to the class InputRichMessage, allowing bots to specify rich message formatting via block entities.

Ephemeral Messages

• Introduced support for Ephemeral Messages, allowing bots to send group messages and receive commands that are visible only to a specific user and the bot.
• Added the field is_ephemeral to the class BotCommand.
• Added the field receiver_user to the class Message.
• Added the field ephemeral_message_id to the class Message.
• Added the parameters receiver_user_id and callback_query_id to the methods sendMessage, sendAnimation, sendAudio, sendDocument, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue.
• Added the field ephemeral_message_id to the class ReplyParameters, allowing bots to reply to ephemeral messages.
• Marked the field message_id in the class ReplyParameters as optional if the field ephemeral_message_id is present.
• Added the methods editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, and editEphemeralMessageReplyMarkup allowing bots to edit ephemeral messages.
• Added the method deleteEphemeralMessage allowing bots to delete ephemeral messages.

Communities

• Introduced initial support for Communities - several supergroups, channels, and bots linked together around a shared topic or audience.
• Added the class Community which represents a community.
• Added the class CommunityChatAdded and the field community_chat_added to the class Message.
• Added the class CommunityChatRemoved and the field community_chat_removed to the class Message.
• Added the field community to the class ChatFullInfo.

General

• [ ]
• Added updates about changes to a user payment subscription, represented by the class BotSubscriptionUpdated and the field subscription in the class Update.
• Hardened the security of Mini Apps by disallowing the usage of Mini App methods from origins different from the original Mini App domain. The protection will be automatically enabled for all Mini Apps on July 20, 2026. You can opt-out from the protection through the @BotFather Mini App. If you do so, you acknowledge that it is the responsibility of the bot to ensure that the Mini App has no links to untrusted sites.

[coder2020official]

@Badiboy I'm pretty much done except for one point (creating a handler to handle user payment subscription updates), so you may start reviewing so we can get over this asap

[coder2020official]

Double check tho might've missed something in between

[Badiboy]

God, one more API update... )

[Badiboy]

Some minor requests.

[Copilot]

Pull request overview

This PR updates pyTelegramBotAPI to align with Telegram Bot API 10.2 by extending type models and client helpers for rich messages, ephemeral messaging, communities, and subscription updates.

Changes:

• Added new/updated types models and parsing for subscriptions, communities, and ephemeral message fields.
• Extended sync/async API helpers and bot methods to support outgoing ephemeral parameters and ephemeral edit/delete endpoints.
• Updated tests and update-type lists to match the expanded Update schema.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/test_telebot.py	Adjusts test helper Update construction to include the new subscription field.
tests/test_handler_backends.py	Updates positional Update construction to match the expanded constructor arity.
telebot/util.py	Extends update/service-message type lists for new API 10.2 event types.
telebot/types.py	Adds new API 10.2 objects/fields (rich message inputs, communities, ephemeral fields, subscriptions) and updates serialization/deserialization.
telebot/asyncio_helper.py	Adds receiver_user_id/callback_query_id send params and implements ephemeral edit/delete API calls (async).
telebot/async_telebot.py	Wires new send params, adds ephemeral edit/delete methods, and introduces subscription handlers (async bot).
telebot/apihelper.py	Adds receiver_user_id/callback_query_id send params and implements ephemeral edit/delete API calls (sync).
telebot/__init__.py	Wires new send params, adds ephemeral edit/delete methods, and introduces subscription handlers (sync bot).

Comments suppressed due to low confidence (1)

telebot/types.py:10127

• ReplyParameters.to_dict() always includes message_id even when it is None. When replying to an ephemeral message (only ephemeral_message_id set), this will serialize {"message_id": null, ...} which is likely rejected by the Bot API and makes the new ephemeral reply feature unusable via reply_parameters. Also, self.message_id is now optional but is still typed as int.

    def to_dict(self) -> dict:
        json_dict = {
            'message_id': self.message_id
        }

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[coder2020official]

@Badiboy should be done

[Badiboy]

Da best!