Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
00dc7de
Bump Bot API Version
aelkheir Jan 1, 2026
1a1b23e
Add chango fragment for PR #5078
aelkheir Jan 1, 2026
350a7bc
Use compact syntax for chango fragment
aelkheir Jan 1, 2026
e71a95e
Misc Doc Updates
Bibo-Joshi Jan 6, 2026
d2c19a1
chango fragment
Bibo-Joshi Jan 6, 2026
a6c8fff
Revert "chango fragment"
Bibo-Joshi Jan 6, 2026
6b0a99a
Revert "Misc Doc Updates"
Bibo-Joshi Jan 6, 2026
2624227
Api 9.3 misc doc updates (#5085)
Bibo-Joshi Jan 7, 2026
92a947d
API 9.3 Topics in private chats (#5079)
aelkheir Jan 7, 2026
ae894c1
Api 9.3: Add `UniqueGiftColors` & `ChatFullInfo` Updates (#5084)
Bibo-Joshi Jan 7, 2026
2afddaa
Api 9.3 Rest of Misc (#5086)
Bibo-Joshi Jan 7, 2026
c4dbe8f
Api 9.3 some gift related updates (#5089)
Bibo-Joshi Jan 8, 2026
68d4907
Api 9.3 GiftBackground & Gift Changes (#5090)
Bibo-Joshi Jan 8, 2026
960e1ea
Api 9.3 Updates for `GiftInfo` and `OwnedGiftRegular` (#5091)
Bibo-Joshi Jan 12, 2026
5ff5ef1
Api 9.3 get gifts (#5087)
Bibo-Joshi Jan 12, 2026
b16f7f8
Api 9.3 Changes for `UniqueGift` (#5092)
Bibo-Joshi Jan 12, 2026
faeb210
Api 9.3 `getBusinessAccountGifts` (#5095)
Bibo-Joshi Jan 18, 2026
273de3c
Api 9.3 `UniqueGiftInfo` (#5094)
Bibo-Joshi Jan 18, 2026
3b2aeef
Api 9.3 Fix `test_official` tests (#5106)
aelkheir Jan 18, 2026
ec08c54
add some debug prints
Bibo-Joshi Jan 21, 2026
335b1e6
add some debug prints
Bibo-Joshi Jan 21, 2026
000e778
add some debug prints
Bibo-Joshi Jan 21, 2026
8edb5d5
make PTB_IGNORED_PARAMS read-only to check where the User entry is added
Bibo-Joshi Jan 21, 2026
7e2bc37
Revert "make PTB_IGNORED_PARAMS read-only to check where the User ent…
Bibo-Joshi Jan 21, 2026
6977722
Revert "add some debug prints"
Bibo-Joshi Jan 21, 2026
2207eb0
Revert "add some debug prints"
Bibo-Joshi Jan 21, 2026
408246f
Revert "add some debug prints"
Bibo-Joshi Jan 21, 2026
3eba3aa
Merge branch 'master' into api-9.3-central
Bibo-Joshi Jan 21, 2026
6290429
fix false edit from #5088
Bibo-Joshi Jan 21, 2026
46a0b53
some doc updates
Bibo-Joshi Jan 21, 2026
ee482b9
review
Bibo-Joshi Jan 23, 2026
946f42d
More review
Bibo-Joshi Jan 24, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ dummy change for chango debug
:target: https://pypi.org/project/python-telegram-bot/
:alt: Supported Python versions

.. image:: https://img.shields.io/badge/Bot%20API-9.2-blue?logo=telegram
.. image:: https://img.shields.io/badge/Bot%20API-9.3-blue?logo=telegram
:target: https://core.telegram.org/bots/api-changelog
:alt: Supported Bot API version

Expand Down Expand Up @@ -83,7 +83,7 @@ After installing_ the library, be sure to check out the section on `working with
Telegram API support
~~~~~~~~~~~~~~~~~~~~

All types and methods of the Telegram Bot API **9.2** are natively supported by this library.
All types and methods of the Telegram Bot API **9.3** are natively supported by this library.
In addition, Bot API functionality not yet natively included can still be used as described `in our wiki <https://github.com/python-telegram-bot/python-telegram-bot/wiki/Bot-API-Forward-Compatibility>`_.

Notable Features
Expand Down
28 changes: 28 additions & 0 deletions changes/unreleased/5078.FoNwUYLbXQFRebTFhR6UPn.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
features = """
Full Support for Bot API 9.3

.. warning::

- Bot API 9.3 deprecates the field ``last_resale_star_count`` of ``UniqueGiftInfo`` in favor of the new fields ``last_resale_currency`` and ``last_resale_amount``. The field ``last_resale_star_count`` is still present in PTB for backward compatibility, but it will be removed in future releases. Please update your code accordingly.

- Bot API 9.3 deprecates the argument ``exclude_limited`` of ``Bot.get_business_account_gifts`` in favor of the new arguments ``exclude_limited_upgradable`` and ``exclude_limited_non_upgradable``. The argument ``exclude_limited`` is still present in PTB for backward compatibility, but it will be removed in future releases. Please update your code accordingly.

- Bot API 9.3 introduces a now required argument ``gift_id`` to ``UniqueGift``. For backward compatibility, the argument is currently still marked as optional in the signature and it's presence is enforced through a runtime check. In future versions, this argument will be made required in the signature as well.
Please make sure to update your code accordingly to avoid potential issues in the future. We recommend using keyword arguments to ensure compatibility with future updates.
"""

pull_requests = [
{ uid = "5086", author_uids = ["Bibo-Joshi"] },
{ uid = "5078", author_uid = "aelkheir", closes_threads = ["5077"] },
{ uid = "5079", author_uid = "aelkheir" },
{ uid = "5084", author_uids = ["Bibo-Joshi"] },
{ uid = "5085", author_uids = ["Bibo-Joshi"] },
{ uid = "5087", author_uids = ["Bibo-Joshi"] },
{ uid = "5091", author_uids = ["Bibo-Joshi"] },
{ uid = "5090", author_uids = ["Bibo-Joshi"] },
{ uid = "5089", author_uids = ["Bibo-Joshi"] },
{ uid = "5092", author_uids = ["Bibo-Joshi"] },
{ uid = "5095", author_uids = ["Bibo-Joshi"] },
{ uid = "5094", author_uids = ["Bibo-Joshi"] },
{ uid = "5106", author_uid = ["aelkheir"] },
]
8 changes: 8 additions & 0 deletions docs/source/inclusions/bot_methods.rst
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,8 @@
- Used for sending media grouped together
* - :meth:`~telegram.Bot.send_message`
- Used for sending text messages
* - :meth:`~telegram.Bot.send_message_draft`
- Used for streaming partial text messages
* - :meth:`~telegram.Bot.send_paid_media`
- Used for sending paid media to channels
* - :meth:`~telegram.Bot.send_photo`
Expand Down Expand Up @@ -443,6 +445,8 @@
- Used for setting the business accounts profile photo
* - :meth:`~telegram.Bot.post_story`
- Used for posting a story on behalf of business account.
* - :meth:`~telegram.Bot.repost_story`
- Used for reposting an existing story on behalf of business account.
* - :meth:`~telegram.Bot.edit_story`
- Used for editing business stories posted by the bot.
* - :meth:`~telegram.Bot.convert_gift_to_stars`
Expand Down Expand Up @@ -481,8 +485,12 @@
- Used for getting basic info about a file
* - :meth:`~telegram.Bot.get_available_gifts`
- Used for getting information about gifts available for sending
* - :meth:`~telegram.Bot.get_chat_gifts`
- Used for getting information about gifts owned and hosted by a chat
* - :meth:`~telegram.Bot.get_me`
- Used for getting basic information about the bot
* - :meth:`~telegram.Bot.get_user_gifts`
- Used for getting information about gifts owned and hosted by a user
* - :meth:`~telegram.Bot.save_prepared_inline_message`
- Used for storing a message to be sent by a user of a Mini App

Expand Down
3 changes: 3 additions & 0 deletions docs/source/telegram.at-tree.rst
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,7 @@ Available Types
telegram.forumtopicreopened
telegram.generalforumtopichidden
telegram.generalforumtopicunhidden
telegram.giftbackground
telegram.giftinfo
telegram.giveaway
telegram.giveawaycompleted
Expand Down Expand Up @@ -181,6 +182,7 @@ Available Types
telegram.telegramobject
telegram.textquote
telegram.uniquegift
telegram.uniquegiftcolors
telegram.uniquegiftbackdrop
telegram.uniquegiftbackdropcolors
telegram.uniquegiftinfo
Expand All @@ -190,6 +192,7 @@ Available Types
telegram.user
telegram.userchatboosts
telegram.userprofilephotos
telegram.userrating
telegram.usersshared
telegram.venue
telegram.video
Expand Down
7 changes: 7 additions & 0 deletions docs/source/telegram.giftbackground.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
GiftBackground
==============

.. autoclass:: telegram.GiftBackground
:members:
:show-inheritance:

7 changes: 7 additions & 0 deletions docs/source/telegram.uniquegiftcolors.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
UniqueGiftColors
================

.. autoclass:: telegram.UniqueGiftColors
:members:
:show-inheritance:

6 changes: 6 additions & 0 deletions docs/source/telegram.userrating.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
UserRating
==========

.. autoclass:: telegram.UserRating
:members:
:show-inheritance:
2 changes: 1 addition & 1 deletion docs/substitutions/global.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@

.. |message_thread_id| replace:: Unique identifier for the target message thread of the forum topic.

.. |message_thread_id_arg| replace:: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only.
.. |message_thread_id_arg| replace:: Unique identifier for the target message thread (topic) of a forum; for forum supergroups and private chats of bots with forum topic mode enabled only.

.. |parse_mode| replace:: Mode for parsing entities. See :class:`telegram.constants.ParseMode` and `formatting options <https://core.telegram.org/bots/api#formatting-options>`__ for more details.

Expand Down
7 changes: 6 additions & 1 deletion src/telegram/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -111,6 +111,7 @@
"GeneralForumTopicHidden",
"GeneralForumTopicUnhidden",
"Gift",
"GiftBackground",
"GiftInfo",
"Gifts",
"Giveaway",
Expand Down Expand Up @@ -287,13 +288,15 @@
"UniqueGift",
"UniqueGiftBackdrop",
"UniqueGiftBackdropColors",
"UniqueGiftColors",
"UniqueGiftInfo",
"UniqueGiftModel",
"UniqueGiftSymbol",
"Update",
"User",
"UserChatBoosts",
"UserProfilePhotos",
"UserRating",
"UsersShared",
"Venue",
"Video",
Expand Down Expand Up @@ -453,7 +456,7 @@
from ._games.callbackgame import CallbackGame
from ._games.game import Game
from ._games.gamehighscore import GameHighScore
from ._gifts import AcceptedGiftTypes, Gift, GiftInfo, Gifts
from ._gifts import AcceptedGiftTypes, Gift, GiftBackground, GiftInfo, Gifts
from ._giveaway import Giveaway, GiveawayCompleted, GiveawayCreated, GiveawayWinners
from ._inline.inlinekeyboardbutton import InlineKeyboardButton
from ._inline.inlinekeyboardmarkup import InlineKeyboardMarkup
Expand Down Expand Up @@ -597,13 +600,15 @@
UniqueGift,
UniqueGiftBackdrop,
UniqueGiftBackdropColors,
UniqueGiftColors,
UniqueGiftInfo,
UniqueGiftModel,
UniqueGiftSymbol,
)
from ._update import Update
from ._user import User
from ._userprofilephotos import UserProfilePhotos
from ._userrating import UserRating
from ._videochat import (
VideoChatEnded,
VideoChatParticipantsInvited,
Expand Down
Loading
Loading