messages.ForwardMessages

class pyrogram.raw.functions.messages.ForwardMessages

Forwards messages by their IDs.

Details:
  • Layer: 223

  • ID: 13704A7C

Parameters:
  • from_peer (InputPeer) – Source of messages

  • id (List of int 32-bit) – IDs of messages

  • random_id (List of int 64-bit) – Random ID to prevent resending of messages

  • to_peer (InputPeer) – Destination peer

  • silent (bool, optional) – Whether to send messages silently (no notification will be triggered on the destination clients)

  • background (bool, optional) – Whether to send the message in background

  • with_my_score (bool, optional) – When forwarding games, whether to include your score in the game

  • drop_author (bool, optional) – Whether to forward messages without quoting the original author

  • drop_media_captions (bool, optional) – Whether to strip captions from media

  • noforwards (bool, optional) – Only for bots, disallows further re-forwarding and saving of the messages, even if the destination chat doesn’t have content protection enabled

  • allow_paid_floodskip (bool, optional) – Bots only: if set, allows sending up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot’s balance.

  • top_msg_id (int 32-bit, optional) – Destination forum topic

  • reply_to (InputReplyTo, optional) – Can only contain an inputReplyToMonoForum, to forward messages to a monoforum topic (mutually exclusive with top_msg_id).

  • schedule_date (int 32-bit, optional) – Scheduled message date for scheduled messages

  • schedule_repeat_period (int 32-bit, optional)

  • send_as (InputPeer, optional) – Forward the messages as the specified peer

  • quick_reply_shortcut (InputQuickReplyShortcut, optional) – Add the messages to the specified quick reply shortcut », instead.

  • effect (int 64-bit, optional)

  • video_timestamp (int 32-bit, optional) – Start playing the video at the specified timestamp (seconds).

  • allow_paid_stars (int 64-bit, optional) – For paid messages », specifies the amount of Telegram Stars the user has agreed to pay in order to send the message.

  • suggested_post (SuggestedPost, optional) – Used to suggest a post to a channel, see here » for more info on the full flow.

Returns:

Updates

TL Schema

messages.forwardMessages#13704a7c
flags:#
silent:flags.5?true
background:flags.6?true
with_my_score:flags.8?true
drop_author:flags.11?true
drop_media_captions:flags.12?true
noforwards:flags.14?true
allow_paid_floodskip:flags.19?true
from_peer:InputPeer
id:Vector<int>
random_id:Vector<long>
to_peer:InputPeer
top_msg_id:flags.9?int
reply_to:flags.22?InputReplyTo
schedule_date:flags.10?int
schedule_repeat_period:flags.24?int
send_as:flags.13?InputPeer
quick_reply_shortcut:flags.17?InputQuickReplyShortcut
effect:flags.18?long
video_timestamp:flags.20?int
allow_paid_stars:flags.21?long
suggested_post:flags.23?SuggestedPost

= Updates

Parameter Tree

ForwardMessages
├── silenttrue (optional)
├── backgroundtrue (optional)
├── with_my_scoretrue (optional)
├── drop_authortrue (optional)
├── drop_media_captionstrue (optional)
├── noforwardstrue (optional)
├── allow_paid_floodskiptrue (optional)
├── from_peerInputPeer
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_idlong
│ ├── InputPeerUser
│ │ ├── user_idlong
│ │ └── access_hashlong
│ ├── InputPeerChannel
│ │ ├── channel_idlong
│ │ └── access_hashlong
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_idint
│ │ └── user_idlong
│ ├── peerInputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_idint
│ └── channel_idlong
├── idVector < int >
├── random_idVector < long >
├── to_peerInputPeer
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_idlong
│ ├── InputPeerUser
│ │ ├── user_idlong
│ │ └── access_hashlong
│ ├── InputPeerChannel
│ │ ├── channel_idlong
│ │ └── access_hashlong
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_idint
│ │ └── user_idlong
│ ├── peerInputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_idint
│ └── channel_idlong
├── top_msg_idint (optional)
├── reply_toInputReplyTo (optional)
│ ├── InputReplyToMessage
│ │ ├── reply_to_msg_idint
│ │ ├── top_msg_idint (optional)
│ │ ├── reply_to_peer_idInputPeer (optional)
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── quote_textstring (optional)
│ │ ├── quote_entitiesVector < MessageEntity > (optional)
│ │ │ ├── MessageEntityUnknown
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityMention
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityHashtag
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityBotCommand
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityUrl
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityEmail
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityBold
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityItalic
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityCode
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityPre
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── languagestring
│ │ │ ├── MessageEntityTextUrl
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── urlstring
│ │ │ ├── MessageEntityMentionName
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── user_idlong
│ │ │ ├── InputMessageEntityMentionName
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── user_idInputUser
│ │ │ │ ├── InputUserEmpty
│ │ │ │ ├── InputUserSelf
│ │ │ │ ├── InputUser
│ │ │ │ └── InputUserFromMessage
│ │ │ ├── MessageEntityPhone
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityCashtag
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityUnderline
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityStrike
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityBankCard
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntitySpoiler
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ ├── MessageEntityCustomEmoji
│ │ │ │ ├── offsetint
│ │ │ │ ├── lengthint
│ │ │ │ └── document_idlong
│ │ │ ├── MessageEntityBlockquote
│ │ │ │ ├── collapsedtrue (optional)
│ │ │ │ ├── offsetint
│ │ │ │ └── lengthint
│ │ │ └── MessageEntityFormattedDate
│ │ │ ├── relativetrue (optional)
│ │ │ ├── short_timetrue (optional)
│ │ │ ├── long_timetrue (optional)
│ │ │ ├── short_datetrue (optional)
│ │ │ ├── long_datetrue (optional)
│ │ │ ├── day_of_weektrue (optional)
│ │ │ ├── offsetint
│ │ │ ├── lengthint
│ │ │ └── dateint
│ │ ├── quote_offsetint (optional)
│ │ ├── monoforum_peer_idInputPeer (optional)
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ └── todo_item_idint (optional)
│ ├── InputReplyToStory
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ └── story_idint
│ └── InputReplyToMonoForum
│ └── monoforum_peer_idInputPeer
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ ├── InputPeerUser
│ ├── InputPeerChannel
├── schedule_dateint (optional)
├── schedule_repeat_periodint (optional)
├── send_asInputPeer (optional)
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_idlong
│ ├── InputPeerUser
│ │ ├── user_idlong
│ │ └── access_hashlong
│ ├── InputPeerChannel
│ │ ├── channel_idlong
│ │ └── access_hashlong
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_idint
│ │ └── user_idlong
│ ├── peerInputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_idint
│ └── channel_idlong
├── quick_reply_shortcutInputQuickReplyShortcut (optional)
│ │ └── shortcutstring
│ └── shortcut_idint
├── effectlong (optional)
├── video_timestampint (optional)
├── allow_paid_starslong (optional)
└── suggested_postSuggestedPost (optional)
└── SuggestedPost
├── acceptedtrue (optional)
├── rejectedtrue (optional)
├── priceStarsAmount (optional)
│ ├── StarsAmount
│ │ ├── amountlong
│ │ └── nanosint
│ └── StarsTonAmount
│ └── amountlong
└── schedule_dateint (optional)

Example

await app.invoke(
    ForwardMessages(
        silent=None,
        background=None,
        with_my_score=None,
        drop_author=None,
        drop_media_captions=None,
        noforwards=None,
        allow_paid_floodskip=None,
        from_peer=await app.resolve_peer(chat_id),
        id=[0],
        random_id=[app.rnd_id()],
        to_peer=await app.resolve_peer(chat_id),
        top_msg_id=0,
        reply_to=InputReplyToMessage(
            reply_to_msg_id=0,
            top_msg_id=None,
            reply_to_peer_id=None,
            quote_text=None,
            quote_entities=None,
            quote_offset=None,
            monoforum_peer_id=None,
            todo_item_id=None
        ),
        schedule_date=0,
        schedule_repeat_period=0,
        send_as=await app.resolve_peer(chat_id),
        quick_reply_shortcut=InputQuickReplyShortcut(shortcut="text"),
        effect=0,
        video_timestamp=0,
        allow_paid_stars=0,
        suggested_post=SuggestedPost(
            accepted=None,
            rejected=None,
            price=None,
            schedule_date=None
        ),
    )
)