Optional
animationMessage is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set
Optional
audioMessage is an audio file, information about the file
Optional
author_Signature of the post author for messages in channels, or the custom title of an anonymous group administrator
Optional
boost_Service message: user boosted the chat
Optional
business_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.
Optional
captionCaption for the animation, audio, document, photo, video or voice
Optional
caption_For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption
Optional
channel_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.
Chat the message belonged to
Optional
chat_Optional
chat_Service message: a chat was shared with the bot
Optional
connected_The domain name of the website on which the user has logged in. More about Telegram Login »
Optional
contactMessage is a shared contact, information about the contact
Always 0. The field can be used to differentiate regular and inaccessible messages.
Optional
delete_Service message: the chat photo was deleted
Optional
diceMessage is a dice with random value
Optional
documentMessage is a general file, information about the file
Optional
edit_Date the message was last edited in Unix time
Optional
effect_Unique identifier of the message effect added to the message
Optional
entitiesFor text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text
Optional
external_Information about the message that is being replied to, which may come from another chat or forum topic
Optional
forum_Service message: forum topic closed
Optional
forum_Service message: forum topic created
Optional
forum_Service message: forum topic edited
Optional
forum_Service message: forum topic reopened
Optional
forward_Information about the original message for forwarded messages
Optional
fromSender 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
Optional
gameMessage is a game, information about the game. More about games »
Optional
general_Service message: the 'General' forum topic hidden
Optional
general_Service message: the 'General' forum topic unhidden
Optional
giveawayThe message is a scheduled giveaway message
Optional
giveaway_Service message: a giveaway without public winners was completed
Optional
giveaway_Service message: a scheduled giveaway was created
Optional
giveaway_A giveaway with public winners was completed
Optional
group_Service message: the group has been created
Optional
has_True, if the message media is covered by a spoiler animation
Optional
has_True, if the message can't be forwarded
Optional
invoiceMessage is an invoice for a payment, information about the invoice. More about payments »
Optional
is_True, if the message is a channel post that was automatically forwarded to the connected discussion group
Optional
is_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
Optional
is_True, if the message is sent to a forum topic
Optional
left_A member was removed from the group, information about them (this member may be the bot itself)
Optional
link_Options used for link preview generation for the message, if it is a text message and link preview options were changed
Optional
locationMessage is a shared location, information about the location
Optional
media_The unique identifier of a media message group this message belongs to
Optional
message_Service message: auto-delete timer settings changed in the chat
Unique message identifier inside the chat
Optional
message_Unique identifier of a message thread or a forum topic to which the message belongs; for supergroups only
Optional
migrate_The supergroup has been migrated from a group with the specified identifier.
Optional
migrate_The group has been migrated to a supergroup with the specified identifier.
Optional
new_New members that were added to the group or supergroup and information about them (the bot itself may be one of these members)
Optional
new_A chat photo was change to this value
Optional
new_A chat title was changed to this value
Optional
paid_Message contains paid media; information about the paid media
Optional
passport_Telegram Passport data
Optional
photoMessage is a photo, available sizes of the photo
Optional
pinned_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.
Optional
pollMessage is a native poll, information about the poll
Optional
proximity_Service message. A user in the chat triggered another user's proximity alert while sharing Live Location.
Optional
quoteFor replies that quote part of the original message, the quoted part of the message
Optional
refunded_Message is a service message about a refunded payment, information about the payment. More about payments »
Optional
reply_Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons.
Optional
reply_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.
Optional
reply_For replies to a story, the original message
Optional
sender_If the sender of the message boosted the chat, the number of boosts added by the user
Optional
sender_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.
Optional
sender_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.
Optional
show_True, if the caption must be shown above the message media
Optional
stickerMessage is a sticker, information about the sticker
Optional
storyMessage is a forwarded story
Optional
successful_Message is a service message about a successful payment, information about the payment. More about payments »
Optional
supergroup_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.
Optional
textFor text messages, the actual UTF-8 text of the message
Optional
users_Service message: users were shared with the bot
Optional
venueMessage is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set
Optional
via_Bot through which the message was sent
Optional
videoMessage is a video, information about the video
Optional
video_Service message: video chat ended
Optional
video_Service message: new participants invited to a video chat
Optional
video_Service message: video chat scheduled
Optional
video_Service message: video chat started
Optional
video_Message is a video note, information about the video message
Optional
voiceMessage is a voice message, information about the file
Optional
web_Service message: data sent by a Web App
Optional
write_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
This object describes a message that was deleted or is otherwise inaccessible to the bot.