telegram api type · layer 229

Update

Object contains info on events occurred.

constructors (165)

constructoriddescription
updateNewMessage#1f2b0afdNew message in a private chat or in a basic group.
updateMessageID#4e90bfd6Sent message with random_id client identifier was assigned an identifier.
updateDeleteMessages#a20db0e5Messages were deleted.
updateUserTyping#2a17bf5cThe 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#83487af0The 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#07761198Composition of chat participants changed.
updateUserStatus#e5bdf8deContact status update.
updateUserName#a7848924Changes the user's first name, last name and username.
updateNewAuthorization#8951abefA new session logged into the current user's account through an unknown device.
updateNewEncryptedMessage#12bcbd9aNew encrypted message.
updateEncryptedChatTyping#1710f156Interlocutor 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#b4a2e88dChange of state in an encrypted chat.
updateEncryptedMessagesRead#38fe25b7Communication history in an encrypted chat was marked as read.
updateChatParticipantAdd#3dda5451New group member.
updateChatParticipantDelete#e32f3d77A member has left the group.
updateDcOptions#8e5e9873Changes in the data center configuration options.
updateNotifySettings#bec268efChanges in notification settings.
updateServiceNotification#ebe46819A service message for the user.
updatePrivacy#ee3b272aPrivacy rules were changed
updateUserPhone#05492a13A user's phone number was changed
updateReadHistoryInbox#9e84bc99Incoming messages were read
updateReadHistoryOutbox#2f2f21bfOutgoing messages were read
updateWebPage#7f891213An instant view webpage preview was generated
updateReadMessagesContents#f8227181Contents of messages in the common message box were read (emitted specifically for messages like voice messages or video, only once the media is watched and marked as read using messages.readMessageContents).
updateChannelTooLong#108d941fThere 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#635b4c09Channel/supergroup (channel and/or channelFull) information was updated.
updateNewChannelMessage#62ba04d9A new message was sent in a channel/supergroup
updateReadChannelInbox#922e6e10Incoming messages in a channel/supergroup were read
updateDeleteChannelMessages#c32d5b12Some messages in a supergroup/channel were deleted
updateChannelMessageViews#f226ac08The view counter of a message in a channel has changed
updateChatParticipantAdmin#d7ca61a2Admin permissions of a user in a basic group were changed
updateNewStickerSet#688a30aaA new stickerset was installed
updateStickerSetsOrder#0bb2d201The order of stickersets was changed
updateStickerSets#31c24808Installed stickersets have changed, the client should refetch them as described in the docs.
updateSavedGifs#9375341eThe saved gif list has changed, the client should refetch it using messages.getSavedGifs
updateBotInlineQuery#496f379cAn incoming inline query
updateBotInlineSend#12f12a07The 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#1b3f4df7A message was edited in a channel/supergroup
updateBotCallbackQuery#b9cfc48dA callback button was pressed, and the button data was sent to the bot that created the button
updateEditMessage#e40370a3A message was edited
updateInlineBotCallbackQuery#691e9052This notification is received by bots when a button is pressed
updateReadChannelOutbox#b75f99a9Outgoing messages in a channel/supergroup were read
updateDraftMessage#edfc111eNotifies a change of a message draft.
updateReadFeaturedStickers#571d2742Some featured stickers were marked as read
updateRecentStickers#9a422c20The recent sticker list was updated
updateConfig#a229dd06The server-side configuration has changed; the client should re-fetch the config using help.getConfig and help.getAppConfig.
updatePtsChanged#3354678fCommon message box sequence PTS has changed, state has to be refetched using updates.getState
updateChannelWebPage#2f2ba99fA webpage preview of a link in a channel/supergroup message was generated
updateDialogPinned#6e6fe51cA dialog was pinned/unpinned
updatePinnedDialogs#fa0f3ca2Pinned dialogs were updated
updateBotWebhookJSON#8317c0c3A new incoming event; for bots only
updateBotWebhookJSONQuery#9b9240a6A new incoming query; for bots only
updateBotShippingQuery#b5aefd7dThis object contains information about an incoming shipping query.
updateBotPrecheckoutQuery#8caa9a96This object contains information about an incoming pre-checkout query.
updatePhoneCall#ab0f6b1eAn incoming phone call
updateLangPackTooLong#46560264A language pack has changed, the client should manually fetch the changed strings using langpack.getDifference
updateLangPack#56022f4dLanguage pack updated
updateFavedStickers#e511996dThe list of favorited stickers was changed, the client should call messages.getFavedStickers to refetch the new list
updateChannelReadMessagesContents#25f324f7The specified channel/supergroup messages were read (emitted specifically for messages like voice messages or video, only once the media is watched and marked as read using channels.readMessageContents)
updateContactsReset#7084a7beAll contacts were deleted
updateChannelAvailableMessages#b23fc698The history of a channel/supergroup was hidden.
updateDialogUnreadMark#b658f23eThe manual unread mark of a chat was changed
updateMessagePoll#d64c522bThe results of a poll have changed
updateChatDefaultBannedRights#54c01850Default banned rights in a normal chat were updated
updateFolderPeers#19360dc0The peer list of a peer folder was updated
updatePeerSettings#6a7e7366Settings of a certain peer have changed
updatePeerLocated#b4afcfb0List of peers near you was updated
updateNewScheduledMessage#39a51dfbA message was added to the schedule queue of a chat
updateDeleteScheduledMessages#f2a71983Some scheduled messages were deleted (or sent) from the schedule queue of a chat
updateTheme#8216fba3A cloud theme was updated
updateGeoLiveViewed#871fb939Live geoposition message was viewed
updateLoginToken#564fe691A login token (for login via QR code) was accepted.
updateMessagePollVote#7699f014A specific peer has voted in a poll
updateDialogFilter#26ffde7dA new folder was added
updateDialogFilterOrder#a5d72105New folder order
updateDialogFilters#3504914fClients should update folder info
updatePhoneCallSignalingData#2661bf09Incoming phone call signaling payload
updateChannelMessageForwards#d29a27f4The forward counter of a message in a channel has changed
updateReadChannelDiscussionInbox#d6b19546Incoming comments in a discussion thread were marked as read
updateReadChannelDiscussionOutbox#695c9e7cOutgoing comments in a discussion thread were marked as read
updatePeerBlocked#ebe07752We blocked a peer, see here » for more info on blocklists.
updateChannelUserTyping#8c88c923A user is typing in a supergroup, channel or message thread
updatePinnedMessages#ed85eab5Some messages were pinned in a chat
updatePinnedChannelMessages#5bb98608Messages were pinned/unpinned in a channel/supergroup
updateChat#f89a6a4eChat (chat and/or chatFull) information was updated.
updateGroupCallParticipants#f2ebdb4eThe participant list of a certain group call has changed
updateGroupCall#9d2216e0A new groupcall was started
updatePeerHistoryTTL#bb9bb9a5The Time-To-Live for messages sent by the current user in a specific chat has changed
updateChatParticipant#d087663aA user has joined or left a specific chat
updateChannelParticipant#985d3abbA participant has left, joined, was banned or admined in a channel or supergroup.
updateBotStopped#c4870a49A bot was stopped or re-started.
updateGroupCallConnection#0b783982New WebRTC parameters
updateBotCommands#4d712f2eThe command set of a certain bot in a certain chat has changed.
updatePendingJoinRequests#7063c3dbSomeone has requested to join a chat or channel
updateBotChatInviteRequester#7cb34d79Someone has requested to join a chat or channel (bots only, users will receive an updatePendingJoinRequests, instead)
updateMessageReactions#1e297bfaNew message reactions » are available
updateAttachMenuBots#17b7a20bThe list of installed attachment menu entries » has changed, use messages.getAttachMenuBots to fetch the updated list.
updateWebViewResultSent#1592b79dIndicates to a bot that a webview was closed and an inline message was sent on behalf of the user using messages.sendWebViewResultMessage
updateBotMenuButton#14b85813The menu button behavior for the specified bot has changed
updateSavedRingtones#74d8be99The list of saved notification sounds has changed, use account.getSavedRingtones to fetch the new list.
updateTranscribedAudio#0084cd5aA pending voice message transcription » initiated with messages.transcribeAudio was updated.
updateReadFeaturedEmojiStickers#fb4c496cSome featured custom emoji stickers were marked as read
updateUserEmojiStatus#28373599The emoji status of a certain user has changed
updateRecentEmojiStatuses#30f443dbThe list of recent emoji statuses has changed
updateRecentReactions#6f7863f4The list of recent message reactions has changed
updateMoveStickerSetToTop#86fccf85A stickerset was just moved to top, see here for more info »
updateMessageExtendedMedia#d5a41724You bought a paid media »: this update contains the revealed media.
updateUser#20529438User (user and/or userFull) information was updated.
updateAutoSaveSettings#ec05b097Media autosave settings have changed and must be refetched using account.getAutoSaveSettings.
updateStory#75b3b798A new story was posted.
updateReadStories#f74e932bStories of a specific peer were marked as read.
updateStoryID#1bf335b9A story was successfully uploaded.
updateStoriesStealthMode#2c084dc1Indicates that stories stealth mode was activated.
updateSentStoryReaction#7d627683Indicates we reacted to a story ».
updateBotChatBoost#904dd49cA channel/supergroup boost has changed (bots only)
updateChannelViewForumAsMessages#07b68920Users 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#ae3f101dThe wallpaper » of a given peer has changed.
updateBotMessageReaction#ac21d3ceBots only: a user has changed their reactions on a message with public reactions.
updateBotMessageReactions#09cb7759Bots only: the number of reactions on a message with anonymous reactions has changed.
updateSavedDialogPinned#aeaf9e74A saved message dialog was pinned/unpinned
updatePinnedSavedDialogs#686c85a6Pinned saved dialogs » were updated
updateSavedReactionTags#39c67432The list of reaction tag » names assigned by the user has changed and should be refetched using messages.getSavedReactionTags ».
updateSmsJob#f16269d4A new SMS job was received
updateQuickReplies#f9470ab2Info about or the order of quick reply shortcuts » was changed.
updateNewQuickReply#f53da717A new quick reply shortcut » was created.
updateDeleteQuickReply#53e6f1ecA 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#3e050d0fA new message was added to a quick reply shortcut ».
updateDeleteQuickReplyMessages#566fe7cdOne or more messages in a quick reply shortcut » were deleted.
updateBotBusinessConnect#8ae5c97aConnecting 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#9ddb347cA message was received via a connected business chat ».
updateBotEditBusinessMessage#07df587cA message was edited in a connected business chat ».
updateBotDeleteBusinessMessage#a02a982eA message was deleted in a connected business chat ».
updateNewStoryReaction#1824e40bRepresents a new reaction to a story.
updateStarsBalance#4e80a379The current account's Telegram Stars balance » has changed.
updateBusinessBotCallbackQuery#1ea2fda7A callback button sent via a business connection was pressed, and the button data was sent to the bot that created the button.
updateStarsRevenueStatus#a584b019The Telegram Star balance of a channel/bot we own has changed ».
updateBotPurchasedPaidMedia#283bd312Bots only: a user has purchased a paid media.
updatePaidReactionPrivacy#8b725fceContains the current default paid reaction privacy, see here » for more info.
updateSentPhoneCode#504aa18fA paid login SMS code was successfully sent.
updateGroupCallChainBlocks#a477288fContains updates to the blockchain of a conference call, see here » for more info.
updateReadMonoForumInbox#77b0e372Incoming messages in a monoforum topic were read
updateReadMonoForumOutbox#a4a79376Outgoing messages in a monoforum were read.
updateMonoForumNoPaidException#9f812b08An admin has (un)exempted this monoforum topic » from payment to send messages using account.toggleNoPaidMessagesException.
updateGroupCallMessage#d8326f0d
updateGroupCallEncryptedMessage#c957a766
updatePinnedForumTopic#683b2c52
updatePinnedForumTopics#def143d0
updateDeleteGroupCallMessages#3e85e92c
updateStarGiftAuctionState#48e246c2
updateStarGiftAuctionUserState#dc58f31e
updateEmojiGameInfo#fb9c547a
updateStarGiftCraftFail#ac072444
updateChatParticipantRank#bd8367b9
updateManagedBot#4880ed9a
updateBotGuestChatQuery#cdd4093d
updateAiComposeTones#8c0f91fb
updateJoinChatWebViewDecision#bdac7e70
updateNewBotConnection#b22083a6
updateWebBrowserSettings#c39a2ade
updateWebBrowserException#140502d1
updateNewEphemeralMessage#20bcbba1
updateDeleteEphemeralMessages#56dbfcf8
updateEditEphemeralMessage#4bbb8f01
updateEphemeralBotCallbackQuery#7c1079d6
updateBotStarsSubscription#6c0d8e23

used by (6)