OptionalallowBots only: if set, allows sending up to 1000 messages per second past the flood limits, at a Stars cost.
OptionalallowStars to pay for sending a paid message, when the recipient charges for messages.
OptionalattributesOptional attributes that override the inferred ones, like DocumentAttributeFilename and so on.
OptionalbackgroundSend this message as a background message.
OptionalbuttonsThe matrix (list of lists), row list or button to be shown after sending the message.
This parameter will only work if you have signed in as a bot. You can also pass your own ReplyMarkup here.
All the following limits apply together:
OptionalclearWhether the existing draft should be cleared or not.
OptionalcommentSimilar to replyTo, but replies in the linked group of a broadcast channel instead (effectively leaving a "comment to" the specified message).
This parameter takes precedence over replyTo.
If there is no linked chat, SG_ID_INVALID is thrown.
OptionaleffectMessage effect ID (animation/visual effect).
OptionalfileSends a message with a file attached (e.g. a photo, video, audio or document). The message may be empty.
OptionalforceWhether to send the given file as a document or not.
OptionalformattingA list of message formatting entities. When provided, the parseMode is ignored.
OptionalinvertIf true, media will be shown below the text instead of above.
OptionallinkShould the link preview be shown?
OptionalmessageThe message to be sent, or another message object to resend as a copy.
The maximum length for a message is 35,000 bytes or 4,096 characters.
Longer messages will not be sliced automatically, and you should slice them manually if the text to send is longer than said length.
OptionalnoforwardsOptionalparseSee the parseMode property for allowed values. Markdown parsing will be used by default.
OptionalquickAdd the message to a quick-reply shortcut instead of sending it. A shortcut name, shortcut ID, or a raw Api.TypeInputQuickReplyShortcut.
OptionalquoteFormatting entities of the quote. Offsets are relative to quoteText.
OptionalquoteOffset of the quote within the original message (UTF-16 code units).
OptionalquoteQuoted part of the message being replied to. Requires replyTo.
OptionalreplyWhether to reply to a message or not. If an integer is provided, it should be the ID of the message that it should reply to.
Also accepts a raw Api.TypeInputReplyTo for full control (stories, monoforums, todo items).
OptionalreplyChat where the quoted message was sent, for quoting messages from other chats.
OptionalrichRich message content (Layer 228): tables, headings, lists, inline media.
Build it with the Rich helpers — Rich.markdown("# hi"), Rich.html("<h1>hi</h1>") (server-side parsing), or Rich.blocks([...]). Only for plain text messages.
OptionalscheduleIf set, the message won't send immediately, and instead it will be scheduled to be automatically sent at a later time.
OptionalscheduleRepeat period (in seconds) for recurring scheduled messages. Requires schedule.
OptionalsendSend the message as a specific entity (channel/user).
OptionalsilentWhether the message should notify people in a broadcast channel or not. Defaults to false, which means it will notify them. Set it to True to alter this behaviour.
OptionalsuggestedSuggested-post metadata for direct-messages channels.
OptionalsupportWhether the sent video supports streaming or not.
Note that Telegram only recognizes as streamable some formats like MP4, and others like AVI or MKV will not work.
You should convert these to MP4 before sending if you want them to be streamable. Unsupported formats will result in VideoContentTypeError.
OptionalthumbOptional JPEG thumbnail (for documents). Telegram will ignore this parameter unless you pass a .jpg file!
The file must also be small in dimensions and in disk size. Successful thumbnails were files below 20kB and 320x320px.
Width/height and dimensions/size ratios may be important.
For Telegram to accept a thumbnail, you must provide the dimensions of the underlying media through attributes: with DocumentAttributesVideo.
OptionaltopUsed for threads to reply to a specific thread
OptionalupdateWhether the order of the user's sticker sets should be updated when a sticker is sent.
Interface for sending a message. only message is required