Update

Object contains info on events occurred.

updateNewMessage#1f2b0afd message:Message pts:int pts_count:int = Update;
updateMessageID#4e90bfd6 id:int random_id:long = Update;
updateDeleteMessages#a20db0e5 messages:Vector<int> pts:int pts_count:int = Update;
updateUserTyping#c01e857f user_id:long action:SendMessageAction = Update;
updateChatUserTyping#83487af0 chat_id:long from_id:Peer action:SendMessageAction = Update;
updateChatParticipants#7761198 participants:ChatParticipants = Update;
updateUserStatus#e5bdf8de user_id:long status:UserStatus = Update;
updateUserName#a7848924 user_id:long first_name:string last_name:string usernames:Vector<Username> = Update;
updateNewAuthorization#8951abef flags:# unconfirmed:flags.0?true hash:long date:flags.0?int device:flags.0?string location:flags.0?string = Update;
updateNewEncryptedMessage#12bcbd9a message:EncryptedMessage qts:int = Update;
updateEncryptedChatTyping#1710f156 chat_id:int = Update;
updateEncryption#b4a2e88d chat:EncryptedChat date:int = Update;
updateEncryptedMessagesRead#38fe25b7 chat_id:int max_date:int date:int = Update;
updateChatParticipantAdd#3dda5451 chat_id:long user_id:long inviter_id:long date:int version:int = Update;
updateChatParticipantDelete#e32f3d77 chat_id:long user_id:long version:int = Update;
updateDcOptions#8e5e9873 dc_options:Vector<DcOption> = Update;
updateNotifySettings#bec268ef peer:NotifyPeer notify_settings:PeerNotifySettings = Update;
updateServiceNotification#ebe46819 flags:# popup:flags.0?true invert_media:flags.2?true inbox_date:flags.1?int type:string message:string media:MessageMedia entities:Vector<MessageEntity> = Update;
updatePrivacy#ee3b272a key:PrivacyKey rules:Vector<PrivacyRule> = Update;
updateUserPhone#5492a13 user_id:long phone:string = Update;
updateReadHistoryInbox#9c974fdf flags:# folder_id:flags.0?int peer:Peer max_id:int still_unread_count:int pts:int pts_count:int = Update;
updateReadHistoryOutbox#2f2f21bf peer:Peer max_id:int pts:int pts_count:int = Update;
updateWebPage#7f891213 webpage:WebPage pts:int pts_count:int = Update;
updateReadMessagesContents#f8227181 flags:# messages:Vector<int> pts:int pts_count:int date:flags.0?int = Update;
updateChannelTooLong#108d941f flags:# channel_id:long pts:flags.0?int = Update;
updateChannel#635b4c09 channel_id:long = Update;
updateNewChannelMessage#62ba04d9 message:Message pts:int pts_count:int = Update;
updateReadChannelInbox#922e6e10 flags:# folder_id:flags.0?int channel_id:long max_id:int still_unread_count:int pts:int = Update;
updateDeleteChannelMessages#c32d5b12 channel_id:long messages:Vector<int> pts:int pts_count:int = Update;
updateChannelMessageViews#f226ac08 channel_id:long id:int views:int = Update;
updateChatParticipantAdmin#d7ca61a2 chat_id:long user_id:long is_admin:Bool version:int = Update;
updateNewStickerSet#688a30aa stickerset:messages.StickerSet = Update;
updateStickerSetsOrder#bb2d201 flags:# masks:flags.0?true emojis:flags.1?true order:Vector<long> = Update;
updateStickerSets#31c24808 flags:# masks:flags.0?true emojis:flags.1?true = Update;
updateSavedGifs#9375341e = Update;
updateBotInlineQuery#496f379c flags:# query_id:long user_id:long query:string geo:flags.0?GeoPoint peer_type:flags.1?InlineQueryPeerType offset:string = Update;
updateBotInlineSend#12f12a07 flags:# user_id:long query:string geo:flags.0?GeoPoint id:string msg_id:flags.1?InputBotInlineMessageID = Update;
updateEditChannelMessage#1b3f4df7 message:Message pts:int pts_count:int = Update;
updateBotCallbackQuery#b9cfc48d flags:# query_id:long user_id:long peer:Peer msg_id:int chat_instance:long data:flags.0?bytes game_short_name:flags.1?string = Update;
updateEditMessage#e40370a3 message:Message pts:int pts_count:int = Update;
updateInlineBotCallbackQuery#691e9052 flags:# query_id:long user_id:long msg_id:InputBotInlineMessageID chat_instance:long data:flags.0?bytes game_short_name:flags.1?string = Update;
updateReadChannelOutbox#b75f99a9 channel_id:long max_id:int = Update;
updateDraftMessage#1b49ec6d flags:# peer:Peer top_msg_id:flags.0?int draft:DraftMessage = Update;
updateReadFeaturedStickers#571d2742 = Update;
updateRecentStickers#9a422c20 = Update;
updateConfig#a229dd06 = Update;
updatePtsChanged#3354678f = Update;
updateChannelWebPage#2f2ba99f channel_id:long webpage:WebPage pts:int pts_count:int = Update;
updateDialogPinned#6e6fe51c flags:# pinned:flags.0?true folder_id:flags.1?int peer:DialogPeer = Update;
updatePinnedDialogs#fa0f3ca2 flags:# folder_id:flags.1?int order:flags.0?Vector<DialogPeer> = Update;
updateBotWebhookJSON#8317c0c3 data:DataJSON = Update;
updateBotWebhookJSONQuery#9b9240a6 query_id:long data:DataJSON timeout:int = Update;
updateBotShippingQuery#b5aefd7d query_id:long user_id:long payload:bytes shipping_address:PostAddress = Update;
updateBotPrecheckoutQuery#8caa9a96 flags:# query_id:long user_id:long payload:bytes info:flags.0?PaymentRequestedInfo shipping_option_id:flags.1?string currency:string total_amount:long = Update;
updatePhoneCall#ab0f6b1e phone_call:PhoneCall = Update;
updateLangPackTooLong#46560264 lang_code:string = Update;
updateLangPack#56022f4d difference:LangPackDifference = Update;
updateFavedStickers#e511996d = Update;
updateChannelReadMessagesContents#ea29055d flags:# channel_id:long top_msg_id:flags.0?int messages:Vector<int> = Update;
updateContactsReset#7084a7be = Update;
updateChannelAvailableMessages#b23fc698 channel_id:long available_min_id:int = Update;
updateDialogUnreadMark#e16459c3 flags:# unread:flags.0?true peer:DialogPeer = Update;
updateMessagePoll#aca1657b flags:# poll_id:long poll:flags.0?Poll results:PollResults = Update;
updateChatDefaultBannedRights#54c01850 peer:Peer default_banned_rights:ChatBannedRights version:int = Update;
updateFolderPeers#19360dc0 folder_peers:Vector<FolderPeer> pts:int pts_count:int = Update;
updatePeerSettings#6a7e7366 peer:Peer settings:PeerSettings = Update;
updatePeerLocated#b4afcfb0 peers:Vector<PeerLocated> = Update;
updateNewScheduledMessage#39a51dfb message:Message = Update;
updateDeleteScheduledMessages#90866cee peer:Peer messages:Vector<int> = Update;
updateTheme#8216fba3 theme:Theme = Update;
updateGeoLiveViewed#871fb939 peer:Peer msg_id:int = Update;
updateLoginToken#564fe691 = Update;
updateMessagePollVote#24f40e77 poll_id:long peer:Peer options:Vector<bytes> qts:int = Update;
updateDialogFilter#26ffde7d flags:# id:int filter:flags.0?DialogFilter = Update;
updateDialogFilterOrder#a5d72105 order:Vector<int> = Update;
updateDialogFilters#3504914f = Update;
updatePhoneCallSignalingData#2661bf09 phone_call_id:long data:bytes = Update;
updateChannelMessageForwards#d29a27f4 channel_id:long id:int forwards:int = Update;
updateReadChannelDiscussionInbox#d6b19546 flags:# channel_id:long top_msg_id:int read_max_id:int broadcast_id:flags.0?long broadcast_post:flags.0?int = Update;
updateReadChannelDiscussionOutbox#695c9e7c channel_id:long top_msg_id:int read_max_id:int = Update;
updatePeerBlocked#ebe07752 flags:# blocked:flags.0?true blocked_my_stories_from:flags.1?true peer_id:Peer = Update;
updateChannelUserTyping#8c88c923 flags:# channel_id:long top_msg_id:flags.0?int from_id:Peer action:SendMessageAction = Update;
updatePinnedMessages#ed85eab5 flags:# pinned:flags.0?true peer:Peer messages:Vector<int> pts:int pts_count:int = Update;
updatePinnedChannelMessages#5bb98608 flags:# pinned:flags.0?true channel_id:long messages:Vector<int> pts:int pts_count:int = Update;
updateChat#f89a6a4e chat_id:long = Update;
updateGroupCallParticipants#f2ebdb4e call:InputGroupCall participants:Vector<GroupCallParticipant> version:int = Update;
updateGroupCall#14b24500 chat_id:long call:GroupCall = Update;
updatePeerHistoryTTL#bb9bb9a5 flags:# peer:Peer ttl_period:flags.0?int = Update;
updateChatParticipant#d087663a flags:# chat_id:long date:int actor_id:long user_id:long prev_participant:flags.0?ChatParticipant new_participant:flags.1?ChatParticipant invite:flags.2?ExportedChatInvite qts:int = Update;
updateChannelParticipant#985d3abb flags:# via_chatlist:flags.3?true channel_id:long date:int actor_id:long user_id:long prev_participant:flags.0?ChannelParticipant new_participant:flags.1?ChannelParticipant invite:flags.2?ExportedChatInvite qts:int = Update;
updateBotStopped#c4870a49 user_id:long date:int stopped:Bool qts:int = Update;
updateGroupCallConnection#b783982 flags:# presentation:flags.0?true params:DataJSON = Update;
updateBotCommands#4d712f2e peer:Peer bot_id:long commands:Vector<BotCommand> = Update;
updatePendingJoinRequests#7063c3db peer:Peer requests_pending:int recent_requesters:Vector<long> = Update;
updateBotChatInviteRequester#11dfa986 peer:Peer date:int user_id:long about:string invite:ExportedChatInvite qts:int = Update;
updateMessageReactions#5e1b3cb8 flags:# peer:Peer msg_id:int top_msg_id:flags.0?int reactions:MessageReactions = Update;
updateAttachMenuBots#17b7a20b = Update;
updateWebViewResultSent#1592b79d query_id:long = Update;
updateBotMenuButton#14b85813 bot_id:long button:BotMenuButton = Update;
updateSavedRingtones#74d8be99 = Update;
updateTranscribedAudio#84cd5a flags:# pending:flags.0?true peer:Peer msg_id:int transcription_id:long text:string = Update;
updateReadFeaturedEmojiStickers#fb4c496c = Update;
updateUserEmojiStatus#28373599 user_id:long emoji_status:EmojiStatus = Update;
updateRecentEmojiStatuses#30f443db = Update;
updateRecentReactions#6f7863f4 = Update;
updateMoveStickerSetToTop#86fccf85 flags:# masks:flags.0?true emojis:flags.1?true stickerset:long = Update;
updateMessageExtendedMedia#5a73a98c peer:Peer msg_id:int extended_media:MessageExtendedMedia = Update;
updateChannelPinnedTopic#192efbe3 flags:# pinned:flags.0?true channel_id:long topic_id:int = Update;
updateChannelPinnedTopics#fe198602 flags:# channel_id:long order:flags.0?Vector<int> = Update;
updateUser#20529438 user_id:long = Update;
updateAutoSaveSettings#ec05b097 = Update;
updateGroupInvitePrivacyForbidden#ccf08ad6 user_id:long = Update;
updateStory#75b3b798 peer:Peer story:StoryItem = Update;
updateReadStories#f74e932b peer:Peer max_id:int = Update;
updateStoryID#1bf335b9 id:int random_id:long = Update;
updateStoriesStealthMode#2c084dc1 stealth_mode:StoriesStealthMode = Update;
updateSentStoryReaction#7d627683 peer:Peer story_id:int reaction:Reaction = Update;
updateBotChatBoost#904dd49c peer:Peer boost:Boost qts:int = Update;
updateChannelViewForumAsMessages#7b68920 channel_id:long enabled:Bool = Update;
updatePeerWallpaper#ae3f101d flags:# wallpaper_overridden:flags.1?true peer:Peer wallpaper:flags.0?WallPaper = Update;
updateBotMessageReaction#ac21d3ce peer:Peer msg_id:int date:int actor:Peer old_reactions:Vector<Reaction> new_reactions:Vector<Reaction> qts:int = Update;
updateBotMessageReactions#9cb7759 peer:Peer msg_id:int date:int reactions:Vector<ReactionCount> qts:int = Update;

Constructors

Constructor Description
updateNewMessage New message in a private chat or in a basic group.
updateMessageID Sent message with random_id client identifier was assigned an identifier.
updateDeleteMessages Messages were deleted.
updateUserTyping The user is preparing a message; typing, recording, uploading, etc. This update is valid for 6 seconds. If no further updates of this kind are received after 6 seconds, it should be considered that the user stopped doing whatever they were doing
updateChatUserTyping The user is preparing a message in a group; typing, recording, uploading, etc. This update is valid for 6 seconds. If no further updates of this kind are received after 6 seconds, it should be considered that the user stopped doing whatever they were doing
updateChatParticipants Composition of chat participants changed.
updateUserStatus Contact status update.
updateUserName Changes the user's first name, last name and username.
updateNewAuthorization A new session logged into the current user's account through an unknown device.
updateNewEncryptedMessage New encrypted message.
updateEncryptedChatTyping Interlocutor is typing a message in an encrypted chat. Update period is 6 second. If upon this time there is no repeated update, it shall be considered that the interlocutor stopped typing.
updateEncryption Change of state in an encrypted chat.
updateEncryptedMessagesRead Communication history in an encrypted chat was marked as read.
updateChatParticipantAdd New group member.
updateChatParticipantDelete A member has left the group.
updateDcOptions Changes in the data center configuration options.
updateNotifySettings Changes in notification settings.
updateServiceNotification A service message for the user.

The app must show the message to the user upon receiving this update. In case the popup parameter was passed, the text message must be displayed in a popup alert immediately upon receipt. It is recommended to handle the text as you would an ordinary message in terms of highlighting links, etc. The message must also be stored locally as part of the message history with the user id 777000 (Telegram Notifications).
updatePrivacy Privacy rules were changed
updateUserPhone A user's phone number was changed
updateReadHistoryInbox Incoming messages were read
updateReadHistoryOutbox Outgoing messages were read
updateWebPage An instant view webpage preview was generated
updateReadMessagesContents Contents of messages in the common message box were read
updateChannelTooLong There are new updates in the specified channel, the client must fetch them.
If the difference is too long or if the channel isn't currently in the states, start fetching from the specified pts.
updateChannel Channel/supergroup (channel and/or channelFull) information was updated.

This update can only be received through getDifference or in updates/updatesCombined constructors, so it will always come bundled with the updated channel, that should be applied as usual », without re-fetching the info manually.

However, full peer information will not come bundled in updates, so the full peer cache (channelFull) must be invalidated for channel_id when receiving this update.
updateNewChannelMessage A new message was sent in a channel/supergroup
updateReadChannelInbox Incoming messages in a channel/supergroup were read
updateDeleteChannelMessages Some messages in a supergroup/channel were deleted
updateChannelMessageViews The view counter of a message in a channel has changed
updateChatParticipantAdmin Admin permissions of a user in a basic group were changed
updateNewStickerSet A new stickerset was installed
updateStickerSetsOrder The order of stickersets was changed
updateStickerSets Installed stickersets have changed, the client should refetch them as described in the docs.
updateSavedGifs The saved gif list has changed, the client should refetch it using messages.getSavedGifs
updateBotInlineQuery An incoming inline query
updateBotInlineSend The result of an inline query that was chosen by a user and sent to their chat partner. Please see our documentation on the feedback collecting for details on how to enable these updates for your bot.
updateEditChannelMessage A message was edited in a channel/supergroup
updateBotCallbackQuery A callback button was pressed, and the button data was sent to the bot that created the button
updateEditMessage A message was edited
updateInlineBotCallbackQuery This notification is received by bots when a button is pressed
updateReadChannelOutbox Outgoing messages in a channel/supergroup were read
updateDraftMessage Notifies a change of a message draft.
updateReadFeaturedStickers Some featured stickers were marked as read
updateRecentStickers The recent sticker list was updated
updateConfig The server-side configuration has changed; the client should re-fetch the config using help.getConfig and help.getAppConfig.
updatePtsChanged Common message box sequence PTS has changed, state has to be refetched using updates.getState
updateChannelWebPage A webpage preview of a link in a channel/supergroup message was generated
updateDialogPinned A dialog was pinned/unpinned
updatePinnedDialogs Pinned dialogs were updated
updateBotWebhookJSON A new incoming event; for bots only
updateBotWebhookJSONQuery A new incoming query; for bots only
updateBotShippingQuery This object contains information about an incoming shipping query.
updateBotPrecheckoutQuery This object contains information about an incoming pre-checkout query.
updatePhoneCall An incoming phone call
updateLangPackTooLong A language pack has changed, the client should manually fetch the changed strings using langpack.getDifference
updateLangPack Language pack updated
updateFavedStickers The list of favorited stickers was changed, the client should call messages.getFavedStickers to refetch the new list
updateChannelReadMessagesContents The specified channel/supergroup messages were read
updateContactsReset All contacts were deleted
updateChannelAvailableMessages The history of a channel/supergroup was hidden.
updateDialogUnreadMark The manual unread mark of a chat was changed
updateMessagePoll The results of a poll have changed
updateChatDefaultBannedRights Default banned rights in a normal chat were updated
updateFolderPeers The peer list of a peer folder was updated
updatePeerSettings Settings of a certain peer have changed
updatePeerLocated List of peers near you was updated
updateNewScheduledMessage A message was added to the schedule queue of a chat
updateDeleteScheduledMessages Some scheduled messages were deleted (or sent) from the schedule queue of a chat
updateTheme A cloud theme was updated
updateGeoLiveViewed Live geoposition message was viewed
updateLoginToken A login token (for login via QR code) was accepted.
updateMessagePollVote A specific peer has voted in a poll
updateDialogFilter A new folder was added
updateDialogFilterOrder New folder order
updateDialogFilters Clients should update folder info
updatePhoneCallSignalingData Incoming phone call signaling payload
updateChannelMessageForwards The forward counter of a message in a channel has changed
updateReadChannelDiscussionInbox Incoming comments in a discussion thread were marked as read
updateReadChannelDiscussionOutbox Outgoing comments in a discussion thread were marked as read
updatePeerBlocked We blocked a peer, see here » for more info on blocklists.
updateChannelUserTyping A user is typing in a supergroup, channel or message thread
updatePinnedMessages Some messages were pinned in a chat
updatePinnedChannelMessages Messages were pinned/unpinned in a channel/supergroup
updateChat Chat (chat and/or chatFull) information was updated.

This update can only be received through getDifference or in updates/updatesCombined constructors, so it will always come bundled with the updated chat, that should be applied as usual », without re-fetching the info manually.

However, full peer information will not come bundled in updates, so the full peer cache (chatFull) must be invalidated for chat_id when receiving this update.
updateGroupCallParticipants The participant list of a certain group call has changed
updateGroupCall A new groupcall was started
updatePeerHistoryTTL The Time-To-Live for messages sent by the current user in a specific chat has changed
updateChatParticipant A user has joined or left a specific chat
updateChannelParticipant A participant has left, joined, was banned or admined in a channel or supergroup.
updateBotStopped A bot was stopped or re-started.
updateGroupCallConnection New WebRTC parameters
updateBotCommands The command set of a certain bot in a certain chat has changed.
updatePendingJoinRequests Someone has requested to join a chat or channel
updateBotChatInviteRequester Someone has requested to join a chat or channel (bots only, users will receive an updatePendingJoinRequests, instead)
updateMessageReactions New message reactions » are available
updateAttachMenuBots The list of installed attachment menu entries » has changed, use messages.getAttachMenuBots to fetch the updated list.
updateWebViewResultSent Indicates to a bot that a webview was closed and an inline message was sent on behalf of the user using messages.sendWebViewResultMessage
updateBotMenuButton The menu button behavior for the specified bot has changed
updateSavedRingtones The list of saved notification sounds has changed, use account.getSavedRingtones to fetch the new list.
updateTranscribedAudio A pending voice message transcription » initiated with messages.transcribeAudio was updated.
updateReadFeaturedEmojiStickers Some featured custom emoji stickers were marked as read
updateUserEmojiStatus The emoji status of a certain user has changed
updateRecentEmojiStatuses The list of recent emoji statuses has changed
updateRecentReactions The list of recent message reactions has changed
updateMoveStickerSetToTop A stickerset was just moved to top, see here for more info »
updateMessageExtendedMedia You bought a paid media »: this update contains the revealed media.
updateChannelPinnedTopic A forum topic » was pinned or unpinned.
updateChannelPinnedTopics The pinned topics of a forum have changed.
updateUser User (user and/or userFull) information was updated.

This update can only be received through getDifference or in updates/updatesCombined constructors, so it will always come bundled with the updated user, that should be applied as usual », without re-fetching the info manually.

However, full peer information will not come bundled in updates, so the full peer cache (userFull) must be invalidated for user_id when receiving this update.
updateAutoSaveSettings Media autosave settings have changed and must be refetched using account.getAutoSaveSettings.
updateStory A new story was posted.
updateReadStories Stories of a specific peer were marked as read.
updateStoryID A story was successfully uploaded.

Once a story is successfully uploaded, an updateStoryID will be returned, indicating the story ID (id) that was attributed to the story (like for messages, random_id indicates the random_id that was passed to stories.sendStory: this way, you can tell which story was assigned a specific id by checking which stories.sendStory call has the returned random_id).
updateStoriesStealthMode Indicates that stories stealth mode was activated.
updateSentStoryReaction Indicates we reacted to a story ».
updateBotChatBoost A channel/supergroup boost has changed (bots only)
updateChannelViewForumAsMessages Users may also choose to display messages from all topics as if they were sent to a normal group, using a "View as messages" setting in the local client.
This setting only affects the current account, and is synced to other logged in sessions using the channels.toggleViewForumAsMessages method; invoking this method will update the value of the view_forum_as_messages flag of channelFull or dialog and emit an updateChannelViewForumAsMessages.
updatePeerWallpaper The wallpaper » of a given peer has changed.
updateBotMessageReaction Bots only: a user has changed their reactions on a message with public reactions.
updateBotMessageReactions Bots only: the number of reactions on a message with anonymous reactions has changed.
updateSavedDialogPinned A saved message dialog was pinned/unpinned
updatePinnedSavedDialogs Pinned saved dialogs » were updated
updateSavedReactionTags The list of reaction tag » names assigned by the user has changed and should be refetched using messages.getSavedReactionTags ».
updateSmsJob A new SMS job was received
updateQuickReplies Info about or the order of quick reply shortcuts » was changed.
updateNewQuickReply A new quick reply shortcut » was created.
updateDeleteQuickReply A quick reply shortcut » was deleted. This will not emit updateDeleteQuickReplyMessages updates, even if all the messages in the shortcut are also deleted by this update.
updateQuickReplyMessage A new message was added to a quick reply shortcut ».
updateDeleteQuickReplyMessages One or more messages in a quick reply shortcut » were deleted.
updateBotBusinessConnect Connecting or disconnecting a business bot or changing the connection settings will emit an updateBotBusinessConnect update to the bot, with the new settings and a connection_id that will be used by the bot to handle updates from and send messages as the user.
updateBotNewBusinessMessage A message was received via a connected business chat ».
updateBotEditBusinessMessage A message was edited in a connected business chat ».
updateBotDeleteBusinessMessage A message was deleted in a connected business chat ».
updateNewStoryReaction Represents a new reaction to a story.
updateBroadcastRevenueTransactions A new channel ad revenue transaction was made, see here » for more info.
updateStarsBalance The current account's Telegram Stars balance » has changed.
updateBusinessBotCallbackQuery A callback button sent via a business connection was pressed, and the button data was sent to the bot that created the button.
updateStarsRevenueStatus The Telegram Star balance of a channel/bot we own has changed ».
updateBotPurchasedPaidMedia Bots only: a user has purchased a paid media.
updatePaidReactionPrivacy Contains the current default paid reaction privacy, see here » for more info.

Clients should invoke messages.getPaidReactionPrivacy on startup to fetch the current default reaction privacy because this update is only sent to currently online sessions and cannot be fetched using getDifference on client startup.