stories.SendStory

class pyrogram.raw.functions.stories.SendStory

Uploads a Telegram Story.

Details:

• Layer: 223

• ID: 737FC2EC

Parameters:

• peer (InputPeer) – The peer to send the story as.

• media (InputMedia) – The story media.

• privacy_rules (List of InputPrivacyRule) – Privacy rules for the story, indicating who can or can’t view the story.

• random_id (int 64-bit) – Unique client message ID required to prevent message resending.

• pinned (bool, optional) – Whether to add the story to the profile automatically upon expiration. If not set, the story will only be added to the archive, see here » for more info.

• noforwards (bool, optional) – If set, disables forwards, screenshots, and downloads.

• fwd_modified (bool, optional) – Set this flag when reposting stories with fwd_from_id+fwd_from_id, if the media was modified before reposting.

• media_areas (List of MediaArea, optional) – Media areas associated to the story, see here » for more info.

• caption (str, optional) – Story caption.

• entities (List of MessageEntity, optional) – Message entities for styled text, if allowed by the stories_entities client configuration parameter ».

• period (int 32-bit, optional) – Period after which the story is moved to archive (and to the profile if pinned is set), in seconds; must be one of 6 * 3600, 12 * 3600, 86400, or 2 * 86400 for Telegram Premium users, and 86400 otherwise.

• fwd_from_id (InputPeer, optional) – If set, indicates that this story is a repost of story with ID fwd_from_story posted by the peer in fwd_from_id.

• fwd_from_story (int 32-bit, optional) – If set, indicates that this story is a repost of story with ID fwd_from_story posted by the peer in fwd_from_id.

• albums (List of int 32-bit, optional) – If set, adds the story to the specified albums.

Returns:

Updates

TL Schema

stories.sendStory#737fc2ec
flags:#
pinned:flags.2?true
noforwards:flags.4?true
fwd_modified:flags.7?true
peer:InputPeer
media:InputMedia
media_areas:flags.5?Vector<MediaArea>
caption:flags.0?string
entities:flags.1?Vector<MessageEntity>
privacy_rules:Vector<InputPrivacyRule>
random_id:long
period:flags.3?int
fwd_from_id:flags.6?InputPeer
fwd_from_story:flags.6?int
albums:flags.8?Vector<int>

= Updates

Parameter Tree

Example

await app.invoke(
    SendStory(
        pinned=None,
        noforwards=None,
        fwd_modified=None,
        peer=await app.resolve_peer(chat_id),
        media=InputMediaEmpty(),
        media_areas=[
                MediaAreaVenue(
                    coordinates=MediaAreaCoordinates(
                        x=0.0,
                        y=0.0,
                        w=0.0,
                        h=0.0,
                        rotation=0.0,
                        radius=None
                    ),
                    geo=GeoPointEmpty(),
                    title="text",
                    address="text",
                    provider="text",
                    venue_id="text",
                    venue_type="text"
                )
            ],
        caption="text",
        entities=[
                MessageEntityUnknown(
                    offset=0,
                    length=0
                )
            ],
        privacy_rules=[
                InputPrivacyValueAllowContacts()
            ],
        random_id=app.rnd_id(),
        period=0,
        fwd_from_id=await app.resolve_peer(chat_id),
        fwd_from_story=0,
        albums=[0],
    )
)