posting, editing, deleting stories(needs testing)

Author: coder2020official

telebot/__init__.py

@@ -6664,7 +6664,126 @@ def transfer_gift(
             new_owner_chat_id=new_owner_chat_id,
             star_count=star_count
         )
+    
+    def post_story(
+            self, business_connection_id: str, content: types.InputStoryContent,
+            active_period: int, caption: Optional[str]=None,
+            parse_mode: Optional[str]=None,
+            caption_entities: Optional[List[types.MessageEntity]]=None,
+            areas: Optional[List[types.StoryArea]]=None,
+            post_to_chat_page: Optional[bool]=None,
+            protect_content: Optional[bool]=None) -> types.Story:
+
+        """
+        Posts a story on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns Story on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#poststory
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param content: Content of the story
+        :type content: :class:`telebot.types.InputStoryContent`
+
+        :param active_period: Period after which the story is moved to the archive, in seconds; must be one of 6 * 3600, 12 * 3600, 86400, or 2 * 86400
+        :type active_period: :obj:`int`
+
+        :param caption: Caption of the story, 0-2048 characters after entities parsing
+        :type caption: :obj:`str`
+
+        :param parse_mode: Mode for parsing entities in the story caption. See formatting options for more details.
+        :type parse_mode: :obj:`str`
+
+        :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode
+        :type caption_entities: :obj:`list` of :class:`telebot.types.MessageEntity`
+
+        :param areas: A JSON-serialized list of clickable areas to be shown on the story
+        :type areas: :obj:`list` of :class:`telebot.types.StoryArea`
+
+        :param post_to_chat_page: Pass True to keep the story accessible after it expires
+        :type post_to_chat_page: :obj:`bool`
+
+        :param protect_content: Pass True if the content of the story must be protected from forwarding and screenshotting
+        :type protect_content: :obj:`bool`
+
+        :return: On success, a Story object is returned.
+        :rtype: :class:`telebot.types.Story`
+        """
+        return types.Story.de_json(
+            apihelper.post_story(
+                self.token, business_connection_id, content,
+                active_period, caption=caption,
+                parse_mode=parse_mode,
+                caption_entities=caption_entities,
+                areas=areas,
+                post_to_chat_page=post_to_chat_page,
+                protect_content=protect_content
+            )
+        )
+
+    def edit_story(
+            self, business_connection_id: str, story_id: int,
+            content: types.InputStoryContent,
+            caption: Optional[str]=None,
+            parse_mode: Optional[str]=None,
+            caption_entities: Optional[List[types.MessageEntity]]=None,
+            areas: Optional[List[types.StoryArea]]=None) -> types.Story:
+        """
+        Edits a story previously posted by the bot on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns Story on success.
 
+        Telegram documentation: https://core.telegram.org/bots/api#editstory
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param story_id: Unique identifier of the story to edit
+        :type story_id: :obj:`int`
+
+        :param content: Content of the story
+        :type content: :class:`telebot.types.InputStoryContent`
+
+        :param caption: Caption of the story, 0-2048 characters after entities parsing
+        :type caption: :obj:`str`
+
+        :param parse_mode: Mode for parsing entities in the story caption. See formatting options for more details.
+        :type parse_mode: :obj:`str`
+
+        :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode
+        :type caption_entities: :obj:`list` of :class:`telebot.types.MessageEntity`
+
+        :param areas: A JSON-serialized list of clickable areas to be shown on the story
+        :type areas: :obj:`list` of :class:`telebot.types.StoryArea`
+
+        :return: On success, a Story object is returned.
+        :rtype: :class:`telebot.types.Story`
+
+        """
+        return types.Story.de_json(
+            apihelper.edit_story(
+                self.token, business_connection_id, story_id,
+                content, caption=caption,
+                parse_mode=parse_mode,
+                caption_entities=caption_entities,
+                areas=areas
+            )
+    )
+
+    def delete_story(self, business_connection_id: str, story_id: int) -> bool:
+        """
+        Deletes a story previously posted by the bot on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns True on success.
+        
+        Telegram documentation: https://core.telegram.org/bots/api#deletestory
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param story_id: Unique identifier of the story to delete
+        :type story_id: :obj:`int`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return apihelper.delete_story(self.token, business_connection_id, story_id)
 
     def get_available_gifts(self) -> types.Gifts:
         """

telebot/apihelper.py

@@ -2090,6 +2090,51 @@ def transfer_gift(token, business_connection_id, owned_gift_id, new_owner_chat_i
         payload['star_count'] = star_count
     return _make_request(token, method_url, params=payload, method='post')
 
+def post_story(token, business_connection_id, content, active_period, caption=None, parse_mode=None,
+             caption_entities=None, areas=None, post_to_chat_page=None, protect_content=None):
+    method_url = 'postStory'
+    payload = {'business_connection_id': business_connection_id, 'active_period': active_period}
+    
+    content_json, files = content.convert_input_story()
+    payload['content'] = content_json
+    
+    if caption:
+        payload['caption'] = caption
+    if parse_mode:
+        payload['parse_mode'] = parse_mode
+    if caption_entities:
+        payload['caption_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(caption_entities))
+    if areas:
+        payload['areas'] = json.dumps([area.to_json() for area in areas])
+    if post_to_chat_page is not None:
+        payload['post_to_chat_page'] = post_to_chat_page
+    if protect_content is not None:
+        payload['protect_content'] = protect_content
+    return _make_request(token, method_url, params=payload, files=files, method='post')
+
+def edit_story(token, business_connection_id, story_id, content, caption=None, parse_mode=None,
+                caption_entities=None, areas=None):
+    method_url = 'editStory'
+    payload = {'business_connection_id': business_connection_id, 'story_id': story_id}
+    
+    content_json, files = content.convert_input_story()
+    payload['content'] = content_json
+    
+    if caption:
+        payload['caption'] = caption
+    if parse_mode:
+        payload['parse_mode'] = parse_mode
+    if caption_entities:
+        payload['caption_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(caption_entities))
+    if areas:
+        payload['areas'] = json.dumps([area.to_json() for area in areas])
+    return _make_request(token, method_url, params=payload, files=files, method='post')
+
+def delete_story(token, business_connection_id, story_id):
+    method_url = 'deleteStory'
+    payload = {'business_connection_id': business_connection_id, 'story_id': story_id}
+    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

@@ -8120,6 +8120,126 @@ async def transfer_gift(
             new_owner_chat_id=new_owner_chat_id,
             star_count=star_count
         )
+    
+    async def post_story(
+            self, business_connection_id: str, content: types.InputStoryContent,
+            active_period: int, caption: Optional[str]=None,
+            parse_mode: Optional[str]=None,
+            caption_entities: Optional[List[types.MessageEntity]]=None,
+            areas: Optional[List[types.StoryArea]]=None,
+            post_to_chat_page: Optional[bool]=None,
+            protect_content: Optional[bool]=None) -> types.Story:
+
+        """
+        Posts a story on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns Story on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#poststory
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param content: Content of the story
+        :type content: :class:`telebot.types.InputStoryContent`
+
+        :param active_period: Period after which the story is moved to the archive, in seconds; must be one of 6 * 3600, 12 * 3600, 86400, or 2 * 86400
+        :type active_period: :obj:`int`
+
+        :param caption: Caption of the story, 0-2048 characters after entities parsing
+        :type caption: :obj:`str`
+
+        :param parse_mode: Mode for parsing entities in the story caption. See formatting options for more details.
+        :type parse_mode: :obj:`str`
+
+        :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode
+        :type caption_entities: :obj:`list` of :class:`telebot.types.MessageEntity`
+
+        :param areas: A JSON-serialized list of clickable areas to be shown on the story
+        :type areas: :obj:`list` of :class:`telebot.types.StoryArea`
+
+        :param post_to_chat_page: Pass True to keep the story accessible after it expires
+        :type post_to_chat_page: :obj:`bool`
+
+        :param protect_content: Pass True if the content of the story must be protected from forwarding and screenshotting
+        :type protect_content: :obj:`bool`
+
+        :return: On success, a Story object is returned.
+        :rtype: :class:`telebot.types.Story`
+        """
+        return types.Story.de_json(
+            await asyncio_helper.post_story(
+                self.token, business_connection_id, content,
+                active_period, caption=caption,
+                parse_mode=parse_mode,
+                caption_entities=caption_entities,
+                areas=areas,
+                post_to_chat_page=post_to_chat_page,
+                protect_content=protect_content
+            )
+        )
+
+    async def edit_story(
+            self, business_connection_id: str, story_id: int,
+            content: types.InputStoryContent,
+            caption: Optional[str]=None,
+            parse_mode: Optional[str]=None,
+            caption_entities: Optional[List[types.MessageEntity]]=None,
+            areas: Optional[List[types.StoryArea]]=None) -> types.Story:
+        """
+        Edits a story previously posted by the bot on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns Story on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#editstory
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param story_id: Unique identifier of the story to edit
+        :type story_id: :obj:`int`
+
+        :param content: Content of the story
+        :type content: :class:`telebot.types.InputStoryContent`
+
+        :param caption: Caption of the story, 0-2048 characters after entities parsing
+        :type caption: :obj:`str`
+
+        :param parse_mode: Mode for parsing entities in the story caption. See formatting options for more details.
+        :type parse_mode: :obj:`str`
+
+        :param caption_entities: A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode
+        :type caption_entities: :obj:`list` of :class:`telebot.types.MessageEntity`
+
+        :param areas: A JSON-serialized list of clickable areas to be shown on the story
+        :type areas: :obj:`list` of :class:`telebot.types.StoryArea`
+
+        :return: On success, a Story object is returned.
+        :rtype: :class:`telebot.types.Story`
+
+        """
+        return types.Story.de_json(
+            await asyncio_helper.edit_story(
+                self.token, business_connection_id, story_id,
+                content, caption=caption,
+                parse_mode=parse_mode,
+                caption_entities=caption_entities,
+                areas=areas
+            )
+    )
+
+    async def delete_story(self, business_connection_id: str, story_id: int) -> bool:
+        """
+        Deletes a story previously posted by the bot on behalf of a managed business account. Requires the can_manage_stories business bot right. Returns True on success.
+        
+        Telegram documentation: https://core.telegram.org/bots/api#deletestory
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param story_id: Unique identifier of the story to delete
+        :type story_id: :obj:`int`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return await asyncio_helper.delete_story(self.token, business_connection_id, story_id)
 
     async def get_available_gifts(self) -> types.Gifts:
         """

telebot/asyncio_helper.py

@@ -2063,6 +2063,51 @@ async def transfer_gift(token, business_connection_id, owned_gift_id, new_owner_
         payload['star_count'] = star_count
     return await _process_request(token, method_url, params=payload, method='post')
 
+async def post_story(token, business_connection_id, content, active_period, caption=None, parse_mode=None,
+             caption_entities=None, areas=None, post_to_chat_page=None, protect_content=None):
+    method_url = 'postStory'
+    payload = {'business_connection_id': business_connection_id, 'active_period': active_period}
+    
+    content_json, files = content.convert_input_story()
+    payload['content'] = content_json
+    
+    if caption:
+        payload['caption'] = caption
+    if parse_mode:
+        payload['parse_mode'] = parse_mode
+    if caption_entities:
+        payload['caption_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(caption_entities))
+    if areas:
+        payload['areas'] = json.dumps([area.to_json() for area in areas])
+    if post_to_chat_page is not None:
+        payload['post_to_chat_page'] = post_to_chat_page
+    if protect_content is not None:
+        payload['protect_content'] = protect_content
+    return await _process_request(token, method_url, params=payload, files=files, method='post')
+
+async def edit_story(token, business_connection_id, story_id, content, caption=None, parse_mode=None,
+                caption_entities=None, areas=None):
+    method_url = 'editStory'
+    payload = {'business_connection_id': business_connection_id, 'story_id': story_id}
+    
+    content_json, files = content.convert_input_story()
+    payload['content'] = content_json
+    
+    if caption:
+        payload['caption'] = caption
+    if parse_mode:
+        payload['parse_mode'] = parse_mode
+    if caption_entities:
+        payload['caption_entities'] = json.dumps(types.MessageEntity.to_list_of_dicts(caption_entities))
+    if areas:
+        payload['areas'] = json.dumps([area.to_json() for area in areas])
+    return await _process_request(token, method_url, params=payload, files=files, method='post')
+
+async def delete_story(token, business_connection_id, story_id):
+    method_url = 'deleteStory'
+    payload = {'business_connection_id': business_connection_id, 'story_id': story_id}
+    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)