Parameters: - **message\_id** ( `int`")) – Unique message identifier inside this chat. In specific instances (e.g., message containing a video sent to a big chat), the server might automatically schedule a message instead of sending it immediately. In such cases, this field will be `0` and the relevant message will be unusable until it is actually sent. - **from\_user** ( `telegram.User`, optional) – Sender of the message; may be empty for messages sent to channels. For backward compatibility, if the message was sent on behalf of a chat, the field contains a fake sender user in non-channel chats. - **sender\_chat** ( `telegram.Chat`, optional) – Sender of the message when sent on behalf of a chat. For example, the supergroup itself for messages sent by its anonymous administrators or a linked channel for messages automatically forwarded to the channel’s discussion group. For backward compatibility, if the message was sent on behalf of a chat, the field from contains a fake sender user in non-channel chats. - **date** ( `datetime.datetime`")) – Date the message was sent in Unix time. Converted to `datetime.datetime`"). Changed in version 20.3: The default timezone of the bot is used for localization, which is UTC unless `telegram.ext.Defaults.tzinfo` is used. - **chat** ( `telegram.Chat`) – Conversation the message belongs to. - **is\_automatic\_forward** ( `bool`"), optional) – `True`"), if the message is a channel post that was automatically forwarded to the connected discussion group. Added in version 13.9. - **reply\_to\_message** ( `telegram.Message`, optional) – For replies, the original message. Note that the Message object in this field will not contain further `reply_to_message` fields even if it itself is a reply. - **edit\_date** ( `datetime.datetime`"), optional) – Date the message was last edited in Unix time. Converted to `datetime.datetime`"). Changed in version 20.3: The default timezone of the bot is used for localization, which is UTC unless `telegram.ext.Defaults.tzinfo` is used. - **has\_protected\_content** ( `bool`"), optional) – `True`"), if the message can’t be forwarded. Added in version 13.9. - **is\_from\_offline** ( `bool`"), optional) – `True`"), if the message was sent by an implicit action, for example, as an away or a greeting business message, or as a scheduled message. Added in version 21.1. - **media\_group\_id** ( `str`"), optional) – The unique identifier of a media message group this message belongs to. - **text** ( `str`"), optional) – For text messages, the actual UTF-8 text of the message, 0- `4096` characters. - **entities** (Sequence\ [`telegram.MessageEntity`\], optional) – For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text. See `parse_entity` and `parse_entities` methods for how to use properly. This list is empty if the message does not contain entities. Changed in version 20.0: Accepts any `collections.abc.Sequence`") as input instead of just a list. The input is converted to a tuple. - **link\_preview\_options** ( `telegram.LinkPreviewOptions`, optional) – Options used for link preview generation for the message, if it is a text message and link preview options were changed. Added in version 20.8. - **effect\_id** ( `str`"), optional) – Unique identifier of the message effect added to the message. Added in version 21.3. - **caption\_entities** (Sequence\ [`telegram.MessageEntity`\], optional) – For messages with a Caption. Special entities like usernames, URLs, bot commands, etc. that appear in the caption. See `Message.parse_caption_entity` and `parse_caption_entities` methods for how to use properly. This list is empty if the message does not contain caption entities. Changed in version 20.0: Accepts any `collections.abc.Sequence`") as input instead of just a list. The input is converted to a tuple. - **show\_caption\_above\_media** ( `bool`"), optional) – `True`"), if the caption must be shown above the message media. Added in version 21.3. - **audio** ( `telegram.Audio`, optional) – Message is an audio file, information about the file. - **document** ( `telegram.Document`, optional) – Message is a general file, information about the file. - **animation** ( `telegram.Animation`, optional) – Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set. - **game** ( `telegram.Game`, optional) – Message is a game, information about the game. More about games >>. - **photo** (Sequence\ [`telegram.PhotoSize`\], optional) – Message is a photo, available sizes of the photo. This list is empty if the message does not contain a photo. Changed in version 20.0: Accepts any `collections.abc.Sequence`") as input instead of just a list. The input is converted to a tuple. - **sticker** ( `telegram.Sticker`, optional) – Message is a sticker, information about the sticker. - **story** ( `telegram.Story`, optional) – Message is a forwarded story. Added in version 20.5. - **video** ( `telegram.Video`, optional) – Message is a video, information about the video. - **voice** ( `telegram.Voice`, optional) – Message is a voice message, information about the file. - **video\_note** ( `telegram.VideoNote`, optional) – Message is a video note, information about the video message. - **new\_chat\_members** (Sequence\ [`telegram.User`\], optional) – New members that were added to the group or supergroup and information about them (the bot itself may be one of these members). This list is empty if the message does not contain new chat members. Changed in version 20.0: Accepts any `collections.abc.Sequence`") as input instead of just a list. The input is converted to a tuple. - **caption** ( `str`"), optional) – Caption for the animation, audio, document, paid media, photo, video or voice, 0- `1024` characters. - **contact** ( `telegram.Contact`, optional) – Message is a shared contact, information about the contact. - **location** ( `telegram.Location`, optional) – Message is a shared location, information about the location. - **venue** ( `telegram.Venue`, optional) – Message is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set. - **left\_chat\_member** ( `telegram.User`, optional) – A member was removed from the group, information about them (this member may be the bot itself). - **new\_chat\_title** ( `str`"), optional) – A chat title was changed to this value. - **new\_chat\_photo** (Sequence\ [`telegram.PhotoSize`\], optional) – A chat photo was changed to this value. This list is empty if the message does not contain a new chat photo. Changed in version 20.0: Accepts any `collections.abc.Sequence`") as input instead of just a list. The input is converted to a tuple. - **delete\_chat\_photo** ( `bool`"), optional) – Service message: The chat photo was deleted. - **group\_chat\_created** ( `bool`"), optional) – Service message: The group has been created. - **supergroup\_chat\_created** ( `bool`"), optional) – Service message: The supergroup has been created. This field can’t be received in a message coming through updates, because bot can’t be a member of a supergroup when it is created. It can only be found in `reply_to_message` if someone replies to a very first message in a directly created supergroup. - **channel\_chat\_created** ( `bool`"), optional) – Service message: The channel has been created. This field can’t be received in a message coming through updates, because bot can’t be a member of a channel when it is created. It can only be found in `reply_to_message` if someone replies to a very first message in a channel. - **message\_auto\_delete\_timer\_changed** ( `telegram.MessageAutoDeleteTimerChanged`, optional) – Service message: auto-delete timer settings changed in the chat. Added in version 13.4. - **migrate\_to\_chat\_id** ( `int`"), optional) – The group has been migrated to a supergroup with the specified identifier. - **migrate\_from\_chat\_id** ( `int`"), optional) – The supergroup has been migrated from a group with the specified identifier. - **pinned\_message** ( `telegram.MaybeInaccessibleMessage`, optional) – Specified message was pinned. Note that the Message object in this field will not contain further `reply_to_message` fields even if it is itself a reply. Changed in version 20.8: This attribute now is either `telegram.Message` or `telegram.InaccessibleMessage`. - **invoice** ( `telegram.Invoice`, optional) – Message is an invoice for a payment, information about the invoice. More about payments >>. - **successful\_payment** ( `telegram.SuccessfulPayment`, optional) – Message is a service message about a successful payment, information about the payment. More about payments >>. - **connected\_website** ( `str`"), optional) – The domain name of the website on which the user has logged in. More about Telegram Login >>. - **author\_signature** ( `str`"), optional) – Signature of the post author for messages in channels, or the custom title of an anonymous group administrator. - **passport\_data** ( `telegram.PassportData`, optional) – Telegram Passport data. - **poll** ( `telegram.Poll`, optional) – Message is a native poll, information about the poll. - **dice** ( `telegram.Dice`, optional) – Message is a dice with random value. - **via\_bot** ( `telegram.User`, optional) – Bot through which message was sent. - **proximity\_alert\_triggered** ( `telegram.ProximityAlertTriggered`, optional) – Service message. A user in the chat triggered another user’s proximity alert while sharing Live Location. - **video\_chat\_scheduled** ( `telegram.VideoChatScheduled`, optional) – Service message: video chat scheduled. Added in version 20.0. - **video\_chat\_started** ( `telegram.VideoChatStarted`, optional) – Service message: video chat started. Added in version 20.0. - **video\_chat\_ended** ( `telegram.VideoChatEnded`, optional) – Service message: video chat ended. Added in version 20.0. - **video\_chat\_participants\_invited** ( `telegram.VideoChatParticipantsInvited` optional) – Service message: new participants invited to a video chat. Added in version 20.0. - **web\_app\_data** ( `telegram.WebAppData`, optional) – Service message: data sent by a Web App. Added in version 20.0. - **reply\_markup** ( `telegram.InlineKeyboardMarkup`, optional) – Inline keyboard attached to the message. `login_url` buttons are represented as ordinary url buttons. - **is\_topic\_message** ( `bool`"), optional) – `True`"), if the message is sent to a forum topic. Added in version 20.0. - **message\_thread\_id** ( `int`"), optional) – Unique identifier of a message thread to which the message belongs; for supergroups only. Added in version 20.0. - **forum\_topic\_created** ( `telegram.ForumTopicCreated`, optional) – Service message: forum topic created. Added in version 20.0. - **forum\_topic\_closed** ( `telegram.ForumTopicClosed`, optional) – Service message: forum topic closed. Added in version 20.0. - **forum\_topic\_reopened** ( `telegram.ForumTopicReopened`, optional) – Service message: forum topic reopened. Added in version 20.0. - **forum\_topic\_edited** ( `telegram.ForumTopicEdited`, optional) – Service message: forum topic edited. Added in version 20.0. - **general\_forum\_topic\_hidden** ( `telegram.GeneralForumTopicHidden`, optional) – Service message: General forum topic hidden. Added in version 20.0. - **general\_forum\_topic\_unhidden** ( `telegram.GeneralForumTopicUnhidden`, optional) – Service message: General forum topic unhidden. Added in version 20.0. - **write\_access\_allowed** ( `telegram.WriteAccessAllowed`, optional) – Service message: the user allowed the bot to write messages after adding it to the attachment or side menu, launching a Web App from a link, or accepting an explicit request from a Web App sent by the method requestWriteAccess. Added in version 20.0. - **has\_media\_spoiler** ( `bool`"), optional) – `True`"), if the message media is covered by a spoiler animation. Added in version 20.0. - **users\_shared** ( `telegram.UsersShared`, optional) – Service message: users were shared with the bot Added in version 20.8. - **chat\_shared** ( `telegram.ChatShared`, optional) – Service message: a chat was shared with the bot. Added in version 20.1. - **giveaway\_created** ( `telegram.GiveawayCreated`, optional) – Service message: a scheduled giveaway was created Added in version 20.8. - **giveaway** ( `telegram.Giveaway`, optional) – The message is a scheduled giveaway message Added in version 20.8. - **giveaway\_winners** ( `telegram.GiveawayWinners`, optional) – A giveaway with public winners was completed Added in version 20.8. - **giveaway\_completed** ( `telegram.GiveawayCompleted`, optional) – Service message: a giveaway without public winners was completed Added in version 20.8. - **external\_reply** ( `telegram.ExternalReplyInfo`, optional) – Information about the message that is being replied to, which may come from another chat or forum topic. Added in version 20.8. - **quote** ( `telegram.TextQuote`, optional) – For replies that quote part of the original message, the quoted part of the message. Added in version 20.8. - **forward\_origin** ( `telegram.MessageOrigin`, optional) – Information about the original message for forwarded messages Added in version 20.8. - **reply\_to\_story** ( `telegram.Story`, optional) – For replies to a story, the original story. Added in version 21.0. - **boost\_added** ( `telegram.ChatBoostAdded`, optional) – Service message: user boosted the chat. Added in version 21.0. - **sender\_boost\_count** ( `int`"), optional) – If the sender of the message boosted the chat, the number of boosts added by the user. Added in version 21.0. - **business\_connection\_id** ( `str`"), optional) – Unique identifier of the business connection from which the message was received. If non-empty, the message belongs to a chat of the corresponding business account that is independent from any potential bot chat which might share the same identifier. Added in version 21.1. - **sender\_business\_bot** ( `telegram.User`, optional) – The bot that actually sent the message on behalf of the business account. Available only for outgoing messages sent on behalf of the connected business account. Added in version 21.1. - **chat\_background\_set** ( `telegram.ChatBackground`, optional) – Service message: chat background set. Added in version 21.2. - **paid\_media** ( `telegram.PaidMediaInfo`, optional) – Message contains paid media; information about the paid media. Added in version 21.4. - **refunded\_payment** ( `telegram.RefundedPayment`, optional) – Message is a service message about a refunded payment, information about the payment. Added in version 21.4. message\_id [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Unique message identifier inside this chat. In specific instances (e.g., message containing a video sent to a big chat), the server might automatically schedule a message instead of sending it immediately. In such cases, this field will be `0` and the relevant message will be unusable until it is actually sent. Type: `int`") from\_user [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Sender of the message; may be empty for messages sent to channels. For backward compatibility, if the message was sent on behalf of a chat, the field contains a fake sender user in non-channel chats. Type: `telegram.User` sender\_chat [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Sender of the message when sent on behalf of a chat. For example, the supergroup itself for messages sent by its anonymous administrators or a linked channel for messages automatically forwarded to the channel’s discussion group. For backward compatibility, if the message was sent on behalf of a chat, the field from contains a fake sender user in non-channel chats. Type: `telegram.Chat` date [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Date the message was sent in Unix time. Converted to `datetime.datetime`"). Changed in version 20.3: The default timezone of the bot is used for localization, which is UTC unless `telegram.ext.Defaults.tzinfo` is used. Type: `datetime.datetime`") chat [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Conversation the message belongs to. Type: `telegram.Chat` is\_automatic\_forward [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. `True`"), if the message is a channel post that was automatically forwarded to the connected discussion group. Added in version 13.9. Type: `bool`") reply\_to\_message [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. For replies, the original message. Note that the Message object in this field will not contain further `reply_to_message` fields even if it itself is a reply. Type: `telegram.Message` edit\_date [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Date the message was last edited in Unix time. Converted to `datetime.datetime`"). Changed in version 20.3: The default timezone of the bot is used for localization, which is UTC unless `telegram.ext.Defaults.tzinfo` is used. Type: `datetime.datetime`") has\_protected\_content [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. `True`"), if the message can’t be forwarded. Added in version 13.9. Type: `bool`") is\_from\_offline [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. `True`"), if the message was sent by an implicit action, for example, as an away or a greeting business message, or as a scheduled message. Added in version 21.1. Type: `bool`") media\_group\_id [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. The unique identifier of a media message group this message belongs to. Type: `str`") text [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. For text messages, the actual UTF-8 text of the message, 0- `4096` characters. Type: `str`") entities [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text. See `parse_entity` and `parse_entities` methods for how to use properly. This list is empty if the message does not contain entities. Changed in version 20.0: This attribute is now an immutable tuple. Type: tuple\ [`telegram.MessageEntity`\] link\_preview\_options [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Options used for link preview generation for the message, if it is a text message and link preview options were changed. Added in version 20.8. Type: `telegram.LinkPreviewOptions` effect\_id [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Unique identifier of the message effect added to the message. ..versionadded:: 21.3 Type: `str`") caption\_entities [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. For messages with a Caption. Special entities like usernames, URLs, bot commands, etc. that appear in the caption. See `Message.parse_caption_entity` and `parse_caption_entities` methods for how to use properly. This list is empty if the message does not contain caption entities. Changed in version 20.0: This attribute is now an immutable tuple. Type: tuple\ [`telegram.MessageEntity`\] show\_caption\_above\_media [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. `True`"), if the caption must be shown above the message media. Added in version 21.3. Type: `bool`") audio [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is an audio file, information about the file. See also Working with Files and Media Type: `telegram.Audio` document [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a general file, information about the file. See also Working with Files and Media Type: `telegram.Document` animation [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set. See also Working with Files and Media Type: `telegram.Animation` game [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a game, information about the game. More about games >>. Type: `telegram.Game` photo [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a photo, available sizes of the photo. This list is empty if the message does not contain a photo. See also Working with Files and Media Changed in version 20.0: This attribute is now an immutable tuple. Type: tuple\ [`telegram.PhotoSize`\] sticker [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a sticker, information about the sticker. See also Working with Files and Media Type: `telegram.Sticker` story [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a forwarded story. Added in version 20.5. Type: `telegram.Story` video [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a video, information about the video. See also Working with Files and Media Type: `telegram.Video` voice [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a voice message, information about the file. See also Working with Files and Media Type: `telegram.Voice` video\_note [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a video note, information about the video message. See also Working with Files and Media Type: `telegram.VideoNote` new\_chat\_members [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. New members that were added to the group or supergroup and information about them (the bot itself may be one of these members). This list is empty if the message does not contain new chat members. Changed in version 20.0: This attribute is now an immutable tuple. Type: tuple\ [`telegram.User`\] caption [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Caption for the animation, audio, document, paid media, photo, video or voice, 0- `1024` characters. Type: `str`") contact [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a shared contact, information about the contact. Type: `telegram.Contact` location [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a shared location, information about the location. Type: `telegram.Location` venue [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. Message is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set. Type: `telegram.Venue` left\_chat\_member [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. A member was removed from the group, information about them (this member may be the bot itself). Type: `telegram.User` new\_chat\_title [\[source\]](https://github.com/python-telegram-bot/python-telegram-bot/blob/v22.0/telegram/_message.py#L1025-L1219) ¶ Optional. A chat title was changed to this value. Type: `str`")