TelegramPlayground · SpEcHiDe · May 9, 2025 · Apr 15, 2025 · Apr 17, 2025 · Apr 17, 2025
diff --git a/compiler/docs/compiler.py b/compiler/docs/compiler.py
@@ -390,7 +390,18 @@ def get_title_list(s: str) -> list:
         """,
         stories="""
         Stories
+            can_post_story
             get_stories
+            get_chat_active_stories
+            get_chat_archived_stories
+            post_story
+            edit_story
+            edit_business_story
+            delete_stories
+            delete_business_story
+            hide_my_story_view
+            forward_story
+            toggle_story_is_posted_to_chat_page
         """,
         payments="""
         Payments
@@ -691,7 +702,41 @@ def get_title_list(s: str) -> list:
             PaidReactionTypeAnonymous
             PaidReactionTypeChat
             PaidReactionTypeRegular
-        """
+        """,
+        stories="""
+        Stories
+            CanPostStoryResult
+            CanPostStoryResultOk
+            CanPostStoryResultPremiumNeeded
+            CanPostStoryResultBoostNeeded
+            CanPostStoryResultActiveStoryLimitExceeded
+            CanPostStoryResultWeeklyLimitExceeded
+            CanPostStoryResultMonthlyLimitExceeded
+            InputStoryContent
+            InputStoryContentPhoto
+            InputStoryContentVideo
+            StoryAreaPosition
+            LocationAddress
+            StoryAreaType
+            StoryAreaTypeFoundVenue
+            StoryAreaTypeLocation
+            StoryAreaTypeSuggestedReaction
+            StoryAreaTypeLink
+            StoryAreaTypeMessage
+            StoryAreaTypeWeather
+            StoryAreaTypeUniqueGift
+            StoryArea
+            StoryRepostInfo
+            StoryOrigin
+            StoryOriginHiddenUser
+            StoryOriginPublicStory
+            StoryPrivacySettings
+            StoryPrivacySettingsEveryone
+            StoryPrivacySettingsContacts
+            StoryPrivacySettingsCloseFriends
+            StoryPrivacySettingsSelectedUsers
+            StoryStealthMode
+        """,
     )
 
     root = PYROGRAM_API_DEST + "/types"

diff --git a/compiler/docs/template/types.rst b/compiler/docs/template/types.rst
@@ -163,3 +163,16 @@ Payments
     :hidden:
 
     {payments}
+
+Stories
+--------
+
+.. autosummary::
+    :nosignatures:
+
+    {stories}
+
+.. toctree::
+    :hidden:
+
+    {stories}
diff --git a/docs/source/releases/changes-in-this-fork.rst b/docs/source/releases/changes-in-this-fork.rst
@@ -41,6 +41,14 @@ Changes in this Fork
 | Scheme layer used: 202 |
 +------------------------+
 
+- Added the method :meth:`~pyrogram.Client.post_story` allowing bots to post a story on behalf of a managed business account.
+- Added the method :meth:`~pyrogram.Client.edit_story` and :meth:`~pyrogram.Client.edit_business_story`, allowing bots to edit stories they had previously posted on behalf of a managed business account.
+- Added the methods :meth:`~pyrogram.Client.delete_stories` and :meth:`~pyrogram.Client.delete_business_story`, allowing bots to delete stories they had previously posted on behalf of a managed business account.
+- Added the classes :obj:`~pyrogram.types.InputStoryContentPhoto` and :obj:`~pyrogram.types.InputStoryContentVideo` representing the content of a story to post.
+- Added the classes :obj:`~pyrogram.types.StoryArea`, :obj:`~pyrogram.types.StoryAreaPosition`, :obj:`~pyrogram.types.LocationAddress`, :obj:`~pyrogram.types.StoryAreaTypeLocation`, :obj:`~pyrogram.types.StoryAreaTypeSuggestedReaction`, :obj:`~pyrogram.types.StoryAreaTypeLink`, :obj:`~pyrogram.types.StoryAreaTypeWeather`, :obj:`~pyrogram.types.StoryAreaTypeUniqueGift`, :obj:`~pyrogram.types.StoryAreaTypeFoundVenue` and :obj:`~pyrogram.types.StoryAreaTypeMessage` describing clickable active areas on stories.
+- Added the classes :obj:`~pyrogram.types.StoryPrivacySettings`, :obj:`~pyrogram.types.StoryPrivacySettingsEveryone`, :obj:`~pyrogram.types.StoryPrivacySettingsContacts`, :obj:`~pyrogram.types.StoryPrivacySettingsCloseFriends`, :obj:`~pyrogram.types.StoryPrivacySettingsSelectedUsers` to describe the privacy settings of a story.
+- Added the methods :meth:`~pyrogram.Client.can_post_story`, :meth:`~pyrogram.Client.hide_my_story_view`, :meth:`~pyrogram.Client.forward_story`,  :meth:`~pyrogram.Client.toggle_story_is_posted_to_chat_page`,  :meth:`~pyrogram.Client.get_chat_active_stories`,  :meth:`~pyrogram.Client.get_chat_archived_stories`.
+- Add support for parsing story links in :meth:`~pyrogram.Client.get_messages`.
 - View `new and changed <https://telegramplayground.github.io/TG-APIs/TL/diff/tdlib.html?from=201&to=202>`__ `raw API methods <https://telegramplayground.github.io/TG-APIs/TL/diff/tdesktop.html?from=200&to=202>`__.
 
 +------------------------+

diff --git a/pyrogram/methods/business/get_owned_star_count.py b/pyrogram/methods/business/get_owned_star_count.py
@@ -83,8 +83,8 @@ async def get_business_account_star_balance(
         if not business_connection_id:
             raise ValueError("business_connection_id is required")
 
-        business_connection = self.business_user_connection_cache[business_connection_id]
-        if not business_connection:
+        business_connection = self.business_user_connection_cache.get(business_connection_id)
+        if business_connection is None:
             business_connection = await self.get_business_connection(business_connection_id)
         r = await self.invoke(
             raw.functions.InvokeWithBusinessConnection(

diff --git a/pyrogram/methods/chats/pin_chat_message.py b/pyrogram/methods/chats/pin_chat_message.py
@@ -79,8 +79,8 @@ async def pin_chat_message(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+        if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/chats/unpin_chat_message.py b/pyrogram/methods/chats/unpin_chat_message.py
@@ -66,8 +66,8 @@ async def unpin_chat_message(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/messages/edit_cached_media.py b/pyrogram/methods/messages/edit_cached_media.py
@@ -110,8 +110,8 @@ async def edit_cached_media(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/messages/edit_message_media.py b/pyrogram/methods/messages/edit_message_media.py
@@ -309,8 +309,8 @@ async def edit_message_media(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/messages/edit_message_reply_markup.py b/pyrogram/methods/messages/edit_message_reply_markup.py
@@ -73,8 +73,8 @@ async def edit_message_reply_markup(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/messages/edit_message_text.py b/pyrogram/methods/messages/edit_message_text.py
@@ -134,8 +134,8 @@ async def edit_message_text(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/messages/get_messages.py b/pyrogram/methods/messages/get_messages.py
@@ -143,6 +143,28 @@ async def get_messages(
                         int(linkps[4])
                     )
                     message_id = int(linkps[5])
+                elif linkps[4] == "s":
+                    # https://t.me/yehudalev/s/1
+                    if (
+                        self.me and
+                        self.me.is_bot
+                    ):
+                        raise ValueError(
+                            "Invalid ClientType used to parse this story link"
+                        )
+                    raw_chat_id = linkps[3]
+                    story_id = int(linkps[5])
+
+                    story = await self.get_stories(
+                        story_poster_chat_id=raw_chat_id,
+                        story_ids=story_id
+                    )
+                    return types.Message(
+                        client=self,
+                        id=0,
+                        story=story,
+                        empty=True
+                    )
                 else:
                     # https://t.me/TheForum/322/487
                     raw_chat_id = linkps[3]
@@ -192,7 +214,7 @@ async def get_messages(
                 raw_chat_id = linkps[3]
                 if raw_chat_id == "m":
                     raise ValueError(
-                        "Invalid ClientType used to parse this message link"
+                        "Invalid ClientType used to parse this link to start chat"
                     )
                 message_id = int(linkps[4])
 

diff --git a/pyrogram/methods/messages/send_animation.py b/pyrogram/methods/messages/send_animation.py
@@ -312,8 +312,8 @@ async def progress(current, total):
             session = None
             business_connection = None
             if business_connection_id:
-                business_connection = self.business_user_connection_cache[business_connection_id]
-                if not business_connection:
+                business_connection = self.business_user_connection_cache.get(business_connection_id)
+                if business_connection is None:
                     business_connection = await self.get_business_connection(business_connection_id)
                 session = await get_session(
                     self,

diff --git a/pyrogram/methods/messages/send_audio.py b/pyrogram/methods/messages/send_audio.py
@@ -280,8 +280,8 @@ async def progress(current, total):
             session = None
             business_connection = None
             if business_connection_id:
-                business_connection = self.business_user_connection_cache[business_connection_id]
-                if not business_connection:
+                business_connection = self.business_user_connection_cache.get(business_connection_id)
+                if business_connection is None:
                     business_connection = await self.get_business_connection(business_connection_id)
                 session = await get_session(
                     self,

diff --git a/pyrogram/methods/messages/send_document.py b/pyrogram/methods/messages/send_document.py
@@ -272,8 +272,8 @@ async def progress(current, total):
             session = None
             business_connection = None
             if business_connection_id:
-                business_connection = self.business_user_connection_cache[business_connection_id]
-                if not business_connection:
+                business_connection = self.business_user_connection_cache.get(business_connection_id)
+                if business_connection is None:
                     business_connection = await self.get_business_connection(business_connection_id)
                 session = await get_session(
                     self,

diff --git a/pyrogram/methods/messages/send_media_group.py b/pyrogram/methods/messages/send_media_group.py
@@ -475,8 +475,8 @@ async def send_media_group(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/messages/send_message.py b/pyrogram/methods/messages/send_message.py
@@ -199,8 +199,8 @@ async def send_message(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/messages/send_paid_media.py b/pyrogram/methods/messages/send_paid_media.py
@@ -337,8 +337,8 @@ async def send_paid_media(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/messages/send_photo.py b/pyrogram/methods/messages/send_photo.py
@@ -258,8 +258,8 @@ async def send_photo(
             session = None
             business_connection = None
             if business_connection_id:
-                business_connection = self.business_user_connection_cache[business_connection_id]
-                if not business_connection:
+                business_connection = self.business_user_connection_cache.get(business_connection_id)
+                if business_connection is None:
                     business_connection = await self.get_business_connection(business_connection_id)
                 session = await get_session(
                     self,

diff --git a/pyrogram/methods/messages/send_sticker.py b/pyrogram/methods/messages/send_sticker.py
@@ -246,8 +246,8 @@ async def send_sticker(
             session = None
             business_connection = None
             if business_connection_id:
-                business_connection = self.business_user_connection_cache[business_connection_id]
-                if not business_connection:
+                business_connection = self.business_user_connection_cache.get(business_connection_id)
+                if business_connection is None:
                     business_connection = await self.get_business_connection(business_connection_id)
                 session = await get_session(
                     self,

diff --git a/pyrogram/methods/messages/send_video.py b/pyrogram/methods/messages/send_video.py
@@ -381,8 +381,8 @@ async def progress(current, total):
             session = None
             business_connection = None
             if business_connection_id:
-                business_connection = self.business_user_connection_cache[business_connection_id]
-                if not business_connection:
+                business_connection = self.business_user_connection_cache.get(business_connection_id)
+                if business_connection is None:
                     business_connection = await self.get_business_connection(business_connection_id)
                 session = await get_session(
                     self,

diff --git a/pyrogram/methods/messages/send_video_note.py b/pyrogram/methods/messages/send_video_note.py
@@ -274,8 +274,8 @@ async def send_video_note(
             session = None
             business_connection = None
             if business_connection_id:
-                business_connection = self.business_user_connection_cache[business_connection_id]
-                if not business_connection:
+                business_connection = self.business_user_connection_cache.get(business_connection_id)
+                if business_connection is None:
                     business_connection = await self.get_business_connection(business_connection_id)
                 session = await get_session(
                     self,

diff --git a/pyrogram/methods/messages/send_voice.py b/pyrogram/methods/messages/send_voice.py
@@ -270,8 +270,8 @@ async def send_voice(
             session = None
             business_connection = None
             if business_connection_id:
-                business_connection = self.business_user_connection_cache[business_connection_id]
-                if not business_connection:
+                business_connection = self.business_user_connection_cache.get(business_connection_id)
+                if business_connection is None:
                     business_connection = await self.get_business_connection(business_connection_id)
                 session = await get_session(
                     self,

diff --git a/pyrogram/methods/messages/stop_poll.py b/pyrogram/methods/messages/stop_poll.py
@@ -82,8 +82,8 @@ async def stop_poll(
         session = None
         business_connection = None
         if business_connection_id:
-            business_connection = self.business_user_connection_cache[business_connection_id]
-            if not business_connection:
+            business_connection = self.business_user_connection_cache.get(business_connection_id)
+            if business_connection is None:
                 business_connection = await self.get_business_connection(business_connection_id)
             session = await get_session(
                 self,

diff --git a/pyrogram/methods/stories/__init__.py b/pyrogram/methods/stories/__init__.py
@@ -1,5 +1,5 @@
 #  Pyrogram - Telegram MTProto API Client Library for Python
-#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#  Copyright (C) 2017-present <https://github.com/TelegramPlayGround>
 #
 #  This file is part of Pyrogram.
 #
@@ -17,9 +17,27 @@
 #  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
 
+from .can_post_story import CanPostStory
+from .delete_stories import DeleteStories
+from .edit_story import EditStory
+from .forward_story import ForwardStory
+from .get_chat_active_stories import GetChatActiveStories
+from .get_chat_archived_stories import GetChatArchivedStories
 from .get_stories import GetStories
+from .hide_my_story_view import HideMyStoryView
+from .post_story import PostStory
+from .toggle_story_is_posted_to_chat_page import ToggleStoryIsPostedToChatPage
 
 class Stories(
+    CanPostStory,
+    DeleteStories,
+    EditStory,
+    ForwardStory,
+    GetChatActiveStories,
+    GetChatArchivedStories,
     GetStories,
+    HideMyStoryView,
+    PostStory,
+    ToggleStoryIsPostedToChatPage,
 ):
     pass