Added upgrade_gift and transfer_gift methods

Author: coder2020official

telebot/__init__.py

@@ -6600,6 +6600,71 @@ def convert_gift_to_stars(self, business_connection_id: str, owned_gift_id: str)
         :rtype: :obj:`bool`
         """
         return apihelper.convert_gift_to_stars(self.token, business_connection_id, owned_gift_id)
+    
+    def upgrade_gift(
+            self, business_connection_id: str, owned_gift_id: str,
+            keep_original_details: Optional[bool]=None,
+            star_count: Optional[int]=None) -> bool:
+        """
+        Upgrades a given regular gift to a unique gift. Requires the can_transfer_and_upgrade_gifts business bot right.
+        Additionally requires the can_transfer_stars business bot right if the upgrade is paid. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#upgradegift
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param owned_gift_id: Unique identifier of the regular gift that should be upgraded to a unique one
+        :type owned_gift_id: :obj:`str`
+
+        :param keep_original_details: Pass True to keep the original gift text, sender and receiver in the upgraded gift
+        :type keep_original_details: :obj:`bool`
+
+        :param star_count: The amount of Telegram Stars that will be paid for the upgrade from the business account balance.
+            If gift.prepaid_upgrade_star_count > 0, then pass 0, otherwise, the can_transfer_stars business bot right is required and gift.upgrade_star_count must be passed.
+        :type star_count: :obj:`int`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return apihelper.upgrade_gift(
+            self.token, business_connection_id, owned_gift_id,
+            keep_original_details=keep_original_details,
+            star_count=star_count
+        )
+
+    def transfer_gift(
+            self, business_connection_id: str, owned_gift_id: str,
+            new_owner_chat_id: Union[int, str],
+            star_count: Optional[int]=None) -> bool:
+        """
+        Transfers an owned unique gift to another user. Requires the can_transfer_and_upgrade_gifts business bot right.
+        Requires can_transfer_stars business bot right if the transfer is paid. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#transfergift
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param owned_gift_id: Unique identifier of the regular gift that should be transferred
+        :type owned_gift_id: :obj:`str`
+
+        :param new_owner_chat_id: Unique identifier of the chat which will own the gift. The chat must be active in the last 24 hours.
+        :type new_owner_chat_id: :obj:`int` | :obj:`str`
+
+        :param star_count: The amount of Telegram Stars that will be paid for the transfer from the business account balance.
+            If positive, then the can_transfer_stars business bot right is required.
+        :type star_count: :obj:`int`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return apihelper.transfer_gift(
+            self.token, business_connection_id, owned_gift_id,
+            new_owner_chat_id=new_owner_chat_id,
+            star_count=star_count
+        )
+
 
     def get_available_gifts(self) -> types.Gifts:
         """

telebot/apihelper.py

@@ -2074,6 +2074,22 @@ def convert_gift_to_stars(token, business_connection_id, owned_gift_id):
     payload = {'business_connection_id': business_connection_id, 'owned_gift_id': owned_gift_id}
     return _make_request(token, method_url, params=payload, method='post')
 
+def upgrade_gift(token, business_connection_id, owned_gift_id, keep_original_details=None, star_count=None):
+    method_url = 'upgradeGift'
+    payload = {'business_connection_id': business_connection_id, 'owned_gift_id': owned_gift_id}
+    if keep_original_details is not None:
+        payload['keep_original_details'] = keep_original_details
+    if star_count is not None:
+        payload['star_count'] = star_count
+    return _make_request(token, method_url, params=payload, method='post')
+
+def transfer_gift(token, business_connection_id, owned_gift_id, new_owner_chat_id, star_count=None):
+    method_url = 'transferGift'
+    payload = {'business_connection_id': business_connection_id, 'owned_gift_id': owned_gift_id, 'new_owner_chat_id': new_owner_chat_id}
+    if star_count is not None:
+        payload['star_count'] = star_count
+    return _make_request(token, method_url, params=payload, method='post')
+
 def create_new_sticker_set(
         token, user_id, name, title, stickers, sticker_type=None, needs_repainting=None):
     method_url = 'createNewStickerSet'

telebot/async_telebot.py

@@ -8056,6 +8056,70 @@ async def convert_gift_to_stars(self, business_connection_id: str, owned_gift_id
         :rtype: :obj:`bool`
         """
         return await asyncio_helper.convert_gift_to_stars(self.token, business_connection_id, owned_gift_id)
+    
+    async def upgrade_gift(
+            self, business_connection_id: str, owned_gift_id: str,
+            keep_original_details: Optional[bool]=None,
+            star_count: Optional[int]=None) -> bool:
+        """
+        Upgrades a given regular gift to a unique gift. Requires the can_transfer_and_upgrade_gifts business bot right.
+        Additionally requires the can_transfer_stars business bot right if the upgrade is paid. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#upgradegift
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param owned_gift_id: Unique identifier of the regular gift that should be upgraded to a unique one
+        :type owned_gift_id: :obj:`str`
+
+        :param keep_original_details: Pass True to keep the original gift text, sender and receiver in the upgraded gift
+        :type keep_original_details: :obj:`bool`
+
+        :param star_count: The amount of Telegram Stars that will be paid for the upgrade from the business account balance.
+            If gift.prepaid_upgrade_star_count > 0, then pass 0, otherwise, the can_transfer_stars business bot right is required and gift.upgrade_star_count must be passed.
+        :type star_count: :obj:`int`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return await asyncio_helper.upgrade_gift(
+            self.token, business_connection_id, owned_gift_id,
+            keep_original_details=keep_original_details,
+            star_count=star_count
+        )
+
+    async def transfer_gift(
+            self, business_connection_id: str, owned_gift_id: str,
+            new_owner_chat_id: Union[int, str],
+            star_count: Optional[int]=None) -> bool:
+        """
+        Transfers an owned unique gift to another user. Requires the can_transfer_and_upgrade_gifts business bot right.
+        Requires can_transfer_stars business bot right if the transfer is paid. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#transfergift
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param owned_gift_id: Unique identifier of the regular gift that should be transferred
+        :type owned_gift_id: :obj:`str`
+
+        :param new_owner_chat_id: Unique identifier of the chat which will own the gift. The chat must be active in the last 24 hours.
+        :type new_owner_chat_id: :obj:`int` | :obj:`str`
+
+        :param star_count: The amount of Telegram Stars that will be paid for the transfer from the business account balance.
+            If positive, then the can_transfer_stars business bot right is required.
+        :type star_count: :obj:`int`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return await asyncio_helper.transfer_gift(
+            self.token, business_connection_id, owned_gift_id,
+            new_owner_chat_id=new_owner_chat_id,
+            star_count=star_count
+        )
 
     async def get_available_gifts(self) -> types.Gifts:
         """

telebot/asyncio_helper.py

@@ -2047,6 +2047,22 @@ async def convert_gift_to_stars(token, business_connection_id, owned_gift_id):
     payload = {'business_connection_id': business_connection_id, 'owned_gift_id': owned_gift_id}
     return await _process_request(token, method_url, params=payload, method='post')
 
+async def upgrade_gift(token, business_connection_id, owned_gift_id, keep_original_details=None, star_count=None):
+    method_url = 'upgradeGift'
+    payload = {'business_connection_id': business_connection_id, 'owned_gift_id': owned_gift_id}
+    if keep_original_details is not None:
+        payload['keep_original_details'] = keep_original_details
+    if star_count is not None:
+        payload['star_count'] = star_count
+    return await _process_request(token, method_url, params=payload, method='post')
+
+async def transfer_gift(token, business_connection_id, owned_gift_id, new_owner_chat_id, star_count=None):
+    method_url = 'transferGift'
+    payload = {'business_connection_id': business_connection_id, 'owned_gift_id': owned_gift_id, 'new_owner_chat_id': new_owner_chat_id}
+    if star_count is not None:
+        payload['star_count'] = star_count
+    return await _process_request(token, method_url, params=payload, method='post')
+
 async def get_available_gifts(token):
     method_url = 'getAvailableGifts'
     return await _process_request(token, method_url)