Stories

[SpEcHiDe]

• Added the classes InputStoryContentPhoto and InputStoryContentVideo representing the content of a story to post.
• Added the classes StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather,StoryAreaTypeUniqueGift, StoryAreaTypeFoundVenue and StoryAreaTypeMessage describing clickable active areas on stories.
• Added the method post_story allowing bots to post a story on behalf of a managed business account.
• Added the methods edit_story and edit_business_story allowing bots to edit stories they had previously posted on behalf of a managed business account.
• Added the methods delete_stories and delete_business_story allowing bots to delete stories they had previously posted on behalf of a managed business account.
• Added the classes StoryPrivacySettings StoryPrivacySettingsEveryone StoryPrivacySettingsContacts StoryPrivacySettingsCloseFriends StoryPrivacySettingsSelectedUsers to describe the privacy settings of a story.
• Renamed attributes in story?
• Added the method can_post_story and the classes CanPostStoryResult CanPostStoryResultOk CanPostStoryResultPremiumNeeded CanPostStoryResultBoostNeeded CanPostStoryResultActiveStoryLimitExceeded CanPostStoryResultWeeklyLimitExceeded CanPostStoryResultMonthlyLimitExceeded to check whether the current user can post a story on behalf of a chat.
• Added the method hide_my_story_view for Telegram Premium users and the type StoryStealthMode.
• Add support for parsing story link in get_messages
• Add forward_story
• Add toggle_story_is_posted_to_chat_page
• Add get_chat_active_stories and get_chat_archived_stories.
• Added the classes StoryRepostInfo, StoryOrigin, StoryOriginHiddenUser, StoryOriginPublicStory

[Copilot]

Pull Request Overview

This PR introduces new Story-related classes and methods, such as posting, editing, deleting, and managing stories, and also improves the story link parsing in get_messages. Additionally, the PR updates multiple messaging methods to use a safer and more consistent pattern when retrieving business connection objects.

• Updated business connection retrieval in several messaging methods by replacing direct indexing with a .get() method and explicit None checks.
• Added support for parsing story links in get_messages.
• Updated documentation to include the new Story API.

Reviewed Changes

Copilot reviewed 70 out of 70 changed files in this pull request and generated 16 comments.

Show a summary per file

File	Description
pyrogram/methods/messages/send_video.py	Updates business connection retrieval logic.
pyrogram/methods/messages/send_sticker.py	Updates business connection retrieval logic.
pyrogram/methods/messages/send_photo.py	Updates business connection retrieval logic.
pyrogram/methods/messages/send_paid_media.py	Updates business connection retrieval logic.
pyrogram/methods/messages/send_message.py	Updates business connection retrieval logic.
pyrogram/methods/messages/send_media_group.py	Updates business connection retrieval logic.
pyrogram/methods/messages/send_document.py	Updates business connection retrieval logic.
pyrogram/methods/messages/send_audio.py	Updates business connection retrieval logic.
pyrogram/methods/messages/send_animation.py	Updates business connection retrieval logic.
pyrogram/methods/messages/edit_message_text.py	Updates business connection retrieval logic.
pyrogram/methods/messages/edit_message_reply_markup.py	Updates business connection retrieval logic.
pyrogram/methods/messages/edit_message_media.py	Updates business connection retrieval logic.
pyrogram/methods/messages/edit_cached_media.py	Updates business connection retrieval logic.
pyrogram/methods/chats/unpin_chat_message.py	Updates business connection retrieval logic.
pyrogram/methods/chats/pin_chat_message.py	Updates business connection retrieval logic and slight indentation fix.
pyrogram/methods/business/get_owned_star_count.py	Updates business connection retrieval logic.
pyrogram/methods/messages/get_messages.py	Adds new branch to handle story links and standardizes error messages for bots in story links.

Comments suppressed due to low confidence (1)

pyrogram/methods/messages/get_messages.py:152

• [nitpick] The error message for story link parsing is clear, though consider reviewing consistency with other link parsing error messages. Ensure that this message is documented appropriately in the API reference.

raise ValueError("Invalid ClientType used to parse this story link")