messages.SendMessage

class pyrogram.raw.functions.messages.SendMessage

Sends a message to a chat

Details:
  • Layer: 223

  • ID: 545CD15A

Parameters:
  • peer (InputPeer) – The destination where the message will be sent

  • message (str) – The message

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

  • no_webpage (bool, optional) – Set this flag to disable generation of the webpage preview

  • silent (bool, optional) – Send this message silently (no notifications for the receivers)

  • background (bool, optional) – Send this message as background message

  • clear_draft (bool, optional) – Clear the draft field

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

  • update_stickersets_order (bool, optional) – Whether to move used stickersets to top, see here for more info on this flag »

  • invert_media (bool, optional) – If set, any eventual webpage preview will be shown on top of the message instead of at the bottom.

  • 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.

  • reply_to (InputReplyTo, optional) – If set, indicates that the message should be sent in reply to the specified message or story. Also used to quote other messages.

  • reply_markup (ReplyMarkup, optional) – Reply markup for sending bot buttons

  • entities (List of MessageEntity, optional) – Message entities for sending styled text

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

  • schedule_repeat_period (int 32-bit, optional)

  • send_as (InputPeer, optional) – Send this message as the specified peer

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

  • effect (int 64-bit, optional) – Specifies a message effect » to use for the message.

  • 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.sendMessage#545cd15a
flags:#
no_webpage:flags.1?true
silent:flags.5?true
background:flags.6?true
clear_draft:flags.7?true
noforwards:flags.14?true
update_stickersets_order:flags.15?true
invert_media:flags.16?true
allow_paid_floodskip:flags.19?true
peer:InputPeer
reply_to:flags.0?InputReplyTo
message:string
random_id:long
reply_markup:flags.2?ReplyMarkup
entities:flags.3?Vector<MessageEntity>
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
allow_paid_stars:flags.21?long
suggested_post:flags.22?SuggestedPost

= Updates

Parameter Tree

SendMessage
├── no_webpagetrue (optional)
├── silenttrue (optional)
├── backgroundtrue (optional)
├── clear_drafttrue (optional)
├── noforwardstrue (optional)
├── update_stickersets_ordertrue (optional)
├── invert_mediatrue (optional)
├── allow_paid_floodskiptrue (optional)
├── 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
├── 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
├── messagestring
├── random_idlong
├── reply_markupReplyMarkup (optional)
│ ├── ReplyKeyboardHide
│ │ └── selectivetrue (optional)
│ │ ├── single_usetrue (optional)
│ │ ├── selectivetrue (optional)
│ │ └── placeholderstring (optional)
│ ├── ReplyKeyboardMarkup
│ │ ├── resizetrue (optional)
│ │ ├── single_usetrue (optional)
│ │ ├── selectivetrue (optional)
│ │ ├── persistenttrue (optional)
│ │ ├── rowsVector < KeyboardButtonRow >
│ │ │ └── KeyboardButtonRow
│ │ │ └── buttonsVector < KeyboardButton >
│ │ │ ├── KeyboardButton
│ │ │ ├── KeyboardButtonUrl
│ │ │ ├── KeyboardButtonCallback
│ │ │ ├── KeyboardButtonRequestPhone
│ │ │ ├── KeyboardButtonRequestGeoLocation
│ │ │ ├── KeyboardButtonSwitchInline
│ │ │ ├── KeyboardButtonGame
│ │ │ ├── KeyboardButtonBuy
│ │ │ ├── KeyboardButtonUrlAuth
│ │ │ ├── InputKeyboardButtonUrlAuth
│ │ │ ├── KeyboardButtonRequestPoll
│ │ │ ├── InputKeyboardButtonUserProfile
│ │ │ ├── KeyboardButtonUserProfile
│ │ │ ├── KeyboardButtonWebView
│ │ │ ├── KeyboardButtonSimpleWebView
│ │ │ ├── KeyboardButtonRequestPeer
│ │ │ ├── InputKeyboardButtonRequestPeer
│ │ │ └── KeyboardButtonCopy
│ │ └── placeholderstring (optional)
│ └── ReplyInlineMarkup
│ └── rowsVector < KeyboardButtonRow >
│ └── KeyboardButtonRow
│ └── buttonsVector < KeyboardButton >
│ ├── KeyboardButton
│ ├── KeyboardButtonUrl
│ ├── KeyboardButtonGame
│ ├── KeyboardButtonBuy
│ ├── KeyboardButtonUrlAuth
│ ├── KeyboardButtonWebView
│ └── KeyboardButtonCopy
├── entitiesVector < MessageEntity > (optional)
│ ├── MessageEntityUnknown
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityMention
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityHashtag
│ │ ├── offsetint
│ │ └── lengthint
│ │ ├── 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
│ │ ├── offsetint
│ │ ├── lengthint
│ │ └── user_idlong
│ │ ├── offsetint
│ │ ├── lengthint
│ │ └── user_idInputUser
│ │ ├── InputUserEmpty
│ │ ├── InputUserSelf
│ │ ├── InputUser
│ │ └── InputUserFromMessage
│ ├── MessageEntityPhone
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityCashtag
│ │ ├── offsetint
│ │ └── lengthint
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityStrike
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntityBankCard
│ │ ├── offsetint
│ │ └── lengthint
│ ├── MessageEntitySpoiler
│ │ ├── offsetint
│ │ └── lengthint
│ │ ├── offsetint
│ │ ├── lengthint
│ │ └── document_idlong
│ │ ├── collapsedtrue (optional)
│ │ ├── offsetint
│ │ └── lengthint
│ ├── relativetrue (optional)
│ ├── short_timetrue (optional)
│ ├── long_timetrue (optional)
│ ├── short_datetrue (optional)
│ ├── long_datetrue (optional)
│ ├── day_of_weektrue (optional)
│ ├── offsetint
│ ├── lengthint
│ └── dateint
├── 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)
├── 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(
    SendMessage(
        no_webpage=None,
        silent=None,
        background=None,
        clear_draft=None,
        noforwards=None,
        update_stickersets_order=None,
        invert_media=None,
        allow_paid_floodskip=None,
        peer=await app.resolve_peer(chat_id),
        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
        ),
        message="Hello",
        random_id=app.rnd_id(),
        reply_markup=ReplyInlineMarkup(rows=[
                    KeyboardButtonRow(buttons=[
                                KeyboardButtonUrl(
                                    style=None,
                                    text="Open",
                                    url="https://google.com"
                                )
                            ])
                ]),
        entities=[
                MessageEntityUnknown(
                    offset=0,
                    length=0
                )
            ],
        schedule_date=0,
        schedule_repeat_period=0,
        send_as=await app.resolve_peer(chat_id),
        quick_reply_shortcut=InputQuickReplyShortcut(shortcut="text"),
        effect=0,
        allow_paid_stars=0,
        suggested_post=SuggestedPost(
            accepted=None,
            rejected=None,
            price=None,
            schedule_date=None
        ),
    )
)