pyTelegramBotAPI 4.22.1__py3-none-any.whl → 4.23.0__py3-none-any.whl

{pytelegrambotapi-4.22.1.dist-info → pytelegrambotapi-4.23.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyTelegramBotAPI
-Version: 4.22.1
+Version: 4.23.0
 Summary: Python Telegram bot api.
 Project-URL: Homepage, https://github.com/eternnoir/pyTelegramBotAPI
 Project-URL: Documentation, https://pytba.readthedocs.org
@@ -53,7 +53,7 @@ Description-Content-Type: text/markdown
 <p align="center">A simple, but extensible Python implementation for the <a href="https://core.telegram.org/bots/api">Telegram Bot API</a>.</p>
 <p align="center">Both synchronous and asynchronous.</p>
 
-## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api-changelog#july-31-2024"><img src="https://img.shields.io/badge/Bot%20API-7.8-blue?logo=telegram" alt="Supported Bot API version"></a>
+## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#september-6-2024"><img src="https://img.shields.io/badge/Bot%20API-7.10-blue?logo=telegram" alt="Supported Bot API version"></a>
 
 <h2><a href='https://pytba.readthedocs.io/en/latest/index.html'>Official documentation</a></h2>
 <h2><a href='https://pytba.readthedocs.io/ru/latest/index.html'>Official ru documentation</a></h2>

{pytelegrambotapi-4.22.1.dist-info → pytelegrambotapi-4.23.0.dist-info}/RECORD

@@ -1,17 +1,17 @@
-telebot/__init__.py,sha256=ty7WzdASNMWG_cqdg4o3A-kagN9aVIGkc0j93R9reT4,412119
-telebot/apihelper.py,sha256=FJwcuzZXK54GqNmUiziobpbgrN5pwk_LcPBbkhlINf4,94286
-telebot/async_telebot.py,sha256=N5vCHak84CCjxZJCehus8eRt1TaSmUlRyzzAw_ONqYk,385225
-telebot/asyncio_filters.py,sha256=0bnF-CPOX-IZUIjViTk5lxa5OR_UxB8Z5ng0kfDq5nM,12856
+telebot/__init__.py,sha256=b0LIGG4qK94pnwefptKq0KVNwxR6NgAedzCdiUcGrfc,417917
+telebot/apihelper.py,sha256=dI1K74azMPqwBwEs4UvWQ4shW36JJKAn2ptFQo-j3ss,95267
+telebot/async_telebot.py,sha256=tksz1f9UfU6oyU1CZ_PRTtDm4k5J82uosXgBrJHrbOA,391043
+telebot/asyncio_filters.py,sha256=w63xFjFnXtr4oo3Kqx1Fs485vQxNCgXZs1ukdkNcnEA,12854
 telebot/asyncio_handler_backends.py,sha256=BWS7zr93FJNZJmPHBoXo4i_PIHGlmrEoWy1miXax9aI,2785
-telebot/asyncio_helper.py,sha256=Wvd8i8KFqGizkyaL7xZfb4Woan1yphoQGFYHvdErKyw,95049
+telebot/asyncio_helper.py,sha256=veOPbLDag2HwlJ0CYQbIkmEHmz1ek2uk72NzNs7PdL0,96125
 telebot/callback_data.py,sha256=k4Rz3lAONG5J2M9TESKMIjqXoBNJMfEy9nnrmJAyi3Q,5358
-telebot/custom_filters.py,sha256=0NX8hR5EMGjOnl11sLPYwl9gwIxd9APTsxqBhxCASLM,12977
+telebot/custom_filters.py,sha256=ncF8_zwlSqkuATI46Xc6HQ5Y1ZoQ1fO6AlcRbs7bO3U,12975
 telebot/formatting.py,sha256=_y8M5KOv9UOXfF9z7Et4fPVgh9JnzI1cr4un9sfdlc0,15176
 telebot/handler_backends.py,sha256=lyKu0PaH2c4y5FfyQS3M9tOyBJ8ATjxHZkATzu01XpE,7969
 telebot/service_utils.py,sha256=xLmlZLTVs34UOdQtMvwduor8hnLxQCx8iJ92wDGl2Mw,2053
-telebot/types.py,sha256=KiKe3WnBAGCN_65Uxe104IGG77cvpUthTzlEjwnc0r4,459391
-telebot/util.py,sha256=YLSNl9LYEmj7PxNgZN5OO3IvtR5YESvVfTsReuxZ9Zw,21361
-telebot/version.py,sha256=dvJgb3UnEA3MSfEPGopCGapphKRx6FGNQqRhsbEch3o,99
+telebot/types.py,sha256=rHHkagvfWgtqxGsXvwVR_GD9EWujzn1_lm9AYnxkc40,463667
+telebot/util.py,sha256=ylRtI4DI4I1BJAF2Ack7WyGbTN1cRkubUCbhLNiiPj4,21385
+telebot/version.py,sha256=33cH7PM7w-P3rSAYZ0ykyw3QddU6BsFL5Asu9RL52qA,99
 telebot/asyncio_storage/__init__.py,sha256=fraOWJby1ddJmPAXf1oXWmZJXRodSpING17MF875NPI,433
 telebot/asyncio_storage/base_storage.py,sha256=I-NII9ZMCxCHStPc-73qSyQhjBtkhNzb2IcZPhjR1Eg,3243
 telebot/asyncio_storage/memory_storage.py,sha256=h8yc2xpfLmbcBjPmKkqNhZtUtpNQ7EuKIfMGue61e7w,5849
@@ -35,7 +35,7 @@ telebot/storage/base_storage.py,sha256=WzGgSflKzcn2ENsgz1Q-D_v-ZKCtnMOURGOHIwNJ0
 telebot/storage/memory_storage.py,sha256=-r1vuIt1YHq9btkr6E7BCu4Do-wUDlNcttG22SSgEYo,5799
 telebot/storage/pickle_storage.py,sha256=dqw7syOJuTWyU0KK8XwbJvQ9PMyDHhZQG-MevZImEak,7121
 telebot/storage/redis_storage.py,sha256=DReU2lc8cI0f3XMIT1N9-suGZ6jE8H9I_mapK3A-lyE,9450
-pytelegrambotapi-4.22.1.dist-info/METADATA,sha256=ECBI-3IKxlXtRMzbmXv11FBTUOlP67NghcrAvQArhTk,48162
-pytelegrambotapi-4.22.1.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
-pytelegrambotapi-4.22.1.dist-info/licenses/LICENSE,sha256=qz_jTTxi4zSAFaTdASiwml2iAk0UZ6R4MRADNzwYo_A,18387
-pytelegrambotapi-4.22.1.dist-info/RECORD,,
+pytelegrambotapi-4.23.0.dist-info/METADATA,sha256=7DjRELqoR1X4QlXm6oojq1e6IIt3pxX7J_5PjoLz59c,48157
+pytelegrambotapi-4.23.0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
+pytelegrambotapi-4.23.0.dist-info/licenses/LICENSE,sha256=qz_jTTxi4zSAFaTdASiwml2iAk0UZ6R4MRADNzwYo_A,18387
+pytelegrambotapi-4.23.0.dist-info/RECORD,,

telebot/__init__.py

@@ -248,6 +248,7 @@ class TeleBot:
         self.business_message_handlers = []
         self.edited_business_message_handlers = []
         self.deleted_business_messages_handlers = []
+        self.purchased_paid_media_handlers = []
 
         self.custom_filters = {}
         self.state_handlers = []
@@ -724,6 +725,7 @@ class TeleBot:
         new_business_messages = None
         new_edited_business_messages = None
         new_deleted_business_messages = None
+        new_purchased_paid_media = None
         
         for update in updates:
             if apihelper.ENABLE_MIDDLEWARE and not self.use_class_middlewares:
@@ -805,8 +807,10 @@ class TeleBot:
             if update.deleted_business_messages:
                 if new_deleted_business_messages is None: new_deleted_business_messages = []
                 new_deleted_business_messages.append(update.deleted_business_messages)
-
-
+            if update.purchased_paid_media:
+                if new_purchased_paid_media is None: new_purchased_paid_media = []
+                new_purchased_paid_media.append(update.purchased_paid_media)
+                
         if new_messages:
             self.process_new_messages(new_messages)
         if new_edited_messages:
@@ -851,6 +855,8 @@ class TeleBot:
             self.process_new_edited_business_message(new_edited_business_messages)
         if new_deleted_business_messages:
             self.process_new_deleted_business_messages(new_deleted_business_messages)
+        if new_purchased_paid_media:
+            self.process_new_purchased_paid_media(new_purchased_paid_media)
 
     def process_new_messages(self, new_messages):
         """
@@ -987,8 +993,11 @@ class TeleBot:
         """
         self._notify_command_handlers(self.deleted_business_messages_handlers, new_deleted_business_messages, 'deleted_business_messages')
     
-
-
+    def process_new_purchased_paid_media(self, new_purchased_paid_media):
+        """
+        :meta private:
+        """
+        self._notify_command_handlers(self.purchased_paid_media_handlers, new_purchased_paid_media, 'purchased_paid_media')
 
     def process_middlewares(self, update):
         """
@@ -3136,7 +3145,9 @@ class TeleBot:
             caption: Optional[str]=None, parse_mode: Optional[str]=None, caption_entities: Optional[List[types.MessageEntity]]=None,
             show_caption_above_media: Optional[bool]=None, disable_notification: Optional[bool]=None,
             protect_content: Optional[bool]=None, reply_parameters: Optional[types.ReplyParameters]=None,
-            reply_markup: Optional[REPLY_MARKUP_TYPES]=None) -> types.Message:
+            reply_markup: Optional[REPLY_MARKUP_TYPES]=None, business_connection_id: Optional[str]=None,
+            payload: Optional[str]=None
+    ) -> types.Message:
         """
         Use this method to send paid media to channel chats. On success, the sent Message is returned.
 
@@ -3175,6 +3186,12 @@ class TeleBot:
         :param reply_markup: Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user
         :type reply_markup: :class:`telebot.types.InlineKeyboardMarkup` or :class:`telebot.types.ReplyKeyboardMarkup` or :class:`telebot.types.ReplyKeyboardRemove` or :class:`telebot.types.ForceReply`
 
+        :param business_connection_id: Identifier of a business connection, in which the message will be sent
+        :type business_connection_id: :obj:`str`
+
+        :param payload: Bot-defined paid media payload, 0-128 bytes. This will not be displayed to the user, use it for your internal processes.
+        :type payload: :obj:`str`
+
         :return: On success, the sent Message is returned.
         :rtype: :class:`telebot.types.Message`
         """
@@ -3183,7 +3200,8 @@ class TeleBot:
                 self.token, chat_id, star_count, media, caption=caption, parse_mode=parse_mode,
                 caption_entities=caption_entities, show_caption_above_media=show_caption_above_media,
                 disable_notification=disable_notification, protect_content=protect_content,
-                reply_parameters=reply_parameters, reply_markup=reply_markup)
+                reply_parameters=reply_parameters, reply_markup=reply_markup, business_connection_id=business_connection_id,
+                payload=payload)
         )
 
 
@@ -4195,6 +4213,62 @@ class TeleBot:
             apihelper.edit_chat_invite_link(self.token, chat_id, invite_link, name, expire_date, member_limit, creates_join_request)
         )
 
+    def create_chat_subscription_invite_link(
+            self, chat_id: Union[int, str], subscription_period: int, subscription_price: int,
+            name: Optional[str]=None) -> types.ChatInviteLink:
+        """
+        Use this method to create a subscription invite link for a channel chat. The bot must have the can_invite_users administrator rights.
+        The link can be edited using the method editChatSubscriptionInviteLink or revoked using the method revokeChatInviteLink.
+        Returns the new invite link as a ChatInviteLink object.
+
+        Telegram documentation: https://core.telegram.org/bots/api#createchatsubscriptioninvitelink
+
+        :param chat_id: Unique identifier for the target channel chat or username of the target channel
+            (in the format @channelusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+        
+        :param name: Invite link name; 0-32 characters
+        :type name: :obj:`str`
+
+        :param subscription_period: The number of seconds the subscription will be active for before the next payment.
+            Currently, it must always be 2592000 (30 days).
+        :type subscription_period: :obj:`int`
+
+        :param subscription_price: The amount of Telegram Stars a user must pay initially and after each subsequent
+            subscription period to be a member of the chat; 1-2500
+        :type subscription_price: :obj:`int`
+
+        :return: Returns the new invite link as a ChatInviteLink object.
+        :rtype: :class:`telebot.types.ChatInviteLink`
+        """
+        return types.ChatInviteLink.de_json(
+            apihelper.create_chat_subscription_invite_link(self.token, chat_id, subscription_period, subscription_price, name=name)
+        )
+    
+    def edit_chat_subscription_invite_link(
+            self, chat_id: Union[int, str], invite_link: str, name: Optional[str]=None) -> types.ChatInviteLink:
+        """
+        Use this method to edit a subscription invite link created by the bot. The bot must have the can_invite_users administrator rights.
+        Returns the edited invite link as a ChatInviteLink object.
+
+        Telegram documentation: https://core.telegram.org/bots/api#editchatsubscriptioninvitelink
+
+        :param chat_id: Unique identifier for the target chat or username of the target channel
+            (in the format @channelusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+
+        :param invite_link: The invite link to edit
+        :type invite_link: :obj:`str`
+
+        :param name: Invite link name; 0-32 characters
+        :type name: :obj:`str`
+
+        :return: Returns the edited invite link as a ChatInviteLink object.
+        :rtype: :class:`telebot.types.ChatInviteLink`
+        """
+        return types.ChatInviteLink.de_json(
+            apihelper.edit_chat_subscription_invite_link(self.token, chat_id, invite_link, name=name)
+        )
 
     def revoke_chat_invite_link(
             self, chat_id: Union[int, str], invite_link: str) -> types.ChatInviteLink:
@@ -5567,7 +5641,7 @@ class TeleBot:
 
 
     def answer_pre_checkout_query(
-            self, pre_checkout_query_id: int, ok: bool, 
+            self, pre_checkout_query_id: str, ok: bool, 
             error_message: Optional[str]=None) -> bool:
         """
         Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmation in the form of an Update with the
@@ -7975,6 +8049,55 @@ class TeleBot:
         handler_dict = self._build_handler_dict(callback, func=func, pass_bot=pass_bot, **kwargs)
         self.add_pre_checkout_query_handler(handler_dict)
 
+    def purchased_paid_media_handler(self, func=None, **kwargs):
+        """
+        Handles new incoming purchased paid media.
+
+        :param func: Function executed as a filter
+        :type func: :obj:`function`
+
+        :param kwargs: Optional keyword arguments(custom filters)
+
+        :return: None
+        """
+        def decorator(handler):
+            handler_dict = self._build_handler_dict(handler, func=func, **kwargs)
+            self.add_purchased_paid_media_handler(handler_dict)
+            return handler
+        
+        return decorator
+    
+    def add_purchased_paid_media_handler(self, handler_dict):
+        """
+        Adds a purchased paid media handler
+        Note that you should use register_purchased_paid_media_handler to add purchased_paid_media_handler to the bot.
+
+        :meta private:
+
+        :param handler_dict:
+        :return:
+        """
+        self.purchased_paid_media_handlers.append(handler_dict)
+
+    def register_purchased_paid_media_handler(self, callback: Callable, func: Callable, pass_bot: Optional[bool]=False, **kwargs):
+        """
+        Registers purchased paid media handler.
+
+        :param callback: function to be called
+        :type callback: :obj:`function`
+        
+        :param func: Function executed as a filter
+        :type func: :obj:`function`
+
+        :param pass_bot: True if you need to pass TeleBot instance to handler(useful for separating handlers into different files)
+        :type pass_bot: :obj:`bool`
+
+        :param kwargs: Optional keyword arguments(custom filters)
+
+        :return: None
+        """
+        handler_dict = self._build_handler_dict(callback, func=func, pass_bot=pass_bot, **kwargs)
+        self.add_purchased_paid_media_handler(handler_dict)
 
     def poll_handler(self, func, **kwargs):
         """

telebot/apihelper.py

@@ -529,28 +529,33 @@ def send_photo(
 def send_paid_media(
         token, chat_id, star_count, media,
         caption=None, parse_mode=None, caption_entities=None, show_caption_above_media=None,
-        disable_notification=None, protect_content=None, reply_parameters=None, reply_markup=None):
+        disable_notification=None, protect_content=None, reply_parameters=None, reply_markup=None,
+        business_connection_id=None, payload=None):
     method_url = r'sendPaidMedia'
     media_json, files = convert_input_media_array(media)
-    payload = {'chat_id': chat_id, 'star_count': star_count, 'media': media_json}
+    _payload = {'chat_id': chat_id, 'star_count': star_count, 'media': media_json}
     if caption:
-        payload['caption'] = caption
+        _payload['caption'] = caption
     if parse_mode:
-        payload['parse_mode'] = parse_mode
+        _payload['parse_mode'] = parse_mode
     if caption_entities:
-        payload['caption_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(caption_entities))
+        _payload['caption_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(caption_entities))
     if show_caption_above_media is not None:
-        payload['show_caption_above_media'] = show_caption_above_media
+        _payload['show_caption_above_media'] = show_caption_above_media
     if disable_notification is not None:
-        payload['disable_notification'] = disable_notification
+        _payload['disable_notification'] = disable_notification
     if protect_content is not None:
-        payload['protect_content'] = protect_content
+        _payload['protect_content'] = protect_content
     if reply_parameters is not None:
-        payload['reply_parameters'] = reply_parameters.to_json()
+        _payload['reply_parameters'] = reply_parameters.to_json()
     if reply_markup:
-        payload['reply_markup'] = _convert_markup(reply_markup)
+        _payload['reply_markup'] = _convert_markup(reply_markup)
+    if business_connection_id:
+        _payload['business_connection_id'] = business_connection_id
+    if payload:
+        _payload['payload'] = payload
     return _make_request(
-        token, method_url, params=payload,
+        token, method_url, params=_payload,
         method='post' if files else 'get',
         files=files if files else None)
 
@@ -1202,6 +1207,26 @@ def edit_chat_invite_link(token, chat_id, invite_link, name, expire_date, member
 
     return _make_request(token, method_url, params=payload, method='post')
 
+def create_chat_subscription_invite_link(token, chat_id, subscription_period, subscription_price, name=None):
+    method_url = 'createChatSubscriptionInviteLink'
+    payload = {
+        'chat_id': chat_id,
+        'subscription_period': subscription_period,
+        'subscription_price': subscription_price
+    }
+    if name:
+        payload['name'] = name
+    return _make_request(token, method_url, params=payload, method='post')
+
+def edit_chat_subscription_invite_link(token, chat_id, invite_link, name=None):
+    method_url = 'editChatSubscriptionInviteLink'
+    payload = {
+        'chat_id': chat_id,
+        'invite_link': invite_link
+    }
+    if name:
+        payload['name'] = name
+    return _make_request(token, method_url, params=payload, method='post')
 
 def revoke_chat_invite_link(token, chat_id, invite_link):
     method_url = 'revokeChatInviteLink'

telebot/async_telebot.py

@@ -183,6 +183,7 @@ class AsyncTeleBot:
         self.business_message_handlers = []
         self.edited_business_message_handlers = []
         self.deleted_business_messages_handlers = []
+        self.purchased_paid_media_handlers = []
 
         self.custom_filters = {}
         self.state_handlers = []
@@ -636,6 +637,7 @@ class AsyncTeleBot:
         new_business_messages = None
         new_edited_business_messages = None
         new_deleted_business_messages = None
+        new_purchased_paid_media = None
 
 
         for update in updates:
@@ -706,6 +708,9 @@ class AsyncTeleBot:
             if update.deleted_business_messages:
                 if new_deleted_business_messages is None: new_deleted_business_messages = []
                 new_deleted_business_messages.append(update.deleted_business_messages)
+            if update.purchased_paid_media:
+                if new_purchased_paid_media is None: new_purchased_paid_media = []
+                new_purchased_paid_media.append(update.purchased_paid_media)
 
 
         if new_messages:
@@ -750,6 +755,8 @@ class AsyncTeleBot:
             await self.process_new_edited_business_message(new_edited_business_messages)
         if new_deleted_business_messages:
             await self.process_new_deleted_business_messages(new_deleted_business_messages)
+        if new_purchased_paid_media:
+            await self.process_new_purchased_paid_media(new_purchased_paid_media)
 
     async def process_new_messages(self, new_messages):
         """
@@ -884,6 +891,12 @@ class AsyncTeleBot:
         """
         await self._process_updates(self.deleted_business_messages_handlers, new_deleted_business_messages, 'deleted_business_messages')
 
+    async def process_new_purchased_paid_media(self, new_purchased_paid_media):
+        """
+        :meta private:
+        """
+        await self._process_updates(self.purchased_paid_media_handlers, new_purchased_paid_media, 'purchased_paid_media')
+
     async def _get_middlewares(self, update_type):
         """
         :meta private:
@@ -1867,6 +1880,56 @@ class AsyncTeleBot:
         handler_dict = self._build_handler_dict(callback, func=func, pass_bot=pass_bot, **kwargs)
         self.add_pre_checkout_query_handler(handler_dict)
 
+    def purchased_paid_media_handler(self, func=None, **kwargs):
+        """
+        Handles new incoming purchased paid media.
+
+        :param func: Function executed as a filter
+        :type func: :obj:`function`
+
+        :param kwargs: Optional keyword arguments(custom filters)
+
+        :return: None
+        """
+        def decorator(handler):
+            handler_dict = self._build_handler_dict(handler, func=func, **kwargs)
+            self.add_purchased_paid_media_handler(handler_dict)
+            return handler
+        
+        return decorator
+    
+    def add_purchased_paid_media_handler(self, handler_dict):
+        """
+        Adds a purchased paid media handler
+        Note that you should use register_purchased_paid_media_handler to add purchased_paid_media_handler to the bot.
+
+        :meta private:
+
+        :param handler_dict:
+        :return:
+        """
+        self.purchased_paid_media_handlers.append(handler_dict)
+
+    def register_purchased_paid_media_handler(self, callback: Callable, func: Callable, pass_bot: Optional[bool]=False, **kwargs):
+        """
+        Registers purchased paid media handler.
+
+        :param callback: function to be called
+        :type callback: :obj:`function`
+        
+        :param func: Function executed as a filter
+        :type func: :obj:`function`
+
+        :param pass_bot: True if you need to pass TeleBot instance to handler(useful for separating handlers into different files)
+        :type pass_bot: :obj:`bool`
+
+        :param kwargs: Optional keyword arguments(custom filters)
+
+        :return: None
+        """
+        handler_dict = self._build_handler_dict(callback, func=func, pass_bot=pass_bot, **kwargs)
+        self.add_purchased_paid_media_handler(handler_dict)
+
     def poll_handler(self, func, **kwargs):
         """
         Handles new state of a poll. Bots receive only updates about stopped polls and polls, which are sent by the bot
@@ -3439,7 +3502,7 @@ class AsyncTeleBot:
 
         disable_notification = self.disable_notification if (disable_notification is None) else disable_notification
         protect_content = self.protect_content if (protect_content is None) else protect_content
-        result = await asyncio_helper.forward_messages(self.token, chat_id, from_chat_id, message_ids, disable_notification, protect_content, message_thread_id)
+        result = await asyncio_helper.forward_messages(self.token, chat_id, from_chat_id, message_ids, disable_notification, message_thread_id, protect_content)
         return [types.MessageID.de_json(message_id) for message_id in result]
     
     async def copy_messages(self, chat_id: Union[str, int], from_chat_id: Union[str, int], message_ids: List[int],
@@ -4564,7 +4627,8 @@ class AsyncTeleBot:
             caption: Optional[str]=None, parse_mode: Optional[str]=None, caption_entities: Optional[List[types.MessageEntity]]=None,
             show_caption_above_media: Optional[bool]=None, disable_notification: Optional[bool]=None,
             protect_content: Optional[bool]=None, reply_parameters: Optional[types.ReplyParameters]=None,
-            reply_markup: Optional[REPLY_MARKUP_TYPES]=None) -> types.Message:
+            reply_markup: Optional[REPLY_MARKUP_TYPES]=None, business_connection_id: Optional[str]=None,
+            payload: Optional[str]=None) -> types.Message:
         """
         Use this method to send paid media to channel chats. On success, the sent Message is returned.
 
@@ -4603,6 +4667,12 @@ class AsyncTeleBot:
         :param reply_markup: Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user
         :type reply_markup: :class:`telebot.types.InlineKeyboardMarkup` or :class:`telebot.types.ReplyKeyboardMarkup` or :class:`telebot.types.ReplyKeyboardRemove` or :class:`telebot.types.ForceReply`
 
+        :param business_connection_id: Identifier of a business connection, in which the message will be sent
+        :type business_connection_id: :obj:`str`
+
+        :param payload: Bot-defined paid media payload, 0-128 bytes. This will not be displayed to the user, use it for your internal processes.
+        :type payload: :obj:`str`
+
         :return: On success, the sent Message is returned.
         :rtype: :class:`telebot.types.Message`
         """
@@ -4611,8 +4681,8 @@ class AsyncTeleBot:
                 self.token, chat_id, star_count, media, caption=caption, parse_mode=parse_mode,
                 caption_entities=caption_entities, show_caption_above_media=show_caption_above_media,
                 disable_notification=disable_notification, protect_content=protect_content,
-                reply_parameters=reply_parameters, reply_markup=reply_markup)
-        )
+                reply_parameters=reply_parameters, reply_markup=reply_markup, business_connection_id=business_connection_id,
+                payload=payload))
 
     async def send_media_group(
             self, chat_id: Union[int, str], 
@@ -5603,6 +5673,63 @@ class AsyncTeleBot:
         return types.ChatInviteLink.de_json(
             await asyncio_helper.edit_chat_invite_link(self.token, chat_id, invite_link, name, expire_date, member_limit, creates_join_request)
         )
+    
+    async def create_chat_subscription_invite_link(
+            self, chat_id: Union[int, str], subscription_period: int, subscription_price: int,
+            name: Optional[str]=None) -> types.ChatInviteLink:
+        """
+        Use this method to create a subscription invite link for a channel chat. The bot must have the can_invite_users administrator rights.
+        The link can be edited using the method editChatSubscriptionInviteLink or revoked using the method revokeChatInviteLink.
+        Returns the new invite link as a ChatInviteLink object.
+
+        Telegram documentation: https://core.telegram.org/bots/api#createchatsubscriptioninvitelink
+
+        :param chat_id: Unique identifier for the target channel chat or username of the target channel
+            (in the format @channelusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+        
+        :param name: Invite link name; 0-32 characters
+        :type name: :obj:`str`
+
+        :param subscription_period: The number of seconds the subscription will be active for before the next payment.
+            Currently, it must always be 2592000 (30 days).
+        :type subscription_period: :obj:`int`
+
+        :param subscription_price: The amount of Telegram Stars a user must pay initially and after each subsequent
+            subscription period to be a member of the chat; 1-2500
+        :type subscription_price: :obj:`int`
+
+        :return: Returns the new invite link as a ChatInviteLink object.
+        :rtype: :class:`telebot.types.ChatInviteLink`
+        """
+        return types.ChatInviteLink.de_json(
+            await asyncio_helper.create_chat_subscription_invite_link(self.token, chat_id, subscription_period, subscription_price, name=name)
+        )
+
+    async def edit_chat_subscription_invite_link(
+            self, chat_id: Union[int, str], invite_link: str, name: Optional[str]=None) -> types.ChatInviteLink:
+        """
+        Use this method to edit a subscription invite link created by the bot. The bot must have the can_invite_users administrator rights.
+        Returns the edited invite link as a ChatInviteLink object.
+
+        Telegram documentation: https://core.telegram.org/bots/api#editchatsubscriptioninvitelink
+
+        :param chat_id: Unique identifier for the target chat or username of the target channel
+            (in the format @channelusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+
+        :param invite_link: The invite link to edit
+        :type invite_link: :obj:`str`
+
+        :param name: Invite link name; 0-32 characters
+        :type name: :obj:`str`
+
+        :return: Returns the edited invite link as a ChatInviteLink object.
+        :rtype: :class:`telebot.types.ChatInviteLink`
+        """
+        return types.ChatInviteLink.de_json(
+            await asyncio_helper.edit_chat_subscription_invite_link(self.token, chat_id, invite_link, name=name)
+        )
 
     async def revoke_chat_invite_link(
             self, chat_id: Union[int, str], invite_link: str) -> types.ChatInviteLink:
@@ -6918,7 +7045,7 @@ class AsyncTeleBot:
         return await asyncio_helper.answer_shipping_query(self.token, shipping_query_id, ok, shipping_options, error_message)
 
     async def answer_pre_checkout_query(
-            self, pre_checkout_query_id: int, ok: bool, 
+            self, pre_checkout_query_id: str, ok: bool, 
             error_message: Optional[str]=None) -> bool:
         """
         Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmation in the form of an Update with the

telebot/asyncio_filters.py

@@ -398,7 +398,7 @@ class StateFilter(AdvancedCustomFilter):
         :meta private:
         """
         
-        chat_id, user_id, business_connection_id, bot_id, message_thread_id = resolve_context(message, self.bot._user.id)
+        chat_id, user_id, business_connection_id, bot_id, message_thread_id = resolve_context(message, self.bot.bot_id)
 
         if chat_id is None:
             chat_id = user_id # May change in future

telebot/asyncio_helper.py

@@ -309,7 +309,7 @@ async def send_message(
     if message_effect_id:
         params['message_effect_id'] = message_effect_id
     
-    return await _process_request(token, method_name, params=params)
+    return await _process_request(token, method_name, params=params, method='post')
 
 # methods
 
@@ -519,28 +519,35 @@ async def send_photo(
 async def send_paid_media(
         token, chat_id, star_count, media,
         caption=None, parse_mode=None, caption_entities=None, show_caption_above_media=None,
-        disable_notification=None, protect_content=None, reply_parameters=None, reply_markup=None):
+        disable_notification=None, protect_content=None, reply_parameters=None, reply_markup=None,
+        business_connection_id=None, payload=None):
     method_url = r'sendPaidMedia'
     media_json, files = convert_input_media_array(media)
-    payload = {'chat_id': chat_id, 'star_count': star_count, 'media': media_json}
+    _payload = {'chat_id': chat_id, 'star_count': star_count, 'media': media_json}
+    # USE _payload for request payload
     if caption:
-        payload['caption'] = caption
+        _payload['caption'] = caption
     if parse_mode:
-        payload['parse_mode'] = parse_mode
+        _payload['parse_mode'] = parse_mode
     if caption_entities:
-        payload['caption_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(caption_entities))
+        _payload['caption_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(caption_entities))
     if show_caption_above_media is not None:
-        payload['show_caption_above_media'] = show_caption_above_media
+        _payload['show_caption_above_media'] = show_caption_above_media
     if disable_notification is not None:
-        payload['disable_notification'] = disable_notification
+        _payload['disable_notification'] = disable_notification
     if protect_content is not None:
-        payload['protect_content'] = protect_content
+        _payload['protect_content'] = protect_content
     if reply_parameters is not None:
-        payload['reply_parameters'] = reply_parameters.to_json()
+        _payload['reply_parameters'] = reply_parameters.to_json()
     if reply_markup:
-        payload['reply_markup'] = _convert_markup(reply_markup)
+        _payload['reply_markup'] = _convert_markup(reply_markup)
+    if business_connection_id:
+        _payload['business_connection_id'] = business_connection_id
+    if payload:
+        _payload['payload'] = payload
+        
     return await _process_request(
-        token, method_url, params=payload,
+        token, method_url, params=_payload,
         method='post' if files else 'get',
         files=files if files else None)
 
@@ -1182,6 +1189,28 @@ async def edit_chat_invite_link(token, chat_id, invite_link, name, expire_date,
 
     return await _process_request(token, method_url, params=payload, method='post')
 
+async def create_chat_subscription_invite_link(token, chat_id, subscription_period, subscription_price, name=None):
+    method_url = 'createChatSubscriptionInviteLink'
+    payload = {
+        'chat_id': chat_id,
+        'subscription_period': subscription_period,
+        'subscription_price': subscription_price
+    }
+    if name:
+        payload['name'] = name
+    return await _process_request(token, method_url, params=payload, method='post')
+
+async def edit_chat_subscription_invite_link(token, chat_id, invite_link, name=None):
+    method_url = 'editChatSubscriptionInviteLink'
+    payload = {
+        'chat_id': chat_id,
+        'invite_link': invite_link
+    }
+    if name:
+        payload['name'] = name
+    return await _process_request(token, method_url, params=payload, method='post')
+
+
 async def revoke_chat_invite_link(token, chat_id, invite_link):
     method_url = 'revokeChatInviteLink'
     payload = {

telebot/custom_filters.py

@@ -404,7 +404,7 @@ class StateFilter(AdvancedCustomFilter):
         :meta private:
         """
         
-        chat_id, user_id, business_connection_id, bot_id, message_thread_id = resolve_context(message, self.bot._user.id)
+        chat_id, user_id, business_connection_id, bot_id, message_thread_id = resolve_context(message, self.bot.bot_id)
 
         if chat_id is None:
             chat_id = user_id # May change in future

telebot/types.py

@@ -153,6 +153,9 @@ class Update(JsonDeserializable):
         checkout
     :type pre_checkout_query: :class:`telebot.types.PreCheckoutQuery`
 
+    :purchased_paid_media: Optional. A user purchased paid media with a non-empty payload sent by the bot in a non-channel chat
+    :type purchased_paid_media: :class:`telebot.types.PaidMediaPurchased`
+
     :param poll: Optional. New poll state. Bots receive only updates about stopped polls and polls, which are sent by the 
         bot
     :type poll: :class:`telebot.types.Poll`
@@ -222,18 +225,19 @@ class Update(JsonDeserializable):
         business_message = Message.de_json(obj.get('business_message'))
         edited_business_message = Message.de_json(obj.get('edited_business_message'))
         deleted_business_messages = BusinessMessagesDeleted.de_json(obj.get('deleted_business_messages'))
+        purchased_paid_media = PaidMediaPurchased.de_json(obj.get('purchased_paid_media'))
 
         return cls(update_id, message, edited_message, channel_post, edited_channel_post, inline_query,
                    chosen_inline_result, callback_query, shipping_query, pre_checkout_query, poll, poll_answer,
                    my_chat_member, chat_member, chat_join_request, message_reaction, message_reaction_count,
                    removed_chat_boost, chat_boost, business_connection, business_message, edited_business_message,
-                   deleted_business_messages)
+                   deleted_business_messages, purchased_paid_media)
 
     def __init__(self, update_id, message, edited_message, channel_post, edited_channel_post, inline_query,
                  chosen_inline_result, callback_query, shipping_query, pre_checkout_query, poll, poll_answer,
                  my_chat_member, chat_member, chat_join_request, message_reaction, message_reaction_count,
                  removed_chat_boost, chat_boost, business_connection, business_message, edited_business_message,
-                 deleted_business_messages, **kwargs):
+                 deleted_business_messages, purchased_paid_media):
         self.update_id: int = update_id
         self.message: Optional[Message] = message
         self.edited_message: Optional[Message] = edited_message
@@ -257,6 +261,7 @@ class Update(JsonDeserializable):
         self.business_message: Optional[Message] = business_message
         self.edited_business_message: Optional[Message] = edited_business_message
         self.deleted_business_messages: Optional[BusinessMessagesDeleted] = deleted_business_messages
+        self.purchased_paid_media: Optional[PaidMediaPurchased] = purchased_paid_media
 
 
 
@@ -1525,7 +1530,7 @@ class Message(JsonDeserializable):
         self.json = json_string
 
     @property
-    def html_text(self) -> str:
+    def html_text(self) -> Optional[str]:
         """
         Returns html-rendered text.
         """
@@ -1534,7 +1539,7 @@ class Message(JsonDeserializable):
         return apply_html_entities(self.text, self.entities, getattr(self, "custom_subs", None))
 
     @property
-    def html_caption(self) -> str:
+    def html_caption(self) -> Optional[str]:
         """
         Returns html-rendered caption.
         """
@@ -1618,6 +1623,14 @@ class Message(JsonDeserializable):
         logger.warning('The parameter "user_shared" is deprecated, use "users_shared" instead')
         return self.users_shared
 
+    @property
+    def any_text(self) -> Optional[str]:
+        return self.caption if (self.caption is not None) else self.text
+
+    @property
+    def any_entities(self) -> Optional[List[MessageEntity]]:
+        return self.caption_entities if (self.caption_entities is not None) else self.entities
+
 
 # noinspection PyShadowingBuiltins
 class MessageEntity(Dictionaryable, JsonSerializable, JsonDeserializable):
@@ -2553,13 +2566,13 @@ class KeyboardButtonRequestUsers(Dictionaryable):
     """
     def __init__(
             self, request_id: int, user_is_bot: Optional[bool]=None, user_is_premium: Optional[bool]=None,
-            max_quantity: Optional[int]=None, request_name: Optional[str]=None, request_username: Optional[bool]=None,
+            max_quantity: Optional[int]=None, request_name: Optional[bool]=None, request_username: Optional[bool]=None,
             request_photo: Optional[bool]=None) -> None:
         self.request_id: int = request_id
         self.user_is_bot: Optional[bool] = user_is_bot
         self.user_is_premium: Optional[bool] = user_is_premium
         self.max_quantity: Optional[int] = max_quantity
-        self.request_name: Optional[str] = request_name
+        self.request_name: Optional[bool] = request_name
         self.request_username: Optional[bool] = request_username
         self.request_photo: Optional[bool] = request_photo
 
@@ -2734,6 +2747,7 @@ class KeyboardButton(Dictionaryable, JsonSerializable):
         if request_user is not None:
             logger.warning('The parameter "request_user" is deprecated, use "request_users" instead')
             if self.request_users is None:
+                # noinspection PyTypeChecker
                 self.request_users = request_user
 
 
@@ -4268,6 +4282,7 @@ class ChosenInlineResult(JsonDeserializable):
         self.query: str = query
 
 
+# noinspection PyShadowingBuiltins
 class InlineQueryResultBase(ABC, Dictionaryable, JsonSerializable):
     """
     This object represents one result of an inline query. Telegram clients currently support results of the following 20 types:
@@ -5407,8 +5422,8 @@ class InlineQueryResultCachedBase(ABC, JsonSerializable):
     Base class of all InlineQueryResultCached* classes.
     """
     def __init__(self):
-        self.type: str = None
-        self.id: str = None
+        self.type: str = ""
+        self.id: str = ""
         self.title: Optional[str] = None
         self.description: Optional[str] = None
         self.caption: Optional[str] = None
@@ -5416,6 +5431,7 @@ class InlineQueryResultCachedBase(ABC, JsonSerializable):
         self.input_message_content: Optional[InputMessageContent] = None
         self.parse_mode: Optional[str] = None
         self.caption_entities: Optional[List[MessageEntity]] = None
+        # noinspection PyTypeChecker
         self.payload_dic: Dict[str] = {}
         self.show_caption_above_media: Optional[bool] = None
 
@@ -7104,6 +7120,7 @@ class InputPollOption(JsonSerializable):
         return json_dict
 
 
+# noinspection PyShadowingBuiltins
 class Poll(JsonDeserializable):
     """
     This object contains information about a poll.
@@ -7586,7 +7603,7 @@ class MenuButton(JsonDeserializable, JsonSerializable, Dictionaryable):
         raise NotImplementedError
 
 
-# noinspection PyUnusedLocal
+# noinspection PyUnusedLocal,PyShadowingBuiltins
 class MenuButtonCommands(MenuButton):
     """
     Represents a menu button, which opens the bot's list of commands.
@@ -7610,7 +7627,7 @@ class MenuButtonCommands(MenuButton):
         return json.dumps(self.to_dict())
 
 
-# noinspection PyUnusedLocal
+# noinspection PyUnusedLocal,PyShadowingBuiltins
 class MenuButtonWebApp(MenuButton):
     """
     Represents a menu button, which launches a Web App.
@@ -7645,7 +7662,7 @@ class MenuButtonWebApp(MenuButton):
         return json.dumps(self.to_dict())
 
 
-# noinspection PyUnusedLocal
+# noinspection PyUnusedLocal,PyShadowingBuiltins
 class MenuButtonDefault(MenuButton):
     """
     Describes that no specific value for the menu button was set.
@@ -8202,7 +8219,7 @@ class InputSticker(Dictionaryable, JsonSerializable):
     def to_json(self) -> str:
         return json.dumps(self.to_dict())
     
-    def convert_input_sticker(self) -> Tuple[dict, Optional[dict]]:
+    def convert_input_sticker(self) -> Tuple[str, Optional[dict]]:
         if service_utils.is_string(self.sticker):
             return self.to_json(), None
 
@@ -8343,6 +8360,7 @@ class InlineQueryResultsButton(JsonSerializable, Dictionaryable):
         return json.dumps(self.to_dict())
 
 
+# noinspection PyShadowingBuiltins
 class Story(JsonDeserializable):
     """
     This object represents a story.
@@ -8465,6 +8483,27 @@ class ReactionTypeCustomEmoji(ReactionType):
         return json_dict
 
 
+class ReactionTypePaid(ReactionType):
+    """
+    This object represents a paid reaction type.
+
+    Telegram documentation: https://core.telegram.org/bots/api#reactiontypepaid
+
+    :param type: Type of the reaction, must be paid
+    :type type: :obj:`str`
+
+    :return: Instance of the class
+    :rtype: :class:`ReactionTypePaid`
+    """
+
+    def __init__(self, **kwargs) -> None:
+        super().__init__('paid')
+
+    def to_dict(self) -> dict:
+        return super().to_dict()
+    
+
+
 class MessageReactionUpdated(JsonDeserializable):
     """
     This object represents a service message about a change in the list of the current user's reactions to a message.
@@ -8955,6 +8994,9 @@ class Giveaway(JsonDeserializable):
     :param country_codes: Optional. A list of two-letter ISO 3166-1 alpha-2 country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway.
     :type country_codes: :obj:`list` of :obj:`str`
 
+    :param prize_star_count: Optional. The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only
+    :type prize_star_count: :obj:`int`
+
     :param premium_subscription_month_count: Optional. The number of months the Telegram Premium subscription won from the giveaway will be active for
     :type premium_subscription_month_count: :obj:`int`
 
@@ -8972,7 +9014,7 @@ class Giveaway(JsonDeserializable):
     def __init__(self, chats: List[Chat], winners_selection_date: int, winner_count: int,
                  only_new_members: Optional[bool] = None, has_public_winners: Optional[bool] = None,
                  prize_description: Optional[str] = None, country_codes: Optional[List[str]] = None,
-                 premium_subscription_month_count: Optional[int] = None, **kwargs) -> None:
+                 premium_subscription_month_count: Optional[int] = None, prize_star_count: Optional[int] = None, **kwargs) -> None:
         self.chats: List[Chat] = chats
         self.winners_selection_date: int = winners_selection_date
         self.winner_count: int = winner_count
@@ -8981,6 +9023,7 @@ class Giveaway(JsonDeserializable):
         self.prize_description: Optional[str] = prize_description
         self.country_codes: Optional[List[str]] = country_codes
         self.premium_subscription_month_count: Optional[int] = premium_subscription_month_count
+        self.prize_star_count: Optional[int] = prize_star_count
                      
 
 class GiveawayWinners(JsonDeserializable):
@@ -9022,6 +9065,9 @@ class GiveawayWinners(JsonDeserializable):
     :param prize_description: Optional. Description of additional giveaway prize
     :type prize_description: :obj:`str`
 
+    :param prize_star_count: Optional. The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only
+    :type prize_star_count: :obj:`int`
+
     :return: Instance of the class
     :rtype: :class:`GiveawayWinners`
     """
@@ -9038,7 +9084,7 @@ class GiveawayWinners(JsonDeserializable):
                  winners: List[User], additional_chat_count: Optional[int] = None,
                  premium_subscription_month_count: Optional[int] = None, unclaimed_prize_count: Optional[int] = None,
                  only_new_members: Optional[bool] = None, was_refunded: Optional[bool] = None,
-                 prize_description: Optional[str] = None, **kwargs) -> None:
+                 prize_description: Optional[str] = None, prize_star_count: Optional[int] = None, **kwargs) -> None:
         self.chat: Chat = chat
         self.giveaway_message_id: int = giveaway_message_id
         self.winners_selection_date: int = winners_selection_date
@@ -9050,6 +9096,7 @@ class GiveawayWinners(JsonDeserializable):
         self.only_new_members: Optional[bool] = only_new_members
         self.was_refunded: Optional[bool] = was_refunded
         self.prize_description: Optional[str] = prize_description
+        self.prize_star_count: Optional[int] = prize_star_count
                      
         
 class GiveawayCompleted(JsonDeserializable):
@@ -9067,6 +9114,9 @@ class GiveawayCompleted(JsonDeserializable):
     :param giveaway_message: Optional. Message with the giveaway that was completed, if it wasn't deleted
     :type giveaway_message: :class:`Message`
 
+    :param is_star_giveaway: Optional. True, if the giveaway was a Telegram Star giveaway
+    :type is_star_giveaway: :obj:`bool`
+
     :return: Instance of the class
     :rtype: :class:`GiveawayCompleted`
     """
@@ -9080,15 +9130,21 @@ class GiveawayCompleted(JsonDeserializable):
         return cls(**obj)
     
     def __init__(self, winner_count: int, unclaimed_prize_count: Optional[int] = None,
-                    giveaway_message: Optional[Message] = None, **kwargs) -> None:
+                    giveaway_message: Optional[Message] = None, is_star_giveaway: Optional[bool] = None, **kwargs) -> None:
         self.winner_count: int = winner_count
         self.unclaimed_prize_count: Optional[int] = unclaimed_prize_count
         self.giveaway_message: Optional[Message] = giveaway_message
+        self.is_star_giveaway: Optional[bool] = is_star_giveaway
                         
 
 class GiveawayCreated(JsonDeserializable):
     """
-    This object represents a service message about the creation of a scheduled giveaway. Currently holds no information.
+    This object represents a service message about the creation of a scheduled giveaway.
+
+    :prize_star_count: Optional. The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only
+    :type prize_star_count: :obj:`int`
+
+    :return: Instance of the class
     """
 
     @classmethod
@@ -9097,8 +9153,8 @@ class GiveawayCreated(JsonDeserializable):
         obj = cls.check_json(json_string)
         return cls(**obj)
 
-    def __init__(self, **kwargs) -> None:
-        pass
+    def __init__(self, prize_star_count=None, **kwargs) -> None:
+        self.prize_star_count: Optional[str] = prize_star_count
 
 
 class TextQuote(JsonDeserializable):
@@ -9250,12 +9306,12 @@ class UsersShared(JsonDeserializable):
         self.users: List[SharedUser] = users
 
     @property
-    def user_id(self) -> int:
+    def user_id(self) -> None:
         logger.warning('The parameter "user_id" is deprecated, use "user_ids" instead')
         return None
 
     @property
-    def user_ids(self) -> List[int]:
+    def user_ids(self) -> List[SharedUser]:
         logger.warning('The parameter "user_ids" is deprecated, use "users" instead')
         return self.users
 
@@ -9429,6 +9485,9 @@ class ChatBoostSourceGiveaway(ChatBoostSource):
     :param is_unclaimed: True, if the giveaway was completed, but there was no user to win the prize
     :type is_unclaimed: :obj:`bool`
 
+    :param prize_star_count: Optional. The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only
+    :type prize_star_count: :obj:`int`
+
     :return: Instance of the class
     :rtype: :class:`ChatBoostSourceGiveaway`
     """
@@ -9440,11 +9499,12 @@ class ChatBoostSourceGiveaway(ChatBoostSource):
         obj['user'] = User.de_json(obj.get('user'))
         return cls(**obj)
 
-    def __init__(self, source, giveaway_message_id, user=None, is_unclaimed=None, **kwargs):
+    def __init__(self, source, giveaway_message_id, user=None, is_unclaimed=None, prize_star_count=None, **kwargs):
         self.source: str = source
         self.giveaway_message_id: int = giveaway_message_id
-        self.user: User = user
-        self.is_unclaimed: bool = is_unclaimed
+        self.user: Optional[User] = user
+        self.is_unclaimed: Optional[bool] = is_unclaimed
+        self.prize_star_count: Optional[int] = prize_star_count
 
 
 class ChatBoost(JsonDeserializable):
@@ -10217,8 +10277,9 @@ class RevenueWithdrawalState(JsonDeserializable):
         elif obj["type"] == "failed":
             return RevenueWithdrawalStateFailed.de_json(obj)
         return None
-    
 
+
+# noinspection PyShadowingBuiltins
 class RevenueWithdrawalStatePending(RevenueWithdrawalState):
     """
     The withdrawal is in progress.
@@ -10232,7 +10293,6 @@ class RevenueWithdrawalStatePending(RevenueWithdrawalState):
     :rtype: :class:`RevenueWithdrawalStatePending`
     """
 
-    # noinspection PyPackageRequirements
     def __init__(self, type, **kwargs):
         self.type: str = type
 
@@ -10243,6 +10303,7 @@ class RevenueWithdrawalStatePending(RevenueWithdrawalState):
         return cls(**obj)
 
 
+# noinspection PyShadowingBuiltins
 class RevenueWithdrawalStateSucceeded(RevenueWithdrawalState):
     """
     The withdrawal succeeded.
@@ -10262,7 +10323,6 @@ class RevenueWithdrawalStateSucceeded(RevenueWithdrawalState):
     :rtype: :class:`RevenueWithdrawalStateSucceeded`
     """
 
-    # noinspection PyPackageRequirements
     def __init__(self, type, date, url, **kwargs):
         self.type: str = type
         self.date: int = date
@@ -10273,9 +10333,9 @@ class RevenueWithdrawalStateSucceeded(RevenueWithdrawalState):
         if json_string is None: return None
         obj = cls.check_json(json_string)
         return cls(**obj)
-    
 
-    
+
+# noinspection PyShadowingBuiltins
 class RevenueWithdrawalStateFailed(RevenueWithdrawalState):
     """
     The withdrawal failed and the transaction was refunded.
@@ -10289,7 +10349,6 @@ class RevenueWithdrawalStateFailed(RevenueWithdrawalState):
     :rtype: :class:`RevenueWithdrawalStateFailed`
     """
 
-    # noinspection PyPackageRequirements
     def __init__(self, type, **kwargs):
         self.type: str = type
 
@@ -10329,7 +10388,9 @@ class TransactionPartner(JsonDeserializable):
             return TransactionPartnerTelegramAds.de_json(obj)
         elif obj["type"] == "other":
             return TransactionPartnerOther.de_json(obj)
-        
+
+
+# noinspection PyShadowingBuiltins
 class TransactionPartnerFragment(TransactionPartner):
     """
     Describes a withdrawal transaction with Fragment.
@@ -10347,7 +10408,6 @@ class TransactionPartnerFragment(TransactionPartner):
 
     """
 
-    # noinspection PyPackageRequirements
     def __init__(self, type, withdrawal_state=None, **kwargs):
         self.type: str = type
         self.withdrawal_state: Optional[RevenueWithdrawalState] = withdrawal_state
@@ -10359,9 +10419,9 @@ class TransactionPartnerFragment(TransactionPartner):
         if 'withdrawal_state' in obj:
             obj['withdrawal_state'] = RevenueWithdrawalState.de_json(obj['withdrawal_state'])
         return cls(**obj)
-    
 
 
+# noinspection PyShadowingBuiltins
 class TransactionPartnerUser(TransactionPartner):
     """
     Describes a transaction with a user.
@@ -10377,22 +10437,30 @@ class TransactionPartnerUser(TransactionPartner):
     :param invoice_payload: Optional, Bot-specified invoice payload
     :type invoice_payload: :obj:`str`
 
+    :param paid_media: Optional. Information about the paid media bought by the user
+    :type paid_media: :obj:`list` of :class:`PaidMedia`
+
     :return: Instance of the class
     :rtype: :class:`TransactionPartnerUser`
     """
 
-    def __init__(self, type, user, invoice_payload=None, **kwargs):
+    def __init__(self, type, user, invoice_payload=None, paid_media: Optional[List[PaidMedia]] = None, **kwargs):
         self.type: str = type
         self.user: User = user
         self.invoice_payload: Optional[str] = invoice_payload
+        self.paid_media: Optional[List[PaidMedia]] = paid_media
 
     @classmethod
     def de_json(cls, json_string):
         if json_string is None: return None
         obj = cls.check_json(json_string)
         obj['user'] = User.de_json(obj['user'])
+        if 'paid_media' in obj:
+            obj['paid_media'] = [PaidMedia.de_json(media) for media in obj['paid_media']]
         return cls(**obj)
-    
+
+
+# noinspection PyShadowingBuiltins
 class TransactionPartnerTelegramAds(TransactionPartner):
     """
     Describes a transaction with Telegram Ads.
@@ -10413,8 +10481,10 @@ class TransactionPartnerTelegramAds(TransactionPartner):
     def de_json(cls, json_string):
         if json_string is None: return None
         obj = cls.check_json(json_string)
-    
-        
+        return obj
+
+
+# noinspection PyShadowingBuiltins
 class TransactionPartnerOther(TransactionPartner):
     """
     Describes a transaction with an unknown source or recipient.
@@ -10436,9 +10506,9 @@ class TransactionPartnerOther(TransactionPartner):
         if json_string is None: return None
         obj = cls.check_json(json_string)
         return cls(**obj)
-    
 
 
+# noinspection PyShadowingBuiltins
 class StarTransaction(JsonDeserializable):
     """
     Describes a Telegram Star transaction.
@@ -10531,7 +10601,9 @@ class PaidMedia(JsonDeserializable):
             return PaidMediaPhoto.de_json(obj)
         elif obj["type"] == "video":
             return PaidMediaVideo.de_json(obj)
-        
+
+
+# noinspection PyShadowingBuiltins
 class PaidMediaPreview(PaidMedia):
     """
     The paid media isn't available before the payment.
@@ -10565,8 +10637,9 @@ class PaidMediaPreview(PaidMedia):
         if json_string is None: return None
         obj = cls.check_json(json_string)
         return cls(**obj)
-    
 
+
+# noinspection PyShadowingBuiltins
 class PaidMediaPhoto(PaidMedia):
     """
     The paid media is a photo.
@@ -10595,8 +10668,9 @@ class PaidMediaPhoto(PaidMedia):
 
         obj['photo'] = [PhotoSize.de_json(photo) for photo in obj['photo']]
         return cls(**obj)
-    
 
+
+# noinspection PyShadowingBuiltins
 class PaidMediaVideo(PaidMedia):
     """
     The paid media is a video.
@@ -10653,6 +10727,7 @@ class PaidMediaInfo(JsonDeserializable):
         self.paid_media: List[PaidMedia] = paid_media
 
 
+# noinspection PyShadowingBuiltins
 class InputPaidMedia(JsonSerializable):
     """
     This object describes the paid media to be sent. Currently, it can be one of
@@ -10807,4 +10882,31 @@ class RefundedPayment(JsonDeserializable):
         obj = cls.check_json(json_string)
         return cls(**obj)
     
-    
+    
+class PaidMediaPurchased(JsonDeserializable):
+    """
+    This object contains information about a paid media purchase.
+
+    Telegram documentation: https://core.telegram.org/bots/api#paidmediapurchased
+
+    :param from_user: User who purchased the media
+    :type from_user: :class:`User`
+
+    :param paid_media_payload: Bot-specified paid media payload
+    :type paid_media_payload: :obj:`str`
+
+    :return: Instance of the class
+    :rtype: :class:`PaidMediaPurchased`
+    """
+
+    def __init__(self, from_user, paid_media_payload, **kwargs):
+        self.from_user: User = from_user
+        self.paid_media_payload: str = paid_media_payload
+
+    @classmethod
+    def de_json(cls, json_string):
+        if json_string is None: return None
+        obj = cls.check_json(json_string)
+        obj['from_user'] = User.de_json(obj['from_user'])
+        return cls(**obj)
+    

telebot/util.py

@@ -48,7 +48,7 @@ update_types = [
     "message", "edited_message", "channel_post", "edited_channel_post", "inline_query", "chosen_inline_result",
     "callback_query", "shipping_query", "pre_checkout_query", "poll", "poll_answer", "my_chat_member", "chat_member",
     "chat_join_request", "message_reaction", "message_reaction_count", "chat_boost", "removed_chat_boost",
-    "business_connection", "business_message", "edited_business_message", "deleted_business_messages"
+    "business_connection", "business_message", "edited_business_message", "deleted_business_messages", "purchased_paid_media"
 ]
 
 

telebot/version.py

@@ -1,3 +1,3 @@
 # Versions should comply with PEP440.
 # This line is parsed in setup.py:
-__version__ = '4.22.1'
+__version__ = '4.23.0'