pyTelegramBotAPI 4.32.0__py3-none-any.whl → 4.33.0__py3-none-any.whl

{pytelegrambotapi-4.32.0.dist-info → pytelegrambotapi-4.33.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyTelegramBotAPI
-Version: 4.32.0
+Version: 4.33.0
 Summary: Python Telegram bot API.
 Project-URL: Homepage, https://github.com/eternnoir/pyTelegramBotAPI
 Project-URL: Documentation, https://pytba.readthedocs.org
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: requests
 Provides-Extra: coloredlogs
 Requires-Dist: coloredlogs; extra == 'coloredlogs'
@@ -51,7 +51,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#march-1-2026"><img src="https://img.shields.io/badge/Bot%20API-9.5-blue?logo=telegram" alt="Supported Bot API version"></a>
+## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api-changelog#april-3-2026"><img src="https://img.shields.io/badge/Bot%20API-9.6-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>
@@ -110,7 +110,7 @@ Description-Content-Type: text/markdown
 
 ## Getting started
 
-This API is tested with Python 3.9-3.13 and Pypy 3.
+This API is tested with Python 3.10-3.14 and PyPy 3.
 There are two ways to install the library:
 
 * Installation using pip (a Python package manager):

{pytelegrambotapi-4.32.0.dist-info → pytelegrambotapi-4.33.0.dist-info}/RECORD

@@ -1,18 +1,18 @@
-telebot/__init__.py,sha256=N66uzken5iV53MtWlKrwB3YcS6Ecnd3wCv3ny5qlFZU,499445
-telebot/apihelper.py,sha256=Nd1XLwABjWw7X_BcJ87GghVqwHuZ1MR8KMGKW01cgWI,124058
-telebot/async_telebot.py,sha256=pSBVbVCu_6WBS2eGC0Fc3IvvrsNOPEILKQsu9uBqRvI,473014
+telebot/__init__.py,sha256=n10cPWnpA8bCX52oPCrxmDfbC6PkbDnC4HQVYLRK2Bs,506985
+telebot/apihelper.py,sha256=8Zk2w8SpLxC62Iyiyw514RjAWLRWlYOtS3UGg9pTUsE,126258
+telebot/async_telebot.py,sha256=NfIrtalP4hiuZ4AyuxWeU2FnQC6k0faH_D77H2CmZ90,480898
 telebot/asyncio_filters.py,sha256=Mea64Q--9yznmy2YuLrK2gVXBtbDDFjlaTU6u6EwOlg,13307
 telebot/asyncio_handler_backends.py,sha256=8yYMIIspdMKs-udbpLXUGZ1R-ZgW1Dz4vKjKmo_C4Zg,2883
-telebot/asyncio_helper.py,sha256=_OS0nlnMVibqTa-D6HXVMnLCTU9__eKfCRK0hCJKgyQ,125373
+telebot/asyncio_helper.py,sha256=dm8s6ZwRn6XZWuDApHCiOxk61oIwZJKmxWvAtCmsWYE,127920
 telebot/callback_data.py,sha256=k4Rz3lAONG5J2M9TESKMIjqXoBNJMfEy9nnrmJAyi3Q,5358
 telebot/custom_filters.py,sha256=ImvJ_gasI2NDbog2NBEkqUEQdVEzaONVOCaJwOTi-Mc,13430
 telebot/formatting.py,sha256=hIaE3IiiumD6tf-X8DSDvFQyGHPq48nmEdLVJcr_nKQ,15950
-telebot/handler_backends.py,sha256=t1j1sQVS511AcQYd73TrvlxpS6757UQ0cVmWrA9_kg4,8226
+telebot/handler_backends.py,sha256=INPxzW-osA9ICwpTqUrxZK1Bs4tGJDz99HcyJ5ZUWHY,8245
 telebot/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 telebot/service_utils.py,sha256=xLmlZLTVs34UOdQtMvwduor8hnLxQCx8iJ92wDGl2Mw,2053
-telebot/types.py,sha256=4-42IPSNjvGD_BGfNPjw3g8aHKw2SCIoYTapYJBrKwU,585087
-telebot/util.py,sha256=YZfYvvIfptXN9ZnidGr7tbZSgiNY0mlo3zQOYwT1ngc,22524
-telebot/version.py,sha256=WNORxQXzb_lRKkuKqIvZdOBq1oOOlaj8Dv539VW_D0g,99
+telebot/types.py,sha256=Y1vKzCH7SYrbIeU6xKQWYAIQZI-fL1zj6o2tsDLEtv0,599365
+telebot/util.py,sha256=vJX8HO2Lhjt4_I8mBLC5-iAZr5xJvZ1wd4JFQSUP2dw,21886
+telebot/version.py,sha256=wuWsdohLIO2ZX8wCiMw8LqRlFD5nDJQMm1EfG48Lj2c,99
 telebot/asyncio_storage/__init__.py,sha256=DpVFdTvFpJveTbHY2CezqGWjHKjG__qMdmJvFEc_ekw,446
 telebot/asyncio_storage/base_storage.py,sha256=T5FWpT057w-FSbprDBCEY2P1wzdrYoe8yonBOJLpSQs,3966
 telebot/asyncio_storage/memory_storage.py,sha256=XQO8hYPBOenrv8KHd3Bzj8Eg7OCmvJV4rbmKJPl5eB0,6074
@@ -36,7 +36,7 @@ telebot/storage/base_storage.py,sha256=Xcgb2LdGV_5L16W1TnRXG0tvkopNCf9xh37ri1Xza
 telebot/storage/memory_storage.py,sha256=PNDLz67TMioY_A-po9la4-qblIdoCERh7fHU18KqIeU,6024
 telebot/storage/pickle_storage.py,sha256=6vvR8vzNE0SUKiAYP_bM3Cx9if4-xLNOMkHvJtdgbM4,7399
 telebot/storage/redis_storage.py,sha256=WY8khaSVmEkJO6kQbQ-t916564BIwX2kinUMg_wLLDM,9774
-pytelegrambotapi-4.32.0.dist-info/METADATA,sha256=y1OsQhZ_zb0FXmnQP3efWbRBIk6loiULhqeOb9VR3G4,48258
-pytelegrambotapi-4.32.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-pytelegrambotapi-4.32.0.dist-info/licenses/LICENSE,sha256=qz_jTTxi4zSAFaTdASiwml2iAk0UZ6R4MRADNzwYo_A,18387
-pytelegrambotapi-4.32.0.dist-info/RECORD,,
+pytelegrambotapi-4.33.0.dist-info/METADATA,sha256=mSaTWkjqiGh_Ufc-iB7DFhEOltvrYyvVE3zsMK9PN2M,48270
+pytelegrambotapi-4.33.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+pytelegrambotapi-4.33.0.dist-info/licenses/LICENSE,sha256=qz_jTTxi4zSAFaTdASiwml2iAk0UZ6R4MRADNzwYo_A,18387
+pytelegrambotapi-4.33.0.dist-info/RECORD,,

telebot/__init__.py

@@ -249,6 +249,7 @@ class TeleBot:
         self.edited_business_message_handlers = []
         self.deleted_business_messages_handlers = []
         self.purchased_paid_media_handlers = []
+        self.managed_bot_handlers = []
 
         self.custom_filters = {}
         self.state_handlers = []
@@ -726,6 +727,7 @@ class TeleBot:
         new_edited_business_messages = None
         new_deleted_business_messages = None
         new_purchased_paid_media = None
+        new_managed_bots = None
 
         for update in updates:
             if apihelper.ENABLE_MIDDLEWARE and not self.use_class_middlewares:
@@ -810,6 +812,9 @@ class TeleBot:
             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 update.managed_bot:
+                if new_managed_bots is None: new_managed_bots = []
+                new_managed_bots.append(update.managed_bot)
 
         if new_messages:
             self.process_new_messages(new_messages)
@@ -857,6 +862,8 @@ class TeleBot:
             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)
+        if new_managed_bots:
+            self.process_new_managed_bot(new_managed_bots)
 
     def process_new_messages(self, new_messages):
         """
@@ -999,6 +1006,12 @@ class TeleBot:
         """
         self._notify_command_handlers(self.purchased_paid_media_handlers, new_purchased_paid_media, 'purchased_paid_media')
 
+    def process_new_managed_bot(self, new_managed_bots):
+        """
+        :meta private:
+        """
+        self._notify_command_handlers(self.managed_bot_handlers, new_managed_bots, 'managed_bot')
+
     def process_middlewares(self, update):
         """
         :meta private:
@@ -5227,6 +5240,33 @@ class TeleBot:
             apihelper.get_business_connection(self.token, business_connection_id)
         )
 
+    def get_managed_bot_token(self, user_id: int) -> str:
+        """
+        Use this method to get the token of a managed bot. Returns the token as String on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#getmanagedbottoken
+
+        :param user_id: User identifier of the managed bot whose token will be returned
+        :type user_id: :obj:`int`
+
+        :return: Returns the token as String on success.
+        :rtype: :obj:`str`
+        """
+        return apihelper.get_managed_bot_token(self.token, user_id)
+
+    def replace_managed_bot_token(self, user_id: int) -> str:
+        """
+        Use this method to revoke the current token of a managed bot and generate a new one. Returns the new token as String on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#replacemanagedbottoken
+
+        :param user_id: User identifier of the managed bot whose token will be replaced
+        :type user_id: :obj:`int`
+
+        :return: Returns the new token as String on success.
+        :rtype: :obj:`str`
+        """
+        return apihelper.replace_managed_bot_token(self.token, user_id)
 
     def set_my_commands(self, commands: List[types.BotCommand],
             scope: Optional[types.BotCommandScope]=None,
@@ -6049,7 +6089,6 @@ class TeleBot:
             send_email_to_provider=send_email_to_provider, is_flexible=is_flexible ,subscription_period=subscription_period,
             business_connection_id=business_connection_id)
 
-
     # noinspection PyShadowingBuiltins
     def send_poll(
             self, chat_id: Union[int, str], question: str, options: List[Union[str, types.InputPollOption]],
@@ -6074,7 +6113,15 @@ class TeleBot:
             question_parse_mode: Optional[str] = None,
             question_entities: Optional[List[types.MessageEntity]] = None,
             message_effect_id: Optional[str]=None,
-            allow_paid_broadcast: Optional[bool]=None) -> types.Message:
+            allow_paid_broadcast: Optional[bool]=None,
+            allows_revoting: Optional[bool]=None,
+            shuffle_options: Optional[bool]=None,
+            allow_adding_options: Optional[bool]=None,
+            hide_results_until_closes: Optional[bool]=None,
+            correct_option_ids: Optional[List[int]]=None,
+            description: Optional[str]=None,
+            description_parse_mode: Optional[str]=None,
+            description_entities: Optional[List[types.MessageEntity]]=None) -> types.Message:
         """
         Use this method to send a native poll.
         On success, the sent Message is returned.
@@ -6096,10 +6143,10 @@ class TeleBot:
         :param type: Poll type, “quiz” or “regular”, defaults to “regular”
         :type type: :obj:`str`
 
-        :param allows_multiple_answers: True, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to False
+        :param allows_multiple_answers: True, if the poll allows multiple answers, defaults to False
         :type allows_multiple_answers: :obj:`bool`
 
-        :param correct_option_id: 0-based identifier of the correct answer option. Available only for polls in quiz mode, defaults to None
+        :param correct_option_id: Deprecated, use correct_option_ids instead. 
         :type correct_option_id: :obj:`int`
 
         :param explanation: Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing
@@ -6108,10 +6155,11 @@ class TeleBot:
         :param explanation_parse_mode: Mode for parsing entities in the explanation. See formatting options for more details.
         :type explanation_parse_mode: :obj:`str`
 
-        :param open_period: Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with close_date.
+        :param open_period: Amount of time in seconds the poll will be active after creation, 5-2628000. Can't be used together with close_date.
         :type open_period: :obj:`int`
 
         :param close_date: Point in time (Unix timestamp) when the poll will be automatically closed.
+            Must be at least 5 and no more than 2628000 seconds in the future. Can't be used together with open_period.
         :type close_date: :obj:`int` | :obj:`datetime`
 
         :param is_closed: Pass True, if the poll needs to be immediately closed. This can be useful for poll preview.
@@ -6160,6 +6208,30 @@ class TeleBot:
             of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance
         :type allow_paid_broadcast: :obj:`bool`
 
+        :param allows_revoting: Pass True, if the poll allows to change chosen answer options, defaults to False for quizzes and to True for regular polls
+        :type allows_revoting: :obj:`bool`
+
+        :param shuffle_options: Pass True, if the poll options must be shown in random order
+        :type shuffle_options: :obj:`bool`
+
+        :param allow_adding_options: Pass True, if answer options can be added to the poll after creation; not supported for anonymous polls and quizzes
+        :type allow_adding_options: :obj:`bool`
+
+        :param hide_results_until_closes: Pass True, if poll results must be shown only after the poll closes
+        :type hide_results_until_closes: :obj:`bool`
+
+        :param correct_option_ids: A JSON-serialized list of monotonically increasing 0-based identifiers of the correct answer options, required for polls in quiz mode
+        :type correct_option_ids: :obj:`list` of :obj:`int`
+
+        :param description: Description of the poll to be sent, 0-1024 characters after entities parsing
+        :type description: :obj:`str`
+
+        :param description_parse_mode: Mode for parsing entities in the poll description. See formatting options for more details.
+        :type description_parse_mode: :obj:`str`
+
+        :param description_entities: A JSON-serialized list of special entities that appear in the poll description, which can be specified instead of description_parse_mode
+        :type description_entities: :obj:`list` of :obj:`MessageEntity`
+
         :return: On success, the sent Message is returned.
         :rtype: :obj:`types.Message`
         """
@@ -6192,6 +6264,7 @@ class TeleBot:
 
         explanation_parse_mode = self.parse_mode if (explanation_parse_mode is None) else explanation_parse_mode
         question_parse_mode = self.parse_mode if (question_parse_mode is None) else question_parse_mode
+        description_parse_mode = self.parse_mode if (description_parse_mode is None) else description_parse_mode
 
         if options and (not isinstance(options[0], types.InputPollOption)):
             # show a deprecation warning
@@ -6203,19 +6276,33 @@ class TeleBot:
                 options = [types.InputPollOption(option.text, text_entities=option.text_entities) for option in options]
             else:
                 raise RuntimeError("Type of 'options' items is unknown. Options should be List[types.InputPollOption], other types are deprecated.")
+            
+        # handle deprecated correct_option_id parameter
+        if correct_option_id is not None:
+            if correct_option_ids is not None:
+                # show a conflict warning
+                logger.warning("Both 'correct_option_id' and 'correct_option_ids' parameters are set: use 'correct_option_ids' instead.")
+            else:
+                # convert correct_option_id to correct_option_ids
+                correct_option_ids = [correct_option_id]
+                logger.warning("The parameter 'correct_option_id' is deprecated, use 'correct_option_ids' instead.")
+
 
         return types.Message.de_json(
             apihelper.send_poll(
                 self.token, chat_id, question, options,
                 is_anonymous=is_anonymous, type=type, allows_multiple_answers=allows_multiple_answers,
-                correct_option_id=correct_option_id, explanation=explanation,
+                explanation=explanation,
                 explanation_parse_mode=explanation_parse_mode, open_period=open_period,
                 close_date=close_date, is_closed=is_closed, disable_notification=disable_notification,
                 reply_markup=reply_markup, timeout=timeout, explanation_entities=explanation_entities,
                 protect_content=protect_content, message_thread_id=message_thread_id,
                 reply_parameters=reply_parameters, business_connection_id=business_connection_id,
                 question_parse_mode=question_parse_mode, question_entities=question_entities,
-                message_effect_id=message_effect_id, allow_paid_broadcast=allow_paid_broadcast)
+                message_effect_id=message_effect_id, allow_paid_broadcast=allow_paid_broadcast,
+                allows_revoting=allows_revoting, shuffle_options=shuffle_options,
+                allow_adding_options=allow_adding_options, hide_results_until_closes=hide_results_until_closes, correct_option_ids=correct_option_ids,
+                description=description, description_parse_mode=description_parse_mode, description_entities=description_entities)
             )
 
 
@@ -6796,10 +6883,10 @@ class TeleBot:
         :param text: Text that will be shown along with the gift; 0-255 characters
         :type text: :obj:`str`
 
-        :param text_parse_mode: Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored.
+        :param text_parse_mode: Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, “custom_emoji”, and “date_time” are ignored.
         :type text_parse_mode: :obj:`str`
 
-        :param text_entities: A JSON-serialized list of special entities that appear in the gift text. It can be specified instead of text_parse_mode. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored.
+        :param text_entities: A JSON-serialized list of special entities that appear in the gift text. It can be specified instead of text_parse_mode. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, “custom_emoji”, and “date_time” are ignored.
         :type text_entities: :obj:`list` of :obj:`types.MessageEntity`
 
         :return: Returns True on success.
@@ -7503,10 +7590,10 @@ class TeleBot:
         :param text: Text that will be shown along with the service message about the subscription; 0-128 characters
         :type text: :obj:`str`
 
-        :param text_parse_mode: Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored.
+        :param text_parse_mode: Mode for parsing entities in the text. See formatting options for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, “custom_emoji”, and “date_time” are ignored.
         :type text_parse_mode: :obj:`str`
 
-        :param text_entities: A JSON-serialized list of special entities that appear in the gift text. It can be specified instead of text_parse_mode. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom_emoji” are ignored.
+        :param text_entities: A JSON-serialized list of special entities that appear in the gift text. It can be specified instead of text_parse_mode. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, “custom_emoji”, and “date_time” are ignored.
         :type text_entities: :obj:`list` of :class:`telebot.types.MessageEntity`
 
         :return: Returns True on success.
@@ -8127,6 +8214,25 @@ class TeleBot:
                 self.token, user_id, result, allow_user_chats=allow_user_chats, allow_bot_chats=allow_bot_chats,
                 allow_group_chats=allow_group_chats, allow_channel_chats=allow_channel_chats)
         )
+    
+    def save_prepared_keyboard_button(self, user_id: int, button: types.KeyboardButton) -> types.PreparedKeyboardButton:
+        """
+        Use this method to store a keyboard button that can be used by a user within a Mini App. Returns a PreparedKeyboardButton object.
+
+        Telegram Documentation: https://core.telegram.org/bots/api#savepreparedkeyboardbutton
+
+        :param user_id: Unique identifier of the target user that can use the button
+        :type user_id: :obj:`int`
+
+        :param button: A JSON-serialized object describing the button to be saved. The button must be of the type request_users, request_chat, or request_managed_bot
+        :type button: :class:`telebot.types.KeyboardButton`
+
+        :return: On success, a PreparedKeyboardButton object is returned.
+        :rtype: :class:`telebot.types.PreparedKeyboardButton`
+        """
+        return types.PreparedKeyboardButton.de_json(
+            apihelper.save_prepared_keyboard_button(self.token, user_id, button)
+        )
 
     def register_for_reply(self, message: types.Message, callback: Callable, *args, **kwargs) -> None:
         """
@@ -10346,6 +10452,53 @@ class TeleBot:
         handler_dict = self._build_handler_dict(callback, func=func, pass_bot=pass_bot, **kwargs)
         self.add_deleted_business_messages_handler(handler_dict)
 
+    def managed_bot_handler(self, func=None, **kwargs):
+        """
+        Handles new incoming updates about managed bot. As a parameter to the decorator function, it passes :class:`telebot.types.ManagedBotUpdated` object.
+
+        :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_managed_bot_handler(handler_dict)
+            return handler
+        
+        return decorator
+    
+    def add_managed_bot_handler(self, handler_dict):
+        """
+        Adds a managed_bot handler.
+        Note that you should use register_managed_bot_handler to add managed_bot_handler to the bot.
+
+        :meta private:
+        :param handler_dict:
+        :return:
+        """
+        self.managed_bot_handlers.append(handler_dict)
+
+    def register_managed_bot_handler(self, callback: Callable, func: Optional[Callable]=None, pass_bot: Optional[bool]=False, **kwargs):
+        """
+        Registers managed bot 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_managed_bot_handler(handler_dict)
+
 
     def add_custom_filter(self, custom_filter: Union[SimpleCustomFilter, AdvancedCustomFilter]):
         """

telebot/apihelper.py

@@ -1606,6 +1606,16 @@ def get_business_connection(token, business_connection_id):
     payload = {'business_connection_id': business_connection_id}
     return _make_request(token, method_url, params=payload , method='post')
 
+def get_managed_bot_token(token, user_id):
+    method_url = 'getManagedBotToken'
+    payload = {'user_id': user_id}
+    return _make_request(token, method_url, params=payload , method='post')
+
+def replace_managed_bot_token(token, user_id):
+    method_url = 'replaceManagedBotToken'
+    payload = {'user_id': user_id}
+    return _make_request(token, method_url, params=payload , method='post')
+
 def delete_my_commands(token, scope=None, language_code=None):
     method_url = r'deleteMyCommands'
     payload = {}
@@ -1893,7 +1903,9 @@ def send_invoice(
     :param message_thread_id: Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
     :param reply_parameters: A JSON-serialized object for an inline keyboard. If empty, one 'Pay total price' button will be shown. If not empty, the first button must be a Pay button.
     :param message_effect_id: Unique identifier of the message effect to be added to the message; for private chats only
-    :param allow_paid_broadcast:
+    :param allow_paid_broadcast: Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance
+    :param direct_messages_topic_id: Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat
+    :param suggested_post_parameters: A JSON-serialized object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined.
     :return:
     """
     method_url = r'sendInvoice'
@@ -2486,6 +2498,12 @@ def save_prepared_inline_message(token, user_id, result: types.InlineQueryResult
         return _make_request(token, method_url, params=payload, method='post')
 
 
+def save_prepared_keyboard_button(token, user_id, button):
+    method_url = 'savePreparedKeyboardButton'
+    payload = {'user_id': user_id, 'button': button.to_json()}
+    return _make_request(token, method_url, params=payload, method='post')
+
+
 def create_invoice_link(token, title, description, payload, provider_token,
             currency, prices, max_tip_amount=None, suggested_tip_amounts=None, provider_data=None,
             photo_url=None, photo_size=None, photo_width=None, photo_height=None, need_name=None, need_phone_number=None,
@@ -2534,11 +2552,12 @@ def create_invoice_link(token, title, description, payload, provider_token,
 # noinspection PyShadowingBuiltins
 def send_poll(
         token, chat_id, question, options,
-        is_anonymous = None, type = None, allows_multiple_answers = None, correct_option_id = None, explanation = None,
+        is_anonymous = None, type = None, allows_multiple_answers = None, explanation = None,
         explanation_parse_mode=None, open_period = None, close_date = None, is_closed = None, disable_notification=False,
         reply_markup=None, timeout=None, explanation_entities=None, protect_content=None, message_thread_id=None,
         reply_parameters=None, business_connection_id=None, question_parse_mode=None, question_entities=None, message_effect_id=None,
-        allow_paid_broadcast=None):
+        allow_paid_broadcast=None, allows_revoting=None, shuffle_options=None, allow_adding_options=None, hide_results_until_closes=None,
+        correct_option_ids=None, description=None, description_parse_mode=None, description_entities=None):
     method_url = r'sendPoll'
     payload = {
         'chat_id': str(chat_id),
@@ -2552,8 +2571,6 @@ def send_poll(
         payload['type'] = type
     if allows_multiple_answers is not None:
         payload['allows_multiple_answers'] = allows_multiple_answers
-    if correct_option_id is not None:
-        payload['correct_option_id'] = correct_option_id
     if explanation:
         payload['explanation'] = explanation
     if explanation_parse_mode:
@@ -2591,6 +2608,22 @@ def send_poll(
         payload['message_effect_id'] = message_effect_id
     if allow_paid_broadcast is not None:
         payload['allow_paid_broadcast'] = allow_paid_broadcast
+    if allows_revoting is not None:
+        payload['allows_revoting'] = allows_revoting
+    if shuffle_options is not None:
+        payload['shuffle_options'] = shuffle_options
+    if allow_adding_options is not None:
+        payload['allow_adding_options'] = allow_adding_options
+    if hide_results_until_closes is not None:
+        payload['hide_results_until_closes'] = hide_results_until_closes
+    if correct_option_ids is not None:
+        payload['correct_option_ids'] = json.dumps(correct_option_ids)
+    if description is not None:
+        payload['description'] = description
+    if description_parse_mode is not None:
+        payload['description_parse_mode'] = description_parse_mode
+    if description_entities is not None:
+        payload['description_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(description_entities))
     return _make_request(token, method_url, params=payload)
 
 def create_forum_topic(token, chat_id, name, icon_color=None, icon_custom_emoji_id=None):