Message
This object represents a message.
Поля
message_idInteger
Unique message identifier inside this chat; 0 for ephemeral messages. In specific instances (e.g., a 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.
Unique identifier of a message thread or forum topic to which the message belongs; for supergroups and private chats only
Information about the direct messages chat topic that contains the message
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 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.
If the sender of the message boosted the chat, the number of boosts added by the user
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.
Tag or custom title of the sender of the message; for supergroups only
For ephemeral messages, the user who received the message
For ephemeral messages, identifier of the ephemeral message inside this chat. The identifier may be reused for another ephemeral message after the message is deleted or expires.
dateInteger
Date the message was sent in Unix time. It is always a positive number, representing a valid date.
The unique identifier for the guest query. Use this identifier with the method answerGuestQuery to send a response message. If non-empty, the message belongs to the chat where the guest bot was summoned, which may not coincide with other existing bot chats sharing the same identifier.
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.
Information about the original message for forwarded messages
True, if the message is sent to a topic in a forum supergroup or a private chat with the bot
True, if the message is a channel post that was automatically forwarded to the connected discussion group
For replies in the same chat and message thread, 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. If the message is a reply to an ephemeral message, then this field may be omitted.
Information about the message that is being replied to, which may come from another chat or forum topic
For replies that quote part of the original message, the quoted part of the message
For replies to a story, the original story
Identifier of the specific checklist task that is being replied to
Persistent identifier of the specific poll option that is being replied to
For a message sent by a guest bot, this is the user whose original message triggered the bot's response
For a message sent by a guest bot, this is the chat whose original message triggered the bot's response
Date the message was last edited in Unix time
True, if the message can't be forwarded
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
True, if the message is a paid post. Note that such posts must not be deleted for 24 hours to receive the payment and can't be edited.
The unique identifier inside this chat of a media message group this message belongs to
Signature of the post author for messages in channels, or the custom title of an anonymous group administrator
The number of Telegram Stars that were paid by the sender of the message to send it
For text messages, the actual UTF-8 text of the message
For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text
Options used for link preview generation for the message, if it is a text message and link preview options were changed
Information about suggested post parameters if the message is a suggested post in a channel direct messages chat. If the message is an approved or declined suggested post, then it can't be edited.
Unique identifier of the message effect added to the message
Message is a rich formatted message
Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set.
Message is a live photo, information about the live photo. For backward compatibility, when this field is set, the photo field will also be set.
Message contains paid media; information about the paid media
Message is a video note, information about the video message
Caption for the animation, audio, document, paid media, photo, video or voice
For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption
True, if the caption must be shown above the message media
True, if the message media is covered by a spoiler animation
Message is a game, information about the game. More about games »
Message is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set.
New members that were added to the group or supergroup and information about them (the bot itself may be one of these members)
A member was removed from the group, information about them (this member may be the bot itself)
Service message: chat owner has left
Service message: chat owner has changed
A chat title was changed to this value
A chat photo was change to this value
Service message: the chat photo was deleted
Service message: the group has been created
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.
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.
Service message: auto-delete timer settings changed in the chat
The group has been migrated to a supergroup with the specified identifier. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier.
The supergroup has been migrated from a group with the specified identifier. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier.
Specified message was pinned. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply.
Message is an invoice for a payment, information about the invoice. More about payments »
Message is a service message about a successful payment, information about the payment. More about payments »
Message is a service message about a refunded payment, information about the payment. More about payments »
Service message: a unique gift was sent or received
Service message: upgrade of a gift was purchased after the gift was sent
The domain name of the website on which the user has logged in. More about Telegram Login »
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
Telegram Passport data
Service message: a user in the chat triggered another user's proximity alert while sharing Live Location
Service message: user boosted the chat
Service message: chat background set
Service message: some tasks in a checklist were marked as done or not done
Service message: tasks were added to a checklist
Service message: chat or bot added to a Community
Service message: chat was joined by a user from a Community
Service message: chat or bot removed from a Community
Service message: the price for paid messages in the corresponding direct messages chat of a channel has changed
Service message: forum topic created
Service message: forum topic edited
Service message: forum topic closed
Service message: forum topic reopened
Service message: a scheduled giveaway was created
A giveaway with public winners was completed
Service message: a giveaway without public winners was completed
Service message: user created a bot that will be managed by the current bot
Service message: the price for paid messages has changed in the chat
Service message: answer option was added to a poll
Service message: answer option was deleted from a poll
Service message: a suggested post was approved
Service message: approval of a suggested post has failed
Service message: a suggested post was declined
Service message: payment for a suggested post was received
Service message: payment for a suggested post was refunded
Service message: video chat scheduled
Service message: video chat started
Service message: video chat ended
Service message: new participants invited to a video chat
Service message: data sent by a Web App
Минимальный JSON
JSON
{
"message_id": 1,
"date": 1790000000,
"chat": {
"id": 1780243423,
"type": "private"
}
}