Bot API 9.3 #2539

coder2020official · 2025-12-31T13:37:58Z

December 31, 2025
Bot API 9.3

Topics in private chats

Added the field has_topics_enabled to the class User, which can be used to determine whether forum topic mode is enabled for the bot in private chats.
Added the method sendMessageDraft, allowing partial messages to be streamed to a user while being generated.
Supported the fields message_thread_id and is_topic_message in the class Message for messages in private chats with forum topic mode enabled.
Supported the parameter message_thread_id in private chats with topics in the methods sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage, and forwardMessages, allowing bots to send a message to a specific topic.
Supported the parameter message_thread_id in private chats in the method sendChatAction, allowing bots to send chat actions to a specific topic in private chats.
Supported the parameter message_thread_id in private chats with topics in the method editForumTopic, deleteForumTopic, and unpinAllForumTopicMessages, allowing bots to manage topics in private chats.
Added the field is_name_implicit to the classes ForumTopic and ForumTopicCreated.

Gifts

Miscellaneous

Allowed bots to disable their main username if they have additional active usernames purchased on Fragment.
Allowed bots to disable the right can_restrict_members in channel chats.
Added the method repostStory, allowing bots to repost stories across different business accounts they manage.
Added the class UserRating and the field rating to the class ChatFullInfo.
Increased the maximum price for paid media to 25000 Telegram Stars.
Added the field paid_message_star_count to the class ChatFullInfo.
Added the parameter message_effect_id to the methods forwardMessage and copyMessage.
Added the field unique_gift_colors to the class ChatFullInfo.
Added the field completed_by_chat to the class ChecklistTask.

…ed to determine whether forum topic mode is enabled for the bot in private chats.

…reamed to a user while being generated.

…ass Message for messages in private chats with forum topic mode enabled.

…s in some methods

…opicCreated.

…_currency and last_resale_amount in the class UniqueGiftInfo.

…mited_upgradable and exclude_limited_non_upgradable in the method getBusinessAccountGifts.

…o.origin for messages about the upgrade of a gift that was purchased after it was sent. Added the value “offer” as a possible value of UniqueGiftInfo.origin for messages about the purchase of a gift through a purchase offer.

…AccountGifts, to filter out gifts that were assigned from the TON blockchain.

… the class Gift.

…GiftRegular.

…a user's name, replies to messages and link previews based on a unique gift.

…Gift.

…e field unique_gift_number to the classes GiftInfo and OwnedGiftRegular.

…different business accounts they manage.

…Info.

…nd copyMessage.

coder2020official · 2025-12-31T14:43:41Z

@Badiboy happy new year
finished I think, but messed up some stuff (need thorough review) and had to fix conflicts, hopefully nothing was impacted
skipped updating docstrings in places like 'supported ...'

Badiboy · 2026-01-01T18:31:37Z

Got it... Will work on, but bot so fast.

Badiboy · 2026-01-07T14:16:08Z

telebot/types.py

    :type message_id: :obj:`int`

-    :param message_thread_id: Optional. Unique identifier of a message thread to which the message belongs; for supergroups only
+    :param message_thread_id: Optional. Unique identifier of a message thread to which the message belongs; for supergroups and private chats only


Need to process this parameter manually in de_json.

Badiboy · 2026-01-07T14:16:13Z

telebot/types.py

    :type forward_origin: :class:`telebot.types.MessageOrigin`

-    :param is_topic_message: Optional. True, if the message is sent to a forum topic
+    :param is_topic_message: Optional. True, if the message is sent to a topic in a forum supergroup or a private chat with the bot


Need to process this parameter manually in de_json.

Badiboy · 2026-01-07T14:30:39Z

telebot/apihelper.py

+          payload['exclude_unique'] = exclude_unique
+     if sort_by_price is not None:
+          payload['sort_by_price'] = sort_by_price
+     if offset is not None:


use an empty string to get the first chunk of results

I do not know how TG will process absence of this parameter. May be pass "" is offset is None?

Badiboy · 2026-01-07T14:32:03Z

telebot/apihelper.py

+                payload['exclude_unique'] = exclude_unique
+        if sort_by_price is not None:
+                payload['sort_by_price'] = sort_by_price
+        if offset is not None:


use an empty string to get the first chunk of results

I do not know how TG will process absence of this parameter. May be pass "" is offset is None?

Badiboy · 2026-01-07T14:32:53Z

telebot/asyncio_helper.py

+     if sort_by_price is not None:
+          payload['sort_by_price'] = sort_by_price
+     if offset is not None:
+          payload['offset'] = offset


use an empty string to get the first chunk of results

I do not know how TG will process absence of this parameter. May be pass "" is offset is None?

Badiboy · 2026-01-07T18:11:52Z

telebot/types.py

        obj['symbol'] = UniqueGiftSymbol.de_json(obj['symbol'])
        obj['backdrop'] = UniqueGiftBackdrop.de_json(obj['backdrop'])
        obj['gift_id'] = obj['gift_id']
+        if 'is_from_blockchain' in obj:


if 'is_from_blockchain' in obj: obj['is_from_blockchain'] = obj['is_from_blockchain']

Don't need this.

Badiboy · 2026-01-07T18:13:52Z

telebot/types.py

        if json_string is None: return None
        obj = cls.check_json(json_string)
        obj['sticker'] = Sticker.de_json(obj['sticker'])
+        if 'personal_total_count' in obj:


if 'personal_total_count' in obj: obj['personal_total_count'] = obj['personal_total_count'] if 'personal_remaining_count' in obj: obj['personal_remaining_count'] = obj['personal_remaining_count']

Don't need this.

Badiboy · 2026-01-07T18:15:05Z

telebot/types.py

        if 'personal_remaining_count' in obj:
            obj['personal_remaining_count'] = obj['personal_remaining_count']
-
+        if 'is_premium' in obj:


if 'is_premium' in obj: obj['is_premium'] = obj['is_premium']

Don't need this.

Badiboy · 2026-01-07T18:15:40Z

telebot/types.py

        obj['gift_id'] = obj['gift_id']
        if 'is_from_blockchain' in obj:
            obj['is_from_blockchain'] = obj['is_from_blockchain']
+        if 'is_premium' in obj:


if 'is_premium' in obj: obj['is_premium'] = obj['is_premium']

Don't need this.

Badiboy · 2026-01-07T18:32:23Z

telebot/types.py

-        self.limited_gifts: bool = limited_gifts
-        self.unique_gifts: bool = unique_gifts
-        self.premium_subscription: bool = premium_subscription
+    def __init__(self, unlimited_gifts: Optional[bool]=None, limited_gifts: Optional[bool]=None,


They don't marked as OPTIONAL. New form of description, but not mentioned as optional there.

I haven't had an opportunity to test, but was cautious

coder2020official added 28 commits December 31, 2025 16:46

Added the field has_topics_enabled to the class User, which can be us…

09308bf

…ed to determine whether forum topic mode is enabled for the bot in private chats.

Added the method sendMessageDraft, allowing partial messages to be st…

ec90c74

…reamed to a user while being generated.

Supported the fields message_thread_id and is_topic_message in the cl…

345a9b1

…ass Message for messages in private chats with forum topic mode enabled.

Supported the parameter message_thread_id in private chats with topic…

0a1ab2f

…s in some methods

Added the field is_name_implicit to the classes ForumTopic and ForumT…

184a672

…opicCreated.

Added the methods getUserGifts and getChatGifts.

00032db

Replaced the field last_resale_star_count with the fields last_resale…

d8a107a

…_currency and last_resale_amount in the class UniqueGiftInfo.

Replaced the parameter exclude_limited with the parameters exclude_li…

3bfc160

…mited_upgradable and exclude_limited_non_upgradable in the method getBusinessAccountGifts.

Added the field gift_upgrade_sent to the class Message.

5ca90c8

Added the field gift_id to the class UniqueGift.

2f062da

Added the field is_from_blockchain to the class UniqueGift.

98245c3

Added the parameter exclude_from_blockchain in the method getBusiness…

1702b7c

…AccountGifts, to filter out gifts that were assigned from the TON blockchain.

Added the fields personal_total_count and personal_remaining_count to…

e87e7cc

… the class Gift.

Added the field is_premium to the classes Gift and UniqueGift.

19cea9d

Fix

d1f2862

Added the field is_upgrade_separate to the classes GiftInfo and Owned…

4ea5ddc

…GiftRegular.

Added the class UniqueGiftColors that describes the color scheme for …

ba12d90

…a user's name, replies to messages and link previews based on a unique gift.

Added the field has_colors to the class Gift.

951f24c

Added the field colors to the class UniqueGift.

b6df64c

Added the class GiftBackground and the field background to the class …

a845b76

…Gift.

Merge branch 'master' into master

8ad7d7e

Added the field unique_gift_variant_count to the class Gift. Added th…

8d61448

…e field unique_gift_number to the classes GiftInfo and OwnedGiftRegular.

Added the method repostStory, allowing bots to repost stories across …

913ff95

…different business accounts they manage.

Added the class UserRating and the field rating to the class ChatFull…

9688d33

…Info.

Added the field paid_message_star_count to the class ChatFullInfo.

40d9c3b

completed_by_chat & unique_gift_colors

6e6190b

Added the parameter message_effect_id to the methods forwardMessage a…

9c057fb

…nd copyMessage.

Badiboy requested changes Jan 7, 2026

View reviewed changes

Bot API 9.3 #2539

Are you sure you want to change the base?

Bot API 9.3 #2539

Conversation

coder2020official commented Dec 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coder2020official commented Dec 31, 2025

Uh oh!

Badiboy commented Jan 1, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

coder2020official commented Dec 31, 2025 •

edited

Loading