message_t

struct banana::api::message_t

This object represents a message.

integer_t message_id

Unique message identifier inside this chat

integer_t date

Date the message was sent in Unix time. It is always a positive number, representing a valid date.

chat_t chat

Chat the message belongs to

optional_t<integer_t> message_thread_id

Optional. Unique identifier of a message thread to which the message belongs; for supergroups only

optional_t<user_t> from

Optional. Sender of the message; empty for messages sent to channels. For backward compatibility, the field contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.

optional_t<chat_t> sender_chat

Optional. Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, the field from contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat.

optional_t<integer_t> sender_boost_count

Optional. If the sender of the message boosted the chat, the number of boosts added by the user

optional_t<user_t> sender_business_bot

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.

optional_t<message_origin_t> forward_origin

Optional. Information about the original message for forwarded messages

optional_t<boolean_t> is_topic_message

Optional. True, if the message is sent to a forum topic

optional_t<boolean_t> is_automatic_forward

Optional. True, if the message is a channel post that was automatically forwarded to the connected discussion group

optional_t<message_t> reply_to_message

Optional. 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_t<external_reply_info_t> external_reply

Optional. Information about the message that is being replied to, which may come from another chat or forum topic

optional_t<text_quote_t> quote

Optional. For replies that quote part of the original message, the quoted part of the message

optional_t<story_t> reply_to_story

Optional. For replies to a story, the original story

optional_t<user_t> via_bot

Optional. Bot through which the message was sent

optional_t<integer_t> edit_date

Optional. Date the message was last edited in Unix time

optional_t<boolean_t> has_protected_content

Optional. True, if the message can’t be forwarded

optional_t<boolean_t> is_from_offline

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

optional_t<string_t> media_group_id

Optional. The unique identifier of a media message group this message belongs to

optional_t<string_t> author_signature

Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator

optional_t<string_t> text

Optional. For text messages, the actual UTF-8 text of the message

optional_t<array_t<message_entity_t>> entities

Optional. For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text

optional_t<link_preview_options_t> link_preview_options

Optional. Options used for link preview generation for the message, if it is a text message and link preview options were changed

optional_t<string_t> effect_id

Optional. Unique identifier of the message effect added to the message

optional_t<animation_t> 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

optional_t<audio_t> audio

Optional. Message is an audio file, information about the file

optional_t<document_t> document

Optional. Message is a general file, information about the file

optional_t<paid_media_info_t> paid_media

Optional. Message contains paid media; information about the paid media

optional_t<array_t<photo_size_t>> photo

Optional. Message is a photo, available sizes of the photo

optional_t<sticker_t> sticker

Optional. Message is a sticker, information about the sticker

optional_t<story_t> story

Optional. Message is a forwarded story

optional_t<video_t> video

Optional. Message is a video, information about the video

optional_t<video_note_t> video_note

Optional. Message is a video note, information about the video message

optional_t<voice_t> voice

Optional. Message is a voice message, information about the file

optional_t<string_t> caption

Optional. Caption for the animation, audio, document, paid media, photo, video or voice

optional_t<array_t<message_entity_t>> caption_entities

Optional. For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption

optional_t<boolean_t> show_caption_above_media

Optional. True, if the caption must be shown above the message media

optional_t<boolean_t> has_media_spoiler

Optional. True, if the message media is covered by a spoiler animation

optional_t<contact_t> contact

Optional. Message is a shared contact, information about the contact

optional_t<dice_t> dice

Optional. Message is a dice with random value

optional_t<game_t> game

Optional. Message is a game, information about the game. More about games »

optional_t<poll_t> poll

Optional. Message is a native poll, information about the poll

optional_t<venue_t> 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

optional_t<location_t> location

Optional. Message is a shared location, information about the location

optional_t<array_t<user_t>> new_chat_members

Optional. New members that were added to the group or supergroup and information about them (the bot itself may be one of these members)

optional_t<user_t> left_chat_member

Optional. A member was removed from the group, information about them (this member may be the bot itself)

optional_t<string_t> new_chat_title

Optional. A chat title was changed to this value

optional_t<array_t<photo_size_t>> new_chat_photo

Optional. A chat photo was change to this value

optional_t<boolean_t> delete_chat_photo

Optional. Service message: the chat photo was deleted

optional_t<boolean_t> group_chat_created

Optional. Service message: the group has been created

optional_t<boolean_t> supergroup_chat_created

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.

optional_t<boolean_t> channel_chat_created

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.

optional_t<message_auto_delete_timer_changed_t> message_auto_delete_timer_changed

Optional. Service message: auto-delete timer settings changed in the chat

optional_t<integer_t> migrate_to_chat_id

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

optional_t<integer_t> migrate_from_chat_id

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

optional_t<maybe_inaccessible_message_t> pinned_message

Optional. 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_t<invoice_t> invoice

Optional. Message is an invoice for a payment, information about the invoice. More about payments »

optional_t<successful_payment_t> successful_payment

Optional. Message is a service message about a successful payment, information about the payment. More about payments »

optional_t<refunded_payment_t> refunded_payment

Optional. Message is a service message about a refunded payment, information about the payment. More about payments »

optional_t<users_shared_t> users_shared

Optional. Service message: users were shared with the bot

optional_t<chat_shared_t> chat_shared

Optional. Service message: a chat was shared with the bot

optional_t<string_t> connected_website

Optional. The domain name of the website on which the user has logged in. More about Telegram Login »

optional_t<write_access_allowed_t> write_access_allowed

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

optional_t<passport_data_t> passport_data

Optional. Telegram Passport data

optional_t<proximity_alert_triggered_t> proximity_alert_triggered

Optional. Service message. A user in the chat triggered another user’s proximity alert while sharing Live Location.

optional_t<chat_boost_added_t> boost_added

Optional. Service message: user boosted the chat

optional_t<chat_background_t> chat_background_set

Optional. Service message: chat background set

optional_t<forum_topic_created_t> forum_topic_created

Optional. Service message: forum topic created

optional_t<forum_topic_edited_t> forum_topic_edited

Optional. Service message: forum topic edited

optional_t<forum_topic_closed_t> forum_topic_closed

Optional. Service message: forum topic closed

optional_t<forum_topic_reopened_t> forum_topic_reopened

Optional. Service message: forum topic reopened

optional_t<general_forum_topic_hidden_t> general_forum_topic_hidden

Optional. Service message: the ‘General’ forum topic hidden

optional_t<general_forum_topic_unhidden_t> general_forum_topic_unhidden

Optional. Service message: the ‘General’ forum topic unhidden

optional_t<giveaway_created_t> giveaway_created

Optional. Service message: a scheduled giveaway was created

optional_t<giveaway_t> giveaway

Optional. The message is a scheduled giveaway message

optional_t<giveaway_winners_t> giveaway_winners

Optional. A giveaway with public winners was completed

optional_t<giveaway_completed_t> giveaway_completed

Optional. Service message: a giveaway without public winners was completed

optional_t<video_chat_scheduled_t> video_chat_scheduled

Optional. Service message: video chat scheduled

optional_t<video_chat_started_t> video_chat_started

Optional. Service message: video chat started

optional_t<video_chat_ended_t> video_chat_ended

Optional. Service message: video chat ended

optional_t<video_chat_participants_invited_t> video_chat_participants_invited

Optional. Service message: new participants invited to a video chat

optional_t<web_app_data_t> web_app_data

Optional. Service message: data sent by a Web App

optional_t<inline_keyboard_markup_t> reply_markup

Optional. Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons.

optional_t<string_t> business_connection_id

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.