aiogram/CHANGES/1747.feature.rst
2026-01-02 01:43:40 +02:00

42 lines
3 KiB
ReStructuredText

Added full support for Telegram Bot API 9.3
**Topics in Private Chats**
Bot API 9.3 introduces forum topics functionality for private chats:
- Added new ``sendMessageDraft`` method for streaming partial messages while being generated (requires forum topic mode enabled)
- Added ``has_topics_enabled`` field to the ``User`` class to determine if forum topic mode is enabled in private chats
- Added ``message_thread_id`` and ``is_topic_message`` fields to the ``Message`` class for private chat topic support
- Added ``message_thread_id`` parameter support to messaging methods: ``sendMessage``, ``sendPhoto``, ``sendVideo``, ``sendAnimation``, ``sendAudio``, ``sendDocument``, ``sendPaidMedia``, ``sendSticker``, ``sendVideoNote``, ``sendVoice``, ``sendLocation``, ``sendVenue``, ``sendContact``, ``sendPoll``, ``sendDice``, ``sendInvoice``, ``sendGame``, ``sendMediaGroup``, ``copyMessage``, ``copyMessages``, ``forwardMessage``, ``forwardMessages``
- Updated ``sendChatAction`` to support ``message_thread_id`` parameter in private chats
- Updated ``editForumTopic``, ``deleteForumTopic``, ``unpinAllForumTopicMessages`` methods to manage private chat topics
- Added ``is_name_implicit`` field to ``ForumTopic`` class
**Gifts System Enhancements**
Enhanced gifts functionality with new methods and extended capabilities:
- Added ``getUserGifts`` method to retrieve gifts owned and hosted by a user
- Added ``getChatGifts`` method to retrieve gifts owned by a chat
- Updated ``UniqueGiftInfo`` class: replaced ``last_resale_star_count`` with ``last_resale_currency`` and ``last_resale_amount`` fields, added "gifted_upgrade" and "offer" as origin values
- Updated ``getBusinessAccountGifts`` method: replaced ``exclude_limited`` parameter with ``exclude_limited_upgradable`` and ``exclude_limited_non_upgradable``, added ``exclude_from_blockchain`` parameter
- Added new fields to ``Gift`` class: ``personal_total_count``, ``personal_remaining_count``, ``is_premium``, ``has_colors``, ``unique_gift_variant_count``, ``gift_background``
- Added new fields to ``UniqueGift`` class: ``gift_id``, ``is_from_blockchain``, ``is_premium``, ``colors``
- Added new fields to gift info classes: ``is_upgrade_separate``, ``unique_gift_number``
- Added ``gift_upgrade_sent`` field to the ``Message`` class
- Added ``gifts_from_channels`` field to the ``AcceptedGiftTypes`` class
- Added new ``UniqueGiftColors`` class for color schemes in user names and link previews
- Added new ``GiftBackground`` class for gift background styling
**Business Accounts & Stories**
- Added ``repostStory`` method to enable reposting stories across managed business accounts
**Miscellaneous Updates**
- Bots can now disable main usernames and set ``can_restrict_members`` rights in channels
- Maximum paid media price increased to 25000 Telegram Stars
- Added new ``UserRating`` class
- Added ``rating``, ``paid_message_star_count``, ``unique_gift_colors`` fields to the ``ChatFullInfo`` class
- Added support for ``message_effect_id`` parameter in forward/copy operations
- Added ``completed_by_chat`` field to the ``ChecklistTask`` class