Structs
Contains information about the period of inactivity after which the current user’s account will automatically be deleted
Represents a reaction applied to a message
Represents a list of reactions added to a message
Describes an address
Animated variant of a chat photo in MPEG4 format
Describes an animated or custom representation of an emoji
Describes an animation file. The animation must be encoded in GIF or MPEG4 format
Represents a list of animations
Represents a bot added to attachment menu
Describes a color to highlight a bot added to attachment menu
Describes an audio file. Audio is usually in MP3 or M4A format
Information about the authentication code that was sent
An authentication code is delivered via a phone call to the specified phone number
An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number that calls is the code that must be entered automatically
An authentication code is delivered by an immediately canceled call to the specified phone number. The last digits of the phone number that calls are the code that must be entered manually by the user
An authentication code is delivered via an SMS message to the specified phone number
An authentication code is delivered via a private Telegram message, which can be viewed from another active session
TDLib needs the user’s authentication code to authorize
TDLib needs the user’s email address to authorize. Call
setAuthenticationEmailAddress to provide the email address, or directly call checkAuthenticationEmailCode with Apple ID/Google ID token if allowedTDLib needs the user’s authentication code sent to an email address to authorize. Call
checkAuthenticationEmailCode to provide the codeThe user needs to confirm authorization on another logged in device by scanning a QR code with the provided link
The user has been authorized, but needs to enter a 2-step verification password to start using the application
The user is unregistered and need to accept terms of service and enter their first name and last name to finish registration
Contains auto-download settings
Contains auto-download settings presets for the current user
Represents an available reaction
Represents a list of reactions that can be added to a message
Describes a chat background
Describes a freeform gradient fill of a background
Describes a gradient fill of a background
Describes a solid fill of a background
A filled background
A PNG or TGV (gzipped subset of SVG with MIME type “application/x-tgwallpattern”) pattern to be combined with the background fill chosen by the user
A wallpaper in JPEG format
Contains a list of backgrounds
Describes an action associated with a bank card number
Information about a bank card
Represents a basic group of 0-200 users (must be upgraded to a supergroup to accommodate more than 200 users)
Contains full information about a basic group
Represents a command supported by a bot
A scope covering all members of a chat
A scope covering all administrators of a chat
A scope covering a member of a chat
Contains a list of bot commands
Contains information about a bot
Describes a button to be shown instead of bot commands menu button
Describes a call
Contains the call identifier
Specifies the supported call protocols
Describes a server for relaying call data
A Telegram call reflector
A WebRTC server
The call has ended successfully
The call has ended with an error
The call is pending, waiting to be accepted by a user
The call is ready to use
Contains a bot’s answer to a callback query
The payload for a general callback button
The payload for a callback button requiring password
The payload for a game callback button
The 2-step verification was enabled recently, user needs to wait
The session was created recently, user needs to wait
A chat. (Can be a private chat, basic group, supergroup, or secret chat)
The chat is a private chat with an administrator of a chat to which the user sent join request
The chat is a private or secret chat, which can be reported using the method reportChat, or the other user can be blocked using the method toggleMessageSenderIsBlocked, or the other user can be added to the contact list using the method addContact. If the chat is a private chat with a user with an emoji status, then a notice about emoji status usage must be shown
The chat can be reported as spam using the method reportChat with the reason chatReportReasonSpam. If the chat is a private chat with a user with an emoji status, then a notice about emoji status usage must be shown
The user is uploading a document
The user is uploading a photo
The user is uploading a video
The user is uploading a video note
The user is uploading a voice note
The user is watching animations sent by the other party by clicking on an animated emoji
Contains information about a chat administrator
Describes rights of the administrator
Represents a list of chat administrators
Only specific reactions are available in the chat
Represents a chat event
The chat active usernames were changed
The chat available reactions were changed
The chat description was changed
A new forum topic was created
A forum topic was deleted
A forum topic was edited
A pinned forum topic was changed
A forum topic was closed or reopened
The has_protected_content setting of a channel was toggled
A revoked chat invite link was deleted
A chat invite link was edited
A chat invite link was revoked
The can_invite_users permission of a supergroup chat was toggled
The is_all_history_available setting of a supergroup was toggled
The is_forum setting of a channel was toggled
The linked chat of a supergroup was changed
The supergroup location was changed
Represents a set of filters used to obtain a chat event log
A new chat member was invited
A new member joined the chat via an invite link
A new member was accepted to the chat by an administrator
A chat member has gained/lost administrator status, or the list of their administrator privileges has changed
A chat member was restricted/unrestricted or banned/unbanned, or the list of their restrictions has changed
A message was deleted
A message was edited
A message was pinned
The message TTL was changed
A message was unpinned
The chat permissions was changed
The chat photo was changed
A poll in a message was stopped
The sign_messages setting of a channel was toggled
The slow_mode_delay setting of a supergroup was changed
The supergroup sticker set was changed
The chat title was changed
The chat editable username was changed
A video chat was created
A video chat was ended
The mute_new_participants setting of a video chat was toggled
A video chat participant was muted or unmuted
A video chat participant volume level was changed
Contains a list of chat events
Represents a filter of user chats
Contains basic information about a chat filter
Contains a chat invite link
Describes a chat administrator with a number of active and revoked chat invite links
Contains a list of chat invite link counts
Contains information about a chat invite link
Describes a chat member joined a chat via an invite link
Contains a list of chat members joined a chat via an invite link
Contains a list of chat invite links
Describes a user that sent a join request and waits for administrator approval
Contains a list of requests to join a chat
Contains information about pending join requests for a chat
A list of chats belonging to a chat filter
Contains a list of chat lists
Represents a location to which a chat is connected
Describes a user or a chat as a member of another chat
The user is a member of the chat and has some additional privileges. In basic groups, administrators can edit and delete messages sent by others, add new members, ban unprivileged members, and manage video chats. In supergroups and channels, there are more detailed options for administrator privileges
The user or the chat was banned (and hence is not a member of the chat). Implies the user can’t return to the chat, view messages, or be used as a participant identifier to join a video chat of the chat
The user is the owner of the chat and has all the administrator privileges
The user is under certain restrictions in the chat. Not supported in basic groups and channels
Contains a list of chat members
Returns users which can be mentioned in the chat
Represents a message sender, which can be used to send messages in a chat
Represents a list of message senders, which can be used to send messages in a chat
Describes a chat located nearby
Contains information about notification settings for a chat
Describes actions that a user is allowed to take in a chat
Describes a chat or user profile photo
Contains basic information about the photo of a chat
Contains a list of chat or user profile photos
Describes a position of a chat in a chat list
The chat contains a public service announcement
Contains statistics about administrator actions done by a user
A detailed statistics about a channel chat
Contains statistics about number of new members invited by a user
Contains statistics about interactions with a message
Contains statistics about messages sent by a user
A detailed statistics about a supergroup chat
Describes a chat theme
A basic group (a chat with 0-200 other users)
An ordinary chat with a user
A secret chat with a user
A supergroup or channel (with unlimited members)
Represents a list of chats
Represents a list of chats located nearby
Represents a closed vector path. The path begins at the end point of the last command
Contains information about one website the current user is logged in with Telegram
Contains a list of websites the current user is logged in with Telegram
Describes a user contact
Contains a counter
Contains information about countries
Contains information about a country
Contains the result of a custom request
Contains database statistics
Represents a date according to the Gregorian calendar
Represents a date range
File with the date it was uploaded
Contains information about a tg: deep link
A token for Apple Push Notification service
A token for Apple Push Notification service VoIP notifications
A token for BlackBerry Push Service
A token for Firebase Cloud Messaging
A token for Microsoft Push Notification Service
A token for Microsoft Push Notification Service VoIP channel
A token for Simple Push API for Firefox OS
A token for Tizen Push Service
A token for Ubuntu Push Client service
A token for web Push API
A token for Windows Push Notification Services
A regular animated sticker
Animated stickers to be combined into a slot machine
Describes a document of any type
Contains number of being downloaded and recently downloaded files found
Contains information about a message draft
An authentication token received through Apple ID
An authentication code delivered to a user’s email address
Information about the email address authentication code that was sent
An authentication token received through Google ID
Contains information about a emoji reaction
Describes a custom emoji to be shown instead of the Telegram Premium badge
Contains a list of emoji statuses
Represents a list of emoji
Contains encrypted Telegram Passport data credentials
Contains information about an encrypted Telegram Passport element; for bots only
An object of this type can be returned on every function call, in case of an error
Represents a file
Describes a file added to file download list
Contains size of downloaded prefix of a file
Contains a part of a file
A text with some entities
Describes a forum topic
Describes a forum topic icon
Contains basic information about a forum topic
Contains a list of downloaded files, found by a search
Contains a list of messages found by a search
Describes a game
Contains one row of the game high score table
Contains a list of game high scores
Describes a group call
Contains the group call identifier
Represents a group call participant
Contains information about a group call participant’s video channel
Describes a recently speaking participant in a group call
Describes an available stream in a group call
Represents a list of group call streams
Describes a group of video synchronization source identifiers
Contains a list of hashtags
Contains an HTTP URL
An identity document
Represents the result of an ImportContacts request
Represents a single button in an inline keyboard
A button that sends a callback query to a bot
A button that asks for the 2-step verification password of the current user and then sends a callback query to a bot
A button that opens a specified URL and automatically authorize the current user by calling getLoginUrlInfo
A button that forces an inline query to the bot to be inserted in the input field
A button that opens a specified URL
A button with a user reference to be handled in the same way as textEntityTypeMentionName entities
A button that opens a Web App by calling openWebApp
Represents an animation file
Represents a link to an article or web page
Represents an audio file
Represents a user contact
Represents a document
Represents information about a game
Represents a point on the map
Represents a photo
Represents a sticker
Represents information about a venue
Represents a video
Represents a voice note
Represents the results of the inline query. Use sendInlineQueryResultMessage to send the result of the query
A background from a local file
A background from the server
An animation in MPEG4 format; must be square, at most 10 seconds long, have width between 160 and 800 and be at most 2MB in size
A previously used profile photo of the current user
A static photo in JPEG format
Applies if a user enters new credentials using Apple Pay
Applies if a user enters new credentials using Google Pay
Applies if a user enters new credentials on a payment provider website
Applies if a user chooses some previously saved payment credentials. To use their previously saved credentials, the user must have a valid temporary password
A file generated by the application
A file defined by its unique ID
A file defined by a local path
A file defined by its remote ID. The remote ID is guaranteed to be usable only if the corresponding file is still accessible to the user and known to TDLib.
For example, if the file is from a message, then the message must be not deleted and accessible to the user. If the file database is disabled, then the corresponding object with the file must be preloaded by the application
An identity document to be saved to Telegram Passport
Represents a link to an animated GIF or an animated (i.e., without sound) H.264/MPEG-4 AVC video
Represents a link to an article or web page
Represents a link to an MP3 audio file
Represents a user contact
Represents a link to a file
Represents a game
Represents a point on the map
Represents link to a JPEG image
Represents a link to a WEBP, TGS, or WEBM sticker
Represents information about a venue
Represents a link to a page containing an embedded video player or a video file
Represents a link to an opus-encoded audio file within an OGG container, single channel audio
An invoice from a message of the type messageInvoice
An invoice from a link of the type internalLinkTypeInvoice
An animation message (GIF-style).
An audio message
A message containing a user contact
A dice message
A document message (general file)
A forwarded message
A message with a game; not supported for channels or secret chats
A message with an invoice; can be used only by bots
A message with a location
A photo message
A message with a poll. Polls can’t be sent to secret chats. Polls can be sent only to a private chat with a bot
A sticker message
A text message
A message with information about a venue
A video message
A video note message
A voice note message
A Telegram Passport element to be saved containing the user’s address
A Telegram Passport element to be saved containing the user’s bank statement
A Telegram Passport element to be saved containing the user’s driver license
A Telegram Passport element to be saved containing the user’s email address
Contains the description of an error in a Telegram Passport element; for bots only
A data field contains an error. The error is considered resolved when the field’s value changes
The file contains an error. The error is considered resolved when the file changes
The list of attached files contains an error. The error is considered resolved when the file list changes
The front side of the document contains an error. The error is considered resolved when the file with the front side of the document changes
The reverse side of the document contains an error. The error is considered resolved when the file with the reverse side of the document changes
The selfie contains an error. The error is considered resolved when the file with the selfie changes
One of the files containing the translation of the document contains an error. The error is considered resolved when the file with the translation changes
The translation of the document contains an error. The error is considered resolved when the list of files changes
The element contains an error in an unspecified place. The error will be considered resolved when new data is added
A Telegram Passport element to be saved containing the user’s identity card
A Telegram Passport element to be saved containing the user’s internal passport
A Telegram Passport element to be saved containing the user’s passport
A Telegram Passport element to be saved containing the user’s passport registration
A Telegram Passport element to be saved containing the user’s personal details
A Telegram Passport element to be saved containing the user’s phone number
A Telegram Passport element to be saved containing the user’s rental agreement
A Telegram Passport element to be saved containing the user’s temporary registration
A Telegram Passport element to be saved containing the user’s utility bill
A personal document to be saved to Telegram Passport
A sticker to be added to a sticker set
A thumbnail to be sent along with a file; must be in JPEG or WEBP format for stickers, and less than 200 KB in size
The link is a link to an attachment menu bot to be opened in the specified or a chosen chat. Process given target_chat to open the chat.
Then call searchPublicChat with the given bot username, check that the user is a bot and can be added to attachment menu. Then use getAttachmentMenuBot to receive information about the bot.
If the bot isn’t added to attachment menu, then user needs to confirm adding the bot to attachment menu. If user confirms adding, then use toggleBotIsAddedToAttachmentMenu to add it.
If the attachment menu bot can’t be used in the opened chat, show an error to the user. If the bot is added to attachment menu and can be used in the chat, then use openWebApp with the given URL
The link contains an authentication code. Call checkAuthenticationCode with the code if the current authorization state is authorizationStateWaitCode
The link is a link to a background. Call searchBackground with the given background name to process the link
The link is a link to a Telegram bot, which is supposed to be added to a channel chat as an administrator. Call searchPublicChat with the given bot username and check that the user is a bot,
ask the current user to select a channel chat to add the bot to as an administrator. Then call getChatMember to receive the current bot rights in the chat and if the bot already is an administrator,
check that the current user can edit its administrator rights and combine received rights with the requested administrator rights. Then show confirmation box to the user, and call setChatMemberStatus with the chosen chat and confirmed rights
The link is a link to a chat with a Telegram bot. Call searchPublicChat with the given bot username, check that the user is a bot, show START button in the chat with the bot,
and then call sendBotStartMessage with the given start parameter after the button is pressed
The link is a link to a Telegram bot, which is supposed to be added to a group chat. Call searchPublicChat with the given bot username, check that the user is a bot and can be added to groups,
ask the current user to select a basic group or a supergroup chat to add the bot to, taking into account that bots can be added to a public supergroup only by administrators of the supergroup.
If administrator rights are provided by the link, call getChatMember to receive the current bot rights in the chat and if the bot already is an administrator,
check that the current user can edit its administrator rights, combine received rights with the requested administrator rights, show confirmation box to the user,
and call setChatMemberStatus with the chosen chat and confirmed administrator rights. Before call to setChatMemberStatus it may be required to upgrade the chosen basic group chat to a supergroup chat.
Then if start_parameter isn’t empty, call sendBotStartMessage with the given start parameter and the chosen chat, otherwise just send /start message with bot’s username added to the chat.
The link is a chat invite link. Call checkChatInviteLink with the given invite link to process the link
The link is a link to a game. Call searchPublicChat with the given bot username, check that the user is a bot, ask the current user to select a chat to send the game, and then call sendMessage with inputMessageGame
The link must be opened in an Instant View. Call getWebPageInstantView with the given URL to process the link
The link is a link to an invoice. Call getPaymentForm with the given invoice name to process the link
The link is a link to a language pack. Call getLanguagePackInfo with the given language pack identifier to process the link
The link is a link to a Telegram message. Call getMessageLinkInfo with the given URL to process the link
The link contains a message draft text. A share screen needs to be shown to the user, then the chosen chat must be opened and the text is added to the input field
The link contains a request of Telegram passport data. Call getPassportAuthorizationForm with the given parameters to process the link if the link was received from outside of the application, otherwise ignore it
The link can be used to confirm ownership of a phone number to prevent account deletion. Call sendPhoneNumberConfirmationCode with the given hash and phone number to process the link
The link is a link to the Premium features screen of the applcation from which the user can subscribe to Telegram Premium. Call getPremiumFeatures with the given referrer to process the link
The link is a link to a proxy. Call addProxy with the given parameters to process the link and add the proxy
The link is a link to a chat by its username. Call searchPublicChat with the given chat username to process the link
The link is a link to a sticker set. Call searchStickerSet with the given sticker set name to process the link and show the sticker set
The link is a link to a theme. TDLib has no theme support yet
The link is an unknown tg: link. Call getDeepLinkInfo to process the link
The link is a link to a user by its phone number. Call searchUserByPhoneNumber with the given phone number to process the link
The link is a link to a video chat. Call searchPublicChat with the given chat username, and then joinGroupCall with the given invite hash to process the link
Product invoice
Represents one member of a JSON object
Represents a JSON array
Represents a boolean JSON value
Represents a numeric JSON value
Represents a JSON object
Represents a string JSON value
Represents a single button in a bot keyboard
A button that allows the user to create and send a poll when pressed; available only in private chats
A button that opens a Web App by calling getWebAppUrl
Portion of the price of a product (e.g., “delivery cost”, “tax amount”)
Contains information about a language pack
Represents one language pack string
An ordinary language pack string
A language pack string which has different forms based on the number of some object it mentions. See https:www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more information
Contains a list of language pack strings
Represents a local file
Contains information about the current localization target
Describes a location on planet Earth
The log is written to a file
Contains a list of available TDLib internal log tags
Contains a TDLib internal log verbosity level
An HTTP url needs to be open
An authorization confirmation dialog needs to be shown to the user
Position on a photo where a mask is placed
Describes a message
A message with an animated emoji
An animation message (GIF-style).
An audio message
A newly created basic group
Contains information about found messages, split by days according to the option “utc_time_offset”
Contains information about found messages sent on a specific day
A message with information about an ended call
New chat members were added
An updated chat photo
An updated chat title
A chat member was deleted
A theme in the chat has been changed
The TTL (Time To Live) setting for messages in the chat has been changed
A supergroup has been created from a basic group
A basic group was upgraded to a supergroup and was deactivated as the result
A message with a user contact
Options to be used when a message content is copied without reference to the original sender. Service messages and messageInvoice can’t be copied
A non-standard action has happened in the chat
A dice message. The dice value is randomly generated by the server
A document message (general file)
The media is a photo
The media is hidden until the invoice is paid
The media is unuspported
The media is a video
The messages was exported from a group chat
The messages was exported from a private chat
A forum topic has been created
A forum topic has been edited
A forum topic has been closed or opened
Contains information about a forwarded message
The message was originally a post in a channel
The message was originally sent on behalf of a chat
The message was originally sent by a user, which is hidden by their privacy settings
The message was imported from an exported message history
The message was originally sent by a known user
A message with a game
A new high score was achieved in a game
Telegram Premium was gifted to the user
Contains information about interactions with a message
A message with information about an invite to a video chat
A message with an invoice from a bot
Contains an HTTPS link to a message in a supergroup or channel
Contains information about a link to a message in a chat
A message with a location
Telegram Passport data has been received; for bots only
Telegram Passport data has been sent to a bot
A payment has been completed
A payment has been completed; for bots only
A photo message
A message has been pinned
A message with a poll
Contains information about a message in a specific position
Contains a list of message positions
A user in the chat came within proximity alert range
Contains information about a reaction to a message
Contains information about replies to a message
The message will be sent at the specified date
Options to be used when a message is sent
The message was sent on behalf of a chat
The message was sent by a known user
Represents a list of message senders
The message failed to be sent
A detailed statistics about a message
A sticker message
A newly created supergroup or channel
A text message
Contains information about a message thread
A message with information about a venue
A video message
A message with information about an ended video chat
A new video chat was scheduled
A newly created video chat
A video note message
A voice note message
Data from a Web App has been received; for bots only
Data from a Web App has been sent to a bot
The current user has connected a website by logging in using Telegram Login Widget on it
Contains a list of messages
Thumbnail image of a very poor quality and low resolution
A full list of available network statistic entries
Contains information about the total amount of data that was used for calls
Contains information about the total amount of data that was used to send and receive files
Contains information about a notification
Describes a group of notifications
Describes a notification sound in MP3 format
Contains a list of notification sounds
New call was received
New message was received
New message was received through a push notification
Represents a boolean option
Represents an integer option
Represents a string option
Order information
An invisible anchor on a page, which can be used in a URL to open the page from the specified anchor
An animation
An audio file
The author and publishing date of a page
A block quote
Contains a caption of an instant view web page block, consisting of a text and a trailing credit
A link to a chat
A collage
A page cover
A collapsible block
An embedded web page
An embedded post
The footer of a page
A header
A kicker
A list of data blocks
Describes an item of a list page block
A map
A text paragraph
A photo
A preformatted text paragraph
A pull quote
Contains information about a related article
Related articles
A slideshow
A subheader
The subtitle of a page
A table
Represents a cell of a table
The title of a page
A video
A voice note
Contains information about a Telegram Passport authorization form that was requested
A Telegram Passport element containing the user’s address
A Telegram Passport element containing the user’s bank statement
A Telegram Passport element containing the user’s driver license
A Telegram Passport element containing the user’s email address
Contains the description of an error in a Telegram Passport element
One of the data fields contains an error. The error will be considered resolved when the value of the field changes
The file contains an error. The error will be considered resolved when the file changes
One of files with the translation of the document contains an error. The error will be considered resolved when the file changes
A Telegram Passport element containing the user’s identity card
A Telegram Passport element containing the user’s internal passport
A Telegram Passport element containing the user’s passport
A Telegram Passport element containing the user’s passport registration pages
A Telegram Passport element containing the user’s personal details
A Telegram Passport element containing the user’s phone number
A Telegram Passport element containing the user’s rental agreement
A Telegram Passport element containing the user’s temporary registration
A Telegram Passport element containing the user’s utility bill
Contains information about saved Telegram Passport elements
Contains information about a Telegram Passport elements and corresponding errors
Contains a description of the required Telegram Passport element that was requested by a service
Contains information about a Telegram Passport element that was requested by a service
Represents the current state of 2-step verification
Contains information about an invoice payment form
Describes an additional payment option
Some other payment provider, for which a web payment form must be shown
Smart Glocal payment provider
Stripe payment provider
Contains information about a successful payment
Contains the result of a payment request
Contains the user’s personal details
A personal document, containing some information about a user
Contains settings for the authentication of the user’s phone number
Contains information about a phone number
Describes a photo
Describes an image in JPEG format
A point on a Cartesian plane
Describes a poll
Describes one answer option of a poll
A poll in quiz mode, which has exactly one correct answer option and can be answered only once
A regular poll
Describes a promotion animation for a Premium feature
Contains information about features, available to Premium users
Contains information about a limit, increased for Premium users
Describes an option for buying Telegram Premium to a user
A user tried to use a Premium feature
A limit was exceeded
A user opened an internal link of the type internalLinkTypePremiumFeatures
Contains state of Telegram Premium subscription and promotion videos for Premium features
Describes a user profile photo
Represents a list of proxy servers
Contains information about a proxy server
A HTTP transparent proxy server
An MTProto proxy server
A SOCKS5 proxy server
An animation message (GIF-style).
An audio message
New chat members were invited to a group
A chat title was edited
A chat member was deleted
A chat theme was edited
A message with a user contact
A document message (a general file)
A message with a game
A new high score was achieved in a game
A general message with hidden content
A message with an invoice from a bot
A message with a location
A media album
A forwarded messages
A photo message
A message with a poll
A new recurrent payment was made by the current user
A message with a sticker
A text message
A video message
A video note message
A voice note message
Contains a globally unique push receiver identifier, which can be used to identify which account has received a push notification
A reaction with a custom emoji
A reaction with an emoji
Describes a recommended chat filter
Contains a list of recommended chat filters
Contains information about the current recovery email address
Represents a remote file
Instructs application to force a reply to this message
Contains an inline keyboard layout
Instructs application to remove the keyboard once this message has been received. This kind of keyboard can’t be received in an incoming message; instead, UpdateChatReplyMarkup with message_id == 0 will be sent
Contains a custom keyboard layout to quickly reply to bots
The password reset request was declined
The password reset request is pending
An anchor
A link to an anchor on the same web page
A bold rich text
A rich text email link
A fixed-width rich text
A small image inside the text
An italicized rich text
A marked rich text
A rich text phone number
A plain text
A reference to a richTexts object on the same web page
A strikethrough rich text
A subscript rich text
A superscript rich text
An underlined rich text
A rich text URL link
A concatenation of rich texts
Represents an RTMP url
Contains information about saved payment credentials
Contains information about notification settings for several chats
Contains a value representing a number of seconds
Represents a secret chat
Information about the message sent by answerWebAppQuery
Contains information about one session in a Telegram application used by the current user. Sessions must be shown to the user in the returned order
Contains a list of sessions
One shipping option
The speech recognition failed
The speech recognition is ongoing
The speech recognition successfully finished
Describes a sponsored message
Contains a list of sponsored messages
The graph data to be asynchronously loaded through getStatisticalGraph
A graph data
An error message to be shown to the user instead of the graph
A value with information about its recent changes
Describes a sticker
Represents a sticker set
Represents short information about a sticker set
Represents a list of sticker sets
Represents a list of stickers
Contains the exact storage usage statistics split by chats and file type
Contains the storage usage statistics for a specific chat
Contains the storage usage statistics for a specific file type
Contains approximate storage usage statistics, excluding files of unknown file type
The user gifted Telegram Premium to another user
The user subscribed to Telegram Premium
Suggests the user to convert specified supergroup to a broadcast group
Suggests the user to set a 2-step verification password to be able to log in again
Represents a supergroup or channel with zero or more members (subscribers in the case of channels). From the point of view of the system, a channel is a special kind of a supergroup: only administrators can post and see the list of members, and posts from all administrators use the name and photo of the channel instead of individual names and profile photos. Unlike supergroups, channels can have an unlimited number of subscribers
Contains full information about a supergroup or channel
Returns users banned from the supergroup or channel; can be used only by administrators
Returns contacts of the user, which are members of the supergroup or channel
Returns users which can be mentioned in the supergroup
Returns restricted supergroup members; can be used only by administrators
Used to search for supergroup or channel members via a (string) query
The chat needs to be chosen by the user among chats of the specified types
The chat needs to be open with the provided internal link
Returns information about the availability of a temporary password, which can be used for payments
Contains Telegram terms of service
A simple object containing a sequence of bytes; for testing only
A simple object containing a number; for testing only
A simple object containing a string; for testing only
A simple object containing a vector of numbers; for testing only
A simple object containing a vector of objects that hold a number; for testing only
A simple object containing a vector of strings; for testing only
A simple object containing a vector of objects that hold a string; for testing only
Contains some text
Contains a list of text entities
Represents a part of the text that needs to be formatted in some unusual way
A custom emoji. The text behind a custom emoji must be an emoji. Only premium users can use premium custom emoji
A media timestamp
A text shows instead of a raw mention of the user (e.g., when the user has no username)
Text that must be formatted as if inside pre, and code HTML tags
A text description shown instead of a raw URL
The text uses Markdown-style formatting
Contains parameters of the application theme
Describes theme settings
Represents a thumbnail
Represents a URL linking to an internal Telegram entity
A chat invite link
A URL linking to a sticker set
A URL linking to a public supergroup or channel
A URL linking to a user
Contains a list of t.me URLs
Represents a list of trending sticker sets
Contains information about an unread reaction to a message
The list of active emoji reactions has changed
Contains active notifications that was shown on previous application launches. This update is sent only if the message database is used. In that case it comes once before any updateNotification and updateNotificationGroup update
Some animated emoji message was clicked and a big animated sticker must be played if the message is visible on the screen. chatActionWatchingAnimations with the text of the message needs to be sent if the sticker is played
The parameters of animation search through GetOption(“animation_search_bot_username”) bot has changed
The list of bots added to attachment menu has changed
The user authorization state has changed
Some data of a basic group has changed. This update is guaranteed to come before the basic group identifier is returned to the application
Some data in basicGroupFullInfo has been changed
New call was created or information about a call was updated
A message sender activity in the chat has changed
The chat action bar was changed
The chat available reactions were changed
The value of the default disable_notification parameter, used when a message is sent to the chat, was changed
A chat draft has changed. Be aware that the update may come in the currently opened chat but with old content of the draft. If the user has changed the content of the draft, this update mustn’t be applied
The list of chat filters or a chat filter has changed
A chat content was allowed or restricted for saving
A chat’s has_scheduled_messages field has changed
A chat was blocked or unblocked
A chat was marked as unread or was read
The last message of a chat was changed. If last_message is null, then the last message in the chat became unknown. Some new unknown messages might be added to the chat in this case
User rights changed in a chat; for bots only
The message sender that is selected to send messages in a chat has changed
The message Time To Live setting for a chat was changed
Notification settings for a chat were changed
The number of online group members has changed. This update with non-zero number of online group members is sent only for currently opened chats. There is no guarantee that it will be sent just after the number of online users has changed
The chat pending join requests were changed
Chat permissions was changed
A chat photo was changed
The position of a chat in a chat list has changed. Instead of this update updateChatLastMessage or updateChatDraftMessage might be sent
Incoming messages were read or the number of unread messages has been changed
Outgoing messages were read
The default chat reply markup was changed. Can occur because new messages with reply markup were received or because an old reply markup was hidden by the user
The chat theme was changed
The list of available chat themes has changed
The title of a chat was changed
The chat unread_mention_count has changed
The chat unread_reaction_count has changed
A chat video chat state has changed
The connection state has changed. This update must be used only to show a human-readable description of the connection state
The type of default reaction has changed
Some messages were deleted
The list of supported dice emojis has changed
The list of favorite stickers was updated
Information about a file was updated
A file was added to the file download list. This update is sent only after file download list is loaded for the first time
A file download was changed. This update is sent only after file download list is loaded for the first time
The state of the file download list has changed
The file generation process needs to be started by the application
File generation is no longer needed
A file was removed from the file download list. This update is sent only after file download list is loaded for the first time
Basic information about a topic in a forum chat was changed
Information about a group call was updated
Information about a group call participant was changed. The updates are sent only after the group call is received through getGroupCall and only if the call is joined or being joined
Describes whether there are some pending notification updates. Can be used to prevent application from killing, while there are some pending notifications
The list of installed sticker sets was updated
Some language pack strings have been updated
The message content has changed
The message content was opened. Updates voice note messages to “listened”, video note messages to “viewed” and starts the TTL timer for self-destructing messages
A message was edited. Changes in the message content will come in a separate updateMessageContent
The information about interactions with a message has changed
The message pinned state was changed
A message with a live location was viewed. When the update is received, the application is supposed to update the live location
A message with an unread mention was read
A request to send a message has reached the Telegram server. This doesn’t mean that the message will be sent successfully or even that the send message request will be processed. This update will be sent only if the option “use_quick_ack” is set to true. This update may be sent multiple times for the same message
A message failed to send. Be aware that some messages being sent can be irrecoverably deleted, in which case updateDeleteMessages will be received instead of this update
A message has been successfully sent
The list of unread reactions added to a message was changed
New call signaling data arrived
A new incoming callback query; for bots only
A new chat has been loaded/created. This update is guaranteed to come before the chat identifier is returned to the application. The chat field changes will be reported through separate updates
A user sent a join request to a chat; for bots only
The user has chosen a result of an inline query; for bots only
A new incoming event; for bots only
A new incoming query; for bots only
A new incoming callback query from a message sent via a bot; for bots only
A new incoming inline query; for bots only
A new message was received; can also be an outgoing message
A new incoming pre-checkout query; for bots only. Contains full information about a checkout
A new incoming shipping query; for bots only. Only for invoices with flexible price
A notification was changed
A list of active notifications in a notification group has changed
An option changed its value
A poll was updated; for bots only
A user changed the answer to a poll; for bots only
The list of recently used stickers was updated
The list of saved animations was updated
The list of saved notifications sounds was updated. This update may not be sent until information about a notification sound was requested for the first time
Notification settings for some type of chats were updated
Some data of a secret chat has changed. This update is guaranteed to come before the secret chat identifier is returned to the application
The selected background has changed
A service notification from the server was received. Upon receiving this the application must show a popup with the content of the notification
A sticker set has changed
The list of suggested to the user actions has changed
Some data of a supergroup or a channel has changed. This update is guaranteed to come before the supergroup identifier is returned to the application
Some data in supergroupFullInfo has been changed
New terms of service must be accepted by the user. If the terms of service are declined, then the deleteAccount method must be called with the reason “Decline ToS update”
The list of trending sticker sets was updated or some of them were viewed
Number of unread chats, i.e. with unread messages or marked as unread, has changed. This update is sent only if the message database is used
Number of unread messages in a chat list has changed. This update is sent only if the message database is used
Some data of a user has changed. This update is guaranteed to come before the user identifier is returned to the application
Some data in userFullInfo has been changed
Some privacy setting rules have been changed
The user went online or offline
The list of users nearby has changed. The update is guaranteed to be sent only 60 seconds after a successful searchChatsNearby request
A message was sent by an opened Web App, so the Web App needs to be closed
Contains a list of updates
Represents a user
Contains full information about a user
A rule to allow all members of certain specified basic groups and supergroups to doing something
A rule to allow certain specified users to do something
A rule to restrict all members of specified basic groups and supergroups from doing something
A rule to restrict all specified users from doing something
A list of privacy rules. Rules are matched in the specified order. The first matched rule defines the privacy setting for a given user. If no rule matches, the action is not allowed
The user is offline
The user is online
Contains custom information about the user
A bot (see https:core.telegram.org/bots)
Describes usernames assigned to a user, a supergroup, or a channel
Represents a list of users
Contains a temporary identifier of validated order information, which is stored for one hour. Also contains the available shipping options
A cubic Bézier curve to a given point
A straight line to a given point
Describes a venue
Describes a video file
Describes a video chat
Describes a video note. The video must be equal in width and height, cropped to a circle, and stored in MPEG4 format
Describes a voice note. The voice note must be encoded with the Opus codec, and stored inside an OGG container. Voice notes can have only a single audio channel
Contains information about a Web App
Describes a web page preview
Describes an instant view page for a web page