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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyTelegramBotAPI
-Version: 4.30.0
+Version: 4.32.0
 Summary: Python Telegram bot API.
 Project-URL: Homepage, https://github.com/eternnoir/pyTelegramBotAPI
 Project-URL: Documentation, https://pytba.readthedocs.org
@@ -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#august-15-2025"><img src="https://img.shields.io/badge/Bot%20API-9.2-blue?logo=telegram" alt="Supported Bot API version"></a>
+## <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>
 
 <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>
@@ -843,7 +843,7 @@ Bot instances that were idle for a long time might be rejected by the server whe
 
 Get help. Discuss. Chat.
 
-* Join the [pyTelegramBotAPI Telegram Chat Group](https://telegram.me/joinchat/Bn4ixj84FIZVkwhk2jag6A)
+* Join the [pyTelegramBotAPI Telegram Chat Group](https://t.me/+GNAFesxfJ-o5OTRl)
 	
 ## Telegram Channel
 

pytelegrambotapi-4.32.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+telebot/__init__.py,sha256=N66uzken5iV53MtWlKrwB3YcS6Ecnd3wCv3ny5qlFZU,499445
+telebot/apihelper.py,sha256=Nd1XLwABjWw7X_BcJ87GghVqwHuZ1MR8KMGKW01cgWI,124058
+telebot/async_telebot.py,sha256=pSBVbVCu_6WBS2eGC0Fc3IvvrsNOPEILKQsu9uBqRvI,473014
+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/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/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/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
+telebot/asyncio_storage/pickle_storage.py,sha256=LEwWu_hMSaUKIJT1nOkeIBRdzLEZIF4anInMOKOlkRs,7936
+telebot/asyncio_storage/redis_storage.py,sha256=rDCkS8u3lMVJ-JYFj9k5rDhz6WH9wwGdhSf9_bgiIzk,10236
+telebot/ext/__init__.py,sha256=_mSeNU1cib3cWSZ6Kb6nKy9znEYwEzGNRCYZsD61rLk,66
+telebot/ext/reloader.py,sha256=vzmJxCsA_COHF-bpmyddDuUXroxNih051IYRMiR21LY,826
+telebot/ext/aio/__init__.py,sha256=2yi7jtvEIH1DqAseFevfujNYi7ZSh5aPMOKGrxIgqsw,143
+telebot/ext/aio/webhooks.py,sha256=tf4DMXkKWvM_Uko_lpLRc0uDwttyZGvsvDLNNbwmO_Y,3788
+telebot/ext/sync/__init__.py,sha256=Lj-15dj1TYkf11d0vY14_2mssnoFR5Uk320huWa_rGc,140
+telebot/ext/sync/webhooks.py,sha256=XMMhXnDuFs7CWJ7iDi11H0dwf6fRA4pbAjFjNgNJ18Y,3513
+telebot/states/__init__.py,sha256=LHXRkVrbx8ig_UBtNeYKLdF3HkkzJzkKs2EU23bhwiI,4529
+telebot/states/asyncio/__init__.py,sha256=GOj426jeWP2nuScz4SPRY3FcWZ9V7jE0iUR0B_spyUw,139
+telebot/states/asyncio/context.py,sha256=Mk8rgTmlM-cdpsN6GKUratJE4E6wkzjGo2PyLYtedw4,5101
+telebot/states/asyncio/middleware.py,sha256=JNaDTJ-rE_J6X4UfS0F8rIKUWYrCw5GowdJ8MnRFAzA,751
+telebot/states/sync/__init__.py,sha256=4uC-5KHK3h2rsFcv98pDcLI3dzPet0aRB8x-2M0sMWE,137
+telebot/states/sync/context.py,sha256=Re5448GjbI_GfKpJh-MeDKDNHxodr7y2dTpgERcrB1s,4873
+telebot/states/sync/middleware.py,sha256=lkstXtC_35bZAajVeMkdepbVNK1Yir3XApDzEnMnIiM,701
+telebot/storage/__init__.py,sha256=SJFXvAu45CH35oQgmwsV2PpwynvSmRAzKQU40x2eUWA,414
+telebot/storage/base_storage.py,sha256=Xcgb2LdGV_5L16W1TnRXG0tvkopNCf9xh37ri1XzaqE,3704
+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.30.0.dist-info → pytelegrambotapi-4.32.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.28.0
+Generator: hatchling 1.29.0
 Root-Is-Purelib: true
 Tag: py3-none-any

telebot/__init__.py

@@ -1512,6 +1512,29 @@ class TeleBot:
             apihelper.get_user_profile_photos(self.token, user_id, offset=offset, limit=limit)
         )
 
+    def get_user_profile_audios(self, user_id: int, offset: Optional[int]=None,
+            limit: Optional[int]=None) -> types.UserProfileAudios:
+        """
+        Use this method to get a list of profile audios for a user. Returns a :class:`telebot.types.UserProfileAudios` object.
+
+        Telegram documentation: https://core.telegram.org/bots/api#getuserprofileaudios
+
+        :param user_id: Unique identifier of the target user
+        :type user_id: :obj:`int`
+
+        :param offset: Sequential number of the first audio to be returned. By default, all audios are returned.
+        :type offset: :obj:`int`
+
+        :param limit: Limits the number of audios to be retrieved. Values between 1-100 are accepted. Defaults to 100.
+        :type limit: :obj:`int`
+
+        :return: If the request is successful, a UserProfileAudios object is returned.
+        :rtype: :class:`telebot.types.UserProfileAudios`
+        """
+        return types.UserProfileAudios.de_json(
+            apihelper.get_user_profile_audios(self.token, user_id, offset=offset, limit=limit)
+        )
+
     def set_user_emoji_status(self, user_id: int, emoji_status_custom_emoji_id: Optional[str]=None, emoji_status_expiration_date: Optional[int]=None) -> bool:
         """
         Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess. Returns True on success.
@@ -4214,7 +4237,7 @@ class TeleBot:
             entities: Optional[List[types.MessageEntity]]=None):
         """
         Use this method to stream a partial message to a user while the message is being generated;
-        supported only for bots with forum topic mode enabled. Returns True on success.
+        available for all bots. Returns True on success.
 
         Telegram documentation: https://core.telegram.org/bots/api#sendmessagedraft
 
@@ -4464,7 +4487,8 @@ class TeleBot:
             can_post_stories: Optional[bool]=None,
             can_edit_stories: Optional[bool]=None,
             can_delete_stories: Optional[bool]=None,
-            can_manage_direct_messages: Optional[bool]=None) -> bool:
+            can_manage_direct_messages: Optional[bool]=None,
+            can_manage_tags: Optional[bool]=None) -> bool:
         """
         Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator
         in the chat for this to work and must have the appropriate admin rights.
@@ -4538,6 +4562,9 @@ class TeleBot:
             within the channel and decline suggested posts; for channels only
         :type can_manage_direct_messages: :obj:`bool`
 
+        :param can_manage_tags: Pass True if the administrator can manage tags in the chat
+        :type can_manage_tags: :obj:`bool`
+
         :return: True on success.
         :rtype: :obj:`bool`
         """
@@ -4555,6 +4582,7 @@ class TeleBot:
             can_manage_video_chats=can_manage_video_chats, can_manage_topics=can_manage_topics,
             can_post_stories=can_post_stories, can_edit_stories=can_edit_stories,
             can_delete_stories=can_delete_stories, can_manage_direct_messages=can_manage_direct_messages,
+            can_manage_tags=can_manage_tags,
         )
 
 
@@ -4583,6 +4611,30 @@ class TeleBot:
         return apihelper.set_chat_administrator_custom_title(self.token, chat_id, user_id, custom_title)
 
 
+    def set_chat_member_tag(
+            self, chat_id: Union[int, str], user_id: int, tag: Optional[str]=None) -> bool:
+        """
+        Use this method to set a new tag for a member in a chat.
+        Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#setchatmembertag
+
+        :param chat_id: Unique identifier for the target chat or username of the target supergroup
+            (in the format @supergroupusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+
+        :param user_id: Unique identifier of the target user
+        :type user_id: :obj:`int`
+
+        :param tag: New tag for the member; pass an empty string to remove the tag
+        :type tag: :obj:`str`
+
+        :return: True on success.
+        :rtype: :obj:`bool`
+        """
+        return apihelper.set_chat_member_tag(self.token, chat_id, user_id, tag=tag)
+
+
     def ban_chat_sender_chat(self, chat_id: Union[int, str], sender_chat_id: Union[int, str]) -> bool:
         """
         Use this method to ban a channel chat in a supergroup or a channel.
@@ -5048,6 +5100,31 @@ class TeleBot:
         return types.BotShortDescription.de_json(
             apihelper.get_my_short_description(self.token, language_code=language_code))
 
+    def set_my_profile_photo(self, photo: types.InputProfilePhoto) -> bool:
+        """
+        Use this method to change the profile photo of the bot. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#setmyprofilephoto
+
+        :param photo: The new profile photo to set
+        :type photo: :class:`telebot.types.InputProfilePhoto`
+
+        :return: True on success.
+        :rtype: :obj:`bool`
+        """
+        return apihelper.set_my_profile_photo(self.token, photo)
+
+    def remove_my_profile_photo(self) -> bool:
+        """
+        Use this method to remove the profile photo of the bot. Requires no parameters. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#removemyprofilephoto
+
+        :return: True on success.
+        :rtype: :obj:`bool`
+        """
+        return apihelper.remove_my_profile_photo(self.token)
+
 
     def set_chat_menu_button(self, chat_id: Union[int, str]=None, menu_button: types.MenuButton=None) -> bool:
         """
@@ -7758,7 +7835,7 @@ class TeleBot:
 
         :param sticker: File identifier of the sticker
         :return: On success, True is returned.
-        :rtype: :obj:`bool`
+    	:rtype: :obj:`bool`
         """
         return apihelper.delete_sticker_from_set(self.token, sticker)
 
@@ -7767,8 +7844,8 @@ class TeleBot:
             chat_id: int, name: str, icon_color: Optional[int]=None,
             icon_custom_emoji_id: Optional[str]=None) -> types.ForumTopic:
         """
-        Use this method to create a topic in a forum supergroup chat. The bot must be an administrator
-        in the chat for this to work and must have the can_manage_topics administrator rights.
+        Use this method to create a topic in a forum supergroup chat or a private chat with a user. In the case of a supergroup chat the bot
+        must be an administrator in the chat for this to work and must have the can_manage_topics administrator right.
         Returns information about the created topic as a ForumTopic object.
 
         Telegram documentation: https://core.telegram.org/bots/api#createforumtopic

telebot/apihelper.py

@@ -349,6 +349,16 @@ def get_user_profile_photos(token, user_id, offset=None, limit=None):
     return _make_request(token, method_url, params=payload)
 
 
+def get_user_profile_audios(token, user_id, offset=None, limit=None):
+    method_url = r'getUserProfileAudios'
+    payload = {'user_id': user_id}
+    if offset:
+        payload['offset'] = offset
+    if limit:
+        payload['limit'] = limit
+    return _make_request(token, method_url, params=payload)
+
+
 def set_user_emoji_status(token, user_id, emoji_status_custom_emoji_id=None, emoji_status_expiration_date=None):
     method_url = r'setUserEmojiStatus'
     payload = {'user_id': user_id}
@@ -1277,7 +1287,7 @@ def promote_chat_member(
         can_restrict_members=None, can_pin_messages=None, can_promote_members=None,
         is_anonymous=None, can_manage_chat=None, can_manage_video_chats=None,
         can_manage_topics=None, can_post_stories=None, can_edit_stories=None,
-        can_delete_stories=None, can_manage_direct_messages=None):
+        can_delete_stories=None, can_manage_direct_messages=None, can_manage_tags=None):
     method_url = 'promoteChatMember'
     payload = {'chat_id': chat_id, 'user_id': user_id}
     if can_change_info is not None:
@@ -1312,6 +1322,8 @@ def promote_chat_member(
         payload['can_delete_stories'] = can_delete_stories
     if can_manage_direct_messages is not None:
         payload['can_manage_direct_messages'] = can_manage_direct_messages
+    if can_manage_tags is not None:
+        payload['can_manage_tags'] = can_manage_tags
     return _make_request(token, method_url, params=payload, method='post')
 
 
@@ -1323,6 +1335,14 @@ def set_chat_administrator_custom_title(token, chat_id, user_id, custom_title):
     return _make_request(token, method_url, params=payload, method='post')
 
 
+def set_chat_member_tag(token, chat_id, user_id, tag=None):
+    method_url = 'setChatMemberTag'
+    payload = {'chat_id': chat_id, 'user_id': user_id}
+    if tag is not None:
+        payload['tag'] = tag
+    return _make_request(token, method_url, params=payload, method='post')
+
+
 def ban_chat_sender_chat(token, chat_id, sender_chat_id):
     method_url = 'banChatSenderChat'
     payload = {'chat_id': chat_id, 'sender_chat_id': sender_chat_id}
@@ -1526,6 +1546,17 @@ def get_my_name(token, language_code=None):
         payload['language_code'] = language_code
     return _make_request(token, method_url, params=payload)
 
+def set_my_profile_photo(token, photo):
+    method_url = r'setMyProfilePhoto'
+    payload = {}
+    photo_json, files = photo.convert_input_profile_photo()
+    payload['photo'] = photo_json
+    return _make_request(token, method_url, params=payload, files=files, method='post')
+
+def delete_my_profile_photo(token):
+    method_url = r'deleteMyProfilePhoto'
+    return _make_request(token, method_url, method='post')
+
 def set_chat_menu_button(token, chat_id=None, menu_button=None):
     method_url = r'setChatMenuButton'
     payload = {}

telebot/async_telebot.py

@@ -2989,6 +2989,26 @@ class AsyncTeleBot:
         result = await asyncio_helper.get_user_profile_photos(self.token, user_id, offset, limit)
         return types.UserProfilePhotos.de_json(result)
 
+    async def get_user_profile_audios(self, user_id: int, offset: Optional[int]=None, limit: Optional[int]=None) -> types.UserProfileAudios:
+        """
+        Use this method to get a list of profile audios for a user. Returns a UserProfileAudios object.
+
+        Telegram documentation: https://core.telegram.org/bots/api#getuserprofileaudios
+
+        :param user_id: Unique identifier of the target user
+        :type user_id: :obj:`int`
+
+        :param offset: Sequential number of the first audio to be returned. By default, all audios are returned.
+        :type offset: :obj:`int`
+
+        :param limit: Limits the number of audios to be retrieved. Values between 1-100 are accepted. Defaults to 100.
+        :type limit: :obj:`int`
+
+        :return: If successful, returns a UserProfileAudios object.
+        :rtype: :class:`telebot.types.UserProfileAudios`
+        """
+        return types.UserProfileAudios.de_json(await asyncio_helper.get_user_profile_audios(self.token, user_id, offset=offset, limit=limit))
+
     async def set_user_emoji_status(self, user_id: int, emoji_status_custom_emoji_id: Optional[str]=None, emoji_status_expiration_date: Optional[int]=None) -> bool:
         """
         Use this method to change the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess.
@@ -5737,7 +5757,7 @@ class AsyncTeleBot:
             entities: Optional[List[types.MessageEntity]]=None):
         """
         Use this method to stream a partial message to a user while the message is being generated;
-        supported only for bots with forum topic mode enabled. Returns True on success.
+        available for all bots. Returns True on success.
 
         Telegram documentation: https://core.telegram.org/bots/api#sendmessagedraft
 
@@ -5976,7 +5996,8 @@ class AsyncTeleBot:
             can_post_stories: Optional[bool]=None,
             can_edit_stories: Optional[bool]=None,
             can_delete_stories: Optional[bool]=None,
-            can_manage_direct_messages: Optional[bool]=None) -> bool:
+            can_manage_direct_messages: Optional[bool]=None,
+            can_manage_tags: Optional[bool]=None) -> bool:
         """
         Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator
         in the chat for this to work and must have the appropriate admin rights.
@@ -6050,6 +6071,9 @@ class AsyncTeleBot:
             within the channel and decline suggested posts; for channels only
         :type can_manage_direct_messages: :obj:`bool`
 
+        :param can_manage_tags: Pass True if the administrator can manage tags in the chat
+        :type can_manage_tags: :obj:`bool`
+
         :return: True on success.
         :rtype: :obj:`bool`
         """
@@ -6064,7 +6088,8 @@ class AsyncTeleBot:
             can_edit_messages, can_delete_messages, can_invite_users,
             can_restrict_members, can_pin_messages, can_promote_members,
             is_anonymous, can_manage_chat, can_manage_video_chats, can_manage_topics,
-            can_post_stories, can_edit_stories, can_delete_stories, can_manage_direct_messages=can_manage_direct_messages
+            can_post_stories, can_edit_stories, can_delete_stories,
+            can_manage_direct_messages=can_manage_direct_messages, can_manage_tags=can_manage_tags
         )
 
     async def set_chat_administrator_custom_title(
@@ -6092,6 +6117,30 @@ class AsyncTeleBot:
         return await asyncio_helper.set_chat_administrator_custom_title(self.token, chat_id, user_id, custom_title)
 
 
+    async def set_chat_member_tag(
+            self, chat_id: Union[int, str], user_id: int, tag: Optional[str]=None) -> bool:
+        """
+        Use this method to set a new tag for a member in a chat.
+        Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#setchatmembertag
+
+        :param chat_id: Unique identifier for the target chat or username of the target supergroup
+            (in the format @supergroupusername)
+        :type chat_id: :obj:`int` or :obj:`str`
+
+        :param user_id: Unique identifier of the target user
+        :type user_id: :obj:`int`
+
+        :param tag: New tag for the member; pass an empty string to remove the tag
+        :type tag: :obj:`str`
+
+        :return: True on success.
+        :rtype: :obj:`bool`
+        """
+        return await asyncio_helper.set_chat_member_tag(self.token, chat_id, user_id, tag=tag)
+
+
     async def ban_chat_sender_chat(self, chat_id: Union[int, str], sender_chat_id: Union[int, str]) -> bool:
         """
         Use this method to ban a channel chat in a supergroup or a channel.
@@ -6533,6 +6582,31 @@ class AsyncTeleBot:
         result = await asyncio_helper.get_my_name(self.token, language_code)
         return types.BotName.de_json(result)
 
+    async def set_my_profile_photo(self, photo: types.InputProfilePhoto) -> bool:
+        """
+        Use this method to change the profile photo of the bot. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#setmyprofilephoto
+
+        :param photo: InputProfilePhoto: The new profile photo to set
+        :type photo: :class:`telebot.types.InputProfilePhoto`
+
+        :return: True on success.
+        :rtype: :obj:`bool`
+        """
+        return await asyncio_helper.set_my_profile_photo(self.token, photo)
+
+    async def remove_my_profile_photo(self) -> bool:
+        """
+        Use this method to remove the profile photo of the bot. Requires no parameters. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#removemyprofilephoto
+
+        :return: True on success.
+        :rtype: :obj:`bool`
+        """
+        return await asyncio_helper.remove_my_profile_photo(self.token)
+
     async def set_chat_menu_button(self, chat_id: Union[int, str]=None,
                 menu_button: types.MenuButton=None) -> bool:
         """
@@ -9193,8 +9267,8 @@ class AsyncTeleBot:
             chat_id: int, name: str, icon_color: Optional[int]=None,
             icon_custom_emoji_id: Optional[str]=None) -> types.ForumTopic:
         """
-        Use this method to create a topic in a forum supergroup chat. The bot must be an administrator
-        in the chat for this to work and must have the can_manage_topics administrator rights.
+        Use this method to create a topic in a forum supergroup chat or a private chat with a user. In the case of a supergroup chat the bot
+        must be an administrator in the chat for this to work and must have the can_manage_topics administrator right.
         Returns information about the created topic as a ForumTopic object.
 
         Telegram documentation: https://core.telegram.org/bots/api#createforumtopic