messages.Messages
- class pyrogram.raw.base.messages.Messages
Object contains information on list of messages with auxiliary data.
- Constructors:
This base type has 4 constructors available.
Channel messages
Full list of messages with auxiliary data.
No new messages matching the query were found
Incomplete list of messages and auxiliary data.
- Functions:
This object can be returned by 15 functions.
Returns the list of messages by their IDs.
Returns the conversation history with one interlocutor / within a chat
Search for messages.
Search for messages and peers globally
Get unread messages where we were mentioned
Get live location history of a certain user
Get scheduled messages
Get scheduled messages
Get messages in a reply thread
Get unread reactions to messages you sent
View and search recently sent media.
Fetch saved messages » forwarded from a specific peer, or fetch messages from a monoforum topic ».
Fetch (a subset or all) messages in a quick reply shortcut ».
Get channel/supergroup messages
Globally search for posts from public channels » (including those we aren't a member of) containing either a specific hashtag, or a full text query.
TL Schema
messages.messages#1d73e7ea
messages:Vector<Message>
topics:Vector<ForumTopic>
chats:Vector<Chat>
users:Vector<User>
= messages.Messages
Parameter Tree
Vector < Message >MessageEmptyintPeer (optional)PeerUserlongPeerChatlongPeerChannellongMessagetrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)intPeer (optional)PeerUserlongPeerChatlongPeerChannellongint (optional)string (optional)PeerPeerUserlongPeerChatlongPeerChannellongPeer (optional)PeerUserlongPeerChatlongPeerChannellongMessageFwdHeader (optional)MessageFwdHeadertrue (optional)true (optional)Peer (optional)PeerUserPeerChatPeerChannelstring (optional)intint (optional)string (optional)Peer (optional)PeerUserPeerChatPeerChannelint (optional)Peer (optional)PeerUserPeerChatPeerChannelstring (optional)int (optional)string (optional)long (optional)long (optional)MessageReplyHeader (optional)MessageReplyHeadertrue (optional)true (optional)true (optional)int (optional)Peer (optional)PeerUserPeerChatPeerChannelMessageFwdHeader (optional)MessageFwdHeaderMessageMedia (optional)MessageMediaEmptyMessageMediaPhotoMessageMediaGeoMessageMediaContactMessageMediaUnsupportedMessageMediaDocumentMessageMediaWebPageMessageMediaVenueMessageMediaGameMessageMediaInvoiceMessageMediaGeoLiveMessageMediaPollMessageMediaDiceMessageMediaStoryMessageMediaGiveawayMessageMediaGiveawayResultsMessageMediaPaidMediaMessageMediaToDoMessageMediaVideoStreamint (optional)string (optional)Vector < MessageEntity > (optional)MessageEntityUnknownMessageEntityMentionMessageEntityHashtagMessageEntityBotCommandMessageEntityUrlMessageEntityEmailMessageEntityBoldMessageEntityItalicMessageEntityCodeMessageEntityPreMessageEntityTextUrlMessageEntityMentionNameInputMessageEntityMentionNameMessageEntityPhoneMessageEntityCashtagMessageEntityUnderlineMessageEntityStrikeMessageEntityBankCardMessageEntitySpoilerMessageEntityCustomEmojiMessageEntityBlockquoteMessageEntityFormattedDateint (optional)int (optional)MessageReplyStoryHeaderPeerPeerUserPeerChatPeerChannelintintstringMessageMedia (optional)MessageMediaEmptyMessageMediaPhototrue (optional)Photo (optional)PhotoEmptyPhotoint (optional)MessageMediaGeoGeoPointGeoPointEmptyGeoPointMessageMediaContactstringstringstringstringlongMessageMediaUnsupportedMessageMediaDocumenttrue (optional)true (optional)true (optional)true (optional)true (optional)Document (optional)DocumentEmptyDocumentVector < Document > (optional)DocumentEmptyDocumentPhoto (optional)PhotoEmptyPhotoint (optional)int (optional)MessageMediaWebPagetrue (optional)true (optional)true (optional)true (optional)WebPageWebPageEmptyWebPagePendingWebPageWebPageNotModifiedMessageMediaVenueGeoPointGeoPointEmptyGeoPointstringstringstringstringstringMessageMediaGameGameGameMessageMediaInvoicetrue (optional)true (optional)stringstringWebDocument (optional)WebDocumentWebDocumentNoProxyint (optional)stringlongstringMessageExtendedMedia (optional)MessageExtendedMediaPreviewMessageExtendedMediaMessageMediaGeoLiveGeoPointGeoPointEmptyGeoPointint (optional)intint (optional)MessageMediaPollPollPollPollResultsPollResultsMessageMediaDiceintstringmessages.EmojiGameOutcome (optional)messages.EmojiGameOutcomeMessageMediaStorytrue (optional)PeerPeerUserPeerChatPeerChannelintStoryItem (optional)StoryItemDeletedStoryItemSkippedStoryItemMessageMediaGiveawaytrue (optional)true (optional)Vector < long >Vector < string > (optional)string (optional)intint (optional)long (optional)intMessageMediaGiveawayResultstrue (optional)true (optional)longint (optional)intintintVector < long >int (optional)long (optional)string (optional)intMessageMediaPaidMedialongVector < MessageExtendedMedia >MessageExtendedMediaPreviewMessageExtendedMediaMessageMediaToDoTodoListTodoListVector < TodoCompletion > (optional)TodoCompletionMessageMediaVideoStreamtrue (optional)InputGroupCallInputGroupCallInputGroupCallSlugInputGroupCallInviteMessageReplyMarkup (optional)ReplyKeyboardHidetrue (optional)ReplyKeyboardForceReplytrue (optional)true (optional)string (optional)ReplyKeyboardMarkuptrue (optional)true (optional)true (optional)true (optional)Vector < KeyboardButtonRow >KeyboardButtonRowstring (optional)ReplyInlineMarkupVector < KeyboardButtonRow >KeyboardButtonRowVector < MessageEntity > (optional)MessageEntityUnknownintintMessageEntityMentionintintMessageEntityHashtagintintMessageEntityBotCommandintintMessageEntityUrlintintMessageEntityEmailintintMessageEntityBoldintintMessageEntityItalicintintMessageEntityCodeintintMessageEntityPreintintstringMessageEntityTextUrlintintstringMessageEntityMentionNameintintlongInputMessageEntityMentionNameintintInputUserInputUserEmptyInputUserSelfInputUserInputUserFromMessageMessageEntityPhoneintintMessageEntityCashtagintintMessageEntityUnderlineintintMessageEntityStrikeintintMessageEntityBankCardintintMessageEntitySpoilerintintMessageEntityCustomEmojiintintlongMessageEntityBlockquotetrue (optional)intintMessageEntityFormattedDatetrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)intintintint (optional)int (optional)MessageReplies (optional)MessageRepliestrue (optional)intintVector < Peer > (optional)PeerUserPeerChatPeerChannellong (optional)int (optional)int (optional)int (optional)string (optional)long (optional)MessageReactions (optional)MessageReactionstrue (optional)true (optional)true (optional)Vector < ReactionCount >ReactionCountVector < MessagePeerReaction > (optional)MessagePeerReactionVector < MessageReactor > (optional)MessageReactorVector < RestrictionReason > (optional)RestrictionReasonstringstringstringint (optional)int (optional)long (optional)FactCheck (optional)FactChecktrue (optional)string (optional)TextWithEntities (optional)TextWithEntitieslongint (optional)long (optional)SuggestedPost (optional)SuggestedPosttrue (optional)true (optional)StarsAmount (optional)StarsAmountStarsTonAmountint (optional)int (optional)string (optional)MessageServicetrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)intPeer (optional)PeerUserlongPeerChatlongPeerChannellongPeerPeerUserlongPeerChatlongPeerChannellongPeer (optional)PeerUserlongPeerChatlongPeerChannellongMessageReplyHeader (optional)MessageReplyHeadertrue (optional)true (optional)true (optional)int (optional)Peer (optional)PeerUserPeerChatPeerChannelMessageFwdHeader (optional)MessageFwdHeaderMessageMedia (optional)MessageMediaEmptyMessageMediaPhotoMessageMediaGeoMessageMediaContactMessageMediaUnsupportedMessageMediaDocumentMessageMediaWebPageMessageMediaVenueMessageMediaGameMessageMediaInvoiceMessageMediaGeoLiveMessageMediaPollMessageMediaDiceMessageMediaStoryMessageMediaGiveawayMessageMediaGiveawayResultsMessageMediaPaidMediaMessageMediaToDoMessageMediaVideoStreamint (optional)string (optional)Vector < MessageEntity > (optional)MessageEntityUnknownMessageEntityMentionMessageEntityHashtagMessageEntityBotCommandMessageEntityUrlMessageEntityEmailMessageEntityBoldMessageEntityItalicMessageEntityCodeMessageEntityPreMessageEntityTextUrlMessageEntityMentionNameInputMessageEntityMentionNameMessageEntityPhoneMessageEntityCashtagMessageEntityUnderlineMessageEntityStrikeMessageEntityBankCardMessageEntitySpoilerMessageEntityCustomEmojiMessageEntityBlockquoteMessageEntityFormattedDateint (optional)int (optional)MessageReplyStoryHeaderPeerPeerUserPeerChatPeerChannelintintMessageActionMessageActionEmptyMessageActionChatCreatestringVector < long >MessageActionChatEditTitlestringMessageActionChatEditPhotoPhotoPhotoEmptyPhotoMessageActionChatDeletePhotoMessageActionChatAddUserVector < long >MessageActionChatDeleteUserlongMessageActionChatJoinedByLinklongMessageActionChannelCreatestringMessageActionChatMigrateTolongMessageActionChannelMigrateFromstringlongMessageActionPinMessageMessageActionHistoryClearMessageActionGameScorelongintMessageActionPaymentSentMetrue (optional)true (optional)stringlongbytesPaymentRequestedInfo (optional)PaymentRequestedInfostring (optional)PaymentChargePaymentChargeint (optional)MessageActionPaymentSenttrue (optional)true (optional)stringlongstring (optional)int (optional)MessageActionPhoneCalltrue (optional)longPhoneCallDiscardReason (optional)PhoneCallDiscardReasonMissedPhoneCallDiscardReasonDisconnectPhoneCallDiscardReasonHangupPhoneCallDiscardReasonBusyPhoneCallDiscardReasonMigrateConferenceCallint (optional)MessageActionScreenshotTakenMessageActionCustomActionstringMessageActionBotAllowedtrue (optional)true (optional)string (optional)BotApp (optional)BotAppNotModifiedBotAppMessageActionSecureValuesSentMeVector < SecureValue >SecureValueSecureCredentialsEncryptedSecureCredentialsEncryptedMessageActionSecureValuesSentVector < SecureValueType >SecureValueTypePersonalDetailsSecureValueTypePassportSecureValueTypeDriverLicenseSecureValueTypeIdentityCardSecureValueTypeInternalPassportSecureValueTypeAddressSecureValueTypeUtilityBillSecureValueTypeBankStatementSecureValueTypeRentalAgreementSecureValueTypePassportRegistrationSecureValueTypeTemporaryRegistrationSecureValueTypePhoneSecureValueTypeEmailMessageActionContactSignUpMessageActionGeoProximityReachedPeerPeerUserPeerChatPeerChannelPeerPeerUserPeerChatPeerChannelintMessageActionGroupCallInputGroupCallInputGroupCallInputGroupCallSlugInputGroupCallInviteMessageint (optional)MessageActionInviteToGroupCallInputGroupCallInputGroupCallInputGroupCallSlugInputGroupCallInviteMessageVector < long >MessageActionSetMessagesTTLintlong (optional)MessageActionGroupCallScheduledInputGroupCallInputGroupCallInputGroupCallSlugInputGroupCallInviteMessageintMessageActionSetChatThemeChatThemeChatThemeChatThemeUniqueGiftMessageActionChatJoinedByRequestMessageActionWebViewDataSentMestringstringMessageActionWebViewDataSentstringMessageActionGiftPremiumstringlongintstring (optional)long (optional)TextWithEntities (optional)TextWithEntitiesMessageActionTopicCreatetrue (optional)stringintlong (optional)MessageActionTopicEditstring (optional)long (optional)Bool (optional)Bool (optional)MessageActionSuggestProfilePhotoPhotoPhotoEmptyPhotoMessageActionRequestedPeerintVector < Peer >PeerUserPeerChatPeerChannelMessageActionSetChatWallPapertrue (optional)true (optional)WallPaperWallPaperWallPaperNoFileMessageActionGiftCodetrue (optional)true (optional)Peer (optional)PeerUserPeerChatPeerChannelintstringstring (optional)long (optional)string (optional)long (optional)TextWithEntities (optional)TextWithEntitiesMessageActionGiveawayLaunchlong (optional)MessageActionGiveawayResultstrue (optional)intintMessageActionBoostApplyintMessageActionRequestedPeerSentMeintVector < RequestedPeer >RequestedPeerUserRequestedPeerChatRequestedPeerChannelMessageActionPaymentRefundedPeerPeerUserPeerChatPeerChannelstringlongbytes (optional)PaymentChargePaymentChargeMessageActionGiftStarsstringlonglongstring (optional)long (optional)string (optional)MessageActionPrizeStarstrue (optional)longstringPeerPeerUserPeerChatPeerChannelintMessageActionStarGifttrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)StarGiftStarGiftStarGiftUniqueTextWithEntities (optional)TextWithEntitieslong (optional)int (optional)long (optional)Peer (optional)PeerUserPeerChatPeerChannelPeer (optional)PeerUserPeerChatPeerChannellong (optional)string (optional)int (optional)Peer (optional)PeerUserPeerChatPeerChannelint (optional)MessageActionStarGiftUniquetrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)StarGiftStarGiftStarGiftUniqueint (optional)long (optional)Peer (optional)PeerUserPeerChatPeerChannelPeer (optional)PeerUserPeerChatPeerChannellong (optional)StarsAmount (optional)StarsAmountStarsTonAmountint (optional)int (optional)long (optional)int (optional)intlongMessageActionPaidMessagesPricetrue (optional)longMessageActionConferenceCalltrue (optional)true (optional)true (optional)longint (optional)Vector < Peer > (optional)PeerUserPeerChatPeerChannelMessageActionTodoCompletionsVector < int >Vector < int >MessageActionTodoAppendTasksVector < TodoItem >TodoItemtrue (optional)true (optional)string (optional)int (optional)StarsAmount (optional)StarsAmountStarsTonAmountStarsAmountStarsAmountStarsTonAmountMessageActionSuggestedPostRefundtrue (optional)MessageActionGiftTonstringlongstringlongstring (optional)MessageActionSuggestBirthdayBirthdayBirthdaytrue (optional)true (optional)StarGiftStarGiftStarGiftUniqueStarsAmountStarsAmountStarsTonAmountinttrue (optional)StarGiftStarGiftStarGiftUniqueStarsAmountStarsAmountStarsTonAmountMessageActionNewCreatorPendinglongMessageActionChangeCreatorlongMessageActionNoForwardsToggleBoolBoolMessageActionNoForwardsRequesttrue (optional)BoolBoolMessageReactions (optional)MessageReactionstrue (optional)true (optional)true (optional)Vector < ReactionCount >ReactionCountVector < MessagePeerReaction > (optional)MessagePeerReactionVector < MessageReactor > (optional)MessageReactorint (optional)Vector < ForumTopic >ForumTopicDeletedintForumTopictrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)intintPeerPeerUserlongPeerChatlongPeerChannellongstringintlong (optional)intintintintintintPeerPeerUserlongPeerChatlongPeerChannellongPeerNotifySettingsPeerNotifySettingsBool (optional)Bool (optional)int (optional)NotificationSound (optional)NotificationSoundDefaultNotificationSoundNoneNotificationSoundLocalNotificationSoundRingtoneNotificationSound (optional)NotificationSoundDefaultNotificationSoundNoneNotificationSoundLocalNotificationSoundRingtoneNotificationSound (optional)NotificationSoundDefaultNotificationSoundNoneNotificationSoundLocalNotificationSoundRingtoneBool (optional)Bool (optional)NotificationSound (optional)NotificationSoundDefaultNotificationSoundNoneNotificationSoundLocalNotificationSoundRingtoneNotificationSound (optional)NotificationSoundDefaultNotificationSoundNoneNotificationSoundLocalNotificationSoundRingtoneNotificationSound (optional)NotificationSoundDefaultNotificationSoundNoneNotificationSoundLocalNotificationSoundRingtoneDraftMessage (optional)DraftMessageEmptyint (optional)DraftMessagetrue (optional)true (optional)InputReplyTo (optional)InputReplyToMessageInputReplyToStoryInputReplyToMonoForumstringVector < MessageEntity > (optional)MessageEntityUnknownMessageEntityMentionMessageEntityHashtagMessageEntityBotCommandMessageEntityUrlMessageEntityEmailMessageEntityBoldMessageEntityItalicMessageEntityCodeMessageEntityPreMessageEntityTextUrlMessageEntityMentionNameInputMessageEntityMentionNameMessageEntityPhoneMessageEntityCashtagMessageEntityUnderlineMessageEntityStrikeMessageEntityBankCardMessageEntitySpoilerMessageEntityCustomEmojiMessageEntityBlockquoteMessageEntityFormattedDateInputMedia (optional)InputMediaEmptyInputMediaUploadedPhotoInputMediaPhotoInputMediaGeoPointInputMediaContactInputMediaUploadedDocumentInputMediaDocumentInputMediaVenueInputMediaPhotoExternalInputMediaDocumentExternalInputMediaGameInputMediaInvoiceInputMediaGeoLiveInputMediaPollInputMediaDiceInputMediaStoryInputMediaWebPageInputMediaPaidMediaInputMediaTodoInputMediaStakeDiceintlong (optional)SuggestedPost (optional)SuggestedPostVector < Chat >ChatEmptylongChattrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)longstringChatPhotoChatPhotoEmptyChatPhototrue (optional)longbytes (optional)intintintintInputChannel (optional)InputChannelEmptyInputChannelInputChannelFromMessageChatAdminRights (optional)ChatAdminRightstrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)ChatBannedRights (optional)ChatBannedRightstrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)intChatForbiddenlongstringChanneltrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)longlong (optional)stringstring (optional)ChatPhotoChatPhotoEmptyChatPhototrue (optional)longbytes (optional)intintVector < RestrictionReason > (optional)RestrictionReasonstringstringstringChatAdminRights (optional)ChatAdminRightstrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)ChatBannedRights (optional)ChatBannedRightstrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)intChatBannedRights (optional)ChatBannedRightstrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)intint (optional)Vector < Username > (optional)Usernametrue (optional)true (optional)stringRecentStory (optional)RecentStorytrue (optional)int (optional)PeerColor (optional)PeerColorint (optional)long (optional)PeerColorCollectiblelonglonglongintVector < int >int (optional)Vector < int > (optional)InputPeerColorCollectiblelongPeerColor (optional)PeerColorint (optional)long (optional)PeerColorCollectiblelonglonglongintVector < int >int (optional)Vector < int > (optional)InputPeerColorCollectiblelongEmojiStatus (optional)EmojiStatusEmptyEmojiStatuslongint (optional)EmojiStatusCollectiblelonglongstringstringlongintintintintint (optional)InputEmojiStatusCollectiblelongint (optional)int (optional)int (optional)long (optional)long (optional)long (optional)ChannelForbiddentrue (optional)true (optional)true (optional)longlongstringint (optional)Vector < User >UserEmptylongUsertrue (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)true (optional)longlong (optional)string (optional)string (optional)string (optional)string (optional)UserProfilePhoto (optional)UserProfilePhotoEmptyUserProfilePhototrue (optional)true (optional)longbytes (optional)intUserStatus (optional)UserStatusEmptyUserStatusOnlineintUserStatusOfflineintUserStatusRecentlytrue (optional)UserStatusLastWeektrue (optional)UserStatusLastMonthtrue (optional)int (optional)Vector < RestrictionReason > (optional)RestrictionReasonstringstringstringstring (optional)string (optional)EmojiStatus (optional)EmojiStatusEmptyEmojiStatuslongint (optional)EmojiStatusCollectiblelonglongstringstringlongintintintintint (optional)longint (optional)Vector < Username > (optional)Usernametrue (optional)true (optional)stringRecentStory (optional)RecentStorytrue (optional)int (optional)PeerColor (optional)PeerColorint (optional)long (optional)PeerColorCollectiblelonglonglongintVector < int >int (optional)Vector < int > (optional)longPeerColor (optional)PeerColorint (optional)long (optional)PeerColorCollectiblelonglonglongintVector < int >int (optional)Vector < int > (optional)longint (optional)long (optional)long (optional)Example
Messages(
messages=[
MessageEmpty(
id=0,
peer_id=None
)
],
topics=[
ForumTopicDeleted(id=0)
],
chats=[
ChatEmpty(id=0)
],
users=[
UserEmpty(id=0)
],
)