Module types Copy item path Source AccentColor Contains information about supported accent color for user/chat name, background of empty chat photo, replies to messages and link previews AccountTtl Contains information about the period of inactivity after which the current user’s account will automatically be deleted AddedReaction Represents a reaction applied to a message AddedReactions Represents a list of reactions added to a message Address Describes an address AnimatedChatPhoto Animated variant of a chat photo in MPEG4 format AnimatedEmoji Describes an animated or custom representation of an emoji Animation Describes an animation file. The animation must be encoded in GIF or MPEG4 format Animations Represents a list of animations ArchiveChatListSettings Contains settings for automatic moving of chats to and from the Archive chat lists AttachmentMenuBot Represents a bot, which can be added to attachment or side menu AttachmentMenuBotColor Describes a color to highlight a bot added to attachment menu Audio Describes an audio file. Audio is usually in MP3 or M4A format AuthenticationCodeInfo Information about the authentication code that was sent AuthenticationCodeTypeCall A digit-only authentication code is delivered via a phone call to the specified phone number AuthenticationCodeTypeFirebaseAndroid A digit-only authentication code is delivered via Firebase Authentication to the official Android application AuthenticationCodeTypeFirebaseIos A digit-only authentication code is delivered via Firebase Authentication to the official iOS application AuthenticationCodeTypeFlashCall 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 AuthenticationCodeTypeFragment A digit-only authentication code is delivered to https:fragment.com. The user must be logged in there via a wallet owning the phone number’s NFT AuthenticationCodeTypeMissedCall 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 AuthenticationCodeTypeSms A digit-only authentication code is delivered via an SMS message to the specified phone number; non-official applications may not receive this type of code AuthenticationCodeTypeSmsPhrase An authentication code is a phrase from multiple words delivered via an SMS message to the specified phone number; non-official applications may not receive this type of code AuthenticationCodeTypeSmsWord An authentication code is a word delivered via an SMS message to the specified phone number; non-official applications may not receive this type of code AuthenticationCodeTypeTelegramMessage A digit-only authentication code is delivered via a private Telegram message, which can be viewed from another active session AuthorizationStateWaitCode TDLib needs the user’s authentication code to authorize. Call checkAuthenticationCode to check the code AuthorizationStateWaitEmailAddress 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 allowed AuthorizationStateWaitEmailCode TDLib needs the user’s authentication code sent to an email address to authorize. Call checkAuthenticationEmailCode to provide the code AuthorizationStateWaitOtherDeviceConfirmation The user needs to confirm authorization on another logged in device by scanning a QR code with the provided link AuthorizationStateWaitPassword The user has been authorized, but needs to enter a 2-step verification password to start using the application.
Call checkAuthenticationPassword to provide the password, or requestAuthenticationPasswordRecovery to recover the password, or deleteAccount to delete the account after a week AuthorizationStateWaitRegistration The user is unregistered and need to accept terms of service and enter their first name and last name to finish registration. Call registerUser to accept the terms of service and provide the data AutoDownloadSettings Contains auto-download settings AutoDownloadSettingsPresets Contains auto-download settings presets for the current user AutosaveSettings Describes autosave settings AutosaveSettingsException Contains autosave settings for a chat, which overrides default settings for the corresponding scope AutosaveSettingsScopeChat Autosave settings applied to a chat AvailableReaction Represents an available reaction AvailableReactions Represents a list of reactions that can be added to a message Background Describes a chat background BackgroundFillFreeformGradient Describes a freeform gradient fill of a background BackgroundFillGradient Describes a gradient fill of a background BackgroundFillSolid Describes a solid fill of a background BackgroundTypeChatTheme A background from a chat theme; can be used only as a chat background in channels BackgroundTypeFill A filled background BackgroundTypePattern 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 BackgroundTypeWallpaper A wallpaper in JPEG format Backgrounds Contains a list of backgrounds BankCardActionOpenUrl Describes an action associated with a bank card number BankCardInfo Information about a bank card BasicGroup Represents a basic group of 0-200 users (must be upgraded to a supergroup to accommodate more than 200 users) BasicGroupFullInfo Contains full information about a basic group Birthdate Represents a birthdate of a user BotCommand Represents a command supported by a bot BotCommandScopeChat A scope covering all members of a chat BotCommandScopeChatAdministrators A scope covering all administrators of a chat BotCommandScopeChatMember A scope covering a member of a chat BotCommands Contains a list of bot commands BotInfo Contains information about a bot BotMenuButton Describes a button to be shown instead of bot commands menu button BotWriteAccessAllowReasonConnectedWebsite The user connected a website by logging in using Telegram Login Widget on it BotWriteAccessAllowReasonLaunchedWebApp The user launched a Web App using getWebAppLinkUrl BusinessAwayMessageScheduleCustom Send away messages only in the specified time span BusinessAwayMessageSettings Describes settings for messages that are automatically sent by a Telegram Business account when it is away BusinessBotManageBar Contains information about a business bot that manages the chat BusinessChatLink Contains information about a business chat link BusinessChatLinkInfo Contains information about a business chat link BusinessChatLinks Contains a list of business chat links created by the user BusinessConnectedBot Describes a bot connected to a business account BusinessConnection Describes a connection of the bot with a business account BusinessFeaturePromotionAnimation Describes a promotion animation for a Business feature BusinessFeatures Contains information about features, available to Business user accounts BusinessGreetingMessageSettings Describes settings for greeting messages that are automatically sent by a Telegram Business account as response to incoming messages in an inactive private chat BusinessInfo Contains information about a Telegram Business account BusinessLocation Represents a location of a business BusinessMessage Describes a message from a business account as received by a bot BusinessMessages Contains a list of messages from a business account as received by a bot BusinessOpeningHours Describes opening hours of a business BusinessOpeningHoursInterval Describes an interval of time when the business is open BusinessRecipients Describes private chats chosen for automatic interaction with a business BusinessStartPage Describes settings for a business account start page Call Describes a call CallId Contains the call identifier CallProtocol Specifies the supported call protocols CallServer Describes a server for relaying call data CallServerTypeTelegramReflector A Telegram call reflector CallServerTypeWebrtc A WebRTC server CallStateDiscarded The call has ended successfully CallStateError The call has ended with an error CallStatePending The call is pending, waiting to be accepted by a user CallStateReady The call is ready to use CallbackQueryAnswer Contains a bot’s answer to a callback query CallbackQueryPayloadData The payload for a general callback button CallbackQueryPayloadDataWithPassword The payload for a callback button requiring password CallbackQueryPayloadGame The payload for a game callback button CanSendStoryResultMonthlyLimitExceeded The monthly limit for the number of posted stories exceeded. The user needs to buy Telegram Premium or wait specified time CanSendStoryResultWeeklyLimitExceeded The weekly limit for the number of posted stories exceeded. The user needs to buy Telegram Premium or wait specified time CanTransferOwnershipResultPasswordTooFresh The 2-step verification was enabled recently, user needs to wait CanTransferOwnershipResultSessionTooFresh The session was created recently, user needs to wait Chat A chat. (Can be a private chat, basic group, supergroup, or secret chat) ChatActionBarJoinRequest The chat is a private chat with an administrator of a chat to which the user sent join request ChatActionBarReportAddBlock 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 setMessageSenderBlockList,
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 ChatActionBarReportSpam The chat can be reported as spam using the method reportChat with the reason reportReasonSpam. If the chat is a private chat with a user with an emoji status, then a notice about emoji status usage must be shown ChatActionUploadingDocument The user is uploading a document ChatActionUploadingPhoto The user is uploading a photo ChatActionUploadingVideo The user is uploading a video ChatActionUploadingVideoNote The user is uploading a video note ChatActionUploadingVoiceNote The user is uploading a voice note ChatActionWatchingAnimations The user is watching animations sent by the other party by clicking on an animated emoji ChatActiveStories Describes active stories posted by a chat ChatAdministrator Contains information about a chat administrator ChatAdministratorRights Describes rights of the administrator ChatAdministrators Represents a list of chat administrators ChatAvailableReactionsAll All reactions are available in the chat ChatAvailableReactionsSome Only specific reactions are available in the chat ChatBackground Describes a background set for a specific chat ChatBoost Describes a boost applied to a chat ChatBoostFeatures Contains a list of features available on the first chat boost levels ChatBoostLevelFeatures Contains a list of features available on a specific chat boost level ChatBoostLink Contains an HTTPS link to boost a chat ChatBoostLinkInfo Contains information about a link to boost a chat ChatBoostSlot Describes a slot for chat boost ChatBoostSlots Contains a list of chat boost slots ChatBoostSourceGiftCode The chat created a Telegram Premium gift code for a user ChatBoostSourceGiveaway The chat created a Telegram Premium giveaway ChatBoostSourcePremium A user with Telegram Premium subscription or gifted Telegram Premium boosted the chat ChatBoostStatus Describes current boost status of a chat ChatEvent Represents a chat event ChatEventAccentColorChanged The chat accent color or background custom emoji were changed ChatEventActiveUsernamesChanged The chat active usernames were changed ChatEventAvailableReactionsChanged The chat available reactions were changed ChatEventBackgroundChanged The chat background was changed ChatEventCustomEmojiStickerSetChanged The supergroup sticker set with allowed custom emoji was changed ChatEventDescriptionChanged The chat description was changed ChatEventEmojiStatusChanged The chat emoji status was changed ChatEventForumTopicCreated A new forum topic was created ChatEventForumTopicDeleted A forum topic was deleted ChatEventForumTopicEdited A forum topic was edited ChatEventForumTopicPinned A pinned forum topic was changed ChatEventForumTopicToggleIsClosed A forum topic was closed or reopened ChatEventForumTopicToggleIsHidden The General forum topic was hidden or unhidden ChatEventHasAggressiveAntiSpamEnabledToggled The has_aggressive_anti_spam_enabled setting of a supergroup was toggled ChatEventHasProtectedContentToggled The has_protected_content setting of a channel was toggled ChatEventInviteLinkDeleted A revoked chat invite link was deleted ChatEventInviteLinkEdited A chat invite link was edited ChatEventInviteLinkRevoked A chat invite link was revoked ChatEventInvitesToggled The can_invite_users permission of a supergroup chat was toggled ChatEventIsAllHistoryAvailableToggled The is_all_history_available setting of a supergroup was toggled ChatEventIsForumToggled The is_forum setting of a channel was toggled ChatEventLinkedChatChanged The linked chat of a supergroup was changed ChatEventLocationChanged The supergroup location was changed ChatEventLogFilters Represents a set of filters used to obtain a chat event log ChatEventMemberInvited A new chat member was invited ChatEventMemberJoinedByInviteLink A new member joined the chat via an invite link ChatEventMemberJoinedByRequest A new member was accepted to the chat by an administrator ChatEventMemberPromoted A chat member has gained/lost administrator status, or the list of their administrator privileges has changed ChatEventMemberRestricted A chat member was restricted/unrestricted or banned/unbanned, or the list of their restrictions has changed ChatEventMessageAutoDeleteTimeChanged The message auto-delete timer was changed ChatEventMessageDeleted A message was deleted ChatEventMessageEdited A message was edited ChatEventMessagePinned A message was pinned ChatEventMessageUnpinned A message was unpinned ChatEventPermissionsChanged The chat permissions were changed ChatEventPhotoChanged The chat photo was changed ChatEventPollStopped A poll in a message was stopped ChatEventProfileAccentColorChanged The chat’s profile accent color or profile background custom emoji were changed ChatEventSignMessagesToggled The sign_messages setting of a channel was toggled ChatEventSlowModeDelayChanged The slow_mode_delay setting of a supergroup was changed ChatEventStickerSetChanged The supergroup sticker set was changed ChatEventTitleChanged The chat title was changed ChatEventUsernameChanged The chat editable username was changed ChatEventVideoChatCreated A video chat was created ChatEventVideoChatEnded A video chat was ended ChatEventVideoChatMuteNewParticipantsToggled The mute_new_participants setting of a video chat was toggled ChatEventVideoChatParticipantIsMutedToggled A video chat participant was muted or unmuted ChatEventVideoChatParticipantVolumeLevelChanged A video chat participant volume level was changed ChatEvents Contains a list of chat events ChatFolder Represents a folder for user chats ChatFolderIcon Represents an icon for a chat folder ChatFolderInfo Contains basic information about a chat folder ChatFolderInviteLink Contains a chat folder invite link ChatFolderInviteLinkInfo Contains information about an invite link to a chat folder ChatFolderInviteLinks Represents a list of chat folder invite links ChatInviteLink Contains a chat invite link ChatInviteLinkCount Describes a chat administrator with a number of active and revoked chat invite links ChatInviteLinkCounts Contains a list of chat invite link counts ChatInviteLinkInfo Contains information about a chat invite link ChatInviteLinkMember Describes a chat member joined a chat via an invite link ChatInviteLinkMembers Contains a list of chat members joined a chat via an invite link ChatInviteLinks Contains a list of chat invite links ChatJoinRequest Describes a user that sent a join request and waits for administrator approval ChatJoinRequests Contains a list of requests to join a chat ChatJoinRequestsInfo Contains information about pending join requests for a chat ChatListFolder A list of chats added to a chat folder ChatLists Contains a list of chat lists ChatLocation Represents a location to which a chat is connected ChatMember Describes a user or a chat as a member of another chat ChatMemberStatusAdministrator 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 ChatMemberStatusBanned 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 ChatMemberStatusCreator The user is the owner of the chat and has all the administrator privileges ChatMemberStatusRestricted The user is under certain restrictions in the chat. Not supported in basic groups and channels ChatMembers Contains a list of chat members ChatMembersFilterMention Returns users which can be mentioned in the chat ChatMessageSender Represents a message sender, which can be used to send messages in a chat ChatMessageSenders Represents a list of message senders, which can be used to send messages in a chat ChatNearby Describes a chat located nearby ChatNotificationSettings Contains information about notification settings for a chat or a forum topic ChatPermissions Describes actions that a user is allowed to take in a chat ChatPhoto Describes a chat or user profile photo ChatPhotoInfo Contains basic information about the photo of a chat ChatPhotoSticker Information about the sticker, which was used to create the chat photo. The sticker is shown at the center of the photo and occupies at most 67% of it ChatPhotoStickerTypeCustomEmoji Information about the custom emoji, which was used to create the chat photo ChatPhotoStickerTypeRegularOrMask Information about the sticker, which was used to create the chat photo ChatPhotos Contains a list of chat or user profile photos ChatPosition Describes a position of a chat in a chat list ChatRevenueAmount Contains information about revenue earned from sponsored messages in a chat ChatRevenueStatistics A detailed statistics about revenue earned from sponsored messages in a chat ChatRevenueTransaction Contains a chat revenue transactions ChatRevenueTransactionTypeEarnings Describes earnings from sponsored messages in a chat in some time frame ChatRevenueTransactionTypeRefund Describes a refund for failed withdrawal of earnings ChatRevenueTransactionTypeWithdrawal Describes a withdrawal of earnings ChatRevenueTransactions Contains a list of chat revenue transactions ChatRevenueWithdrawalStateCompleted Withdrawal was completed ChatSourcePublicServiceAnnouncement The chat contains a public service announcement ChatStatisticsAdministratorActionsInfo Contains statistics about administrator actions done by a user ChatStatisticsChannel A detailed statistics about a channel chat ChatStatisticsInteractionInfo Contains statistics about interactions with a message sent in the chat or a story sent by the chat ChatStatisticsInviterInfo Contains statistics about number of new members invited by a user ChatStatisticsMessageSenderInfo Contains statistics about messages sent by a user ChatStatisticsObjectTypeMessage Describes a message sent in the chat ChatStatisticsObjectTypeStory Describes a story sent by the chat ChatStatisticsSupergroup A detailed statistics about a supergroup chat ChatTheme Describes a chat theme ChatTypeBasicGroup A basic group (a chat with 0-200 other users) ChatTypePrivate An ordinary chat with a user ChatTypeSecret A secret chat with a user ChatTypeSupergroup A supergroup or channel (with unlimited members) Chats Represents a list of chats ChatsNearby Represents a list of chats located nearby CloseBirthdayUser Describes a user that had or will have a birthday soon ClosedVectorPath Represents a closed vector path. The path begins at the end point of the last command CollectibleItemInfo Contains information about a collectible item and its last purchase CollectibleItemTypePhoneNumber A phone number CollectibleItemTypeUsername A username ConnectedWebsite Contains information about one website the current user is logged in with Telegram ConnectedWebsites Contains a list of websites the current user is logged in with Telegram Contact Describes a user contact Count Contains a counter Countries Contains information about countries CountryInfo Contains information about a country CreatedBasicGroupChat Contains information about a newly created basic group chat CustomRequestResult Contains the result of a custom request DatabaseStatistics Contains database statistics Date Represents a date according to the Gregorian calendar DateRange Represents a date range DatedFile File with the date it was uploaded DeepLinkInfo Contains information about a tg: deep link DeviceTokenApplePush A token for Apple Push Notification service DeviceTokenApplePushVoIp A token for Apple Push Notification service VoIP notifications DeviceTokenBlackBerryPush A token for BlackBerry Push Service DeviceTokenFirebaseCloudMessaging A token for Firebase Cloud Messaging DeviceTokenHuaweiPush A token for HUAWEI Push Service DeviceTokenMicrosoftPush A token for Microsoft Push Notification Service DeviceTokenMicrosoftPushVoIp A token for Microsoft Push Notification Service VoIP channel DeviceTokenSimplePush A token for Simple Push API for Firefox OS DeviceTokenTizenPush A token for Tizen Push Service DeviceTokenUbuntuPush A token for Ubuntu Push Client service DeviceTokenWebPush A token for web Push API DeviceTokenWindowsPush A token for Windows Push Notification Services DiceStickersRegular A regular animated sticker DiceStickersSlotMachine Animated stickers to be combined into a slot machine Document Describes a document of any type DownloadedFileCounts Contains number of being downloaded and recently downloaded files found DraftMessage Contains information about a message draft EmailAddressAuthenticationAppleId An authentication token received through Apple ID EmailAddressAuthenticationCode An authentication code delivered to a user’s email address EmailAddressAuthenticationCodeInfo Information about the email address authentication code that was sent EmailAddressAuthenticationGoogleId An authentication token received through Google ID EmailAddressResetStateAvailable Email address can be reset after the given period. Call resetAuthenticationEmailAddress to reset it and allow the user to authorize with a code sent to the user’s phone number EmailAddressResetStatePending Email address reset has already been requested. Call resetAuthenticationEmailAddress to check whether immediate reset is possible EmojiCategories Represents a list of emoji categories EmojiCategory Describes an emoji category EmojiCategorySourceSearch The category contains a list of similar emoji to search for in getStickers and searchStickers for stickers,
or getInlineQueryResults with the bot getOption(“animation_search_bot_username”) for animations EmojiKeyword Represents an emoji with its keyword EmojiKeywords Represents a list of emoji with their keywords EmojiReaction Contains information about an emoji reaction EmojiStatus Describes a custom emoji to be shown instead of the Telegram Premium badge EmojiStatuses Contains a list of custom emoji identifiers for emoji statuses Emojis Represents a list of emoji EncryptedCredentials Contains encrypted Telegram Passport data credentials EncryptedPassportElement Contains information about an encrypted Telegram Passport element; for bots only Error An object of this type can be returned on every function call, in case of an error FailedToAddMember Contains information about a user that has failed to be added to a chat FailedToAddMembers Represents a list of users that has failed to be added to a chat File Represents a file FileDownload Describes a file added to file download list FileDownloadedPrefixSize Contains size of downloaded prefix of a file FilePart Contains a part of a file FirebaseAuthenticationSettingsIos Settings for Firebase Authentication in the official iOS application FormattedText A text with some entities ForumTopic Describes a forum topic ForumTopicIcon Describes a forum topic icon ForumTopicInfo Contains basic information about a forum topic ForumTopics Describes a list of forum topics ForwardSource Contains information about the last message from which a new message was forwarded last time FoundChatBoosts Contains a list of boosts applied to a chat FoundChatMessages Contains a list of messages found by a search in a given chat FoundFileDownloads Contains a list of downloaded files, found by a search FoundMessages Contains a list of messages found by a search FoundPosition Contains 0-based match position FoundPositions Contains 0-based positions of matched objects FoundWebApp Contains information about a Web App found by its short name Game Describes a game. Use getInternalLink with internalLinkTypeGame to share the game GameHighScore Contains one row of the game high score table GameHighScores Contains a list of game high scores GroupCall Describes a group call GroupCallId Contains the group call identifier GroupCallParticipant Represents a group call participant GroupCallParticipantVideoInfo Contains information about a group call participant’s video channel GroupCallRecentSpeaker Describes a recently speaking participant in a group call GroupCallStream Describes an available stream in a group call GroupCallStreams Represents a list of group call streams GroupCallVideoSourceGroup Describes a group of video synchronization source identifiers Hashtags Contains a list of hashtags HttpUrl Contains an HTTP URL IdentityDocument An identity document ImportedContacts Represents the result of an importContacts request InlineKeyboardButton Represents a single button in an inline keyboard InlineKeyboardButtonTypeCallback A button that sends a callback query to a bot InlineKeyboardButtonTypeCallbackWithPassword A button that asks for the 2-step verification password of the current user and then sends a callback query to a bot InlineKeyboardButtonTypeLoginUrl A button that opens a specified URL and automatically authorize the current user by calling getLoginUrlInfo InlineKeyboardButtonTypeSwitchInline A button that forces an inline query to the bot to be inserted in the input field InlineKeyboardButtonTypeUrl A button that opens a specified URL InlineKeyboardButtonTypeUser A button with a user reference to be handled in the same way as textEntityTypeMentionName entities InlineKeyboardButtonTypeWebApp A button that opens a Web App by calling openWebApp InlineQueryResultAnimation Represents an animation file InlineQueryResultArticle Represents a link to an article or web page InlineQueryResultAudio Represents an audio file InlineQueryResultContact Represents a user contact InlineQueryResultDocument Represents a document InlineQueryResultGame Represents information about a game InlineQueryResultLocation Represents a point on the map InlineQueryResultPhoto Represents a photo InlineQueryResultSticker Represents a sticker InlineQueryResultVenue Represents information about a venue InlineQueryResultVideo Represents a video InlineQueryResultVoiceNote Represents a voice note InlineQueryResults Represents the results of the inline query. Use sendInlineQueryResultMessage to send the result of the query InlineQueryResultsButton Represents a button to be shown above inline query results InlineQueryResultsButtonTypeStartBot Describes the button that opens a private chat with the bot and sends a start message to the bot with the given parameter InlineQueryResultsButtonTypeWebApp Describes the button that opens a Web App by calling getWebAppUrl InputBackgroundLocal A background from a local file InputBackgroundPrevious A background previously set in the chat; for chat backgrounds only InputBackgroundRemote A background from the server InputBusinessChatLink Describes a business chat link to create or edit InputBusinessStartPage Describes settings for a business account start page to set InputChatPhotoAnimation An animation in MPEG4 format; must be square, at most 10 seconds long, have width between 160 and 1280 and be at most 2MB in size InputChatPhotoPrevious A previously used profile photo of the current user InputChatPhotoStatic A static photo in JPEG format InputChatPhotoSticker A sticker on a custom background InputCredentialsApplePay Applies if a user enters new credentials using Apple Pay InputCredentialsGooglePay Applies if a user enters new credentials using Google Pay InputCredentialsNew Applies if a user enters new credentials on a payment provider website InputCredentialsSaved Applies if a user chooses some previously saved payment credentials. To use their previously saved credentials, the user must have a valid temporary password InputFileGenerated A file generated by the application InputFileId A file defined by its unique identifier InputFileLocal A file defined by a local path InputFileRemote A file defined by its remote identifier. The remote identifier 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 InputIdentityDocument An identity document to be saved to Telegram Passport InputInlineQueryResultAnimation Represents a link to an animated GIF or an animated (i.e., without sound) H.264/MPEG-4 AVC video InputInlineQueryResultArticle Represents a link to an article or web page InputInlineQueryResultAudio Represents a link to an MP3 audio file InputInlineQueryResultContact Represents a user contact InputInlineQueryResultDocument Represents a link to a file InputInlineQueryResultGame Represents a game InputInlineQueryResultLocation Represents a point on the map InputInlineQueryResultPhoto Represents link to a JPEG image InputInlineQueryResultSticker Represents a link to a WEBP, TGS, or WEBM sticker InputInlineQueryResultVenue Represents information about a venue InputInlineQueryResultVideo Represents a link to a page containing an embedded video player or a video file InputInlineQueryResultVoiceNote Represents a link to an opus-encoded audio file within an OGG container, single channel audio InputInvoiceMessage An invoice from a message of the type messageInvoice InputInvoiceName An invoice from a link of the type internalLinkTypeInvoice InputInvoiceTelegram An invoice for a payment toward Telegram; must not be used in the in-store apps InputMessageAnimation An animation message (GIF-style). InputMessageAudio An audio message InputMessageContact A message containing a user contact InputMessageDice A dice message InputMessageDocument A document message (general file) InputMessageForwarded A forwarded message InputMessageGame A message with a game; not supported for channels or secret chats InputMessageInvoice A message with an invoice; can be used only by bots InputMessageLocation A message with a location InputMessagePhoto A photo message InputMessagePoll 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 InputMessageReplyToMessage Describes a message to be replied InputMessageReplyToStory Describes a story to be replied InputMessageSticker A sticker message InputMessageStory A message with a forwarded story. Stories can’t be sent to secret chats. A story can be forwarded only if story.can_be_forwarded InputMessageText A text message InputMessageVenue A message with information about a venue InputMessageVideo A video message InputMessageVideoNote A video note message InputMessageVoiceNote A voice note message InputPassportElementAddress A Telegram Passport element to be saved containing the user’s address InputPassportElementBankStatement A Telegram Passport element to be saved containing the user’s bank statement InputPassportElementDriverLicense A Telegram Passport element to be saved containing the user’s driver license InputPassportElementEmailAddress A Telegram Passport element to be saved containing the user’s email address InputPassportElementError Contains the description of an error in a Telegram Passport element; for bots only InputPassportElementErrorSourceDataField A data field contains an error. The error is considered resolved when the field’s value changes InputPassportElementErrorSourceFile The file contains an error. The error is considered resolved when the file changes InputPassportElementErrorSourceFiles The list of attached files contains an error. The error is considered resolved when the file list changes InputPassportElementErrorSourceFrontSide 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 InputPassportElementErrorSourceReverseSide 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 InputPassportElementErrorSourceSelfie The selfie contains an error. The error is considered resolved when the file with the selfie changes InputPassportElementErrorSourceTranslationFile 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 InputPassportElementErrorSourceTranslationFiles The translation of the document contains an error. The error is considered resolved when the list of files changes InputPassportElementErrorSourceUnspecified The element contains an error in an unspecified place. The error will be considered resolved when new data is added InputPassportElementIdentityCard A Telegram Passport element to be saved containing the user’s identity card InputPassportElementInternalPassport A Telegram Passport element to be saved containing the user’s internal passport InputPassportElementPassport A Telegram Passport element to be saved containing the user’s passport InputPassportElementPassportRegistration A Telegram Passport element to be saved containing the user’s passport registration InputPassportElementPersonalDetails A Telegram Passport element to be saved containing the user’s personal details InputPassportElementPhoneNumber A Telegram Passport element to be saved containing the user’s phone number InputPassportElementRentalAgreement A Telegram Passport element to be saved containing the user’s rental agreement InputPassportElementTemporaryRegistration A Telegram Passport element to be saved containing the user’s temporary registration InputPassportElementUtilityBill A Telegram Passport element to be saved containing the user’s utility bill InputPersonalDocument A personal document to be saved to Telegram Passport InputSticker A sticker to be added to a sticker set InputStoryArea Describes a clickable rectangle area on a story media to be added InputStoryAreaTypeFoundVenue An area pointing to a venue found by the bot getOption(“venue_search_bot_username”) InputStoryAreaTypeLocation An area pointing to a location InputStoryAreaTypeMessage An area pointing to a message InputStoryAreaTypePreviousVenue An area pointing to a venue already added to the story InputStoryAreaTypeSuggestedReaction An area pointing to a suggested reaction InputStoryAreas Contains a list of story areas to be added InputStoryContentPhoto A photo story InputStoryContentVideo A video story InputTextQuote Describes manually chosen quote from another message InputThumbnail 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 InternalLinkTypeAttachmentMenuBot 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 show a disclaimer about Mini Apps being a third-party apps, ask the user to accept their Terms of service and confirm adding the bot to side and attachment menu.
If the user accept the terms and confirms adding, then use toggleBotIsAddedToAttachmentMenu to add the bot.
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 InternalLinkTypeAuthenticationCode The link contains an authentication code. Call checkAuthenticationCode with the code if the current authorization state is authorizationStateWaitCode InternalLinkTypeBackground The link is a link to a background. Call searchBackground with the given background name to process the link
If background is found and the user wants to apply it, then call setDefaultBackground InternalLinkTypeBotAddToChannel 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 InternalLinkTypeBotStart 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 InternalLinkTypeBotStartInGroup 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. InternalLinkTypeBusinessChat The link is a link to a business chat. Use getBusinessChatLinkInfo with the provided link name to get information about the link,
then open received private chat and replace chat draft with the provided text InternalLinkTypeChatBoost The link is a link to boost a Telegram chat. Call getChatBoostLinkInfo with the given URL to process the link.
If the chat is found, then call getChatBoostStatus and getAvailableChatBoostSlots to get the current boost status and check whether the chat can be boosted.
If the user wants to boost the chat and the chat can be boosted, then call boostChat InternalLinkTypeChatFolderInvite The link is an invite link to a chat folder. Call checkChatFolderInviteLink with the given invite link to process the link.
If the link is valid and the user wants to join the chat folder, then call addChatFolderByInviteLink InternalLinkTypeChatInvite The link is a chat invite link. Call checkChatInviteLink with the given invite link to process the link.
If the link is valid and the user wants to join the chat, then call joinChatByInviteLink InternalLinkTypeGame 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 InternalLinkTypeInstantView The link must be opened in an Instant View. Call getWebPageInstantView with the given URL to process the link.
If Instant View is found, then show it, otherwise, open the fallback URL in an external browser InternalLinkTypeInvoice The link is a link to an invoice. Call getPaymentForm with the given invoice name to process the link InternalLinkTypeLanguagePack The link is a link to a language pack. Call getLanguagePackInfo with the given language pack identifier to process the link.
If the language pack is found and the user wants to apply it, then call setOption for the option “language_pack_id” InternalLinkTypeMessage The link is a link to a Telegram message or a forum topic. Call getMessageLinkInfo with the given URL to process the link,
and then open received forum topic or chat and show the message there InternalLinkTypeMessageDraft 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 InternalLinkTypePassportDataRequest 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 InternalLinkTypePhoneNumberConfirmation The link can be used to confirm ownership of a phone number to prevent account deletion. Call sendPhoneNumberCode with the given phone number and with phoneNumberCodeTypeConfirmOwnership with the given hash to process the link.
If succeeded, call checkPhoneNumberCode to check entered by the user code, or resendPhoneNumberCode to resend it InternalLinkTypePremiumFeatures The link is a link to the Premium features screen of the application from which the user can subscribe to Telegram Premium. Call getPremiumFeatures with the given referrer to process the link InternalLinkTypePremiumGift The link is a link to the screen for gifting Telegram Premium subscriptions to friends via inputInvoiceTelegram payments or in-store purchases InternalLinkTypePremiumGiftCode The link is a link with a Telegram Premium gift code. Call checkPremiumGiftCode with the given code to process the link.
If the code is valid and the user wants to apply it, then call applyPremiumGiftCode InternalLinkTypeProxy The link is a link to a proxy. Call addProxy with the given parameters to process the link and add the proxy InternalLinkTypePublicChat The link is a link to a chat by its username. Call searchPublicChat with the given chat username to process the link
If the chat is found, open its profile information screen or the chat itself.
If draft text isn’t empty and the chat is a private chat, then put the draft text in the input field InternalLinkTypeSideMenuBot The link is a link to a bot, which can be installed to the side menu. 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 side menu, then show a disclaimer about Mini Apps being a third-party apps,
ask the user to accept their Terms of service and confirm adding the bot to side and attachment menu. If the user accept the terms and confirms adding, then use toggleBotIsAddedToAttachmentMenu to add the bot.
If the bot is added to side menu, then use getWebAppUrl with the given URL and open the returned URL as a Web App InternalLinkTypeStickerSet 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.
If the sticker set is found and the user wants to add it, then call changeStickerSet InternalLinkTypeStory The link is a link to a story. Call searchPublicChat with the given sender username, then call getStory with the received chat identifier and the given story identifier, then show the story if received InternalLinkTypeTheme The link is a link to a theme. TDLib has no theme support yet InternalLinkTypeUnknownDeepLink The link is an unknown tg: link. Call getDeepLinkInfo to process the link InternalLinkTypeUserPhoneNumber The link is a link to a user by its phone number. Call searchUserByPhoneNumber with the given phone number to process the link.
If the user is found, then call createPrivateChat and open the chat. If draft text isn’t empty, then put the draft text in the input field InternalLinkTypeUserToken The link is a link to a user by a temporary token. Call searchUserByToken with the given token to process the link.
If the user is found, then call createPrivateChat and open the chat InternalLinkTypeVideoChat 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 InternalLinkTypeWebApp The link is a link to a Web App. Call searchPublicChat with the given bot username, check that the user is a bot, then call searchWebApp with the received bot and the given web_app_short_name.
Process received foundWebApp by showing a confirmation dialog if needed. If the bot can be added to attachment or side menu, but isn’t added yet, then show a disclaimer about Mini Apps being a third-party apps
instead of the dialog and ask the user to accept their Terms of service. If the user accept the terms and confirms adding, then use toggleBotIsAddedToAttachmentMenu to add the bot.
Then, call getWebAppLinkUrl and open the returned URL as a Web App Invoice Product invoice JsonObjectMember Represents one member of a JSON object JsonValueArray Represents a JSON array JsonValueBoolean Represents a boolean JSON value JsonValueNumber Represents a numeric JSON value JsonValueObject Represents a JSON object JsonValueString Represents a string JSON value KeyboardButton Represents a single button in a bot keyboard KeyboardButtonTypeRequestChat A button that requests a chat to be shared by the current user; available only in private chats. Use the method shareChatWithBot to complete the request KeyboardButtonTypeRequestPoll A button that allows the user to create and send a poll when pressed; available only in private chats KeyboardButtonTypeRequestUsers A button that requests users to be shared by the current user; available only in private chats. Use the method shareUsersWithBot to complete the request KeyboardButtonTypeWebApp A button that opens a Web App by calling getWebAppUrl LabeledPricePart Portion of the price of a product (e.g., “delivery cost”, “tax amount”) LanguagePackInfo Contains information about a language pack LanguagePackString Represents one language pack string LanguagePackStringValueOrdinary An ordinary language pack string LanguagePackStringValuePluralized 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 LanguagePackStrings Contains a list of language pack strings LinkPreviewOptions Options to be used for generation of a link preview LocalFile Represents a local file LocalizationTargetInfo Contains information about the current localization target Location Describes a location on planet Earth LogStreamFile The log is written to a file LogTags Contains a list of available TDLib internal log tags LogVerbosityLevel Contains a TDLib internal log verbosity level LoginUrlInfoOpen An HTTP URL needs to be open LoginUrlInfoRequestConfirmation An authorization confirmation dialog needs to be shown to the user MaskPosition Position on a photo where a mask is placed Message Describes a message MessageAnimatedEmoji A message with an animated emoji MessageAnimation An animation message (GIF-style). MessageAudio An audio message MessageAutoDeleteTime Contains default auto-delete timer setting for new chats MessageBasicGroupChatCreate A newly created basic group MessageBotWriteAccessAllowed The user allowed the bot to send messages MessageCalendar Contains information about found messages, split by days according to the option “utc_time_offset” MessageCalendarDay Contains information about found messages sent on a specific day MessageCall A message with information about an ended call MessageChatAddMembers New chat members were added MessageChatBoost The chat was boosted by the sender of the message MessageChatChangePhoto An updated chat photo MessageChatChangeTitle An updated chat title MessageChatDeleteMember A chat member was deleted MessageChatSetBackground A new background was set in the chat MessageChatSetMessageAutoDeleteTime The auto-delete or self-destruct timer for messages in the chat has been changed MessageChatSetTheme A theme in the chat has been changed MessageChatShared The current user shared a chat, which was requested by the bot MessageChatUpgradeFrom A supergroup has been created from a basic group MessageChatUpgradeTo A basic group was upgraded to a supergroup and was deactivated as the result MessageContact A message with a user contact MessageCopyOptions Options to be used when a message content is copied without reference to the original sender. Service messages, messages with messageInvoice, messagePremiumGiveaway, or messagePremiumGiveawayWinners content can’t be copied MessageCustomServiceAction A non-standard action has happened in the chat MessageDice A dice message. The dice value is randomly generated by the server MessageDocument A document message (general file) MessageExtendedMediaPhoto The media is a photo MessageExtendedMediaPreview The media is hidden until the invoice is paid MessageExtendedMediaUnsupported The media is unsupported MessageExtendedMediaVideo The media is a video MessageFileTypeGroup The messages were exported from a group chat MessageFileTypePrivate The messages were exported from a private chat MessageForumTopicCreated A forum topic has been created MessageForumTopicEdited A forum topic has been edited MessageForumTopicIsClosedToggled A forum topic has been closed or opened MessageForumTopicIsHiddenToggled A General forum topic has been hidden or unhidden MessageForwardInfo Contains information about a forwarded message MessageGame A message with a game MessageGameScore A new high score was achieved in a game MessageGiftedPremium Telegram Premium was gifted to the user MessageImportInfo Contains information about a message created with importMessages MessageInteractionInfo Contains information about interactions with a message MessageInviteVideoChatParticipants A message with information about an invitation to a video chat MessageInvoice A message with an invoice from a bot. Use getInternalLink with internalLinkTypeBotStart to share the invoice MessageLink Contains an HTTPS link to a message in a supergroup or channel, or a forum topic MessageLinkInfo Contains information about a link to a message or a forum topic in a chat MessageLocation A message with a location MessageOriginChannel The message was originally a post in a channel MessageOriginChat The message was originally sent on behalf of a chat MessageOriginHiddenUser The message was originally sent by a user, which is hidden by their privacy settings MessageOriginUser The message was originally sent by a known user MessagePassportDataReceived Telegram Passport data has been received; for bots only MessagePassportDataSent Telegram Passport data has been sent to a bot MessagePaymentSuccessful A payment has been completed MessagePaymentSuccessfulBot A payment has been completed; for bots only MessagePhoto A photo message MessagePinMessage A message has been pinned MessagePoll A message with a poll MessagePosition Contains information about a message in a specific position MessagePositions Contains a list of message positions MessagePremiumGiftCode A Telegram Premium gift code was created for the user MessagePremiumGiveaway A Telegram Premium giveaway MessagePremiumGiveawayCompleted A Telegram Premium giveaway without public winners has been completed for the chat MessagePremiumGiveawayWinners A Telegram Premium giveaway with public winners has been completed for the chat MessageProximityAlertTriggered A user in the chat came within proximity alert range MessageReaction Contains information about a reaction to a message MessageReactions Contains a list of reactions added to a message MessageReadDateRead Contains read date of the message MessageReplyInfo Contains information about replies to a message MessageReplyToMessage Describes a message replied by a given message MessageReplyToStory Describes a story replied by a given message MessageSchedulingStateSendAtDate The message will be sent at the specified date MessageSelfDestructTypeTimer The message will be self-destructed in the specified time after its content was opened MessageSendOptions Options to be used when a message is sent MessageSenderChat The message was sent on behalf of a chat MessageSenderUser The message was sent by a known user MessageSenders Represents a list of message senders MessageSendingStateFailed The message failed to be sent MessageSendingStatePending The message is being sent now, but has not yet been delivered to the server MessageSponsor Information about the sponsor of a message MessageStatistics A detailed statistics about a message MessageSticker A sticker message MessageStory A message with a forwarded story MessageSuggestProfilePhoto A profile photo was suggested to a user in a private chat MessageSupergroupChatCreate A newly created supergroup or channel MessageText A text message MessageThreadInfo Contains information about a message thread MessageUsersShared The current user shared users, which were requested by the bot MessageVenue A message with information about a venue MessageVideo A video message MessageVideoChatEnded A message with information about an ended video chat MessageVideoChatScheduled A new video chat was scheduled MessageVideoChatStarted A newly created video chat MessageVideoNote A video note message MessageViewer Represents a viewer of a message MessageViewers Represents a list of message viewers MessageVoiceNote A voice note message MessageWebAppDataReceived Data from a Web App has been received; for bots only MessageWebAppDataSent Data from a Web App has been sent to a bot Messages Contains a list of messages Minithumbnail Thumbnail image of a very poor quality and low resolution NetworkStatistics A full list of available network statistic entries NetworkStatisticsEntryCall Contains information about the total amount of data that was used for calls NetworkStatisticsEntryFile Contains information about the total amount of data that was used to send and receive files NewChatPrivacySettings Contains privacy settings for new chats with non-contacts Notification Contains information about a notification NotificationGroup Describes a group of notifications NotificationSound Describes a notification sound in MP3 format NotificationSounds Contains a list of notification sounds NotificationTypeNewCall New call was received NotificationTypeNewMessage New message was received NotificationTypeNewPushMessage New message was received through a push notification OptionValueBoolean Represents a boolean option OptionValueInteger Represents an integer option OptionValueString Represents a string option OrderInfo Order information PageBlockAnchor An invisible anchor on a page, which can be used in a URL to open the page from the specified anchor PageBlockAnimation An animation PageBlockAudio An audio file PageBlockAuthorDate The author and publishing date of a page PageBlockBlockQuote A block quote PageBlockCaption Contains a caption of an instant view web page block, consisting of a text and a trailing credit PageBlockChatLink A link to a chat PageBlockCollage A collage PageBlockCover A page cover PageBlockDetails A collapsible block PageBlockEmbedded An embedded web page PageBlockEmbeddedPost An embedded post PageBlockFooter The footer of a page PageBlockHeader A header PageBlockKicker A kicker PageBlockList A list of data blocks PageBlockListItem Describes an item of a list page block PageBlockMap A map PageBlockParagraph A text paragraph PageBlockPhoto A photo PageBlockPreformatted A preformatted text paragraph PageBlockPullQuote A pull quote PageBlockRelatedArticle Contains information about a related article PageBlockRelatedArticles Related articles PageBlockSlideshow A slideshow PageBlockSubheader A subheader PageBlockSubtitle The subtitle of a page PageBlockTable A table PageBlockTableCell Represents a cell of a table PageBlockTitle The title of a page PageBlockVideo A video PageBlockVoiceNote A voice note PassportAuthorizationForm Contains information about a Telegram Passport authorization form that was requested PassportElementAddress A Telegram Passport element containing the user’s address PassportElementBankStatement A Telegram Passport element containing the user’s bank statement PassportElementDriverLicense A Telegram Passport element containing the user’s driver license PassportElementEmailAddress A Telegram Passport element containing the user’s email address PassportElementError Contains the description of an error in a Telegram Passport element PassportElementErrorSourceDataField One of the data fields contains an error. The error will be considered resolved when the value of the field changes PassportElementErrorSourceFile The file contains an error. The error will be considered resolved when the file changes PassportElementErrorSourceTranslationFile One of files with the translation of the document contains an error. The error will be considered resolved when the file changes PassportElementIdentityCard A Telegram Passport element containing the user’s identity card PassportElementInternalPassport A Telegram Passport element containing the user’s internal passport PassportElementPassport A Telegram Passport element containing the user’s passport PassportElementPassportRegistration A Telegram Passport element containing the user’s passport registration pages PassportElementPersonalDetails A Telegram Passport element containing the user’s personal details PassportElementPhoneNumber A Telegram Passport element containing the user’s phone number PassportElementRentalAgreement A Telegram Passport element containing the user’s rental agreement PassportElementTemporaryRegistration A Telegram Passport element containing the user’s temporary registration PassportElementUtilityBill A Telegram Passport element containing the user’s utility bill PassportElements Contains information about saved Telegram Passport elements PassportElementsWithErrors Contains information about a Telegram Passport elements and corresponding errors PassportRequiredElement Contains a description of the required Telegram Passport element that was requested by a service PassportSuitableElement Contains information about a Telegram Passport element that was requested by a service PasswordState Represents the current state of 2-step verification PaymentForm Contains information about an invoice payment form PaymentOption Describes an additional payment option PaymentProviderOther Some other payment provider, for which a web payment form must be shown PaymentProviderSmartGlocal Smart Glocal payment provider PaymentProviderStripe Stripe payment provider PaymentReceipt Contains information about a successful payment PaymentResult Contains the result of a payment request PersonalDetails Contains the user’s personal details PersonalDocument A personal document, containing some information about a user PhoneNumberAuthenticationSettings Contains settings for the authentication of the user’s phone number PhoneNumberCodeTypeConfirmOwnership Confirms ownership of a phone number to prevent account deletion while handling links of the type internalLinkTypePhoneNumberConfirmation PhoneNumberInfo Contains information about a phone number Photo Describes a photo PhotoSize Describes an image in JPEG format Point A point on a Cartesian plane Poll Describes a poll PollOption Describes one answer option of a poll PollTypeQuiz A poll in quiz mode, which has exactly one correct answer option and can be answered only once PollTypeRegular A regular poll PremiumFeaturePromotionAnimation Describes a promotion animation for a Premium feature PremiumFeatures Contains information about features, available to Premium users PremiumGiftCodeInfo Contains information about a Telegram Premium gift code PremiumGiftCodePaymentOption Describes an option for creating Telegram Premium gift codes PremiumGiftCodePaymentOptions Contains a list of options for creating Telegram Premium gift codes PremiumGiveawayInfoCompleted Describes a completed giveaway PremiumGiveawayInfoOngoing Describes an ongoing giveaway PremiumGiveawayParameters Describes parameters of a Telegram Premium giveaway PremiumGiveawayParticipantStatusAdministrator The user can’t participate in the giveaway, because they are an administrator in one of the chats that created the giveaway PremiumGiveawayParticipantStatusAlreadyWasMember The user can’t participate in the giveaway, because they have already been member of the chat PremiumGiveawayParticipantStatusDisallowedCountry The user can’t participate in the giveaway, because they phone number is from a disallowed country PremiumLimit Contains information about a limit, increased for Premium users PremiumPaymentOption Describes an option for buying Telegram Premium to a user PremiumSourceBusinessFeature A user tried to use a Business feature PremiumSourceFeature A user tried to use a Premium feature PremiumSourceLimitExceeded A limit was exceeded PremiumSourceLink A user opened an internal link of the type internalLinkTypePremiumFeatures PremiumSourceStoryFeature A user tried to use a Premium story feature PremiumState Contains state of Telegram Premium subscription and promotion videos for Premium features PremiumStatePaymentOption Describes an option for buying or upgrading Telegram Premium for self PrepaidPremiumGiveaway Describes a prepaid Telegram Premium giveaway ProfileAccentColor Contains information about supported accent color for user profile photo background ProfileAccentColors Contains information about supported accent colors for user profile photo background in RGB format ProfilePhoto Describes a user profile photo Proxies Represents a list of proxy servers Proxy Contains information about a proxy server ProxyTypeHttp A HTTP transparent proxy server ProxyTypeMtproto An MTProto proxy server ProxyTypeSocks5 A SOCKS5 proxy server PublicForwardMessage Contains a public forward as a message PublicForwardStory Contains a public repost to a story PublicForwards Represents a list of public forwards and reposts as a story of a message or a story PushMessageContentAnimation An animation message (GIF-style). PushMessageContentAudio An audio message PushMessageContentChatAddMembers New chat members were invited to a group PushMessageContentChatChangeTitle A chat title was edited PushMessageContentChatDeleteMember A chat member was deleted PushMessageContentChatSetBackground A chat background was edited PushMessageContentChatSetTheme A chat theme was edited PushMessageContentContact A message with a user contact PushMessageContentDocument A document message (a general file) PushMessageContentGame A message with a game PushMessageContentGameScore A new high score was achieved in a game PushMessageContentHidden A general message with hidden content PushMessageContentInvoice A message with an invoice from a bot PushMessageContentLocation A message with a location PushMessageContentMediaAlbum A media album PushMessageContentMessageForwards A forwarded messages PushMessageContentPhoto A photo message PushMessageContentPoll A message with a poll PushMessageContentPremiumGiftCode A message with a Telegram Premium gift code created for the user PushMessageContentPremiumGiveaway A message with a Telegram Premium giveaway PushMessageContentRecurringPayment A new recurring payment was made by the current user PushMessageContentSticker A message with a sticker PushMessageContentStory A message with a story PushMessageContentText A text message PushMessageContentVideo A video message PushMessageContentVideoNote A video note message PushMessageContentVoiceNote A voice note message PushReceiverId Contains a globally unique push receiver identifier, which can be used to identify which account has received a push notification QuickReplyMessage Describes a message that can be used for quick reply QuickReplyMessages Contains a list of quick reply messages QuickReplyShortcut Describes a shortcut that can be used for a quick reply ReactionNotificationSettings Contains information about notification settings for reactions ReactionTypeCustomEmoji A reaction with a custom emoji ReactionTypeEmoji A reaction with an emoji ReadDatePrivacySettings Contains privacy settings for message read date in private chats. Read dates are always shown to the users that can see online status of the current user regardless of this setting RecommendedChatFolder Describes a recommended chat folder RecommendedChatFolders Contains a list of recommended chat folders RecoveryEmailAddress Contains information about the current recovery email address RemoteFile Represents a remote file ReplyMarkupForceReply Instructs application to force a reply to this message ReplyMarkupInlineKeyboard Contains an inline keyboard layout ReplyMarkupRemoveKeyboard 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 ReplyMarkupShowKeyboard Contains a custom keyboard layout to quickly reply to bots ReportChatSponsoredMessageOption Describes an option to report a sponsored message ReportChatSponsoredMessageResultOptionRequired The user must choose an option to report the message and repeat request with the chosen option ResetPasswordResultDeclined The password reset request was declined ResetPasswordResultPending The password reset request is pending RichTextAnchor An anchor RichTextAnchorLink A link to an anchor on the same web page RichTextBold A bold rich text RichTextEmailAddress A rich text email link RichTextFixed A fixed-width rich text RichTextIcon A small image inside the text RichTextItalic An italicized rich text RichTextMarked A marked rich text RichTextPhoneNumber A rich text phone number RichTextPlain A plain text RichTextReference A reference to a richTexts object on the same web page RichTextStrikethrough A strikethrough rich text RichTextSubscript A subscript rich text RichTextSuperscript A superscript rich text RichTextUnderline An underlined rich text RichTextUrl A rich text URL link RichTexts A concatenation of rich texts RtmpUrl Represents an RTMP URL SavedCredentials Contains information about saved payment credentials SavedMessagesTag Represents a tag used in Saved Messages or a Saved Messages topic SavedMessagesTags Contains a list of tags used in Saved Messages SavedMessagesTopic Contains information about a Saved Messages topic SavedMessagesTopicTypeSavedFromChat Topic containing messages forwarded from a specific chat ScopeAutosaveSettings Contains autosave settings for an autosave settings scope ScopeNotificationSettings Contains information about notification settings for several chats Seconds Contains a value representing a number of seconds SecretChat Represents a secret chat SentWebAppMessage Information about the message sent by answerWebAppQuery Session 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 Sessions Contains a list of sessions SharedChat Contains information about a chat shared with a bot SharedUser Contains information about a user shared with a bot ShippingOption One shipping option SpeechRecognitionResultError The speech recognition failed SpeechRecognitionResultPending The speech recognition is ongoing SpeechRecognitionResultText The speech recognition successfully finished SponsoredMessage Describes a sponsored message SponsoredMessages Contains a list of sponsored messages StatisticalGraphAsync The graph data to be asynchronously loaded through getStatisticalGraph StatisticalGraphData A graph data StatisticalGraphError An error message to be shown to the user instead of the graph StatisticalValue A value with information about its recent changes Sticker Describes a sticker StickerFullTypeCustomEmoji The sticker is a custom emoji to be used inside message text and caption. Currently, only Telegram Premium users can use custom emoji StickerFullTypeMask The sticker is a mask in WEBP format to be placed on photos or videos StickerFullTypeRegular The sticker is a regular sticker StickerSet Represents a sticker set StickerSetInfo Represents short information about a sticker set StickerSets Represents a list of sticker sets Stickers Represents a list of stickers StorageStatistics Contains the exact storage usage statistics split by chats and file type StorageStatisticsByChat Contains the storage usage statistics for a specific chat StorageStatisticsByFileType Contains the storage usage statistics for a specific file type StorageStatisticsFast Contains approximate storage usage statistics, excluding files of unknown file type StorePaymentPurposeGiftedPremium The user gifting Telegram Premium to another user StorePaymentPurposePremiumGiftCodes The user creating Telegram Premium gift codes for other users StorePaymentPurposePremiumGiveaway The user creating a Telegram Premium giveaway StorePaymentPurposePremiumSubscription The user subscribing to Telegram Premium Stories Represents a list of stories Story Represents a story StoryArea Describes a clickable rectangle area on a story media StoryAreaPosition Describes position of a clickable rectangle area on a story media StoryAreaTypeLocation An area pointing to a location StoryAreaTypeMessage An area pointing to a message StoryAreaTypeSuggestedReaction An area pointing to a suggested reaction. App needs to show a clickable reaction on the area and call setStoryReaction when the are is clicked StoryAreaTypeVenue An area pointing to a venue StoryContentPhoto A photo story StoryContentVideo A video story StoryFullId Contains identifier of a story along with identifier of its sender StoryInfo Contains basic information about a story StoryInteraction Represents interaction with a story StoryInteractionInfo Contains information about interactions with a story StoryInteractionTypeForward A forward of the story as a message StoryInteractionTypeRepost A repost of the story as a story StoryInteractionTypeView A view of the story StoryInteractions Represents a list of interactions with a story StoryOriginHiddenUser The original story was sent by an unknown user StoryOriginPublicStory The original story was a public story with known sender StoryPrivacySettingsContacts The story can be viewed by all contacts except chosen users StoryPrivacySettingsEveryone The story can be viewed by everyone StoryPrivacySettingsSelectedUsers The story can be viewed by certain specified users StoryRepostInfo Contains information about original story that was reposted StoryStatistics A detailed statistics about a story StoryVideo Describes a video file sent in a story SuggestedActionConvertToBroadcastGroup Suggests the user to convert specified supergroup to a broadcast group SuggestedActionExtendPremium Suggests the user to extend their expiring Telegram Premium subscription SuggestedActionSetPassword Suggests the user to set a 2-step verification password to be able to log in again Supergroup 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 SupergroupFullInfo Contains full information about a supergroup or channel SupergroupMembersFilterBanned Returns users banned from the supergroup or channel; can be used only by administrators SupergroupMembersFilterContacts Returns contacts of the user, which are members of the supergroup or channel SupergroupMembersFilterMention Returns users which can be mentioned in the supergroup SupergroupMembersFilterRestricted Returns restricted supergroup members; can be used only by administrators SupergroupMembersFilterSearch Used to search for supergroup or channel members via a (string) query TargetChatChosen The chat needs to be chosen by the user among chats of the specified types TargetChatInternalLink The chat needs to be open with the provided internal link TelegramPaymentPurposePremiumGiftCodes The user creating Telegram Premium gift codes for other users TelegramPaymentPurposePremiumGiveaway The user creating a Telegram Premium giveaway TemporaryPasswordState Returns information about the availability of a temporary password, which can be used for payments TermsOfService Contains Telegram terms of service TestBytes A simple object containing a sequence of bytes; for testing only TestInt A simple object containing a number; for testing only TestString A simple object containing a string; for testing only TestVectorInt A simple object containing a vector of numbers; for testing only TestVectorIntObject A simple object containing a vector of objects that hold a number; for testing only TestVectorString A simple object containing a vector of strings; for testing only TestVectorStringObject A simple object containing a vector of objects that hold a string; for testing only Text Contains some text TextEntities Contains a list of text entities TextEntity Represents a part of the text that needs to be formatted in some unusual way TextEntityTypeCustomEmoji A custom emoji. The text behind a custom emoji must be an emoji. Only premium users can use premium custom emoji TextEntityTypeMediaTimestamp A media timestamp TextEntityTypeMentionName A text shows instead of a raw mention of the user (e.g., when the user has no username) TextEntityTypePreCode Text that must be formatted as if inside pre, and code HTML tags TextEntityTypeTextUrl A text description shown instead of a raw URL TextParseModeMarkdown The text uses Markdown-style formatting TextQuote Describes manually or automatically chosen quote from another message ThemeParameters Contains parameters of the application theme ThemeSettings Describes theme settings Thumbnail Represents a thumbnail TimeZone Describes a time zone TimeZones Contains a list of time zones TmeUrl Represents a URL linking to an internal Telegram entity TmeUrlTypeChatInvite A chat invite link TmeUrlTypeStickerSet A URL linking to a sticker set TmeUrlTypeSupergroup A URL linking to a public supergroup or channel TmeUrlTypeUser A URL linking to a user TmeUrls Contains a list of t.me URLs TrendingStickerSets Represents a list of trending sticker sets UnconfirmedSession Contains information about an unconfirmed session UnreadReaction Contains information about an unread reaction to a message UpdateAccentColors The list of supported accent colors has changed UpdateActiveEmojiReactions The list of active emoji reactions has changed UpdateActiveNotifications Contains active notifications that were 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 UpdateAnimatedEmojiMessageClicked 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 UpdateAnimationSearchParameters The parameters of animation search through getOption(“animation_search_bot_username”) bot has changed UpdateAttachmentMenuBots The list of bots added to attachment or side menu has changed UpdateAuthorizationState The user authorization state has changed UpdateAutosaveSettings Autosave settings for some type of chats were updated UpdateBasicGroup Some data of a basic group has changed. This update is guaranteed to come before the basic group identifier is returned to the application UpdateBasicGroupFullInfo Some data in basicGroupFullInfo has been changed UpdateBusinessConnection A business connection has changed; for bots only UpdateBusinessMessageEdited A message in a business account was edited; for bots only UpdateBusinessMessagesDeleted Messages in a business account were deleted; for bots only UpdateCall New call was created or information about a call was updated UpdateChatAccentColors Chat accent colors have changed UpdateChatAction A message sender activity in the chat has changed UpdateChatActionBar The chat action bar was changed UpdateChatActiveStories The list of active stories posted by a specific chat has changed UpdateChatAddedToList A chat was added to a chat list UpdateChatAvailableReactions The chat available reactions were changed UpdateChatBackground The chat background was changed UpdateChatBlockList A chat was blocked or unblocked UpdateChatBoost A chat boost has changed; for bots only UpdateChatBusinessBotManageBar The bar for managing business bot was changed in a chat UpdateChatDefaultDisableNotification The value of the default disable_notification parameter, used when a message is sent to the chat, was changed UpdateChatDraftMessage 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 UpdateChatEmojiStatus Chat emoji status has changed UpdateChatFolders The list of chat folders or a chat folder has changed UpdateChatHasProtectedContent A chat content was allowed or restricted for saving UpdateChatHasScheduledMessages A chat’s has_scheduled_messages field has changed UpdateChatIsMarkedAsUnread A chat was marked as unread or was read UpdateChatIsTranslatable Translation of chat messages was enabled or disabled UpdateChatLastMessage The last message of a chat was changed UpdateChatMember User rights changed in a chat; for bots only UpdateChatMessageAutoDeleteTime The message auto-delete or self-destruct timer setting for a chat was changed UpdateChatMessageSender The message sender that is selected to send messages in a chat has changed UpdateChatNotificationSettings Notification settings for a chat were changed UpdateChatOnlineMemberCount 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 is sent just after the number of online users has changed UpdateChatPendingJoinRequests The chat pending join requests were changed UpdateChatPermissions Chat permissions were changed UpdateChatPhoto A chat photo was changed UpdateChatPosition The position of a chat in a chat list has changed. An updateChatLastMessage or updateChatDraftMessage update might be sent instead of the update UpdateChatReadInbox Incoming messages were read or the number of unread messages has been changed UpdateChatReadOutbox Outgoing messages were read UpdateChatRemovedFromList A chat was removed from a chat list UpdateChatReplyMarkup 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 UpdateChatTheme The chat theme was changed UpdateChatThemes The list of available chat themes has changed UpdateChatTitle The title of a chat was changed UpdateChatUnreadMentionCount The chat unread_mention_count has changed UpdateChatUnreadReactionCount The chat unread_reaction_count has changed UpdateChatVideoChat A chat video chat state has changed UpdateChatViewAsTopics A chat default appearance has changed UpdateConnectionState The connection state has changed. This update must be used only to show a human-readable description of the connection state UpdateContactCloseBirthdays The list of contacts that had birthdays recently or will have birthday soon has changed UpdateDefaultBackground The default background has changed UpdateDefaultReactionType The type of default reaction has changed UpdateDeleteMessages Some messages were deleted UpdateDiceEmojis The list of supported dice emojis has changed UpdateFavoriteStickers The list of favorite stickers was updated UpdateFile Information about a file was updated UpdateFileAddedToDownloads A file was added to the file download list. This update is sent only after file download list is loaded for the first time UpdateFileDownload A file download was changed. This update is sent only after file download list is loaded for the first time UpdateFileDownloads The state of the file download list has changed UpdateFileGenerationStart The file generation process needs to be started by the application UpdateFileGenerationStop File generation is no longer needed UpdateFileRemovedFromDownloads A file was removed from the file download list. This update is sent only after file download list is loaded for the first time UpdateForumTopicInfo Basic information about a topic in a forum chat was changed UpdateGroupCall Information about a group call was updated UpdateGroupCallParticipant 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 UpdateHavePendingNotifications Describes whether there are some pending notification updates. Can be used to prevent application from killing, while there are some pending notifications UpdateInstalledStickerSets The list of installed sticker sets was updated UpdateLanguagePackStrings Some language pack strings have been updated UpdateMessageContent The message content has changed UpdateMessageContentOpened The message content was opened. Updates voice note messages to “listened”, video note messages to “viewed” and starts the self-destruct timer UpdateMessageEdited A message was edited. Changes in the message content will come in a separate updateMessageContent UpdateMessageInteractionInfo The information about interactions with a message has changed UpdateMessageIsPinned The message pinned state was changed UpdateMessageLiveLocationViewed A message with a live location was viewed. When the update is received, the application is supposed to update the live location UpdateMessageMentionRead A message with an unread mention was read UpdateMessageReaction User changed its reactions on a message with public reactions; for bots only UpdateMessageReactions Reactions added to a message with anonymous reactions have changed; for bots only UpdateMessageSendAcknowledged A request to send a message has reached the Telegram server. This doesn’t mean that the message will be sent successfully.
This update is sent only if the option “use_quick_ack” is set to true. This update may be sent multiple times for the same message UpdateMessageSendFailed 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 UpdateMessageSendSucceeded A message has been successfully sent UpdateMessageUnreadReactions The list of unread reactions added to a message was changed UpdateNewBusinessMessage A new message was added to a business account; for bots only UpdateNewCallSignalingData New call signaling data arrived UpdateNewCallbackQuery A new incoming callback query; for bots only UpdateNewChat 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 UpdateNewChatJoinRequest A user sent a join request to a chat; for bots only UpdateNewChosenInlineResult The user has chosen a result of an inline query; for bots only UpdateNewCustomEvent A new incoming event; for bots only UpdateNewCustomQuery A new incoming query; for bots only UpdateNewInlineCallbackQuery A new incoming callback query from a message sent via a bot; for bots only UpdateNewInlineQuery A new incoming inline query; for bots only UpdateNewMessage A new message was received; can also be an outgoing message UpdateNewPreCheckoutQuery A new incoming pre-checkout query; for bots only. Contains full information about a checkout UpdateNewShippingQuery A new incoming shipping query; for bots only. Only for invoices with flexible price UpdateNotification A notification was changed UpdateNotificationGroup A list of active notifications in a notification group has changed UpdateOption An option changed its value UpdatePoll A poll was updated; for bots only UpdatePollAnswer A user changed the answer to a poll; for bots only UpdateProfileAccentColors The list of supported accent colors for user profiles has changed UpdateQuickReplyShortcut Basic information about a quick reply shortcut has changed. This update is guaranteed to come before the quick shortcut name is returned to the application UpdateQuickReplyShortcutDeleted A quick reply shortcut and all its messages were deleted UpdateQuickReplyShortcutMessages The list of quick reply shortcut messages has changed UpdateQuickReplyShortcuts The list of quick reply shortcuts has changed UpdateReactionNotificationSettings Notification settings for reactions were updated UpdateRecentStickers The list of recently used stickers was updated UpdateSavedAnimations The list of saved animations was updated UpdateSavedMessagesTags Tags used in Saved Messages or a Saved Messages topic have changed UpdateSavedMessagesTopic Basic information about a Saved Messages topic has changed. This update is guaranteed to come before the topic identifier is returned to the application UpdateSavedMessagesTopicCount Number of Saved Messages topics has changed UpdateSavedNotificationSounds The list of saved notification sounds was updated. This update may not be sent until information about a notification sound was requested for the first time UpdateScopeNotificationSettings Notification settings for some type of chats were updated UpdateSecretChat Some data of a secret chat has changed. This update is guaranteed to come before the secret chat identifier is returned to the application UpdateServiceNotification A service notification from the server was received. Upon receiving this the application must show a popup with the content of the notification UpdateSpeechRecognitionTrial The parameters of speech recognition without Telegram Premium subscription has changed UpdateSpeedLimitNotification Download or upload file speed for the user was limited, but it can be restored by subscription to Telegram Premium. The notification can be postponed until a being downloaded or uploaded file is visible to the user
Use getOption(“premium_download_speedup”) or getOption(“premium_upload_speedup”) to get expected speedup after subscription to Telegram Premium UpdateStickerSet A sticker set has changed UpdateStory A story was changed UpdateStoryDeleted A story became inaccessible UpdateStoryListChatCount Number of chats in a story list has changed UpdateStorySendFailed A story failed to send. If the story sending is canceled, then updateStoryDeleted will be received instead of this update UpdateStorySendSucceeded A story has been successfully sent UpdateStoryStealthMode Story stealth mode settings have changed UpdateSuggestedActions The list of suggested to the user actions has changed UpdateSupergroup 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 UpdateSupergroupFullInfo Some data in supergroupFullInfo has been changed UpdateTermsOfService 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” UpdateTrendingStickerSets The list of trending sticker sets was updated or some of them were viewed UpdateUnconfirmedSession The first unconfirmed session has changed UpdateUnreadChatCount 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 UpdateUnreadMessageCount Number of unread messages in a chat list has changed. This update is sent only if the message database is used UpdateUser Some data of a user has changed. This update is guaranteed to come before the user identifier is returned to the application UpdateUserFullInfo Some data in userFullInfo has been changed UpdateUserPrivacySettingRules Some privacy setting rules have been changed UpdateUserStatus The user went online or offline UpdateUsersNearby The list of users nearby has changed. The update is guaranteed to be sent only 60 seconds after a successful searchChatsNearby request UpdateWebAppMessageSent A message was sent by an opened Web App, so the Web App needs to be closed Updates Contains a list of updates User Represents a user UserFullInfo Contains full information about a user UserLink Contains an HTTPS URL, which can be used to get information about a user UserPrivacySettingRuleAllowChatMembers A rule to allow all members of certain specified basic groups and supergroups to doing something UserPrivacySettingRuleAllowUsers A rule to allow certain specified users to do something UserPrivacySettingRuleRestrictChatMembers A rule to restrict all members of specified basic groups and supergroups from doing something UserPrivacySettingRuleRestrictUsers A rule to restrict all specified users from doing something UserPrivacySettingRules 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 UserStatusLastMonth The user is offline, but was online last month UserStatusLastWeek The user is offline, but was online last week UserStatusOffline The user is offline UserStatusOnline The user is online UserStatusRecently The user was online recently UserSupportInfo Contains custom information about the user UserTypeBot A bot (see https:core.telegram.org/bots) Usernames Describes usernames assigned to a user, a supergroup, or a channel Users Represents a list of users ValidatedOrderInfo Contains a temporary identifier of validated order information, which is stored for one hour, and the available shipping options VectorPathCommandCubicBezierCurve A cubic Bézier curve to a given point VectorPathCommandLine A straight line to a given point Venue Describes a venue Video Describes a video file VideoChat Describes a video chat VideoNote Describes a video note. The video must be equal in width and height, cropped to a circle, and stored in MPEG4 format VoiceNote Describes a voice note WebApp Describes a Web App. Use getInternalLink with internalLinkTypeWebApp to share the Web App WebAppInfo Contains information about a Web App WebPage Describes a link preview WebPageInstantView Describes an instant view page for a web page