astra/go-tdlib
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Wiki Activity
go-tdlib/data/td_api.json
astravexton 6855faca26 Update tdlib
2021-12-08 09:23:00 +00:00

25698 lines
No EOL
993 KiB
JSON
Executable file
Raw Blame History

{
"types": [
{
"name": "double",
"description": "",
"class": "Double",
"properties": []
},
{
"name": "string",
"description": "",
"class": "String",
"properties": []
},
{
"name": "int32",
"description": "",
"class": "Int32",
"properties": []
},
{
"name": "int53",
"description": "",
"class": "Int53",
"properties": []
},
{
"name": "int64",
"description": "",
"class": "Int64",
"properties": []
},
{
"name": "bytes",
"description": "",
"class": "Bytes",
"properties": []
},
{
"name": "boolFalse",
"description": "",
"class": "Bool",
"properties": []
},
{
"name": "boolTrue",
"description": "",
"class": "Bool",
"properties": []
},
{
"name": "vector\u003ct\u003e",
"description": "",
"class": "Vector\u003cT\u003e",
"properties": []
},
{
"name": "error",
"description": "An object of this type can be returned on every function call, in case of an error",
"class": "Error",
"properties": [
{
"name": "code",
"type": "int32",
"description": "Error code; subject to future changes. If the error code is 406, the error message must not be processed in any way and must not be displayed to the user"
},
{
"name": "message",
"type": "string",
"description": "Error message; subject to future changes"
}
]
},
{
"name": "ok",
"description": "An object of this type is returned on a successful function call for certain functions",
"class": "Ok",
"properties": []
},
{
"name": "tdlibParameters",
"description": "Contains parameters for TDLib initialization",
"class": "TdlibParameters",
"properties": [
{
"name": "use_test_dc",
"type": "Bool",
"description": "If set to true, the Telegram test environment will be used instead of the production environment"
},
{
"name": "database_directory",
"type": "string",
"description": "The path to the directory for the persistent database; if empty, the current working directory will be used"
},
{
"name": "files_directory",
"type": "string",
"description": "The path to the directory for storing files; if empty, database_directory will be used"
},
{
"name": "use_file_database",
"type": "Bool",
"description": "If set to true, information about downloaded and uploaded files will be saved between application restarts"
},
{
"name": "use_chat_info_database",
"type": "Bool",
"description": "If set to true, the library will maintain a cache of users, basic groups, supergroups, channels and secret chats. Implies use_file_database"
},
{
"name": "use_message_database",
"type": "Bool",
"description": "If set to true, the library will maintain a cache of chats and messages. Implies use_chat_info_database"
},
{
"name": "use_secret_chats",
"type": "Bool",
"description": "If set to true, support for secret chats will be enabled"
},
{
"name": "api_id",
"type": "int32",
"description": "Application identifier for Telegram API access, which can be obtained at https://my.telegram.org"
},
{
"name": "api_hash",
"type": "string",
"description": "Application identifier hash for Telegram API access, which can be obtained at https://my.telegram.org"
},
{
"name": "system_language_code",
"type": "string",
"description": "IETF language tag of the user's operating system language; must be non-empty"
},
{
"name": "device_model",
"type": "string",
"description": "Model of the device the application is being run on; must be non-empty"
},
{
"name": "system_version",
"type": "string",
"description": "Version of the operating system the application is being run on. If empty, the version is automatically detected by TDLib"
},
{
"name": "application_version",
"type": "string",
"description": "Application version; must be non-empty"
},
{
"name": "enable_storage_optimizer",
"type": "Bool",
"description": "If set to true, old files will automatically be deleted"
},
{
"name": "ignore_file_names",
"type": "Bool",
"description": "If set to true, original file names will be ignored. Otherwise, downloaded files will be saved under names as close as possible to the original name"
}
]
},
{
"name": "authenticationCodeTypeTelegramMessage",
"description": "An authentication code is delivered via a private Telegram message, which can be viewed from another active session",
"class": "AuthenticationCodeType",
"properties": [
{
"name": "length",
"type": "int32",
"description": "Length of the code"
}
]
},
{
"name": "authenticationCodeTypeSms",
"description": "An authentication code is delivered via an SMS message to the specified phone number",
"class": "AuthenticationCodeType",
"properties": [
{
"name": "length",
"type": "int32",
"description": "Length of the code"
}
]
},
{
"name": "authenticationCodeTypeCall",
"description": "An authentication code is delivered via a phone call to the specified phone number",
"class": "AuthenticationCodeType",
"properties": [
{
"name": "length",
"type": "int32",
"description": "Length of the code"
}
]
},
{
"name": "authenticationCodeTypeFlashCall",
"description": "An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number from which the call was made is the code that should be entered automatically",
"class": "AuthenticationCodeType",
"properties": [
{
"name": "pattern",
"type": "string",
"description": "Pattern of the phone number from which the call will be made"
}
]
},
{
"name": "authenticationCodeTypeMissedCall",
"description": "An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number from which the call was made is the code that should be entered manually by the user",
"class": "AuthenticationCodeType",
"properties": [
{
"name": "phone_number_prefix",
"type": "string",
"description": "Prefix of the phone number from which the call will be made"
},
{
"name": "length",
"type": "int32",
"description": "Number of digits in the code, excluding the prefix"
}
]
},
{
"name": "authenticationCodeInfo",
"description": "Information about the authentication code that was sent",
"class": "AuthenticationCodeInfo",
"properties": [
{
"name": "phone_number",
"type": "string",
"description": "A phone number that is being authenticated"
},
{
"name": "type",
"type": "AuthenticationCodeType",
"description": "The way the code was sent to the user"
},
{
"name": "next_type",
"type": "AuthenticationCodeType",
"description": "The way the next code will be sent to the user; may be null"
},
{
"name": "timeout",
"type": "int32",
"description": "Timeout before the code can be re-sent, in seconds"
}
]
},
{
"name": "emailAddressAuthenticationCodeInfo",
"description": "Information about the email address authentication code that was sent",
"class": "EmailAddressAuthenticationCodeInfo",
"properties": [
{
"name": "email_address_pattern",
"type": "string",
"description": "Pattern of the email address to which an authentication code was sent"
},
{
"name": "length",
"type": "int32",
"description": "Length of the code; 0 if unknown"
}
]
},
{
"name": "textEntity",
"description": "Represents a part of the text that needs to be formatted in some unusual way",
"class": "TextEntity",
"properties": [
{
"name": "offset",
"type": "int32",
"description": "Offset of the entity, in UTF-16 code units"
},
{
"name": "length",
"type": "int32",
"description": "Length of the entity, in UTF-16 code units"
},
{
"name": "type",
"type": "TextEntityType",
"description": "Type of the entity"
}
]
},
{
"name": "textEntities",
"description": "Contains a list of text entities",
"class": "TextEntities",
"properties": [
{
"name": "entities",
"type": "vector\u003ctextEntity\u003e",
"description": "List of text entities"
}
]
},
{
"name": "formattedText",
"description": "A text with some entities",
"class": "FormattedText",
"properties": [
{
"name": "text",
"type": "string",
"description": "The text"
},
{
"name": "entities",
"type": "vector\u003ctextEntity\u003e",
"description": "Entities contained in the text. Entities can be nested, but must not mutually intersect with each other. Pre, Code and PreCode entities can't contain other entities. Bold, Italic, Underline and Strikethrough entities can contain and to be contained in all other entities. All other entities can't contain each other"
}
]
},
{
"name": "termsOfService",
"description": "Contains Telegram terms of service",
"class": "TermsOfService",
"properties": [
{
"name": "text",
"type": "formattedText",
"description": "Text of the terms of service"
},
{
"name": "min_user_age",
"type": "int32",
"description": "The minimum age of a user to be able to accept the terms; 0 if any"
},
{
"name": "show_popup",
"type": "Bool",
"description": "True, if a blocking popup with terms of service must be shown to the user"
}
]
},
{
"name": "authorizationStateWaitTdlibParameters",
"description": "TDLib needs TdlibParameters for initialization",
"class": "AuthorizationState",
"properties": []
},
{
"name": "authorizationStateWaitEncryptionKey",
"description": "TDLib needs an encryption key to decrypt the local database",
"class": "AuthorizationState",
"properties": [
{
"name": "is_encrypted",
"type": "Bool",
"description": "True, if the database is currently encrypted"
}
]
},
{
"name": "authorizationStateWaitPhoneNumber",
"description": "TDLib needs the user's phone number to authorize. Call `setAuthenticationPhoneNumber` to provide the phone number, or use `requestQrCodeAuthentication`, or `checkAuthenticationBotToken` for other authentication options",
"class": "AuthorizationState",
"properties": []
},
{
"name": "authorizationStateWaitCode",
"description": "TDLib needs the user's authentication code to authorize",
"class": "AuthorizationState",
"properties": [
{
"name": "code_info",
"type": "authenticationCodeInfo",
"description": "Information about the authorization code that was sent"
}
]
},
{
"name": "authorizationStateWaitOtherDeviceConfirmation",
"description": "The user needs to confirm authorization on another logged in device by scanning a QR code with the provided link",
"class": "AuthorizationState",
"properties": [
{
"name": "link",
"type": "string",
"description": "A tg:// URL for the QR code. The link will be updated frequently"
}
]
},
{
"name": "authorizationStateWaitRegistration",
"description": "The user is unregistered and need to accept terms of service and enter their first name and last name to finish registration",
"class": "AuthorizationState",
"properties": [
{
"name": "terms_of_service",
"type": "termsOfService",
"description": "Telegram terms of service"
}
]
},
{
"name": "authorizationStateWaitPassword",
"description": "The user has been authorized, but needs to enter a password to start using the application",
"class": "AuthorizationState",
"properties": [
{
"name": "password_hint",
"type": "string",
"description": "Hint for the password; may be empty"
},
{
"name": "has_recovery_email_address",
"type": "Bool",
"description": "True, if a recovery email address has been set up"
},
{
"name": "recovery_email_address_pattern",
"type": "string",
"description": "Pattern of the email address to which the recovery email was sent; empty until a recovery email has been sent"
}
]
},
{
"name": "authorizationStateReady",
"description": "The user has been successfully authorized. TDLib is now ready to answer queries",
"class": "AuthorizationState",
"properties": []
},
{
"name": "authorizationStateLoggingOut",
"description": "The user is currently logging out",
"class": "AuthorizationState",
"properties": []
},
{
"name": "authorizationStateClosing",
"description": "TDLib is closing, all subsequent queries will be answered with the error 500. Note that closing TDLib can take a while. All resources will be freed only after authorizationStateClosed has been received",
"class": "AuthorizationState",
"properties": []
},
{
"name": "authorizationStateClosed",
"description": "TDLib client is in its final state. All databases are closed and all resources are released. No other updates will be received after this. All queries will be responded to with error code 500. To continue working, one must create a new instance of the TDLib client",
"class": "AuthorizationState",
"properties": []
},
{
"name": "passwordState",
"description": "Represents the current state of 2-step verification",
"class": "PasswordState",
"properties": [
{
"name": "has_password",
"type": "Bool",
"description": "True, if a 2-step verification password is set"
},
{
"name": "password_hint",
"type": "string",
"description": "Hint for the password; may be empty"
},
{
"name": "has_recovery_email_address",
"type": "Bool",
"description": "True, if a recovery email is set"
},
{
"name": "has_passport_data",
"type": "Bool",
"description": "True, if some Telegram Passport elements were saved"
},
{
"name": "recovery_email_address_code_info",
"type": "emailAddressAuthenticationCodeInfo",
"description": "Information about the recovery email address to which the confirmation email was sent; may be null"
},
{
"name": "pending_reset_date",
"type": "int32",
"description": "If not 0, point in time (Unix timestamp) after which the password can be reset immediately using resetPassword"
}
]
},
{
"name": "recoveryEmailAddress",
"description": "Contains information about the current recovery email address",
"class": "RecoveryEmailAddress",
"properties": [
{
"name": "recovery_email_address",
"type": "string",
"description": "Recovery email address"
}
]
},
{
"name": "temporaryPasswordState",
"description": "Returns information about the availability of a temporary password, which can be used for payments",
"class": "TemporaryPasswordState",
"properties": [
{
"name": "has_password",
"type": "Bool",
"description": "True, if a temporary password is available"
},
{
"name": "valid_for",
"type": "int32",
"description": "Time left before the temporary password expires, in seconds"
}
]
},
{
"name": "localFile",
"description": "Represents a local file",
"class": "LocalFile",
"properties": [
{
"name": "path",
"type": "string",
"description": "Local path to the locally available file part; may be empty"
},
{
"name": "can_be_downloaded",
"type": "Bool",
"description": "True, if it is possible to try to download or generate the file"
},
{
"name": "can_be_deleted",
"type": "Bool",
"description": "True, if the file can be deleted"
},
{
"name": "is_downloading_active",
"type": "Bool",
"description": "True, if the file is currently being downloaded (or a local copy is being generated by some other means)"
},
{
"name": "is_downloading_completed",
"type": "Bool",
"description": "True, if the local copy is fully available"
},
{
"name": "download_offset",
"type": "int32",
"description": "Download will be started from this offset. downloaded_prefix_size is calculated from this offset"
},
{
"name": "downloaded_prefix_size",
"type": "int32",
"description": "If is_downloading_completed is false, then only some prefix of the file starting from download_offset is ready to be read. downloaded_prefix_size is the size of that prefix in bytes"
},
{
"name": "downloaded_size",
"type": "int32",
"description": "Total downloaded file size, in bytes. Can be used only for calculating download progress. The actual file size may be bigger, and some parts of it may contain garbage"
}
]
},
{
"name": "remoteFile",
"description": "Represents a remote file",
"class": "RemoteFile",
"properties": [
{
"name": "id",
"type": "string",
"description": "Remote file identifier; may be empty. Can be used by the current user across application restarts or even from other devices. Uniquely identifies a file, but a file can have a lot of different valid identifiers. If the ID starts with \"http://\" or \"https://\", it represents the HTTP URL of the file. TDLib is currently unable to download files if only their URL is known. If downloadFile is called on such a file or if it is sent to a secret chat, TDLib starts a file generation process by sending updateFileGenerationStart to the application with the HTTP URL in the original_path and \"#url#\" as the conversion string. Application must generate the file by downloading it to the specified location"
},
{
"name": "unique_id",
"type": "string",
"description": "Unique file identifier; may be empty if unknown. The unique file identifier which is the same for the same file even for different users and is persistent over time"
},
{
"name": "is_uploading_active",
"type": "Bool",
"description": "True, if the file is currently being uploaded (or a remote copy is being generated by some other means)"
},
{
"name": "is_uploading_completed",
"type": "Bool",
"description": "True, if a remote copy is fully available"
},
{
"name": "uploaded_size",
"type": "int32",
"description": "Size of the remote available part of the file, in bytes; 0 if unknown"
}
]
},
{
"name": "file",
"description": "Represents a file",
"class": "File",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Unique file identifier"
},
{
"name": "size",
"type": "int32",
"description": "File size, in bytes; 0 if unknown"
},
{
"name": "expected_size",
"type": "int32",
"description": "Approximate file size in bytes in case the exact file size is unknown. Can be used to show download/upload progress"
},
{
"name": "local",
"type": "localFile",
"description": "Information about the local copy of the file"
},
{
"name": "remote",
"type": "remoteFile",
"description": "Information about the remote copy of the file"
}
]
},
{
"name": "inputFileId",
"description": "A file defined by its unique ID",
"class": "InputFile",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Unique file identifier"
}
]
},
{
"name": "inputFileRemote",
"description": "A file defined by its remote ID. The remote ID is guaranteed to be usable only if the corresponding file is still accessible to the user and known to TDLib. For example, if the file is from a message, then the message must be not deleted and accessible to the user. If the file database is disabled, then the corresponding object with the file must be preloaded by the application",
"class": "InputFile",
"properties": [
{
"name": "id",
"type": "string",
"description": "Remote file identifier"
}
]
},
{
"name": "inputFileLocal",
"description": "A file defined by a local path",
"class": "InputFile",
"properties": [
{
"name": "path",
"type": "string",
"description": "Local path to the file"
}
]
},
{
"name": "inputFileGenerated",
"description": "A file generated by the application",
"class": "InputFile",
"properties": [
{
"name": "original_path",
"type": "string",
"description": "Local path to a file from which the file is generated; may be empty if there is no such file"
},
{
"name": "conversion",
"type": "string",
"description": "String specifying the conversion applied to the original file; must be persistent across application restarts. Conversions beginning with '#' are reserved for internal TDLib usage"
},
{
"name": "expected_size",
"type": "int32",
"description": "Expected size of the generated file, in bytes; 0 if unknown"
}
]
},
{
"name": "photoSize",
"description": "Describes an image in JPEG format",
"class": "PhotoSize",
"properties": [
{
"name": "type",
"type": "string",
"description": "Image type (see https://core.telegram.org/constructor/photoSize)"
},
{
"name": "photo",
"type": "file",
"description": "Information about the image file"
},
{
"name": "width",
"type": "int32",
"description": "Image width"
},
{
"name": "height",
"type": "int32",
"description": "Image height"
},
{
"name": "progressive_sizes",
"type": "vector\u003cint32\u003e",
"description": "Sizes of progressive JPEG file prefixes, which can be used to preliminarily show the image; in bytes"
}
]
},
{
"name": "minithumbnail",
"description": "Thumbnail image of a very poor quality and low resolution",
"class": "Minithumbnail",
"properties": [
{
"name": "width",
"type": "int32",
"description": "Thumbnail width, usually doesn't exceed 40"
},
{
"name": "height",
"type": "int32",
"description": "Thumbnail height, usually doesn't exceed 40"
},
{
"name": "data",
"type": "bytes",
"description": "The thumbnail in JPEG format"
}
]
},
{
"name": "thumbnailFormatJpeg",
"description": "The thumbnail is in JPEG format",
"class": "ThumbnailFormat",
"properties": []
},
{
"name": "thumbnailFormatPng",
"description": "The thumbnail is in PNG format. It will be used only for background patterns",
"class": "ThumbnailFormat",
"properties": []
},
{
"name": "thumbnailFormatWebp",
"description": "The thumbnail is in WEBP format. It will be used only for some stickers",
"class": "ThumbnailFormat",
"properties": []
},
{
"name": "thumbnailFormatGif",
"description": "The thumbnail is in static GIF format. It will be used only for some bot inline results",
"class": "ThumbnailFormat",
"properties": []
},
{
"name": "thumbnailFormatTgs",
"description": "The thumbnail is in TGS format. It will be used only for animated sticker sets",
"class": "ThumbnailFormat",
"properties": []
},
{
"name": "thumbnailFormatMpeg4",
"description": "The thumbnail is in MPEG4 format. It will be used only for some animations and videos",
"class": "ThumbnailFormat",
"properties": []
},
{
"name": "thumbnail",
"description": "Represents a thumbnail",
"class": "Thumbnail",
"properties": [
{
"name": "format",
"type": "ThumbnailFormat",
"description": "Thumbnail format"
},
{
"name": "width",
"type": "int32",
"description": "Thumbnail width"
},
{
"name": "height",
"type": "int32",
"description": "Thumbnail height"
},
{
"name": "file",
"type": "file",
"description": "The thumbnail"
}
]
},
{
"name": "maskPointForehead",
"description": "The mask is placed relatively to the forehead",
"class": "MaskPoint",
"properties": []
},
{
"name": "maskPointEyes",
"description": "The mask is placed relatively to the eyes",
"class": "MaskPoint",
"properties": []
},
{
"name": "maskPointMouth",
"description": "The mask is placed relatively to the mouth",
"class": "MaskPoint",
"properties": []
},
{
"name": "maskPointChin",
"description": "The mask is placed relatively to the chin",
"class": "MaskPoint",
"properties": []
},
{
"name": "maskPosition",
"description": "Position on a photo where a mask is placed",
"class": "MaskPosition",
"properties": [
{
"name": "point",
"type": "MaskPoint",
"description": "Part of the face, relative to which the mask is placed"
},
{
"name": "x_shift",
"type": "double",
"description": "Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. (For example, -1.0 will place the mask just to the left of the default mask position)"
},
{
"name": "y_shift",
"type": "double",
"description": "Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. (For example, 1.0 will place the mask just below the default mask position)"
},
{
"name": "scale",
"type": "double",
"description": "Mask scaling coefficient. (For example, 2.0 means a doubled size)"
}
]
},
{
"name": "closedVectorPath",
"description": "Represents a closed vector path. The path begins at the end point of the last command",
"class": "ClosedVectorPath",
"properties": [
{
"name": "commands",
"type": "vector\u003cVectorPathCommand\u003e",
"description": "List of vector path commands"
}
]
},
{
"name": "pollOption",
"description": "Describes one answer option of a poll",
"class": "PollOption",
"properties": [
{
"name": "text",
"type": "string",
"description": "Option text; 1-100 characters"
},
{
"name": "voter_count",
"type": "int32",
"description": "Number of voters for this option, available only for closed or voted polls"
},
{
"name": "vote_percentage",
"type": "int32",
"description": "The percentage of votes for this option; 0-100"
},
{
"name": "is_chosen",
"type": "Bool",
"description": "True, if the option was chosen by the user"
},
{
"name": "is_being_chosen",
"type": "Bool",
"description": "True, if the option is being chosen by a pending setPollAnswer request"
}
]
},
{
"name": "pollTypeRegular",
"description": "A regular poll",
"class": "PollType",
"properties": [
{
"name": "allow_multiple_answers",
"type": "Bool",
"description": "True, if multiple answer options can be chosen simultaneously"
}
]
},
{
"name": "pollTypeQuiz",
"description": "A poll in quiz mode, which has exactly one correct answer option and can be answered only once",
"class": "PollType",
"properties": [
{
"name": "correct_option_id",
"type": "int32",
"description": "0-based identifier of the correct answer option; -1 for a yet unanswered poll"
},
{
"name": "explanation",
"type": "formattedText",
"description": "Text that is shown when the user chooses an incorrect answer or taps on the lamp icon; 0-200 characters with at most 2 line feeds; empty for a yet unanswered poll"
}
]
},
{
"name": "animation",
"description": "Describes an animation file. The animation must be encoded in GIF or MPEG4 format",
"class": "Animation",
"properties": [
{
"name": "duration",
"type": "int32",
"description": "Duration of the animation, in seconds; as defined by the sender"
},
{
"name": "width",
"type": "int32",
"description": "Width of the animation"
},
{
"name": "height",
"type": "int32",
"description": "Height of the animation"
},
{
"name": "file_name",
"type": "string",
"description": "Original name of the file; as defined by the sender"
},
{
"name": "mime_type",
"type": "string",
"description": "MIME type of the file, usually \"image/gif\" or \"video/mp4\""
},
{
"name": "has_stickers",
"type": "Bool",
"description": "True, if stickers were added to the animation. The list of corresponding sticker set can be received using getAttachedStickerSets"
},
{
"name": "minithumbnail",
"type": "minithumbnail",
"description": "Animation minithumbnail; may be null"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Animation thumbnail in JPEG or MPEG4 format; may be null"
},
{
"name": "animation",
"type": "file",
"description": "File containing the animation"
}
]
},
{
"name": "audio",
"description": "Describes an audio file. Audio is usually in MP3 or M4A format",
"class": "Audio",
"properties": [
{
"name": "duration",
"type": "int32",
"description": "Duration of the audio, in seconds; as defined by the sender"
},
{
"name": "title",
"type": "string",
"description": "Title of the audio; as defined by the sender"
},
{
"name": "performer",
"type": "string",
"description": "Performer of the audio; as defined by the sender"
},
{
"name": "file_name",
"type": "string",
"description": "Original name of the file; as defined by the sender"
},
{
"name": "mime_type",
"type": "string",
"description": "The MIME type of the file; as defined by the sender"
},
{
"name": "album_cover_minithumbnail",
"type": "minithumbnail",
"description": "The minithumbnail of the album cover; may be null"
},
{
"name": "album_cover_thumbnail",
"type": "thumbnail",
"description": "The thumbnail of the album cover in JPEG format; as defined by the sender. The full size thumbnail is supposed to be extracted from the downloaded file; may be null"
},
{
"name": "audio",
"type": "file",
"description": "File containing the audio"
}
]
},
{
"name": "document",
"description": "Describes a document of any type",
"class": "Document",
"properties": [
{
"name": "file_name",
"type": "string",
"description": "Original name of the file; as defined by the sender"
},
{
"name": "mime_type",
"type": "string",
"description": "MIME type of the file; as defined by the sender"
},
{
"name": "minithumbnail",
"type": "minithumbnail",
"description": "Document minithumbnail; may be null"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Document thumbnail in JPEG or PNG format (PNG will be used only for background patterns); as defined by the sender; may be null"
},
{
"name": "document",
"type": "file",
"description": "File containing the document"
}
]
},
{
"name": "photo",
"description": "Describes a photo",
"class": "Photo",
"properties": [
{
"name": "has_stickers",
"type": "Bool",
"description": "True, if stickers were added to the photo. The list of corresponding sticker sets can be received using getAttachedStickerSets"
},
{
"name": "minithumbnail",
"type": "minithumbnail",
"description": "Photo minithumbnail; may be null"
},
{
"name": "sizes",
"type": "vector\u003cphotoSize\u003e",
"description": "Available variants of the photo, in different sizes"
}
]
},
{
"name": "sticker",
"description": "Describes a sticker",
"class": "Sticker",
"properties": [
{
"name": "set_id",
"type": "int64",
"description": "The identifier of the sticker set to which the sticker belongs; 0 if none"
},
{
"name": "width",
"type": "int32",
"description": "Sticker width; as defined by the sender"
},
{
"name": "height",
"type": "int32",
"description": "Sticker height; as defined by the sender"
},
{
"name": "emoji",
"type": "string",
"description": "Emoji corresponding to the sticker"
},
{
"name": "is_animated",
"type": "Bool",
"description": "True, if the sticker is an animated sticker in TGS format"
},
{
"name": "is_mask",
"type": "Bool",
"description": "True, if the sticker is a mask"
},
{
"name": "mask_position",
"type": "maskPosition",
"description": "Position where the mask is placed; may be null"
},
{
"name": "outline",
"type": "vector\u003cclosedVectorPath\u003e",
"description": "Sticker's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Sticker thumbnail in WEBP or JPEG format; may be null"
},
{
"name": "sticker",
"type": "file",
"description": "File containing the sticker"
}
]
},
{
"name": "video",
"description": "Describes a video file",
"class": "Video",
"properties": [
{
"name": "duration",
"type": "int32",
"description": "Duration of the video, in seconds; as defined by the sender"
},
{
"name": "width",
"type": "int32",
"description": "Video width; as defined by the sender"
},
{
"name": "height",
"type": "int32",
"description": "Video height; as defined by the sender"
},
{
"name": "file_name",
"type": "string",
"description": "Original name of the file; as defined by the sender"
},
{
"name": "mime_type",
"type": "string",
"description": "MIME type of the file; as defined by the sender"
},
{
"name": "has_stickers",
"type": "Bool",
"description": "True, if stickers were added to the video. The list of corresponding sticker sets can be received using getAttachedStickerSets"
},
{
"name": "supports_streaming",
"type": "Bool",
"description": "True, if the video is supposed to be streamed"
},
{
"name": "minithumbnail",
"type": "minithumbnail",
"description": "Video minithumbnail; may be null"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Video thumbnail in JPEG or MPEG4 format; as defined by the sender; may be null"
},
{
"name": "video",
"type": "file",
"description": "File containing the video"
}
]
},
{
"name": "videoNote",
"description": "Describes a video note. The video must be equal in width and height, cropped to a circle, and stored in MPEG4 format",
"class": "VideoNote",
"properties": [
{
"name": "duration",
"type": "int32",
"description": "Duration of the video, in seconds; as defined by the sender"
},
{
"name": "length",
"type": "int32",
"description": "Video width and height; as defined by the sender"
},
{
"name": "minithumbnail",
"type": "minithumbnail",
"description": "Video minithumbnail; may be null"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Video thumbnail in JPEG format; as defined by the sender; may be null"
},
{
"name": "video",
"type": "file",
"description": "File containing the video"
}
]
},
{
"name": "voiceNote",
"description": "Describes a voice note. The voice note must be encoded with the Opus codec, and stored inside an OGG container. Voice notes can have only a single audio channel",
"class": "VoiceNote",
"properties": [
{
"name": "duration",
"type": "int32",
"description": "Duration of the voice note, in seconds; as defined by the sender"
},
{
"name": "waveform",
"type": "bytes",
"description": "A waveform representation of the voice note in 5-bit format"
},
{
"name": "mime_type",
"type": "string",
"description": "MIME type of the file; as defined by the sender"
},
{
"name": "voice",
"type": "file",
"description": "File containing the voice note"
}
]
},
{
"name": "animatedEmoji",
"description": "Describes an animated representation of an emoji",
"class": "AnimatedEmoji",
"properties": [
{
"name": "sticker",
"type": "sticker",
"description": "Animated sticker for the emoji"
},
{
"name": "fitzpatrick_type",
"type": "int32",
"description": "Emoji modifier fitzpatrick type; 0-6; 0 if none"
},
{
"name": "sound",
"type": "file",
"description": "File containing the sound to be played when the animated emoji is clicked if any; may be null. The sound is encoded with the Opus codec, and stored inside an OGG container"
}
]
},
{
"name": "contact",
"description": "Describes a user contact",
"class": "Contact",
"properties": [
{
"name": "phone_number",
"type": "string",
"description": "Phone number of the user"
},
{
"name": "first_name",
"type": "string",
"description": "First name of the user; 1-255 characters in length"
},
{
"name": "last_name",
"type": "string",
"description": "Last name of the user"
},
{
"name": "vcard",
"type": "string",
"description": "Additional data about the user in a form of vCard; 0-2048 bytes in length"
},
{
"name": "user_id",
"type": "int53",
"description": "Identifier of the user, if known; otherwise 0"
}
]
},
{
"name": "location",
"description": "Describes a location on planet Earth",
"class": "Location",
"properties": [
{
"name": "latitude",
"type": "double",
"description": "Latitude of the location in degrees; as defined by the sender"
},
{
"name": "longitude",
"type": "double",
"description": "Longitude of the location, in degrees; as defined by the sender"
},
{
"name": "horizontal_accuracy",
"type": "double",
"description": "The estimated horizontal accuracy of the location, in meters; as defined by the sender. 0 if unknown"
}
]
},
{
"name": "venue",
"description": "Describes a venue",
"class": "Venue",
"properties": [
{
"name": "location",
"type": "location",
"description": "Venue location; as defined by the sender"
},
{
"name": "title",
"type": "string",
"description": "Venue name; as defined by the sender"
},
{
"name": "address",
"type": "string",
"description": "Venue address; as defined by the sender"
},
{
"name": "provider",
"type": "string",
"description": "Provider of the venue database; as defined by the sender. Currently only \"foursquare\" and \"gplaces\" (Google Places) need to be supported"
},
{
"name": "id",
"type": "string",
"description": "Identifier of the venue in the provider database; as defined by the sender"
},
{
"name": "type",
"type": "string",
"description": "Type of the venue in the provider database; as defined by the sender"
}
]
},
{
"name": "game",
"description": "Describes a game",
"class": "Game",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Game ID"
},
{
"name": "short_name",
"type": "string",
"description": "Game short name. To share a game use the URL https://t.me/{bot_username}?game={game_short_name}"
},
{
"name": "title",
"type": "string",
"description": "Game title"
},
{
"name": "text",
"type": "formattedText",
"description": "Game text, usually containing scoreboards for a game"
},
{
"name": "description",
"type": "string",
"description": "Game description"
},
{
"name": "photo",
"type": "photo",
"description": "Game photo"
},
{
"name": "animation",
"type": "animation",
"description": "Game animation; may be null"
}
]
},
{
"name": "poll",
"description": "Describes a poll",
"class": "Poll",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Unique poll identifier"
},
{
"name": "question",
"type": "string",
"description": "Poll question; 1-300 characters"
},
{
"name": "options",
"type": "vector\u003cpollOption\u003e",
"description": "List of poll answer options"
},
{
"name": "total_voter_count",
"type": "int32",
"description": "Total number of voters, participating in the poll"
},
{
"name": "recent_voter_user_ids",
"type": "vector\u003cint53\u003e",
"description": "User identifiers of recent voters, if the poll is non-anonymous"
},
{
"name": "is_anonymous",
"type": "Bool",
"description": "True, if the poll is anonymous"
},
{
"name": "type",
"type": "PollType",
"description": "Type of the poll"
},
{
"name": "open_period",
"type": "int32",
"description": "Amount of time the poll will be active after creation, in seconds"
},
{
"name": "close_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the poll will automatically be closed"
},
{
"name": "is_closed",
"type": "Bool",
"description": "True, if the poll is closed"
}
]
},
{
"name": "profilePhoto",
"description": "Describes a user profile photo",
"class": "ProfilePhoto",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Photo identifier; 0 for an empty photo. Can be used to find a photo in a list of user profile photos"
},
{
"name": "small",
"type": "file",
"description": "A small (160x160) user profile photo. The file can be downloaded only before the photo is changed"
},
{
"name": "big",
"type": "file",
"description": "A big (640x640) user profile photo. The file can be downloaded only before the photo is changed"
},
{
"name": "minithumbnail",
"type": "minithumbnail",
"description": "User profile photo minithumbnail; may be null"
},
{
"name": "has_animation",
"type": "Bool",
"description": "True, if the photo has animated variant"
}
]
},
{
"name": "chatPhotoInfo",
"description": "Contains basic information about the photo of a chat",
"class": "ChatPhotoInfo",
"properties": [
{
"name": "small",
"type": "file",
"description": "A small (160x160) chat photo variant in JPEG format. The file can be downloaded only before the photo is changed"
},
{
"name": "big",
"type": "file",
"description": "A big (640x640) chat photo variant in JPEG format. The file can be downloaded only before the photo is changed"
},
{
"name": "minithumbnail",
"type": "minithumbnail",
"description": "Chat photo minithumbnail; may be null"
},
{
"name": "has_animation",
"type": "Bool",
"description": "True, if the photo has animated variant"
}
]
},
{
"name": "userTypeRegular",
"description": "A regular user",
"class": "UserType",
"properties": []
},
{
"name": "userTypeDeleted",
"description": "A deleted user or deleted bot. No information on the user besides the user identifier is available. It is not possible to perform any active actions on this type of user",
"class": "UserType",
"properties": []
},
{
"name": "userTypeBot",
"description": "A bot (see https://core.telegram.org/bots)",
"class": "UserType",
"properties": [
{
"name": "can_join_groups",
"type": "Bool",
"description": "True, if the bot can be invited to basic group and supergroup chats"
},
{
"name": "can_read_all_group_messages",
"type": "Bool",
"description": "True, if the bot can read all messages in basic group or supergroup chats and not just those addressed to the bot. In private and channel chats a bot can always read all messages"
},
{
"name": "is_inline",
"type": "Bool",
"description": "True, if the bot supports inline queries"
},
{
"name": "inline_query_placeholder",
"type": "string",
"description": "Placeholder for inline queries (displayed on the application input field)"
},
{
"name": "need_location",
"type": "Bool",
"description": "True, if the location of the user is expected to be sent with every inline query to this bot"
}
]
},
{
"name": "userTypeUnknown",
"description": "No information on the user besides the user identifier is available, yet this user has not been deleted. This object is extremely rare and must be handled like a deleted user. It is not possible to perform any actions on users of this type",
"class": "UserType",
"properties": []
},
{
"name": "botCommand",
"description": "Represents a command supported by a bot",
"class": "BotCommand",
"properties": [
{
"name": "command",
"type": "string",
"description": "Text of the bot command"
},
{
"name": "description",
"type": "string",
"description": "Description of the bot command"
}
]
},
{
"name": "botCommands",
"description": "Contains a list of bot commands",
"class": "BotCommands",
"properties": [
{
"name": "bot_user_id",
"type": "int53",
"description": "Bot's user identifier"
},
{
"name": "commands",
"type": "vector\u003cbotCommand\u003e",
"description": "List of bot commands"
}
]
},
{
"name": "chatLocation",
"description": "Represents a location to which a chat is connected",
"class": "ChatLocation",
"properties": [
{
"name": "location",
"type": "location",
"description": "The location"
},
{
"name": "address",
"type": "string",
"description": "Location address; 1-64 characters, as defined by the chat owner"
}
]
},
{
"name": "animatedChatPhoto",
"description": "Animated variant of a chat photo in MPEG4 format",
"class": "AnimatedChatPhoto",
"properties": [
{
"name": "length",
"type": "int32",
"description": "Animation width and height"
},
{
"name": "file",
"type": "file",
"description": "Information about the animation file"
},
{
"name": "main_frame_timestamp",
"type": "double",
"description": "Timestamp of the frame, used as a static chat photo"
}
]
},
{
"name": "chatPhoto",
"description": "Describes a chat or user profile photo",
"class": "ChatPhoto",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Unique photo identifier"
},
{
"name": "added_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the photo has been added"
},
{
"name": "minithumbnail",
"type": "minithumbnail",
"description": "Photo minithumbnail; may be null"
},
{
"name": "sizes",
"type": "vector\u003cphotoSize\u003e",
"description": "Available variants of the photo in JPEG format, in different size"
},
{
"name": "animation",
"type": "animatedChatPhoto",
"description": "Animated variant of the photo in MPEG4 format; may be null"
}
]
},
{
"name": "chatPhotos",
"description": "Contains a list of chat or user profile photos",
"class": "ChatPhotos",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Total number of photos"
},
{
"name": "photos",
"type": "vector\u003cchatPhoto\u003e",
"description": "List of photos"
}
]
},
{
"name": "inputChatPhotoPrevious",
"description": "A previously used profile photo of the current user",
"class": "InputChatPhoto",
"properties": [
{
"name": "chat_photo_id",
"type": "int64",
"description": "Identifier of the current user's profile photo to reuse"
}
]
},
{
"name": "inputChatPhotoStatic",
"description": "A static photo in JPEG format",
"class": "InputChatPhoto",
"properties": [
{
"name": "photo",
"type": "InputFile",
"description": "Photo to be set as profile photo. Only inputFileLocal and inputFileGenerated are allowed"
}
]
},
{
"name": "inputChatPhotoAnimation",
"description": "An animation in MPEG4 format; must be square, at most 10 seconds long, have width between 160 and 800 and be at most 2MB in size",
"class": "InputChatPhoto",
"properties": [
{
"name": "animation",
"type": "InputFile",
"description": "Animation to be set as profile photo. Only inputFileLocal and inputFileGenerated are allowed"
},
{
"name": "main_frame_timestamp",
"type": "double",
"description": "Timestamp of the frame, which will be used as static chat photo"
}
]
},
{
"name": "user",
"description": "Represents a user",
"class": "User",
"properties": [
{
"name": "id",
"type": "int53",
"description": "User identifier"
},
{
"name": "first_name",
"type": "string",
"description": "First name of the user"
},
{
"name": "last_name",
"type": "string",
"description": "Last name of the user"
},
{
"name": "username",
"type": "string",
"description": "Username of the user"
},
{
"name": "phone_number",
"type": "string",
"description": "Phone number of the user"
},
{
"name": "status",
"type": "UserStatus",
"description": "Current online status of the user"
},
{
"name": "profile_photo",
"type": "profilePhoto",
"description": "Profile photo of the user; may be null"
},
{
"name": "is_contact",
"type": "Bool",
"description": "The user is a contact of the current user"
},
{
"name": "is_mutual_contact",
"type": "Bool",
"description": "The user is a contact of the current user and the current user is a contact of the user"
},
{
"name": "is_verified",
"type": "Bool",
"description": "True, if the user is verified"
},
{
"name": "is_support",
"type": "Bool",
"description": "True, if the user is Telegram support account"
},
{
"name": "restriction_reason",
"type": "string",
"description": "If non-empty, it contains a human-readable description of the reason why access to this user must be restricted"
},
{
"name": "is_scam",
"type": "Bool",
"description": "True, if many users reported this user as a scam"
},
{
"name": "is_fake",
"type": "Bool",
"description": "True, if many users reported this user as a fake account"
},
{
"name": "have_access",
"type": "Bool",
"description": "If false, the user is inaccessible, and the only information known about the user is inside this class. It can't be passed to any method except GetUser"
},
{
"name": "type",
"type": "UserType",
"description": "Type of the user"
},
{
"name": "language_code",
"type": "string",
"description": "IETF language tag of the user's language; only available to bots"
}
]
},
{
"name": "userFullInfo",
"description": "Contains full information about a user",
"class": "UserFullInfo",
"properties": [
{
"name": "photo",
"type": "chatPhoto",
"description": "User profile photo; may be null"
},
{
"name": "is_blocked",
"type": "Bool",
"description": "True, if the user is blocked by the current user"
},
{
"name": "can_be_called",
"type": "Bool",
"description": "True, if the user can be called"
},
{
"name": "supports_video_calls",
"type": "Bool",
"description": "True, if a video call can be created with the user"
},
{
"name": "has_private_calls",
"type": "Bool",
"description": "True, if the user can't be called due to their privacy settings"
},
{
"name": "has_private_forwards",
"type": "Bool",
"description": "True, if the user can't be linked in forwarded messages due to their privacy settings"
},
{
"name": "need_phone_number_privacy_exception",
"type": "Bool",
"description": "True, if the current user needs to explicitly allow to share their phone number with the user when the method addContact is used"
},
{
"name": "bio",
"type": "string",
"description": "A short user bio"
},
{
"name": "share_text",
"type": "string",
"description": "For bots, the text that is shown on the bot's profile page and is sent together with the link when users share the bot"
},
{
"name": "description",
"type": "string",
"description": "For bots, the text shown in the chat with the bot if the chat is empty"
},
{
"name": "group_in_common_count",
"type": "int32",
"description": "Number of group chats where both the other user and the current user are a member; 0 for the current user"
},
{
"name": "commands",
"type": "vector\u003cbotCommand\u003e",
"description": "For bots, list of the bot commands"
}
]
},
{
"name": "users",
"description": "Represents a list of users",
"class": "Users",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of users found"
},
{
"name": "user_ids",
"type": "vector\u003cint53\u003e",
"description": "A list of user identifiers"
}
]
},
{
"name": "chatAdministrator",
"description": "Contains information about a chat administrator",
"class": "ChatAdministrator",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "User identifier of the administrator"
},
{
"name": "custom_title",
"type": "string",
"description": "Custom title of the administrator"
},
{
"name": "is_owner",
"type": "Bool",
"description": "True, if the user is the owner of the chat"
}
]
},
{
"name": "chatAdministrators",
"description": "Represents a list of chat administrators",
"class": "ChatAdministrators",
"properties": [
{
"name": "administrators",
"type": "vector\u003cchatAdministrator\u003e",
"description": "A list of chat administrators"
}
]
},
{
"name": "chatPermissions",
"description": "Describes actions that a user is allowed to take in a chat",
"class": "ChatPermissions",
"properties": [
{
"name": "can_send_messages",
"type": "Bool",
"description": "True, if the user can send text messages, contacts, locations, and venues"
},
{
"name": "can_send_media_messages",
"type": "Bool",
"description": "True, if the user can send audio files, documents, photos, videos, video notes, and voice notes. Implies can_send_messages permissions"
},
{
"name": "can_send_polls",
"type": "Bool",
"description": "True, if the user can send polls. Implies can_send_messages permissions"
},
{
"name": "can_send_other_messages",
"type": "Bool",
"description": "True, if the user can send animations, games, stickers, and dice and use inline bots. Implies can_send_messages permissions"
},
{
"name": "can_add_web_page_previews",
"type": "Bool",
"description": "True, if the user may add a web page preview to their messages. Implies can_send_messages permissions"
},
{
"name": "can_change_info",
"type": "Bool",
"description": "True, if the user can change the chat title, photo, and other settings"
},
{
"name": "can_invite_users",
"type": "Bool",
"description": "True, if the user can invite new users to the chat"
},
{
"name": "can_pin_messages",
"type": "Bool",
"description": "True, if the user can pin messages"
}
]
},
{
"name": "chatMemberStatusCreator",
"description": "The user is the owner of the chat and has all the administrator privileges",
"class": "ChatMemberStatus",
"properties": [
{
"name": "custom_title",
"type": "string",
"description": "A custom title of the owner; 0-16 characters without emojis; applicable to supergroups only"
},
{
"name": "is_anonymous",
"type": "Bool",
"description": "True, if the creator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only"
},
{
"name": "is_member",
"type": "Bool",
"description": "True, if the user is a member of the chat"
}
]
},
{
"name": "chatMemberStatusAdministrator",
"description": "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",
"class": "ChatMemberStatus",
"properties": [
{
"name": "custom_title",
"type": "string",
"description": "A custom title of the administrator; 0-16 characters without emojis; applicable to supergroups only"
},
{
"name": "can_be_edited",
"type": "Bool",
"description": "True, if the current user can edit the administrator privileges for the called user"
},
{
"name": "can_manage_chat",
"type": "Bool",
"description": "True, if the administrator can get chat event log, get chat statistics, get message statistics in channels, get channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other privilege; applicable to supergroups and channels only"
},
{
"name": "can_change_info",
"type": "Bool",
"description": "True, if the administrator can change the chat title, photo, and other settings"
},
{
"name": "can_post_messages",
"type": "Bool",
"description": "True, if the administrator can create channel posts; applicable to channels only"
},
{
"name": "can_edit_messages",
"type": "Bool",
"description": "True, if the administrator can edit messages of other users and pin messages; applicable to channels only"
},
{
"name": "can_delete_messages",
"type": "Bool",
"description": "True, if the administrator can delete messages of other users"
},
{
"name": "can_invite_users",
"type": "Bool",
"description": "True, if the administrator can invite new users to the chat"
},
{
"name": "can_restrict_members",
"type": "Bool",
"description": "True, if the administrator can restrict, ban, or unban chat members; always true for channels"
},
{
"name": "can_pin_messages",
"type": "Bool",
"description": "True, if the administrator can pin messages; applicable to basic groups and supergroups only"
},
{
"name": "can_promote_members",
"type": "Bool",
"description": "True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that were directly or indirectly promoted by them"
},
{
"name": "can_manage_video_chats",
"type": "Bool",
"description": "True, if the administrator can manage video chats"
},
{
"name": "is_anonymous",
"type": "Bool",
"description": "True, if the administrator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only"
}
]
},
{
"name": "chatMemberStatusMember",
"description": "The user is a member of the chat, without any additional privileges or restrictions",
"class": "ChatMemberStatus",
"properties": []
},
{
"name": "chatMemberStatusRestricted",
"description": "The user is under certain restrictions in the chat. Not supported in basic groups and channels",
"class": "ChatMemberStatus",
"properties": [
{
"name": "is_member",
"type": "Bool",
"description": "True, if the user is a member of the chat"
},
{
"name": "restricted_until_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when restrictions will be lifted from the user; 0 if never. If the user is restricted for more than 366 days or for less than 30 seconds from the current time, the user is considered to be restricted forever"
},
{
"name": "permissions",
"type": "chatPermissions",
"description": "User permissions in the chat"
}
]
},
{
"name": "chatMemberStatusLeft",
"description": "The user or the chat is not a chat member",
"class": "ChatMemberStatus",
"properties": []
},
{
"name": "chatMemberStatusBanned",
"description": "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",
"class": "ChatMemberStatus",
"properties": [
{
"name": "banned_until_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the user will be unbanned; 0 if never. If the user is banned for more than 366 days or for less than 30 seconds from the current time, the user is considered to be banned forever. Always 0 in basic groups"
}
]
},
{
"name": "chatMember",
"description": "Describes a user or a chat as a member of another chat",
"class": "ChatMember",
"properties": [
{
"name": "member_id",
"type": "MessageSender",
"description": "Identifier of the chat member. Currently, other chats can be only Left or Banned. Only supergroups and channels can have other chats as Left or Banned members and these chats must be supergroups or channels"
},
{
"name": "inviter_user_id",
"type": "int53",
"description": "Identifier of a user that invited/promoted/banned this member in the chat; 0 if unknown"
},
{
"name": "joined_chat_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the user joined the chat"
},
{
"name": "status",
"type": "ChatMemberStatus",
"description": "Status of the member in the chat"
}
]
},
{
"name": "chatMembers",
"description": "Contains a list of chat members",
"class": "ChatMembers",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of chat members found"
},
{
"name": "members",
"type": "vector\u003cchatMember\u003e",
"description": "A list of chat members"
}
]
},
{
"name": "chatMembersFilterContacts",
"description": "Returns contacts of the user",
"class": "ChatMembersFilter",
"properties": []
},
{
"name": "chatMembersFilterAdministrators",
"description": "Returns the owner and administrators",
"class": "ChatMembersFilter",
"properties": []
},
{
"name": "chatMembersFilterMembers",
"description": "Returns all chat members, including restricted chat members",
"class": "ChatMembersFilter",
"properties": []
},
{
"name": "chatMembersFilterMention",
"description": "Returns users which can be mentioned in the chat",
"class": "ChatMembersFilter",
"properties": [
{
"name": "message_thread_id",
"type": "int53",
"description": "If non-zero, the identifier of the current message thread"
}
]
},
{
"name": "chatMembersFilterRestricted",
"description": "Returns users under certain restrictions in the chat; can be used only by administrators in a supergroup",
"class": "ChatMembersFilter",
"properties": []
},
{
"name": "chatMembersFilterBanned",
"description": "Returns users banned from the chat; can be used only by administrators in a supergroup or in a channel",
"class": "ChatMembersFilter",
"properties": []
},
{
"name": "chatMembersFilterBots",
"description": "Returns bot members of the chat",
"class": "ChatMembersFilter",
"properties": []
},
{
"name": "supergroupMembersFilterRecent",
"description": "Returns recently active users in reverse chronological order",
"class": "SupergroupMembersFilter",
"properties": []
},
{
"name": "supergroupMembersFilterContacts",
"description": "Returns contacts of the user, which are members of the supergroup or channel",
"class": "SupergroupMembersFilter",
"properties": [
{
"name": "query",
"type": "string",
"description": "Query to search for"
}
]
},
{
"name": "supergroupMembersFilterAdministrators",
"description": "Returns the owner and administrators",
"class": "SupergroupMembersFilter",
"properties": []
},
{
"name": "supergroupMembersFilterSearch",
"description": "Used to search for supergroup or channel members via a (string) query",
"class": "SupergroupMembersFilter",
"properties": [
{
"name": "query",
"type": "string",
"description": "Query to search for"
}
]
},
{
"name": "supergroupMembersFilterRestricted",
"description": "Returns restricted supergroup members; can be used only by administrators",
"class": "SupergroupMembersFilter",
"properties": [
{
"name": "query",
"type": "string",
"description": "Query to search for"
}
]
},
{
"name": "supergroupMembersFilterBanned",
"description": "Returns users banned from the supergroup or channel; can be used only by administrators",
"class": "SupergroupMembersFilter",
"properties": [
{
"name": "query",
"type": "string",
"description": "Query to search for"
}
]
},
{
"name": "supergroupMembersFilterMention",
"description": "Returns users which can be mentioned in the supergroup",
"class": "SupergroupMembersFilter",
"properties": [
{
"name": "query",
"type": "string",
"description": "Query to search for"
},
{
"name": "message_thread_id",
"type": "int53",
"description": "If non-zero, the identifier of the current message thread"
}
]
},
{
"name": "supergroupMembersFilterBots",
"description": "Returns bot members of the supergroup or channel",
"class": "SupergroupMembersFilter",
"properties": []
},
{
"name": "chatInviteLink",
"description": "Contains a chat invite link",
"class": "ChatInviteLink",
"properties": [
{
"name": "invite_link",
"type": "string",
"description": "Chat invite link"
},
{
"name": "name",
"type": "string",
"description": "Name of the link"
},
{
"name": "creator_user_id",
"type": "int53",
"description": "User identifier of an administrator created the link"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the link was created"
},
{
"name": "edit_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the link was last edited; 0 if never or unknown"
},
{
"name": "expire_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the link will expire; 0 if never"
},
{
"name": "member_limit",
"type": "int32",
"description": "The maximum number of members, which can join the chat using the link simultaneously; 0 if not limited. Always 0 if the link requires approval"
},
{
"name": "member_count",
"type": "int32",
"description": "Number of chat members, which joined the chat using the link"
},
{
"name": "pending_join_request_count",
"type": "int32",
"description": "Number of pending join requests created using this link"
},
{
"name": "creates_join_request",
"type": "Bool",
"description": "True, if the link only creates join request. If true, total number of joining members will be unlimited"
},
{
"name": "is_primary",
"type": "Bool",
"description": "True, if the link is primary. Primary invite link can't have name, expire date or usage limit. There is exactly one primary invite link for each administrator with can_invite_users right at a given time"
},
{
"name": "is_revoked",
"type": "Bool",
"description": "True, if the link was revoked"
}
]
},
{
"name": "chatInviteLinks",
"description": "Contains a list of chat invite links",
"class": "ChatInviteLinks",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of chat invite links found"
},
{
"name": "invite_links",
"type": "vector\u003cchatInviteLink\u003e",
"description": "List of invite links"
}
]
},
{
"name": "chatInviteLinkCount",
"description": "Describes a chat administrator with a number of active and revoked chat invite links",
"class": "ChatInviteLinkCount",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "Administrator's user identifier"
},
{
"name": "invite_link_count",
"type": "int32",
"description": "Number of active invite links"
},
{
"name": "revoked_invite_link_count",
"type": "int32",
"description": "Number of revoked invite links"
}
]
},
{
"name": "chatInviteLinkCounts",
"description": "Contains a list of chat invite link counts",
"class": "ChatInviteLinkCounts",
"properties": [
{
"name": "invite_link_counts",
"type": "vector\u003cchatInviteLinkCount\u003e",
"description": "List of invite link counts"
}
]
},
{
"name": "chatInviteLinkMember",
"description": "Describes a chat member joined a chat by an invite link",
"class": "ChatInviteLinkMember",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "User identifier"
},
{
"name": "joined_chat_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the user joined the chat"
},
{
"name": "approver_user_id",
"type": "int53",
"description": "User identifier of the chat administrator, approved user join request"
}
]
},
{
"name": "chatInviteLinkMembers",
"description": "Contains a list of chat members joined a chat by an invite link",
"class": "ChatInviteLinkMembers",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of chat members found"
},
{
"name": "members",
"type": "vector\u003cchatInviteLinkMember\u003e",
"description": "List of chat members, joined a chat by an invite link"
}
]
},
{
"name": "chatInviteLinkInfo",
"description": "Contains information about a chat invite link",
"class": "ChatInviteLinkInfo",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier of the invite link; 0 if the user has no access to the chat before joining"
},
{
"name": "accessible_for",
"type": "int32",
"description": "If non-zero, the amount of time for which read access to the chat will remain available, in seconds"
},
{
"name": "type",
"type": "ChatType",
"description": "Type of the chat"
},
{
"name": "title",
"type": "string",
"description": "Title of the chat"
},
{
"name": "photo",
"type": "chatPhotoInfo",
"description": "Chat photo; may be null"
},
{
"name": "description",
"type": "string",
"description": "Chat description"
},
{
"name": "member_count",
"type": "int32",
"description": "Number of members in the chat"
},
{
"name": "member_user_ids",
"type": "vector\u003cint53\u003e",
"description": "User identifiers of some chat members that may be known to the current user"
},
{
"name": "creates_join_request",
"type": "Bool",
"description": "True, if the link only creates join request"
},
{
"name": "is_public",
"type": "Bool",
"description": "True, if the chat is a public supergroup or channel, i.e. it has a username or it is a location-based supergroup"
}
]
},
{
"name": "chatJoinRequest",
"description": "Describes a user that sent a join request and waits for administrator approval",
"class": "ChatJoinRequest",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "User identifier"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the user sent the join request"
},
{
"name": "bio",
"type": "string",
"description": "A short bio of the user"
}
]
},
{
"name": "chatJoinRequests",
"description": "Contains a list of chat join requests",
"class": "ChatJoinRequests",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of requests found"
},
{
"name": "requests",
"type": "vector\u003cchatJoinRequest\u003e",
"description": "List of the requests"
}
]
},
{
"name": "chatJoinRequestsInfo",
"description": "Contains information about pending chat join requests",
"class": "ChatJoinRequestsInfo",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Total number of pending join requests"
},
{
"name": "user_ids",
"type": "vector\u003cint53\u003e",
"description": "Identifiers of users sent the newest pending join requests"
}
]
},
{
"name": "basicGroup",
"description": "Represents a basic group of 0-200 users (must be upgraded to a supergroup to accommodate more than 200 users)",
"class": "BasicGroup",
"properties": [
{
"name": "id",
"type": "int53",
"description": "Group identifier"
},
{
"name": "member_count",
"type": "int32",
"description": "Number of members in the group"
},
{
"name": "status",
"type": "ChatMemberStatus",
"description": "Status of the current user in the group"
},
{
"name": "is_active",
"type": "Bool",
"description": "True, if the group is active"
},
{
"name": "upgraded_to_supergroup_id",
"type": "int53",
"description": "Identifier of the supergroup to which this group was upgraded; 0 if none"
}
]
},
{
"name": "basicGroupFullInfo",
"description": "Contains full information about a basic group",
"class": "BasicGroupFullInfo",
"properties": [
{
"name": "photo",
"type": "chatPhoto",
"description": "Chat photo; may be null"
},
{
"name": "description",
"type": "string",
"description": "Group description. Updated only after the basic group is opened"
},
{
"name": "creator_user_id",
"type": "int53",
"description": "User identifier of the creator of the group; 0 if unknown"
},
{
"name": "members",
"type": "vector\u003cchatMember\u003e",
"description": "Group members"
},
{
"name": "invite_link",
"type": "chatInviteLink",
"description": "Primary invite link for this group; may be null. For chat administrators with can_invite_users right only. Updated only after the basic group is opened"
},
{
"name": "bot_commands",
"type": "vector\u003cbotCommands\u003e",
"description": "List of commands of bots in the group"
}
]
},
{
"name": "supergroup",
"description": "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",
"class": "Supergroup",
"properties": [
{
"name": "id",
"type": "int53",
"description": "Supergroup or channel identifier"
},
{
"name": "username",
"type": "string",
"description": "Username of the supergroup or channel; empty for private supergroups or channels"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the current user joined, or the point in time when the supergroup or channel was created, in case the user is not a member"
},
{
"name": "status",
"type": "ChatMemberStatus",
"description": "Status of the current user in the supergroup or channel; custom title will be always empty"
},
{
"name": "member_count",
"type": "int32",
"description": "Number of members in the supergroup or channel; 0 if unknown. Currently it is guaranteed to be known only if the supergroup or channel was received through searchPublicChats, searchChatsNearby, getInactiveSupergroupChats, getSuitableDiscussionChats, getGroupsInCommon, or getUserPrivacySettingRules"
},
{
"name": "has_linked_chat",
"type": "Bool",
"description": "True, if the channel has a discussion group, or the supergroup is the designated discussion group for a channel"
},
{
"name": "has_location",
"type": "Bool",
"description": "True, if the supergroup is connected to a location, i.e. the supergroup is a location-based supergroup"
},
{
"name": "sign_messages",
"type": "Bool",
"description": "True, if messages sent to the channel need to contain information about the sender. This field is only applicable to channels"
},
{
"name": "is_slow_mode_enabled",
"type": "Bool",
"description": "True, if the slow mode is enabled in the supergroup"
},
{
"name": "is_channel",
"type": "Bool",
"description": "True, if the supergroup is a channel"
},
{
"name": "is_broadcast_group",
"type": "Bool",
"description": "True, if the supergroup is a broadcast group, i.e. only administrators can send messages and there is no limit on number of members"
},
{
"name": "is_verified",
"type": "Bool",
"description": "True, if the supergroup or channel is verified"
},
{
"name": "restriction_reason",
"type": "string",
"description": "If non-empty, contains a human-readable description of the reason why access to this supergroup or channel must be restricted"
},
{
"name": "is_scam",
"type": "Bool",
"description": "True, if many users reported this supergroup or channel as a scam"
},
{
"name": "is_fake",
"type": "Bool",
"description": "True, if many users reported this supergroup or channel as a fake account"
}
]
},
{
"name": "supergroupFullInfo",
"description": "Contains full information about a supergroup or channel",
"class": "SupergroupFullInfo",
"properties": [
{
"name": "photo",
"type": "chatPhoto",
"description": "Chat photo; may be null"
},
{
"name": "description",
"type": "string",
"description": "Supergroup or channel description"
},
{
"name": "member_count",
"type": "int32",
"description": "Number of members in the supergroup or channel; 0 if unknown"
},
{
"name": "administrator_count",
"type": "int32",
"description": "Number of privileged users in the supergroup or channel; 0 if unknown"
},
{
"name": "restricted_count",
"type": "int32",
"description": "Number of restricted users in the supergroup; 0 if unknown"
},
{
"name": "banned_count",
"type": "int32",
"description": "Number of users banned from chat; 0 if unknown"
},
{
"name": "linked_chat_id",
"type": "int53",
"description": "Chat identifier of a discussion group for the channel, or a channel, for which the supergroup is the designated discussion group; 0 if none or unknown"
},
{
"name": "slow_mode_delay",
"type": "int32",
"description": "Delay between consecutive sent messages for non-administrator supergroup members, in seconds"
},
{
"name": "slow_mode_delay_expires_in",
"type": "double",
"description": "Time left before next message can be sent in the supergroup, in seconds. An updateSupergroupFullInfo update is not triggered when value of this field changes, but both new and old values are non-zero"
},
{
"name": "can_get_members",
"type": "Bool",
"description": "True, if members of the chat can be retrieved"
},
{
"name": "can_set_username",
"type": "Bool",
"description": "True, if the chat username can be changed"
},
{
"name": "can_set_sticker_set",
"type": "Bool",
"description": "True, if the supergroup sticker set can be changed"
},
{
"name": "can_set_location",
"type": "Bool",
"description": "True, if the supergroup location can be changed"
},
{
"name": "can_get_statistics",
"type": "Bool",
"description": "True, if the supergroup or channel statistics are available"
},
{
"name": "is_all_history_available",
"type": "Bool",
"description": "True, if new chat members will have access to old messages. In public or discussion groups and both public and private channels, old messages are always available, so this option affects only private supergroups without a linked chat. The value of this field is only available for chat administrators"
},
{
"name": "sticker_set_id",
"type": "int64",
"description": "Identifier of the supergroup sticker set; 0 if none"
},
{
"name": "location",
"type": "chatLocation",
"description": "Location to which the supergroup is connected; may be null"
},
{
"name": "invite_link",
"type": "chatInviteLink",
"description": "Primary invite link for this chat; may be null. For chat administrators with can_invite_users right only"
},
{
"name": "bot_commands",
"type": "vector\u003cbotCommands\u003e",
"description": "List of commands of bots in the group"
},
{
"name": "upgraded_from_basic_group_id",
"type": "int53",
"description": "Identifier of the basic group from which supergroup was upgraded; 0 if none"
},
{
"name": "upgraded_from_max_message_id",
"type": "int53",
"description": "Identifier of the last message in the basic group from which supergroup was upgraded; 0 if none"
}
]
},
{
"name": "secretChatStatePending",
"description": "The secret chat is not yet created; waiting for the other user to get online",
"class": "SecretChatState",
"properties": []
},
{
"name": "secretChatStateReady",
"description": "The secret chat is ready to use",
"class": "SecretChatState",
"properties": []
},
{
"name": "secretChatStateClosed",
"description": "The secret chat is closed",
"class": "SecretChatState",
"properties": []
},
{
"name": "secretChat",
"description": "Represents a secret chat",
"class": "SecretChat",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Secret chat identifier"
},
{
"name": "user_id",
"type": "int53",
"description": "Identifier of the chat partner"
},
{
"name": "state",
"type": "SecretChatState",
"description": "State of the secret chat"
},
{
"name": "is_outbound",
"type": "Bool",
"description": "True, if the chat was created by the current user; otherwise false"
},
{
"name": "key_hash",
"type": "bytes",
"description": "Hash of the currently used key for comparison with the hash of the chat partner's key. This is a string of 36 little-endian bytes, which must be split into groups of 2 bits, each denoting a pixel of one of 4 colors FFFFFF, D5E6F3, 2D5775, and 2F99C9. The pixels must be used to make a 12x12 square image filled from left to right, top to bottom. Alternatively, the first 32 bytes of the hash can be converted to the hexadecimal format and printed as 32 2-digit hex numbers"
},
{
"name": "layer",
"type": "int32",
"description": "Secret chat layer; determines features supported by the chat partner's application. Nested text entities and underline and strikethrough entities are supported if the layer \u003e= 101"
}
]
},
{
"name": "messageSenderUser",
"description": "The message was sent by a known user",
"class": "MessageSender",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "Identifier of the user that sent the message"
}
]
},
{
"name": "messageSenderChat",
"description": "The message was sent on behalf of a chat",
"class": "MessageSender",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Identifier of the chat that sent the message"
}
]
},
{
"name": "messageSenders",
"description": "Represents a list of message senders",
"class": "MessageSenders",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of messages senders found"
},
{
"name": "senders",
"type": "vector\u003cMessageSender\u003e",
"description": "List of message senders"
}
]
},
{
"name": "messageForwardOriginUser",
"description": "The message was originally sent by a known user",
"class": "MessageForwardOrigin",
"properties": [
{
"name": "sender_user_id",
"type": "int53",
"description": "Identifier of the user that originally sent the message"
}
]
},
{
"name": "messageForwardOriginChat",
"description": "The message was originally sent by an anonymous chat administrator on behalf of the chat",
"class": "MessageForwardOrigin",
"properties": [
{
"name": "sender_chat_id",
"type": "int53",
"description": "Identifier of the chat that originally sent the message"
},
{
"name": "author_signature",
"type": "string",
"description": "Original message author signature"
}
]
},
{
"name": "messageForwardOriginHiddenUser",
"description": "The message was originally sent by a user, which is hidden by their privacy settings",
"class": "MessageForwardOrigin",
"properties": [
{
"name": "sender_name",
"type": "string",
"description": "Name of the sender"
}
]
},
{
"name": "messageForwardOriginChannel",
"description": "The message was originally a post in a channel",
"class": "MessageForwardOrigin",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Identifier of the chat from which the message was originally forwarded"
},
{
"name": "message_id",
"type": "int53",
"description": "Message identifier of the original message"
},
{
"name": "author_signature",
"type": "string",
"description": "Original post author signature"
}
]
},
{
"name": "messageForwardOriginMessageImport",
"description": "The message was imported from an exported message history",
"class": "MessageForwardOrigin",
"properties": [
{
"name": "sender_name",
"type": "string",
"description": "Name of the sender"
}
]
},
{
"name": "messageForwardInfo",
"description": "Contains information about a forwarded message",
"class": "MessageForwardInfo",
"properties": [
{
"name": "origin",
"type": "MessageForwardOrigin",
"description": "Origin of a forwarded message"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the message was originally sent"
},
{
"name": "public_service_announcement_type",
"type": "string",
"description": "The type of a public service announcement for the forwarded message"
},
{
"name": "from_chat_id",
"type": "int53",
"description": "For messages forwarded to the chat with the current user (Saved Messages), to the Replies bot chat, or to the channel's discussion group, the identifier of the chat from which the message was forwarded last time; 0 if unknown"
},
{
"name": "from_message_id",
"type": "int53",
"description": "For messages forwarded to the chat with the current user (Saved Messages), to the Replies bot chat, or to the channel's discussion group, the identifier of the original message from which the new message was forwarded last time; 0 if unknown"
}
]
},
{
"name": "messageReplyInfo",
"description": "Contains information about replies to a message",
"class": "MessageReplyInfo",
"properties": [
{
"name": "reply_count",
"type": "int32",
"description": "Number of times the message was directly or indirectly replied"
},
{
"name": "recent_replier_ids",
"type": "vector\u003cMessageSender\u003e",
"description": "Identifiers of recent repliers to the message; available in channels with a discussion supergroup"
},
{
"name": "last_read_inbox_message_id",
"type": "int53",
"description": "Identifier of the last read incoming reply to the message"
},
{
"name": "last_read_outbox_message_id",
"type": "int53",
"description": "Identifier of the last read outgoing reply to the message"
},
{
"name": "last_message_id",
"type": "int53",
"description": "Identifier of the last reply to the message"
}
]
},
{
"name": "messageInteractionInfo",
"description": "Contains information about interactions with a message",
"class": "MessageInteractionInfo",
"properties": [
{
"name": "view_count",
"type": "int32",
"description": "Number of times the message was viewed"
},
{
"name": "forward_count",
"type": "int32",
"description": "Number of times the message was forwarded"
},
{
"name": "reply_info",
"type": "messageReplyInfo",
"description": "Information about direct or indirect replies to the message; may be null. Currently, available only in channels with a discussion supergroup and discussion supergroups for messages, which are not replies itself"
}
]
},
{
"name": "messageSendingStatePending",
"description": "The message is being sent now, but has not yet been delivered to the server",
"class": "MessageSendingState",
"properties": []
},
{
"name": "messageSendingStateFailed",
"description": "The message failed to be sent",
"class": "MessageSendingState",
"properties": [
{
"name": "error_code",
"type": "int32",
"description": "An error code; 0 if unknown"
},
{
"name": "error_message",
"type": "string",
"description": "Error message"
},
{
"name": "can_retry",
"type": "Bool",
"description": "True, if the message can be re-sent"
},
{
"name": "need_another_sender",
"type": "Bool",
"description": "True, if the message can be re-sent only on behalf of a different sender"
},
{
"name": "retry_after",
"type": "double",
"description": "Time left before the message can be re-sent, in seconds. No update is sent when this field changes"
}
]
},
{
"name": "message",
"description": "Describes a message",
"class": "Message",
"properties": [
{
"name": "id",
"type": "int53",
"description": "Message identifier; unique for the chat to which the message belongs"
},
{
"name": "sender_id",
"type": "MessageSender",
"description": "Identifier of the sender of the message"
},
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "sending_state",
"type": "MessageSendingState",
"description": "The sending state of the message; may be null"
},
{
"name": "scheduling_state",
"type": "MessageSchedulingState",
"description": "The scheduling state of the message; may be null"
},
{
"name": "is_outgoing",
"type": "Bool",
"description": "True, if the message is outgoing"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is pinned"
},
{
"name": "can_be_edited",
"type": "Bool",
"description": "True, if the message can be edited. For live location and poll messages this fields shows whether editMessageLiveLocation or stopPoll can be used with this message by the application"
},
{
"name": "can_be_forwarded",
"type": "Bool",
"description": "True, if the message can be forwarded"
},
{
"name": "can_be_saved",
"type": "Bool",
"description": "True, if content of the message can be saved locally or copied"
},
{
"name": "can_be_deleted_only_for_self",
"type": "Bool",
"description": "True, if the message can be deleted only for the current user while other users will continue to see it"
},
{
"name": "can_be_deleted_for_all_users",
"type": "Bool",
"description": "True, if the message can be deleted for all users"
},
{
"name": "can_get_statistics",
"type": "Bool",
"description": "True, if the message statistics are available"
},
{
"name": "can_get_message_thread",
"type": "Bool",
"description": "True, if the message thread info is available"
},
{
"name": "can_get_viewers",
"type": "Bool",
"description": "True, if chat members already viewed the message can be received through getMessageViewers"
},
{
"name": "can_get_media_timestamp_links",
"type": "Bool",
"description": "True, if media timestamp links can be generated for media timestamp entities in the message text, caption or web page description"
},
{
"name": "has_timestamped_media",
"type": "Bool",
"description": "True, if media timestamp entities refers to a media in this message as opposed to a media in the replied message"
},
{
"name": "is_channel_post",
"type": "Bool",
"description": "True, if the message is a channel post. All messages to channels are channel posts, all other messages are not channel posts"
},
{
"name": "contains_unread_mention",
"type": "Bool",
"description": "True, if the message contains an unread mention for the current user"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the message was sent"
},
{
"name": "edit_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the message was last edited"
},
{
"name": "forward_info",
"type": "messageForwardInfo",
"description": "Information about the initial message sender; may be null"
},
{
"name": "interaction_info",
"type": "messageInteractionInfo",
"description": "Information about interactions with the message; may be null"
},
{
"name": "reply_in_chat_id",
"type": "int53",
"description": "If non-zero, the identifier of the chat to which the replied message belongs; Currently, only messages in the Replies chat can have different reply_in_chat_id and chat_id"
},
{
"name": "reply_to_message_id",
"type": "int53",
"description": "If non-zero, the identifier of the message this message is replying to; can be the identifier of a deleted message"
},
{
"name": "message_thread_id",
"type": "int53",
"description": "If non-zero, the identifier of the message thread the message belongs to; unique within the chat to which the message belongs"
},
{
"name": "ttl",
"type": "int32",
"description": "For self-destructing messages, the message's TTL (Time To Live), in seconds; 0 if none. TDLib will send updateDeleteMessages or updateMessageContent once the TTL expires"
},
{
"name": "ttl_expires_in",
"type": "double",
"description": "Time left before the message expires, in seconds. If the TTL timer isn't started yet, equals to the value of the ttl field"
},
{
"name": "via_bot_user_id",
"type": "int53",
"description": "If non-zero, the user identifier of the bot through which this message was sent"
},
{
"name": "author_signature",
"type": "string",
"description": "For channel posts and anonymous group messages, optional author signature"
},
{
"name": "media_album_id",
"type": "int64",
"description": "Unique identifier of an album this message belongs to. Only audios, documents, photos and videos can be grouped together in albums"
},
{
"name": "restriction_reason",
"type": "string",
"description": "If non-empty, contains a human-readable description of the reason why access to this message must be restricted"
},
{
"name": "content",
"type": "MessageContent",
"description": "Content of the message"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "Reply markup for the message; may be null"
}
]
},
{
"name": "messages",
"description": "Contains a list of messages",
"class": "Messages",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of messages found"
},
{
"name": "messages",
"type": "vector\u003cmessage\u003e",
"description": "List of messages; messages may be null"
}
]
},
{
"name": "foundMessages",
"description": "Contains a list of messages found by a search",
"class": "FoundMessages",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of messages found; -1 if unknown"
},
{
"name": "messages",
"type": "vector\u003cmessage\u003e",
"description": "List of messages"
},
{
"name": "next_offset",
"type": "string",
"description": "The offset for the next request. If empty, there are no more results"
}
]
},
{
"name": "messagePosition",
"description": "Contains information about a message in a specific position",
"class": "MessagePosition",
"properties": [
{
"name": "position",
"type": "int32",
"description": "0-based message position in the full list of suitable messages"
},
{
"name": "message_id",
"type": "int53",
"description": "Message identifier"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the message was sent"
}
]
},
{
"name": "messagePositions",
"description": "Contains a list of message positions",
"class": "MessagePositions",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Total count of messages found"
},
{
"name": "positions",
"type": "vector\u003cmessagePosition\u003e",
"description": "List of message positions"
}
]
},
{
"name": "messageCalendarDay",
"description": "Contains information about found messages sent in a specific day",
"class": "MessageCalendarDay",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Total number of found messages sent in the day"
},
{
"name": "message",
"type": "message",
"description": "First message sent in the day"
}
]
},
{
"name": "messageCalendar",
"description": "Contains information about found messages, splitted by days according to the option \"utc_time_offset\"",
"class": "MessageCalendar",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Total number of found messages"
},
{
"name": "days",
"type": "vector\u003cmessageCalendarDay\u003e",
"description": "Information about messages sent"
}
]
},
{
"name": "sponsoredMessage",
"description": "Describes a sponsored message",
"class": "SponsoredMessage",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Unique sponsored message identifier"
},
{
"name": "sponsor_chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "link",
"type": "InternalLinkType",
"description": "An internal link to be opened when the sponsored message is clicked; may be null. If null, the sponsor chat needs to be opened instead"
},
{
"name": "content",
"type": "MessageContent",
"description": "Content of the message"
}
]
},
{
"name": "sponsoredMessages",
"description": "Contains a list of sponsored messages",
"class": "SponsoredMessages",
"properties": [
{
"name": "messages",
"type": "vector\u003csponsoredMessage\u003e",
"description": "List of sponsored messages"
}
]
},
{
"name": "notificationSettingsScopePrivateChats",
"description": "Notification settings applied to all private and secret chats when the corresponding chat setting has a default value",
"class": "NotificationSettingsScope",
"properties": []
},
{
"name": "notificationSettingsScopeGroupChats",
"description": "Notification settings applied to all basic groups and supergroups when the corresponding chat setting has a default value",
"class": "NotificationSettingsScope",
"properties": []
},
{
"name": "notificationSettingsScopeChannelChats",
"description": "Notification settings applied to all channels when the corresponding chat setting has a default value",
"class": "NotificationSettingsScope",
"properties": []
},
{
"name": "chatNotificationSettings",
"description": "Contains information about notification settings for a chat",
"class": "ChatNotificationSettings",
"properties": [
{
"name": "use_default_mute_for",
"type": "Bool",
"description": "If true, mute_for is ignored and the value for the relevant type of chat is used instead"
},
{
"name": "mute_for",
"type": "int32",
"description": "Time left before notifications will be unmuted, in seconds"
},
{
"name": "use_default_sound",
"type": "Bool",
"description": "If true, sound is ignored and the value for the relevant type of chat is used instead"
},
{
"name": "sound",
"type": "string",
"description": "The name of an audio file to be used for notification sounds; only applies to iOS applications"
},
{
"name": "use_default_show_preview",
"type": "Bool",
"description": "If true, show_preview is ignored and the value for the relevant type of chat is used instead"
},
{
"name": "show_preview",
"type": "Bool",
"description": "True, if message content must be displayed in notifications"
},
{
"name": "use_default_disable_pinned_message_notifications",
"type": "Bool",
"description": "If true, disable_pinned_message_notifications is ignored and the value for the relevant type of chat is used instead"
},
{
"name": "disable_pinned_message_notifications",
"type": "Bool",
"description": "If true, notifications for incoming pinned messages will be created as for an ordinary unread message"
},
{
"name": "use_default_disable_mention_notifications",
"type": "Bool",
"description": "If true, disable_mention_notifications is ignored and the value for the relevant type of chat is used instead"
},
{
"name": "disable_mention_notifications",
"type": "Bool",
"description": "If true, notifications for messages with mentions will be created as for an ordinary unread message"
}
]
},
{
"name": "scopeNotificationSettings",
"description": "Contains information about notification settings for several chats",
"class": "ScopeNotificationSettings",
"properties": [
{
"name": "mute_for",
"type": "int32",
"description": "Time left before notifications will be unmuted, in seconds"
},
{
"name": "sound",
"type": "string",
"description": "The name of an audio file to be used for notification sounds; only applies to iOS applications"
},
{
"name": "show_preview",
"type": "Bool",
"description": "True, if message content must be displayed in notifications"
},
{
"name": "disable_pinned_message_notifications",
"type": "Bool",
"description": "True, if notifications for incoming pinned messages will be created as for an ordinary unread message"
},
{
"name": "disable_mention_notifications",
"type": "Bool",
"description": "True, if notifications for messages with mentions will be created as for an ordinary unread message"
}
]
},
{
"name": "draftMessage",
"description": "Contains information about a message draft",
"class": "DraftMessage",
"properties": [
{
"name": "reply_to_message_id",
"type": "int53",
"description": "Identifier of the message to reply to; 0 if none"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the draft was created"
},
{
"name": "input_message_text",
"type": "InputMessageContent",
"description": "Content of the message draft; must be of the type inputMessageText"
}
]
},
{
"name": "chatTypePrivate",
"description": "An ordinary chat with a user",
"class": "ChatType",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "User identifier"
}
]
},
{
"name": "chatTypeBasicGroup",
"description": "A basic group (a chat with 0-200 other users)",
"class": "ChatType",
"properties": [
{
"name": "basic_group_id",
"type": "int53",
"description": "Basic group identifier"
}
]
},
{
"name": "chatTypeSupergroup",
"description": "A supergroup or channel (with unlimited members)",
"class": "ChatType",
"properties": [
{
"name": "supergroup_id",
"type": "int53",
"description": "Supergroup or channel identifier"
},
{
"name": "is_channel",
"type": "Bool",
"description": "True, if the supergroup is a channel"
}
]
},
{
"name": "chatTypeSecret",
"description": "A secret chat with a user",
"class": "ChatType",
"properties": [
{
"name": "secret_chat_id",
"type": "int32",
"description": "Secret chat identifier"
},
{
"name": "user_id",
"type": "int53",
"description": "User identifier of the secret chat peer"
}
]
},
{
"name": "chatFilter",
"description": "Represents a filter of user chats",
"class": "ChatFilter",
"properties": [
{
"name": "title",
"type": "string",
"description": "The title of the filter; 1-12 characters without line feeds"
},
{
"name": "icon_name",
"type": "string",
"description": "The icon name for short filter representation. If non-empty, must be one of \"All\", \"Unread\", \"Unmuted\", \"Bots\", \"Channels\", \"Groups\", \"Private\", \"Custom\", \"Setup\", \"Cat\", \"Crown\", \"Favorite\", \"Flower\", \"Game\", \"Home\", \"Love\", \"Mask\", \"Party\", \"Sport\", \"Study\", \"Trade\", \"Travel\", \"Work\". If empty, use getChatFilterDefaultIconName to get default icon name for the filter"
},
{
"name": "pinned_chat_ids",
"type": "vector\u003cint53\u003e",
"description": "The chat identifiers of pinned chats in the filtered chat list"
},
{
"name": "included_chat_ids",
"type": "vector\u003cint53\u003e",
"description": "The chat identifiers of always included chats in the filtered chat list"
},
{
"name": "excluded_chat_ids",
"type": "vector\u003cint53\u003e",
"description": "The chat identifiers of always excluded chats in the filtered chat list"
},
{
"name": "exclude_muted",
"type": "Bool",
"description": "True, if muted chats need to be excluded"
},
{
"name": "exclude_read",
"type": "Bool",
"description": "True, if read chats need to be excluded"
},
{
"name": "exclude_archived",
"type": "Bool",
"description": "True, if archived chats need to be excluded"
},
{
"name": "include_contacts",
"type": "Bool",
"description": "True, if contacts need to be included"
},
{
"name": "include_non_contacts",
"type": "Bool",
"description": "True, if non-contact users need to be included"
},
{
"name": "include_bots",
"type": "Bool",
"description": "True, if bots need to be included"
},
{
"name": "include_groups",
"type": "Bool",
"description": "True, if basic groups and supergroups need to be included"
},
{
"name": "include_channels",
"type": "Bool",
"description": "True, if channels need to be included"
}
]
},
{
"name": "chatFilterInfo",
"description": "Contains basic information about a chat filter",
"class": "ChatFilterInfo",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Unique chat filter identifier"
},
{
"name": "title",
"type": "string",
"description": "The title of the filter; 1-12 characters without line feeds"
},
{
"name": "icon_name",
"type": "string",
"description": "The icon name for short filter representation. One of \"All\", \"Unread\", \"Unmuted\", \"Bots\", \"Channels\", \"Groups\", \"Private\", \"Custom\", \"Setup\", \"Cat\", \"Crown\", \"Favorite\", \"Flower\", \"Game\", \"Home\", \"Love\", \"Mask\", \"Party\", \"Sport\", \"Study\", \"Trade\", \"Travel\", \"Work\""
}
]
},
{
"name": "recommendedChatFilter",
"description": "Describes a recommended chat filter",
"class": "RecommendedChatFilter",
"properties": [
{
"name": "filter",
"type": "chatFilter",
"description": "The chat filter"
},
{
"name": "description",
"type": "string",
"description": "Chat filter description"
}
]
},
{
"name": "recommendedChatFilters",
"description": "Contains a list of recommended chat filters",
"class": "RecommendedChatFilters",
"properties": [
{
"name": "chat_filters",
"type": "vector\u003crecommendedChatFilter\u003e",
"description": "List of recommended chat filters"
}
]
},
{
"name": "chatListMain",
"description": "A main list of chats",
"class": "ChatList",
"properties": []
},
{
"name": "chatListArchive",
"description": "A list of chats usually located at the top of the main chat list. Unmuted chats are automatically moved from the Archive to the Main chat list when a new message arrives",
"class": "ChatList",
"properties": []
},
{
"name": "chatListFilter",
"description": "A list of chats belonging to a chat filter",
"class": "ChatList",
"properties": [
{
"name": "chat_filter_id",
"type": "int32",
"description": "Chat filter identifier"
}
]
},
{
"name": "chatLists",
"description": "Contains a list of chat lists",
"class": "ChatLists",
"properties": [
{
"name": "chat_lists",
"type": "vector\u003cChatList\u003e",
"description": "List of chat lists"
}
]
},
{
"name": "chatSourceMtprotoProxy",
"description": "The chat is sponsored by the user's MTProxy server",
"class": "ChatSource",
"properties": []
},
{
"name": "chatSourcePublicServiceAnnouncement",
"description": "The chat contains a public service announcement",
"class": "ChatSource",
"properties": [
{
"name": "type",
"type": "string",
"description": "The type of the announcement"
},
{
"name": "text",
"type": "string",
"description": "The text of the announcement"
}
]
},
{
"name": "chatPosition",
"description": "Describes a position of a chat in a chat list",
"class": "ChatPosition",
"properties": [
{
"name": "list",
"type": "ChatList",
"description": "The chat list"
},
{
"name": "order",
"type": "int64",
"description": "A parameter used to determine order of the chat in the chat list. Chats must be sorted by the pair (order, chat.id) in descending order"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the chat is pinned in the chat list"
},
{
"name": "source",
"type": "ChatSource",
"description": "Source of the chat in the chat list; may be null"
}
]
},
{
"name": "videoChat",
"description": "Describes a video chat",
"class": "VideoChat",
"properties": [
{
"name": "group_call_id",
"type": "int32",
"description": "Group call identifier of an active video chat; 0 if none. Full information about the video chat can be received through the method getGroupCall"
},
{
"name": "has_participants",
"type": "Bool",
"description": "True, if the video chat has participants"
},
{
"name": "default_participant_id",
"type": "MessageSender",
"description": "Default group call participant identifier to join the video chat; may be null"
}
]
},
{
"name": "chat",
"description": "A chat. (Can be a private chat, basic group, supergroup, or secret chat)",
"class": "Chat",
"properties": [
{
"name": "id",
"type": "int53",
"description": "Chat unique identifier"
},
{
"name": "type",
"type": "ChatType",
"description": "Type of the chat"
},
{
"name": "title",
"type": "string",
"description": "Chat title"
},
{
"name": "photo",
"type": "chatPhotoInfo",
"description": "Chat photo; may be null"
},
{
"name": "permissions",
"type": "chatPermissions",
"description": "Actions that non-administrator chat members are allowed to take in the chat"
},
{
"name": "last_message",
"type": "message",
"description": "Last message in the chat; may be null"
},
{
"name": "positions",
"type": "vector\u003cchatPosition\u003e",
"description": "Positions of the chat in chat lists"
},
{
"name": "default_message_sender_id",
"type": "MessageSender",
"description": "Default identifier of a user or chat that is chosen to send messages in the chat; may be null if the user can't change message sender"
},
{
"name": "has_protected_content",
"type": "Bool",
"description": "True, if chat content can't be saved locally, forwarded, or copied"
},
{
"name": "is_marked_as_unread",
"type": "Bool",
"description": "True, if the chat is marked as unread"
},
{
"name": "is_blocked",
"type": "Bool",
"description": "True, if the chat is blocked by the current user and private messages from the chat can't be received"
},
{
"name": "has_scheduled_messages",
"type": "Bool",
"description": "True, if the chat has scheduled messages"
},
{
"name": "can_be_deleted_only_for_self",
"type": "Bool",
"description": "True, if the chat messages can be deleted only for the current user while other users will continue to see the messages"
},
{
"name": "can_be_deleted_for_all_users",
"type": "Bool",
"description": "True, if the chat messages can be deleted for all users"
},
{
"name": "can_be_reported",
"type": "Bool",
"description": "True, if the chat can be reported to Telegram moderators through reportChat or reportChatPhoto"
},
{
"name": "default_disable_notification",
"type": "Bool",
"description": "Default value of the disable_notification parameter, used when a message is sent to the chat"
},
{
"name": "unread_count",
"type": "int32",
"description": "Number of unread messages in the chat"
},
{
"name": "last_read_inbox_message_id",
"type": "int53",
"description": "Identifier of the last read incoming message"
},
{
"name": "last_read_outbox_message_id",
"type": "int53",
"description": "Identifier of the last read outgoing message"
},
{
"name": "unread_mention_count",
"type": "int32",
"description": "Number of unread messages with a mention/reply in the chat"
},
{
"name": "notification_settings",
"type": "chatNotificationSettings",
"description": "Notification settings for this chat"
},
{
"name": "message_ttl_setting",
"type": "int32",
"description": "Current message Time To Live setting (self-destruct timer) for the chat; 0 if not defined. TTL is counted from the time message or its content is viewed in secret chats and from the send date in other chats"
},
{
"name": "theme_name",
"type": "string",
"description": "If non-empty, name of a theme, set for the chat"
},
{
"name": "action_bar",
"type": "ChatActionBar",
"description": "Information about actions which must be possible to do through the chat action bar; may be null"
},
{
"name": "video_chat",
"type": "videoChat",
"description": "Information about video chat of the chat"
},
{
"name": "pending_join_requests",
"type": "chatJoinRequestsInfo",
"description": "Information about pending join requests; may be null"
},
{
"name": "reply_markup_message_id",
"type": "int53",
"description": "Identifier of the message from which reply markup needs to be used; 0 if there is no default custom reply markup in the chat"
},
{
"name": "draft_message",
"type": "draftMessage",
"description": "A draft of a message in the chat; may be null"
},
{
"name": "client_data",
"type": "string",
"description": "Application-specific data associated with the chat. (For example, the chat scroll position or local chat notification settings can be stored here.) Persistent if the message database is used"
}
]
},
{
"name": "chats",
"description": "Represents a list of chats",
"class": "Chats",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total count of chats found"
},
{
"name": "chat_ids",
"type": "vector\u003cint53\u003e",
"description": "List of chat identifiers"
}
]
},
{
"name": "chatNearby",
"description": "Describes a chat located nearby",
"class": "ChatNearby",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "distance",
"type": "int32",
"description": "Distance to the chat location, in meters"
}
]
},
{
"name": "chatsNearby",
"description": "Represents a list of chats located nearby",
"class": "ChatsNearby",
"properties": [
{
"name": "users_nearby",
"type": "vector\u003cchatNearby\u003e",
"description": "List of users nearby"
},
{
"name": "supergroups_nearby",
"type": "vector\u003cchatNearby\u003e",
"description": "List of location-based supergroups nearby"
}
]
},
{
"name": "publicChatTypeHasUsername",
"description": "The chat is public, because it has username",
"class": "PublicChatType",
"properties": []
},
{
"name": "publicChatTypeIsLocationBased",
"description": "The chat is public, because it is a location-based supergroup",
"class": "PublicChatType",
"properties": []
},
{
"name": "chatActionBarReportSpam",
"description": "The chat can be reported as spam using the method reportChat with the reason chatReportReasonSpam",
"class": "ChatActionBar",
"properties": [
{
"name": "can_unarchive",
"type": "Bool",
"description": "If true, the chat was automatically archived and can be moved back to the main chat list using addChatToList simultaneously with setting chat notification settings to default using setChatNotificationSettings"
}
]
},
{
"name": "chatActionBarReportUnrelatedLocation",
"description": "The chat is a location-based supergroup, which can be reported as having unrelated location using the method reportChat with the reason chatReportReasonUnrelatedLocation",
"class": "ChatActionBar",
"properties": []
},
{
"name": "chatActionBarInviteMembers",
"description": "The chat is a recently created group chat to which new members can be invited",
"class": "ChatActionBar",
"properties": []
},
{
"name": "chatActionBarReportAddBlock",
"description": "The chat is a private or secret chat, which can be reported using the method reportChat, or the other user can be blocked using the method toggleMessageSenderIsBlocked, or the other user can be added to the contact list using the method addContact",
"class": "ChatActionBar",
"properties": [
{
"name": "can_unarchive",
"type": "Bool",
"description": "If true, the chat was automatically archived and can be moved back to the main chat list using addChatToList simultaneously with setting chat notification settings to default using setChatNotificationSettings"
},
{
"name": "distance",
"type": "int32",
"description": "If non-negative, the current user was found by the peer through searchChatsNearby and this is the distance between the users"
}
]
},
{
"name": "chatActionBarAddContact",
"description": "The chat is a private or secret chat and the other user can be added to the contact list using the method addContact",
"class": "ChatActionBar",
"properties": []
},
{
"name": "chatActionBarSharePhoneNumber",
"description": "The chat is a private or secret chat with a mutual contact and the user's phone number can be shared with the other user using the method sharePhoneNumber",
"class": "ChatActionBar",
"properties": []
},
{
"name": "chatActionBarJoinRequest",
"description": "The chat is a private chat with an administrator of a chat to which the user sent join request",
"class": "ChatActionBar",
"properties": [
{
"name": "title",
"type": "string",
"description": "Title of the chat to which the join request was sent"
},
{
"name": "is_channel",
"type": "Bool",
"description": "True, if the join request was sent to a channel chat"
},
{
"name": "request_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the join request was sent"
}
]
},
{
"name": "keyboardButtonTypeText",
"description": "A simple button, with text that must be sent when the button is pressed",
"class": "KeyboardButtonType",
"properties": []
},
{
"name": "keyboardButtonTypeRequestPhoneNumber",
"description": "A button that sends the user's phone number when pressed; available only in private chats",
"class": "KeyboardButtonType",
"properties": []
},
{
"name": "keyboardButtonTypeRequestLocation",
"description": "A button that sends the user's location when pressed; available only in private chats",
"class": "KeyboardButtonType",
"properties": []
},
{
"name": "keyboardButtonTypeRequestPoll",
"description": "A button that allows the user to create and send a poll when pressed; available only in private chats",
"class": "KeyboardButtonType",
"properties": [
{
"name": "force_regular",
"type": "Bool",
"description": "If true, only regular polls must be allowed to create"
},
{
"name": "force_quiz",
"type": "Bool",
"description": "If true, only polls in quiz mode must be allowed to create"
}
]
},
{
"name": "keyboardButton",
"description": "Represents a single button in a bot keyboard",
"class": "KeyboardButton",
"properties": [
{
"name": "text",
"type": "string",
"description": "Text of the button"
},
{
"name": "type",
"type": "KeyboardButtonType",
"description": "Type of the button"
}
]
},
{
"name": "inlineKeyboardButtonTypeUrl",
"description": "A button that opens a specified URL",
"class": "InlineKeyboardButtonType",
"properties": [
{
"name": "url",
"type": "string",
"description": "HTTP or tg:// URL to open"
}
]
},
{
"name": "inlineKeyboardButtonTypeLoginUrl",
"description": "A button that opens a specified URL and automatically authorize the current user if allowed to do so",
"class": "InlineKeyboardButtonType",
"properties": [
{
"name": "url",
"type": "string",
"description": "An HTTP URL to open"
},
{
"name": "id",
"type": "int53",
"description": "Unique button identifier"
},
{
"name": "forward_text",
"type": "string",
"description": "If non-empty, new text of the button in forwarded messages"
}
]
},
{
"name": "inlineKeyboardButtonTypeCallback",
"description": "A button that sends a callback query to a bot",
"class": "InlineKeyboardButtonType",
"properties": [
{
"name": "data",
"type": "bytes",
"description": "Data to be sent to the bot via a callback query"
}
]
},
{
"name": "inlineKeyboardButtonTypeCallbackWithPassword",
"description": "A button that asks for password of the current user and then sends a callback query to a bot",
"class": "InlineKeyboardButtonType",
"properties": [
{
"name": "data",
"type": "bytes",
"description": "Data to be sent to the bot via a callback query"
}
]
},
{
"name": "inlineKeyboardButtonTypeCallbackGame",
"description": "A button with a game that sends a callback query to a bot. This button must be in the first column and row of the keyboard and can be attached only to a message with content of the type messageGame",
"class": "InlineKeyboardButtonType",
"properties": []
},
{
"name": "inlineKeyboardButtonTypeSwitchInline",
"description": "A button that forces an inline query to the bot to be inserted in the input field",
"class": "InlineKeyboardButtonType",
"properties": [
{
"name": "query",
"type": "string",
"description": "Inline query to be sent to the bot"
},
{
"name": "in_current_chat",
"type": "Bool",
"description": "True, if the inline query must be sent from the current chat"
}
]
},
{
"name": "inlineKeyboardButtonTypeBuy",
"description": "A button to buy something. This button must be in the first column and row of the keyboard and can be attached only to a message with content of the type messageInvoice",
"class": "InlineKeyboardButtonType",
"properties": []
},
{
"name": "inlineKeyboardButtonTypeUser",
"description": "A button to open a chat with a user",
"class": "InlineKeyboardButtonType",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "User identifier"
}
]
},
{
"name": "inlineKeyboardButton",
"description": "Represents a single button in an inline keyboard",
"class": "InlineKeyboardButton",
"properties": [
{
"name": "text",
"type": "string",
"description": "Text of the button"
},
{
"name": "type",
"type": "InlineKeyboardButtonType",
"description": "Type of the button"
}
]
},
{
"name": "replyMarkupRemoveKeyboard",
"description": "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",
"class": "ReplyMarkup",
"properties": [
{
"name": "is_personal",
"type": "Bool",
"description": "True, if the keyboard is removed only for the mentioned users or the target user of a reply"
}
]
},
{
"name": "replyMarkupForceReply",
"description": "Instructs application to force a reply to this message",
"class": "ReplyMarkup",
"properties": [
{
"name": "is_personal",
"type": "Bool",
"description": "True, if a forced reply must automatically be shown to the current user. For outgoing messages, specify true to show the forced reply only for the mentioned users and for the target user of a reply"
},
{
"name": "input_field_placeholder",
"type": "string",
"description": "If non-empty, the placeholder to be shown in the input field when the reply is active; 0-64 characters"
}
]
},
{
"name": "replyMarkupShowKeyboard",
"description": "Contains a custom keyboard layout to quickly reply to bots",
"class": "ReplyMarkup",
"properties": [
{
"name": "rows",
"type": "vector\u003cvector\u003ckeyboardButton\u003e\u003e",
"description": "A list of rows of bot keyboard buttons"
},
{
"name": "resize_keyboard",
"type": "Bool",
"description": "True, if the application needs to resize the keyboard vertically"
},
{
"name": "one_time",
"type": "Bool",
"description": "True, if the application needs to hide the keyboard after use"
},
{
"name": "is_personal",
"type": "Bool",
"description": "True, if the keyboard must automatically be shown to the current user. For outgoing messages, specify true to show the keyboard only for the mentioned users and for the target user of a reply"
},
{
"name": "input_field_placeholder",
"type": "string",
"description": "If non-empty, the placeholder to be shown in the input field when the keyboard is active; 0-64 characters"
}
]
},
{
"name": "replyMarkupInlineKeyboard",
"description": "Contains an inline keyboard layout",
"class": "ReplyMarkup",
"properties": [
{
"name": "rows",
"type": "vector\u003cvector\u003cinlineKeyboardButton\u003e\u003e",
"description": "A list of rows of inline keyboard buttons"
}
]
},
{
"name": "loginUrlInfoOpen",
"description": "An HTTP url needs to be open",
"class": "LoginUrlInfo",
"properties": [
{
"name": "url",
"type": "string",
"description": "The URL to open"
},
{
"name": "skip_confirm",
"type": "Bool",
"description": "True, if there is no need to show an ordinary open URL confirm"
}
]
},
{
"name": "loginUrlInfoRequestConfirmation",
"description": "An authorization confirmation dialog needs to be shown to the user",
"class": "LoginUrlInfo",
"properties": [
{
"name": "url",
"type": "string",
"description": "An HTTP URL to be opened"
},
{
"name": "domain",
"type": "string",
"description": "A domain of the URL"
},
{
"name": "bot_user_id",
"type": "int53",
"description": "User identifier of a bot linked with the website"
},
{
"name": "request_write_access",
"type": "Bool",
"description": "True, if the user needs to be requested to give the permission to the bot to send them messages"
}
]
},
{
"name": "messageThreadInfo",
"description": "Contains information about a message thread",
"class": "MessageThreadInfo",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Identifier of the chat to which the message thread belongs"
},
{
"name": "message_thread_id",
"type": "int53",
"description": "Message thread identifier, unique within the chat"
},
{
"name": "reply_info",
"type": "messageReplyInfo",
"description": "Information about the message thread"
},
{
"name": "unread_message_count",
"type": "int32",
"description": "Approximate number of unread messages in the message thread"
},
{
"name": "messages",
"type": "vector\u003cmessage\u003e",
"description": "The messages from which the thread starts. The messages are returned in a reverse chronological order (i.e., in order of decreasing message_id)"
},
{
"name": "draft_message",
"type": "draftMessage",
"description": "A draft of a message in the message thread; may be null"
}
]
},
{
"name": "richTextPlain",
"description": "A plain text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "string",
"description": "Text"
}
]
},
{
"name": "richTextBold",
"description": "A bold rich text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
}
]
},
{
"name": "richTextItalic",
"description": "An italicized rich text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
}
]
},
{
"name": "richTextUnderline",
"description": "An underlined rich text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
}
]
},
{
"name": "richTextStrikethrough",
"description": "A strikethrough rich text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
}
]
},
{
"name": "richTextFixed",
"description": "A fixed-width rich text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
}
]
},
{
"name": "richTextUrl",
"description": "A rich text URL link",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
},
{
"name": "url",
"type": "string",
"description": "URL"
},
{
"name": "is_cached",
"type": "Bool",
"description": "True, if the URL has cached instant view server-side"
}
]
},
{
"name": "richTextEmailAddress",
"description": "A rich text email link",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
},
{
"name": "email_address",
"type": "string",
"description": "Email address"
}
]
},
{
"name": "richTextSubscript",
"description": "A subscript rich text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
}
]
},
{
"name": "richTextSuperscript",
"description": "A superscript rich text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
}
]
},
{
"name": "richTextMarked",
"description": "A marked rich text",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
}
]
},
{
"name": "richTextPhoneNumber",
"description": "A rich text phone number",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Text"
},
{
"name": "phone_number",
"type": "string",
"description": "Phone number"
}
]
},
{
"name": "richTextIcon",
"description": "A small image inside the text",
"class": "RichText",
"properties": [
{
"name": "document",
"type": "document",
"description": "The image represented as a document. The image can be in GIF, JPEG or PNG format"
},
{
"name": "width",
"type": "int32",
"description": "Width of a bounding box in which the image must be shown; 0 if unknown"
},
{
"name": "height",
"type": "int32",
"description": "Height of a bounding box in which the image must be shown; 0 if unknown"
}
]
},
{
"name": "richTextReference",
"description": "A reference to a richTexts object on the same web page",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "The text"
},
{
"name": "anchor_name",
"type": "string",
"description": "The name of a richTextAnchor object, which is the first element of the target richTexts object"
},
{
"name": "url",
"type": "string",
"description": "An HTTP URL, opening the reference"
}
]
},
{
"name": "richTextAnchor",
"description": "An anchor",
"class": "RichText",
"properties": [
{
"name": "name",
"type": "string",
"description": "Anchor name"
}
]
},
{
"name": "richTextAnchorLink",
"description": "A link to an anchor on the same web page",
"class": "RichText",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "The link text"
},
{
"name": "anchor_name",
"type": "string",
"description": "The anchor name. If the name is empty, the link must bring back to top"
},
{
"name": "url",
"type": "string",
"description": "An HTTP URL, opening the anchor"
}
]
},
{
"name": "richTexts",
"description": "A concatenation of rich texts",
"class": "RichText",
"properties": [
{
"name": "texts",
"type": "vector\u003cRichText\u003e",
"description": "Texts"
}
]
},
{
"name": "pageBlockCaption",
"description": "Contains a caption of an instant view web page block, consisting of a text and a trailing credit",
"class": "PageBlockCaption",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Content of the caption"
},
{
"name": "credit",
"type": "RichText",
"description": "Block credit (like HTML tag \u003ccite\u003e)"
}
]
},
{
"name": "pageBlockListItem",
"description": "Describes an item of a list page block",
"class": "PageBlockListItem",
"properties": [
{
"name": "label",
"type": "string",
"description": "Item label"
},
{
"name": "page_blocks",
"type": "vector\u003cPageBlock\u003e",
"description": "Item blocks"
}
]
},
{
"name": "pageBlockHorizontalAlignmentLeft",
"description": "The content must be left-aligned",
"class": "PageBlockHorizontalAlignment",
"properties": []
},
{
"name": "pageBlockHorizontalAlignmentCenter",
"description": "The content must be center-aligned",
"class": "PageBlockHorizontalAlignment",
"properties": []
},
{
"name": "pageBlockHorizontalAlignmentRight",
"description": "The content must be right-aligned",
"class": "PageBlockHorizontalAlignment",
"properties": []
},
{
"name": "pageBlockVerticalAlignmentTop",
"description": "The content must be top-aligned",
"class": "PageBlockVerticalAlignment",
"properties": []
},
{
"name": "pageBlockVerticalAlignmentMiddle",
"description": "The content must be middle-aligned",
"class": "PageBlockVerticalAlignment",
"properties": []
},
{
"name": "pageBlockVerticalAlignmentBottom",
"description": "The content must be bottom-aligned",
"class": "PageBlockVerticalAlignment",
"properties": []
},
{
"name": "pageBlockTableCell",
"description": "Represents a cell of a table",
"class": "PageBlockTableCell",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Cell text; may be null. If the text is null, then the cell must be invisible"
},
{
"name": "is_header",
"type": "Bool",
"description": "True, if it is a header cell"
},
{
"name": "colspan",
"type": "int32",
"description": "The number of columns the cell spans"
},
{
"name": "rowspan",
"type": "int32",
"description": "The number of rows the cell spans"
},
{
"name": "align",
"type": "PageBlockHorizontalAlignment",
"description": "Horizontal cell content alignment"
},
{
"name": "valign",
"type": "PageBlockVerticalAlignment",
"description": "Vertical cell content alignment"
}
]
},
{
"name": "pageBlockRelatedArticle",
"description": "Contains information about a related article",
"class": "PageBlockRelatedArticle",
"properties": [
{
"name": "url",
"type": "string",
"description": "Related article URL"
},
{
"name": "title",
"type": "string",
"description": "Article title; may be empty"
},
{
"name": "description",
"type": "string",
"description": "Article description; may be empty"
},
{
"name": "photo",
"type": "photo",
"description": "Article photo; may be null"
},
{
"name": "author",
"type": "string",
"description": "Article author; may be empty"
},
{
"name": "publish_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the article was published; 0 if unknown"
}
]
},
{
"name": "pageBlockTitle",
"description": "The title of a page",
"class": "PageBlock",
"properties": [
{
"name": "title",
"type": "RichText",
"description": "Title"
}
]
},
{
"name": "pageBlockSubtitle",
"description": "The subtitle of a page",
"class": "PageBlock",
"properties": [
{
"name": "subtitle",
"type": "RichText",
"description": "Subtitle"
}
]
},
{
"name": "pageBlockAuthorDate",
"description": "The author and publishing date of a page",
"class": "PageBlock",
"properties": [
{
"name": "author",
"type": "RichText",
"description": "Author"
},
{
"name": "publish_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the article was published; 0 if unknown"
}
]
},
{
"name": "pageBlockHeader",
"description": "A header",
"class": "PageBlock",
"properties": [
{
"name": "header",
"type": "RichText",
"description": "Header"
}
]
},
{
"name": "pageBlockSubheader",
"description": "A subheader",
"class": "PageBlock",
"properties": [
{
"name": "subheader",
"type": "RichText",
"description": "Subheader"
}
]
},
{
"name": "pageBlockKicker",
"description": "A kicker",
"class": "PageBlock",
"properties": [
{
"name": "kicker",
"type": "RichText",
"description": "Kicker"
}
]
},
{
"name": "pageBlockParagraph",
"description": "A text paragraph",
"class": "PageBlock",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Paragraph text"
}
]
},
{
"name": "pageBlockPreformatted",
"description": "A preformatted text paragraph",
"class": "PageBlock",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Paragraph text"
},
{
"name": "language",
"type": "string",
"description": "Programming language for which the text needs to be formatted"
}
]
},
{
"name": "pageBlockFooter",
"description": "The footer of a page",
"class": "PageBlock",
"properties": [
{
"name": "footer",
"type": "RichText",
"description": "Footer"
}
]
},
{
"name": "pageBlockDivider",
"description": "An empty block separating a page",
"class": "PageBlock",
"properties": []
},
{
"name": "pageBlockAnchor",
"description": "An invisible anchor on a page, which can be used in a URL to open the page from the specified anchor",
"class": "PageBlock",
"properties": [
{
"name": "name",
"type": "string",
"description": "Name of the anchor"
}
]
},
{
"name": "pageBlockList",
"description": "A list of data blocks",
"class": "PageBlock",
"properties": [
{
"name": "items",
"type": "vector\u003cpageBlockListItem\u003e",
"description": "The items of the list"
}
]
},
{
"name": "pageBlockBlockQuote",
"description": "A block quote",
"class": "PageBlock",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Quote text"
},
{
"name": "credit",
"type": "RichText",
"description": "Quote credit"
}
]
},
{
"name": "pageBlockPullQuote",
"description": "A pull quote",
"class": "PageBlock",
"properties": [
{
"name": "text",
"type": "RichText",
"description": "Quote text"
},
{
"name": "credit",
"type": "RichText",
"description": "Quote credit"
}
]
},
{
"name": "pageBlockAnimation",
"description": "An animation",
"class": "PageBlock",
"properties": [
{
"name": "animation",
"type": "animation",
"description": "Animation file; may be null"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Animation caption"
},
{
"name": "need_autoplay",
"type": "Bool",
"description": "True, if the animation must be played automatically"
}
]
},
{
"name": "pageBlockAudio",
"description": "An audio file",
"class": "PageBlock",
"properties": [
{
"name": "audio",
"type": "audio",
"description": "Audio file; may be null"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Audio file caption"
}
]
},
{
"name": "pageBlockPhoto",
"description": "A photo",
"class": "PageBlock",
"properties": [
{
"name": "photo",
"type": "photo",
"description": "Photo file; may be null"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Photo caption"
},
{
"name": "url",
"type": "string",
"description": "URL that needs to be opened when the photo is clicked"
}
]
},
{
"name": "pageBlockVideo",
"description": "A video",
"class": "PageBlock",
"properties": [
{
"name": "video",
"type": "video",
"description": "Video file; may be null"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Video caption"
},
{
"name": "need_autoplay",
"type": "Bool",
"description": "True, if the video must be played automatically"
},
{
"name": "is_looped",
"type": "Bool",
"description": "True, if the video must be looped"
}
]
},
{
"name": "pageBlockVoiceNote",
"description": "A voice note",
"class": "PageBlock",
"properties": [
{
"name": "voice_note",
"type": "voiceNote",
"description": "Voice note; may be null"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Voice note caption"
}
]
},
{
"name": "pageBlockCover",
"description": "A page cover",
"class": "PageBlock",
"properties": [
{
"name": "cover",
"type": "PageBlock",
"description": "Cover"
}
]
},
{
"name": "pageBlockEmbedded",
"description": "An embedded web page",
"class": "PageBlock",
"properties": [
{
"name": "url",
"type": "string",
"description": "Web page URL, if available"
},
{
"name": "html",
"type": "string",
"description": "HTML-markup of the embedded page"
},
{
"name": "poster_photo",
"type": "photo",
"description": "Poster photo, if available; may be null"
},
{
"name": "width",
"type": "int32",
"description": "Block width; 0 if unknown"
},
{
"name": "height",
"type": "int32",
"description": "Block height; 0 if unknown"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Block caption"
},
{
"name": "is_full_width",
"type": "Bool",
"description": "True, if the block must be full width"
},
{
"name": "allow_scrolling",
"type": "Bool",
"description": "True, if scrolling needs to be allowed"
}
]
},
{
"name": "pageBlockEmbeddedPost",
"description": "An embedded post",
"class": "PageBlock",
"properties": [
{
"name": "url",
"type": "string",
"description": "Web page URL"
},
{
"name": "author",
"type": "string",
"description": "Post author"
},
{
"name": "author_photo",
"type": "photo",
"description": "Post author photo; may be null"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the post was created; 0 if unknown"
},
{
"name": "page_blocks",
"type": "vector\u003cPageBlock\u003e",
"description": "Post content"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Post caption"
}
]
},
{
"name": "pageBlockCollage",
"description": "A collage",
"class": "PageBlock",
"properties": [
{
"name": "page_blocks",
"type": "vector\u003cPageBlock\u003e",
"description": "Collage item contents"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Block caption"
}
]
},
{
"name": "pageBlockSlideshow",
"description": "A slideshow",
"class": "PageBlock",
"properties": [
{
"name": "page_blocks",
"type": "vector\u003cPageBlock\u003e",
"description": "Slideshow item contents"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Block caption"
}
]
},
{
"name": "pageBlockChatLink",
"description": "A link to a chat",
"class": "PageBlock",
"properties": [
{
"name": "title",
"type": "string",
"description": "Chat title"
},
{
"name": "photo",
"type": "chatPhotoInfo",
"description": "Chat photo; may be null"
},
{
"name": "username",
"type": "string",
"description": "Chat username, by which all other information about the chat can be resolved"
}
]
},
{
"name": "pageBlockTable",
"description": "A table",
"class": "PageBlock",
"properties": [
{
"name": "caption",
"type": "RichText",
"description": "Table caption"
},
{
"name": "cells",
"type": "vector\u003cvector\u003cpageBlockTableCell\u003e\u003e",
"description": "Table cells"
},
{
"name": "is_bordered",
"type": "Bool",
"description": "True, if the table is bordered"
},
{
"name": "is_striped",
"type": "Bool",
"description": "True, if the table is striped"
}
]
},
{
"name": "pageBlockDetails",
"description": "A collapsible block",
"class": "PageBlock",
"properties": [
{
"name": "header",
"type": "RichText",
"description": "Always visible heading for the block"
},
{
"name": "page_blocks",
"type": "vector\u003cPageBlock\u003e",
"description": "Block contents"
},
{
"name": "is_open",
"type": "Bool",
"description": "True, if the block is open by default"
}
]
},
{
"name": "pageBlockRelatedArticles",
"description": "Related articles",
"class": "PageBlock",
"properties": [
{
"name": "header",
"type": "RichText",
"description": "Block header"
},
{
"name": "articles",
"type": "vector\u003cpageBlockRelatedArticle\u003e",
"description": "List of related articles"
}
]
},
{
"name": "pageBlockMap",
"description": "A map",
"class": "PageBlock",
"properties": [
{
"name": "location",
"type": "location",
"description": "Location of the map center"
},
{
"name": "zoom",
"type": "int32",
"description": "Map zoom level"
},
{
"name": "width",
"type": "int32",
"description": "Map width"
},
{
"name": "height",
"type": "int32",
"description": "Map height"
},
{
"name": "caption",
"type": "pageBlockCaption",
"description": "Block caption"
}
]
},
{
"name": "webPageInstantView",
"description": "Describes an instant view page for a web page",
"class": "WebPageInstantView",
"properties": [
{
"name": "page_blocks",
"type": "vector\u003cPageBlock\u003e",
"description": "Content of the web page"
},
{
"name": "view_count",
"type": "int32",
"description": "Number of the instant view views; 0 if unknown"
},
{
"name": "version",
"type": "int32",
"description": "Version of the instant view, currently can be 1 or 2"
},
{
"name": "is_rtl",
"type": "Bool",
"description": "True, if the instant view must be shown from right to left"
},
{
"name": "is_full",
"type": "Bool",
"description": "True, if the instant view contains the full page. A network request might be needed to get the full web page instant view"
},
{
"name": "feedback_link",
"type": "InternalLinkType",
"description": "An internal link to be opened to leave feedback about the instant view"
}
]
},
{
"name": "webPage",
"description": "Describes a web page preview",
"class": "WebPage",
"properties": [
{
"name": "url",
"type": "string",
"description": "Original URL of the link"
},
{
"name": "display_url",
"type": "string",
"description": "URL to display"
},
{
"name": "type",
"type": "string",
"description": "Type of the web page. Can be: article, photo, audio, video, document, profile, app, or something else"
},
{
"name": "site_name",
"type": "string",
"description": "Short name of the site (e.g., Google Docs, App Store)"
},
{
"name": "title",
"type": "string",
"description": "Title of the content"
},
{
"name": "description",
"type": "formattedText",
"description": "Description of the content"
},
{
"name": "photo",
"type": "photo",
"description": "Image representing the content; may be null"
},
{
"name": "embed_url",
"type": "string",
"description": "URL to show in the embedded preview"
},
{
"name": "embed_type",
"type": "string",
"description": "MIME type of the embedded preview, (e.g., text/html or video/mp4)"
},
{
"name": "embed_width",
"type": "int32",
"description": "Width of the embedded preview"
},
{
"name": "embed_height",
"type": "int32",
"description": "Height of the embedded preview"
},
{
"name": "duration",
"type": "int32",
"description": "Duration of the content, in seconds"
},
{
"name": "author",
"type": "string",
"description": "Author of the content"
},
{
"name": "animation",
"type": "animation",
"description": "Preview of the content as an animation, if available; may be null"
},
{
"name": "audio",
"type": "audio",
"description": "Preview of the content as an audio file, if available; may be null"
},
{
"name": "document",
"type": "document",
"description": "Preview of the content as a document, if available (currently only available for small PDF files and ZIP archives); may be null"
},
{
"name": "sticker",
"type": "sticker",
"description": "Preview of the content as a sticker for small WEBP files, if available; may be null"
},
{
"name": "video",
"type": "video",
"description": "Preview of the content as a video, if available; may be null"
},
{
"name": "video_note",
"type": "videoNote",
"description": "Preview of the content as a video note, if available; may be null"
},
{
"name": "voice_note",
"type": "voiceNote",
"description": "Preview of the content as a voice note, if available; may be null"
},
{
"name": "instant_view_version",
"type": "int32",
"description": "Version of instant view, available for the web page (currently can be 1 or 2), 0 if none"
}
]
},
{
"name": "countryInfo",
"description": "Contains information about a country",
"class": "CountryInfo",
"properties": [
{
"name": "country_code",
"type": "string",
"description": "A two-letter ISO 3166-1 alpha-2 country code"
},
{
"name": "name",
"type": "string",
"description": "Native name of the country"
},
{
"name": "english_name",
"type": "string",
"description": "English name of the country"
},
{
"name": "is_hidden",
"type": "Bool",
"description": "True, if the country must be hidden from the list of all countries"
},
{
"name": "calling_codes",
"type": "vector\u003cstring\u003e",
"description": "List of country calling codes"
}
]
},
{
"name": "countries",
"description": "Contains information about countries",
"class": "Countries",
"properties": [
{
"name": "countries",
"type": "vector\u003ccountryInfo\u003e",
"description": "The list of countries"
}
]
},
{
"name": "phoneNumberInfo",
"description": "Contains information about a phone number",
"class": "PhoneNumberInfo",
"properties": [
{
"name": "country",
"type": "countryInfo",
"description": "Information about the country to which the phone number belongs; may be null"
},
{
"name": "country_calling_code",
"type": "string",
"description": "The part of the phone number denoting country calling code or its part"
},
{
"name": "formatted_phone_number",
"type": "string",
"description": "The phone number without country calling code formatted accordingly to local rules. Expected digits are returned as '-', but even more digits might be entered by the user"
}
]
},
{
"name": "bankCardActionOpenUrl",
"description": "Describes an action associated with a bank card number",
"class": "BankCardActionOpenUrl",
"properties": [
{
"name": "text",
"type": "string",
"description": "Action text"
},
{
"name": "url",
"type": "string",
"description": "The URL to be opened"
}
]
},
{
"name": "bankCardInfo",
"description": "Information about a bank card",
"class": "BankCardInfo",
"properties": [
{
"name": "title",
"type": "string",
"description": "Title of the bank card description"
},
{
"name": "actions",
"type": "vector\u003cbankCardActionOpenUrl\u003e",
"description": "Actions that can be done with the bank card number"
}
]
},
{
"name": "address",
"description": "Describes an address",
"class": "Address",
"properties": [
{
"name": "country_code",
"type": "string",
"description": "A two-letter ISO 3166-1 alpha-2 country code"
},
{
"name": "state",
"type": "string",
"description": "State, if applicable"
},
{
"name": "city",
"type": "string",
"description": "City"
},
{
"name": "street_line1",
"type": "string",
"description": "First line of the address"
},
{
"name": "street_line2",
"type": "string",
"description": "Second line of the address"
},
{
"name": "postal_code",
"type": "string",
"description": "Address postal code"
}
]
},
{
"name": "labeledPricePart",
"description": "Portion of the price of a product (e.g., \"delivery cost\", \"tax amount\")",
"class": "LabeledPricePart",
"properties": [
{
"name": "label",
"type": "string",
"description": "Label for this portion of the product price"
},
{
"name": "amount",
"type": "int53",
"description": "Currency amount in the smallest units of the currency"
}
]
},
{
"name": "invoice",
"description": "Product invoice",
"class": "Invoice",
"properties": [
{
"name": "currency",
"type": "string",
"description": "ISO 4217 currency code"
},
{
"name": "price_parts",
"type": "vector\u003clabeledPricePart\u003e",
"description": "A list of objects used to calculate the total price of the product"
},
{
"name": "max_tip_amount",
"type": "int53",
"description": "The maximum allowed amount of tip in the smallest units of the currency"
},
{
"name": "suggested_tip_amounts",
"type": "vector\u003cint53\u003e",
"description": "Suggested amounts of tip in the smallest units of the currency"
},
{
"name": "is_test",
"type": "Bool",
"description": "True, if the payment is a test payment"
},
{
"name": "need_name",
"type": "Bool",
"description": "True, if the user's name is needed for payment"
},
{
"name": "need_phone_number",
"type": "Bool",
"description": "True, if the user's phone number is needed for payment"
},
{
"name": "need_email_address",
"type": "Bool",
"description": "True, if the user's email address is needed for payment"
},
{
"name": "need_shipping_address",
"type": "Bool",
"description": "True, if the user's shipping address is needed for payment"
},
{
"name": "send_phone_number_to_provider",
"type": "Bool",
"description": "True, if the user's phone number will be sent to the provider"
},
{
"name": "send_email_address_to_provider",
"type": "Bool",
"description": "True, if the user's email address will be sent to the provider"
},
{
"name": "is_flexible",
"type": "Bool",
"description": "True, if the total price depends on the shipping method"
}
]
},
{
"name": "orderInfo",
"description": "Order information",
"class": "OrderInfo",
"properties": [
{
"name": "name",
"type": "string",
"description": "Name of the user"
},
{
"name": "phone_number",
"type": "string",
"description": "Phone number of the user"
},
{
"name": "email_address",
"type": "string",
"description": "Email address of the user"
},
{
"name": "shipping_address",
"type": "address",
"description": "Shipping address for this order; may be null"
}
]
},
{
"name": "shippingOption",
"description": "One shipping option",
"class": "ShippingOption",
"properties": [
{
"name": "id",
"type": "string",
"description": "Shipping option identifier"
},
{
"name": "title",
"type": "string",
"description": "Option title"
},
{
"name": "price_parts",
"type": "vector\u003clabeledPricePart\u003e",
"description": "A list of objects used to calculate the total shipping costs"
}
]
},
{
"name": "savedCredentials",
"description": "Contains information about saved card credentials",
"class": "SavedCredentials",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the saved credentials"
},
{
"name": "title",
"type": "string",
"description": "Title of the saved credentials"
}
]
},
{
"name": "inputCredentialsSaved",
"description": "Applies if a user chooses some previously saved payment credentials. To use their previously saved credentials, the user must have a valid temporary password",
"class": "InputCredentials",
"properties": [
{
"name": "saved_credentials_id",
"type": "string",
"description": "Identifier of the saved credentials"
}
]
},
{
"name": "inputCredentialsNew",
"description": "Applies if a user enters new credentials on a payment provider website",
"class": "InputCredentials",
"properties": [
{
"name": "data",
"type": "string",
"description": "JSON-encoded data with the credential identifier from the payment provider"
},
{
"name": "allow_save",
"type": "Bool",
"description": "True, if the credential identifier can be saved on the server side"
}
]
},
{
"name": "inputCredentialsApplePay",
"description": "Applies if a user enters new credentials using Apple Pay",
"class": "InputCredentials",
"properties": [
{
"name": "data",
"type": "string",
"description": "JSON-encoded data with the credential identifier"
}
]
},
{
"name": "inputCredentialsGooglePay",
"description": "Applies if a user enters new credentials using Google Pay",
"class": "InputCredentials",
"properties": [
{
"name": "data",
"type": "string",
"description": "JSON-encoded data with the credential identifier"
}
]
},
{
"name": "paymentsProviderStripe",
"description": "Stripe payment provider",
"class": "PaymentsProviderStripe",
"properties": [
{
"name": "publishable_key",
"type": "string",
"description": "Stripe API publishable key"
},
{
"name": "need_country",
"type": "Bool",
"description": "True, if the user country must be provided"
},
{
"name": "need_postal_code",
"type": "Bool",
"description": "True, if the user ZIP/postal code must be provided"
},
{
"name": "need_cardholder_name",
"type": "Bool",
"description": "True, if the cardholder name must be provided"
}
]
},
{
"name": "paymentFormTheme",
"description": "Theme colors for a payment form",
"class": "PaymentFormTheme",
"properties": [
{
"name": "background_color",
"type": "int32",
"description": "A color of the payment form background in the RGB24 format"
},
{
"name": "text_color",
"type": "int32",
"description": "A color of text in the RGB24 format"
},
{
"name": "hint_color",
"type": "int32",
"description": "A color of hints in the RGB24 format"
},
{
"name": "link_color",
"type": "int32",
"description": "A color of links in the RGB24 format"
},
{
"name": "button_color",
"type": "int32",
"description": "A color of the buttons in the RGB24 format"
},
{
"name": "button_text_color",
"type": "int32",
"description": "A color of text on the buttons in the RGB24 format"
}
]
},
{
"name": "paymentForm",
"description": "Contains information about an invoice payment form",
"class": "PaymentForm",
"properties": [
{
"name": "id",
"type": "int64",
"description": "The payment form identifier"
},
{
"name": "invoice",
"type": "invoice",
"description": "Full information of the invoice"
},
{
"name": "url",
"type": "string",
"description": "Payment form URL"
},
{
"name": "seller_bot_user_id",
"type": "int53",
"description": "User identifier of the seller bot"
},
{
"name": "payments_provider_user_id",
"type": "int53",
"description": "User identifier of the payment provider bot"
},
{
"name": "payments_provider",
"type": "paymentsProviderStripe",
"description": "Information about the payment provider, if available, to support it natively without the need for opening the URL; may be null"
},
{
"name": "saved_order_info",
"type": "orderInfo",
"description": "Saved server-side order information; may be null"
},
{
"name": "saved_credentials",
"type": "savedCredentials",
"description": "Information about saved card credentials; may be null"
},
{
"name": "can_save_credentials",
"type": "Bool",
"description": "True, if the user can choose to save credentials"
},
{
"name": "need_password",
"type": "Bool",
"description": "True, if the user will be able to save credentials protected by a password they set up"
}
]
},
{
"name": "validatedOrderInfo",
"description": "Contains a temporary identifier of validated order information, which is stored for one hour. Also contains the available shipping options",
"class": "ValidatedOrderInfo",
"properties": [
{
"name": "order_info_id",
"type": "string",
"description": "Temporary identifier of the order information"
},
{
"name": "shipping_options",
"type": "vector\u003cshippingOption\u003e",
"description": "Available shipping options"
}
]
},
{
"name": "paymentResult",
"description": "Contains the result of a payment request",
"class": "PaymentResult",
"properties": [
{
"name": "success",
"type": "Bool",
"description": "True, if the payment request was successful; otherwise the verification_url will be non-empty"
},
{
"name": "verification_url",
"type": "string",
"description": "URL for additional payment credentials verification"
}
]
},
{
"name": "paymentReceipt",
"description": "Contains information about a successful payment",
"class": "PaymentReceipt",
"properties": [
{
"name": "title",
"type": "string",
"description": "Product title"
},
{
"name": "description",
"type": "string",
"description": "Product description"
},
{
"name": "photo",
"type": "photo",
"description": "Product photo; may be null"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the payment was made"
},
{
"name": "seller_bot_user_id",
"type": "int53",
"description": "User identifier of the seller bot"
},
{
"name": "payments_provider_user_id",
"type": "int53",
"description": "User identifier of the payment provider bot"
},
{
"name": "invoice",
"type": "invoice",
"description": "Information about the invoice"
},
{
"name": "order_info",
"type": "orderInfo",
"description": "Order information; may be null"
},
{
"name": "shipping_option",
"type": "shippingOption",
"description": "Chosen shipping option; may be null"
},
{
"name": "credentials_title",
"type": "string",
"description": "Title of the saved credentials chosen by the buyer"
},
{
"name": "tip_amount",
"type": "int53",
"description": "The amount of tip chosen by the buyer in the smallest units of the currency"
}
]
},
{
"name": "datedFile",
"description": "File with the date it was uploaded",
"class": "DatedFile",
"properties": [
{
"name": "file",
"type": "file",
"description": "The file"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the file was uploaded"
}
]
},
{
"name": "passportElementTypePersonalDetails",
"description": "A Telegram Passport element containing the user's personal details",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypePassport",
"description": "A Telegram Passport element containing the user's passport",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeDriverLicense",
"description": "A Telegram Passport element containing the user's driver license",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeIdentityCard",
"description": "A Telegram Passport element containing the user's identity card",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeInternalPassport",
"description": "A Telegram Passport element containing the user's internal passport",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeAddress",
"description": "A Telegram Passport element containing the user's address",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeUtilityBill",
"description": "A Telegram Passport element containing the user's utility bill",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeBankStatement",
"description": "A Telegram Passport element containing the user's bank statement",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeRentalAgreement",
"description": "A Telegram Passport element containing the user's rental agreement",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypePassportRegistration",
"description": "A Telegram Passport element containing the registration page of the user's passport",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeTemporaryRegistration",
"description": "A Telegram Passport element containing the user's temporary registration",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypePhoneNumber",
"description": "A Telegram Passport element containing the user's phone number",
"class": "PassportElementType",
"properties": []
},
{
"name": "passportElementTypeEmailAddress",
"description": "A Telegram Passport element containing the user's email address",
"class": "PassportElementType",
"properties": []
},
{
"name": "date",
"description": "Represents a date according to the Gregorian calendar",
"class": "Date",
"properties": [
{
"name": "day",
"type": "int32",
"description": "Day of the month; 1-31"
},
{
"name": "month",
"type": "int32",
"description": "Month; 1-12"
},
{
"name": "year",
"type": "int32",
"description": "Year; 1-9999"
}
]
},
{
"name": "personalDetails",
"description": "Contains the user's personal details",
"class": "PersonalDetails",
"properties": [
{
"name": "first_name",
"type": "string",
"description": "First name of the user written in English; 1-255 characters"
},
{
"name": "middle_name",
"type": "string",
"description": "Middle name of the user written in English; 0-255 characters"
},
{
"name": "last_name",
"type": "string",
"description": "Last name of the user written in English; 1-255 characters"
},
{
"name": "native_first_name",
"type": "string",
"description": "Native first name of the user; 1-255 characters"
},
{
"name": "native_middle_name",
"type": "string",
"description": "Native middle name of the user; 0-255 characters"
},
{
"name": "native_last_name",
"type": "string",
"description": "Native last name of the user; 1-255 characters"
},
{
"name": "birthdate",
"type": "date",
"description": "Birthdate of the user"
},
{
"name": "gender",
"type": "string",
"description": "Gender of the user, \"male\" or \"female\""
},
{
"name": "country_code",
"type": "string",
"description": "A two-letter ISO 3166-1 alpha-2 country code of the user's country"
},
{
"name": "residence_country_code",
"type": "string",
"description": "A two-letter ISO 3166-1 alpha-2 country code of the user's residence country"
}
]
},
{
"name": "identityDocument",
"description": "An identity document",
"class": "IdentityDocument",
"properties": [
{
"name": "number",
"type": "string",
"description": "Document number; 1-24 characters"
},
{
"name": "expiry_date",
"type": "date",
"description": "Document expiry date; may be null if not applicable"
},
{
"name": "front_side",
"type": "datedFile",
"description": "Front side of the document"
},
{
"name": "reverse_side",
"type": "datedFile",
"description": "Reverse side of the document; only for driver license and identity card; may be null"
},
{
"name": "selfie",
"type": "datedFile",
"description": "Selfie with the document; may be null"
},
{
"name": "translation",
"type": "vector\u003cdatedFile\u003e",
"description": "List of files containing a certified English translation of the document"
}
]
},
{
"name": "inputIdentityDocument",
"description": "An identity document to be saved to Telegram Passport",
"class": "InputIdentityDocument",
"properties": [
{
"name": "number",
"type": "string",
"description": "Document number; 1-24 characters"
},
{
"name": "expiry_date",
"type": "date",
"description": "Document expiry date; pass null if not applicable"
},
{
"name": "front_side",
"type": "InputFile",
"description": "Front side of the document"
},
{
"name": "reverse_side",
"type": "InputFile",
"description": "Reverse side of the document; only for driver license and identity card; pass null otherwise"
},
{
"name": "selfie",
"type": "InputFile",
"description": "Selfie with the document; pass null if unavailable"
},
{
"name": "translation",
"type": "vector\u003cInputFile\u003e",
"description": "List of files containing a certified English translation of the document"
}
]
},
{
"name": "personalDocument",
"description": "A personal document, containing some information about a user",
"class": "PersonalDocument",
"properties": [
{
"name": "files",
"type": "vector\u003cdatedFile\u003e",
"description": "List of files containing the pages of the document"
},
{
"name": "translation",
"type": "vector\u003cdatedFile\u003e",
"description": "List of files containing a certified English translation of the document"
}
]
},
{
"name": "inputPersonalDocument",
"description": "A personal document to be saved to Telegram Passport",
"class": "InputPersonalDocument",
"properties": [
{
"name": "files",
"type": "vector\u003cInputFile\u003e",
"description": "List of files containing the pages of the document"
},
{
"name": "translation",
"type": "vector\u003cInputFile\u003e",
"description": "List of files containing a certified English translation of the document"
}
]
},
{
"name": "passportElementPersonalDetails",
"description": "A Telegram Passport element containing the user's personal details",
"class": "PassportElement",
"properties": [
{
"name": "personal_details",
"type": "personalDetails",
"description": "Personal details of the user"
}
]
},
{
"name": "passportElementPassport",
"description": "A Telegram Passport element containing the user's passport",
"class": "PassportElement",
"properties": [
{
"name": "passport",
"type": "identityDocument",
"description": "Passport"
}
]
},
{
"name": "passportElementDriverLicense",
"description": "A Telegram Passport element containing the user's driver license",
"class": "PassportElement",
"properties": [
{
"name": "driver_license",
"type": "identityDocument",
"description": "Driver license"
}
]
},
{
"name": "passportElementIdentityCard",
"description": "A Telegram Passport element containing the user's identity card",
"class": "PassportElement",
"properties": [
{
"name": "identity_card",
"type": "identityDocument",
"description": "Identity card"
}
]
},
{
"name": "passportElementInternalPassport",
"description": "A Telegram Passport element containing the user's internal passport",
"class": "PassportElement",
"properties": [
{
"name": "internal_passport",
"type": "identityDocument",
"description": "Internal passport"
}
]
},
{
"name": "passportElementAddress",
"description": "A Telegram Passport element containing the user's address",
"class": "PassportElement",
"properties": [
{
"name": "address",
"type": "address",
"description": "Address"
}
]
},
{
"name": "passportElementUtilityBill",
"description": "A Telegram Passport element containing the user's utility bill",
"class": "PassportElement",
"properties": [
{
"name": "utility_bill",
"type": "personalDocument",
"description": "Utility bill"
}
]
},
{
"name": "passportElementBankStatement",
"description": "A Telegram Passport element containing the user's bank statement",
"class": "PassportElement",
"properties": [
{
"name": "bank_statement",
"type": "personalDocument",
"description": "Bank statement"
}
]
},
{
"name": "passportElementRentalAgreement",
"description": "A Telegram Passport element containing the user's rental agreement",
"class": "PassportElement",
"properties": [
{
"name": "rental_agreement",
"type": "personalDocument",
"description": "Rental agreement"
}
]
},
{
"name": "passportElementPassportRegistration",
"description": "A Telegram Passport element containing the user's passport registration pages",
"class": "PassportElement",
"properties": [
{
"name": "passport_registration",
"type": "personalDocument",
"description": "Passport registration pages"
}
]
},
{
"name": "passportElementTemporaryRegistration",
"description": "A Telegram Passport element containing the user's temporary registration",
"class": "PassportElement",
"properties": [
{
"name": "temporary_registration",
"type": "personalDocument",
"description": "Temporary registration"
}
]
},
{
"name": "passportElementPhoneNumber",
"description": "A Telegram Passport element containing the user's phone number",
"class": "PassportElement",
"properties": [
{
"name": "phone_number",
"type": "string",
"description": "Phone number"
}
]
},
{
"name": "passportElementEmailAddress",
"description": "A Telegram Passport element containing the user's email address",
"class": "PassportElement",
"properties": [
{
"name": "email_address",
"type": "string",
"description": "Email address"
}
]
},
{
"name": "inputPassportElementPersonalDetails",
"description": "A Telegram Passport element to be saved containing the user's personal details",
"class": "InputPassportElement",
"properties": [
{
"name": "personal_details",
"type": "personalDetails",
"description": "Personal details of the user"
}
]
},
{
"name": "inputPassportElementPassport",
"description": "A Telegram Passport element to be saved containing the user's passport",
"class": "InputPassportElement",
"properties": [
{
"name": "passport",
"type": "inputIdentityDocument",
"description": "The passport to be saved"
}
]
},
{
"name": "inputPassportElementDriverLicense",
"description": "A Telegram Passport element to be saved containing the user's driver license",
"class": "InputPassportElement",
"properties": [
{
"name": "driver_license",
"type": "inputIdentityDocument",
"description": "The driver license to be saved"
}
]
},
{
"name": "inputPassportElementIdentityCard",
"description": "A Telegram Passport element to be saved containing the user's identity card",
"class": "InputPassportElement",
"properties": [
{
"name": "identity_card",
"type": "inputIdentityDocument",
"description": "The identity card to be saved"
}
]
},
{
"name": "inputPassportElementInternalPassport",
"description": "A Telegram Passport element to be saved containing the user's internal passport",
"class": "InputPassportElement",
"properties": [
{
"name": "internal_passport",
"type": "inputIdentityDocument",
"description": "The internal passport to be saved"
}
]
},
{
"name": "inputPassportElementAddress",
"description": "A Telegram Passport element to be saved containing the user's address",
"class": "InputPassportElement",
"properties": [
{
"name": "address",
"type": "address",
"description": "The address to be saved"
}
]
},
{
"name": "inputPassportElementUtilityBill",
"description": "A Telegram Passport element to be saved containing the user's utility bill",
"class": "InputPassportElement",
"properties": [
{
"name": "utility_bill",
"type": "inputPersonalDocument",
"description": "The utility bill to be saved"
}
]
},
{
"name": "inputPassportElementBankStatement",
"description": "A Telegram Passport element to be saved containing the user's bank statement",
"class": "InputPassportElement",
"properties": [
{
"name": "bank_statement",
"type": "inputPersonalDocument",
"description": "The bank statement to be saved"
}
]
},
{
"name": "inputPassportElementRentalAgreement",
"description": "A Telegram Passport element to be saved containing the user's rental agreement",
"class": "InputPassportElement",
"properties": [
{
"name": "rental_agreement",
"type": "inputPersonalDocument",
"description": "The rental agreement to be saved"
}
]
},
{
"name": "inputPassportElementPassportRegistration",
"description": "A Telegram Passport element to be saved containing the user's passport registration",
"class": "InputPassportElement",
"properties": [
{
"name": "passport_registration",
"type": "inputPersonalDocument",
"description": "The passport registration page to be saved"
}
]
},
{
"name": "inputPassportElementTemporaryRegistration",
"description": "A Telegram Passport element to be saved containing the user's temporary registration",
"class": "InputPassportElement",
"properties": [
{
"name": "temporary_registration",
"type": "inputPersonalDocument",
"description": "The temporary registration document to be saved"
}
]
},
{
"name": "inputPassportElementPhoneNumber",
"description": "A Telegram Passport element to be saved containing the user's phone number",
"class": "InputPassportElement",
"properties": [
{
"name": "phone_number",
"type": "string",
"description": "The phone number to be saved"
}
]
},
{
"name": "inputPassportElementEmailAddress",
"description": "A Telegram Passport element to be saved containing the user's email address",
"class": "InputPassportElement",
"properties": [
{
"name": "email_address",
"type": "string",
"description": "The email address to be saved"
}
]
},
{
"name": "passportElements",
"description": "Contains information about saved Telegram Passport elements",
"class": "PassportElements",
"properties": [
{
"name": "elements",
"type": "vector\u003cPassportElement\u003e",
"description": "Telegram Passport elements"
}
]
},
{
"name": "passportElementErrorSourceUnspecified",
"description": "The element contains an error in an unspecified place. The error will be considered resolved when new data is added",
"class": "PassportElementErrorSource",
"properties": []
},
{
"name": "passportElementErrorSourceDataField",
"description": "One of the data fields contains an error. The error will be considered resolved when the value of the field changes",
"class": "PassportElementErrorSource",
"properties": [
{
"name": "field_name",
"type": "string",
"description": "Field name"
}
]
},
{
"name": "passportElementErrorSourceFrontSide",
"description": "The front side of the document contains an error. The error will be considered resolved when the file with the front side changes",
"class": "PassportElementErrorSource",
"properties": []
},
{
"name": "passportElementErrorSourceReverseSide",
"description": "The reverse side of the document contains an error. The error will be considered resolved when the file with the reverse side changes",
"class": "PassportElementErrorSource",
"properties": []
},
{
"name": "passportElementErrorSourceSelfie",
"description": "The selfie with the document contains an error. The error will be considered resolved when the file with the selfie changes",
"class": "PassportElementErrorSource",
"properties": []
},
{
"name": "passportElementErrorSourceTranslationFile",
"description": "One of files with the translation of the document contains an error. The error will be considered resolved when the file changes",
"class": "PassportElementErrorSource",
"properties": [
{
"name": "file_index",
"type": "int32",
"description": "Index of a file with the error"
}
]
},
{
"name": "passportElementErrorSourceTranslationFiles",
"description": "The translation of the document contains an error. The error will be considered resolved when the list of translation files changes",
"class": "PassportElementErrorSource",
"properties": []
},
{
"name": "passportElementErrorSourceFile",
"description": "The file contains an error. The error will be considered resolved when the file changes",
"class": "PassportElementErrorSource",
"properties": [
{
"name": "file_index",
"type": "int32",
"description": "Index of a file with the error"
}
]
},
{
"name": "passportElementErrorSourceFiles",
"description": "The list of attached files contains an error. The error will be considered resolved when the list of files changes",
"class": "PassportElementErrorSource",
"properties": []
},
{
"name": "passportElementError",
"description": "Contains the description of an error in a Telegram Passport element",
"class": "PassportElementError",
"properties": [
{
"name": "type",
"type": "PassportElementType",
"description": "Type of the Telegram Passport element which has the error"
},
{
"name": "message",
"type": "string",
"description": "Error message"
},
{
"name": "source",
"type": "PassportElementErrorSource",
"description": "Error source"
}
]
},
{
"name": "passportSuitableElement",
"description": "Contains information about a Telegram Passport element that was requested by a service",
"class": "PassportSuitableElement",
"properties": [
{
"name": "type",
"type": "PassportElementType",
"description": "Type of the element"
},
{
"name": "is_selfie_required",
"type": "Bool",
"description": "True, if a selfie is required with the identity document"
},
{
"name": "is_translation_required",
"type": "Bool",
"description": "True, if a certified English translation is required with the document"
},
{
"name": "is_native_name_required",
"type": "Bool",
"description": "True, if personal details must include the user's name in the language of their country of residence"
}
]
},
{
"name": "passportRequiredElement",
"description": "Contains a description of the required Telegram Passport element that was requested by a service",
"class": "PassportRequiredElement",
"properties": [
{
"name": "suitable_elements",
"type": "vector\u003cpassportSuitableElement\u003e",
"description": "List of Telegram Passport elements any of which is enough to provide"
}
]
},
{
"name": "passportAuthorizationForm",
"description": "Contains information about a Telegram Passport authorization form that was requested",
"class": "PassportAuthorizationForm",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Unique identifier of the authorization form"
},
{
"name": "required_elements",
"type": "vector\u003cpassportRequiredElement\u003e",
"description": "Telegram Passport elements that must be provided to complete the form"
},
{
"name": "privacy_policy_url",
"type": "string",
"description": "URL for the privacy policy of the service; may be empty"
}
]
},
{
"name": "passportElementsWithErrors",
"description": "Contains information about a Telegram Passport elements and corresponding errors",
"class": "PassportElementsWithErrors",
"properties": [
{
"name": "elements",
"type": "vector\u003cPassportElement\u003e",
"description": "Telegram Passport elements"
},
{
"name": "errors",
"type": "vector\u003cpassportElementError\u003e",
"description": "Errors in the elements that are already available"
}
]
},
{
"name": "encryptedCredentials",
"description": "Contains encrypted Telegram Passport data credentials",
"class": "EncryptedCredentials",
"properties": [
{
"name": "data",
"type": "bytes",
"description": "The encrypted credentials"
},
{
"name": "hash",
"type": "bytes",
"description": "The decrypted data hash"
},
{
"name": "secret",
"type": "bytes",
"description": "Secret for data decryption, encrypted with the service's public key"
}
]
},
{
"name": "encryptedPassportElement",
"description": "Contains information about an encrypted Telegram Passport element; for bots only",
"class": "EncryptedPassportElement",
"properties": [
{
"name": "type",
"type": "PassportElementType",
"description": "Type of Telegram Passport element"
},
{
"name": "data",
"type": "bytes",
"description": "Encrypted JSON-encoded data about the user"
},
{
"name": "front_side",
"type": "datedFile",
"description": "The front side of an identity document"
},
{
"name": "reverse_side",
"type": "datedFile",
"description": "The reverse side of an identity document; may be null"
},
{
"name": "selfie",
"type": "datedFile",
"description": "Selfie with the document; may be null"
},
{
"name": "translation",
"type": "vector\u003cdatedFile\u003e",
"description": "List of files containing a certified English translation of the document"
},
{
"name": "files",
"type": "vector\u003cdatedFile\u003e",
"description": "List of attached files"
},
{
"name": "value",
"type": "string",
"description": "Unencrypted data, phone number or email address"
},
{
"name": "hash",
"type": "string",
"description": "Hash of the entire element"
}
]
},
{
"name": "inputPassportElementErrorSourceUnspecified",
"description": "The element contains an error in an unspecified place. The error will be considered resolved when new data is added",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "element_hash",
"type": "bytes",
"description": "Current hash of the entire element"
}
]
},
{
"name": "inputPassportElementErrorSourceDataField",
"description": "A data field contains an error. The error is considered resolved when the field's value changes",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "field_name",
"type": "string",
"description": "Field name"
},
{
"name": "data_hash",
"type": "bytes",
"description": "Current data hash"
}
]
},
{
"name": "inputPassportElementErrorSourceFrontSide",
"description": "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",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "file_hash",
"type": "bytes",
"description": "Current hash of the file containing the front side"
}
]
},
{
"name": "inputPassportElementErrorSourceReverseSide",
"description": "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",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "file_hash",
"type": "bytes",
"description": "Current hash of the file containing the reverse side"
}
]
},
{
"name": "inputPassportElementErrorSourceSelfie",
"description": "The selfie contains an error. The error is considered resolved when the file with the selfie changes",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "file_hash",
"type": "bytes",
"description": "Current hash of the file containing the selfie"
}
]
},
{
"name": "inputPassportElementErrorSourceTranslationFile",
"description": "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",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "file_hash",
"type": "bytes",
"description": "Current hash of the file containing the translation"
}
]
},
{
"name": "inputPassportElementErrorSourceTranslationFiles",
"description": "The translation of the document contains an error. The error is considered resolved when the list of files changes",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "file_hashes",
"type": "vector\u003cbytes\u003e",
"description": "Current hashes of all files with the translation"
}
]
},
{
"name": "inputPassportElementErrorSourceFile",
"description": "The file contains an error. The error is considered resolved when the file changes",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "file_hash",
"type": "bytes",
"description": "Current hash of the file which has the error"
}
]
},
{
"name": "inputPassportElementErrorSourceFiles",
"description": "The list of attached files contains an error. The error is considered resolved when the file list changes",
"class": "InputPassportElementErrorSource",
"properties": [
{
"name": "file_hashes",
"type": "vector\u003cbytes\u003e",
"description": "Current hashes of all attached files"
}
]
},
{
"name": "inputPassportElementError",
"description": "Contains the description of an error in a Telegram Passport element; for bots only",
"class": "InputPassportElementError",
"properties": [
{
"name": "type",
"type": "PassportElementType",
"description": "Type of Telegram Passport element that has the error"
},
{
"name": "message",
"type": "string",
"description": "Error message"
},
{
"name": "source",
"type": "InputPassportElementErrorSource",
"description": "Error source"
}
]
},
{
"name": "messageText",
"description": "A text message",
"class": "MessageContent",
"properties": [
{
"name": "text",
"type": "formattedText",
"description": "Text of the message"
},
{
"name": "web_page",
"type": "webPage",
"description": "A preview of the web page that's mentioned in the text; may be null"
}
]
},
{
"name": "messageAnimation",
"description": "An animation message (GIF-style).",
"class": "MessageContent",
"properties": [
{
"name": "animation",
"type": "animation",
"description": "The animation description"
},
{
"name": "caption",
"type": "formattedText",
"description": "Animation caption"
},
{
"name": "is_secret",
"type": "Bool",
"description": "True, if the animation thumbnail must be blurred and the animation must be shown only while tapped"
}
]
},
{
"name": "messageAudio",
"description": "An audio message",
"class": "MessageContent",
"properties": [
{
"name": "audio",
"type": "audio",
"description": "The audio description"
},
{
"name": "caption",
"type": "formattedText",
"description": "Audio caption"
}
]
},
{
"name": "messageDocument",
"description": "A document message (general file)",
"class": "MessageContent",
"properties": [
{
"name": "document",
"type": "document",
"description": "The document description"
},
{
"name": "caption",
"type": "formattedText",
"description": "Document caption"
}
]
},
{
"name": "messagePhoto",
"description": "A photo message",
"class": "MessageContent",
"properties": [
{
"name": "photo",
"type": "photo",
"description": "The photo description"
},
{
"name": "caption",
"type": "formattedText",
"description": "Photo caption"
},
{
"name": "is_secret",
"type": "Bool",
"description": "True, if the photo must be blurred and must be shown only while tapped"
}
]
},
{
"name": "messageExpiredPhoto",
"description": "An expired photo message (self-destructed after TTL has elapsed)",
"class": "MessageContent",
"properties": []
},
{
"name": "messageSticker",
"description": "A sticker message",
"class": "MessageContent",
"properties": [
{
"name": "sticker",
"type": "sticker",
"description": "The sticker description"
}
]
},
{
"name": "messageVideo",
"description": "A video message",
"class": "MessageContent",
"properties": [
{
"name": "video",
"type": "video",
"description": "The video description"
},
{
"name": "caption",
"type": "formattedText",
"description": "Video caption"
},
{
"name": "is_secret",
"type": "Bool",
"description": "True, if the video thumbnail must be blurred and the video must be shown only while tapped"
}
]
},
{
"name": "messageExpiredVideo",
"description": "An expired video message (self-destructed after TTL has elapsed)",
"class": "MessageContent",
"properties": []
},
{
"name": "messageVideoNote",
"description": "A video note message",
"class": "MessageContent",
"properties": [
{
"name": "video_note",
"type": "videoNote",
"description": "The video note description"
},
{
"name": "is_viewed",
"type": "Bool",
"description": "True, if at least one of the recipients has viewed the video note"
},
{
"name": "is_secret",
"type": "Bool",
"description": "True, if the video note thumbnail must be blurred and the video note must be shown only while tapped"
}
]
},
{
"name": "messageVoiceNote",
"description": "A voice note message",
"class": "MessageContent",
"properties": [
{
"name": "voice_note",
"type": "voiceNote",
"description": "The voice note description"
},
{
"name": "caption",
"type": "formattedText",
"description": "Voice note caption"
},
{
"name": "is_listened",
"type": "Bool",
"description": "True, if at least one of the recipients has listened to the voice note"
}
]
},
{
"name": "messageLocation",
"description": "A message with a location",
"class": "MessageContent",
"properties": [
{
"name": "location",
"type": "location",
"description": "The location description"
},
{
"name": "live_period",
"type": "int32",
"description": "Time relative to the message send date, for which the location can be updated, in seconds"
},
{
"name": "expires_in",
"type": "int32",
"description": "Left time for which the location can be updated, in seconds. updateMessageContent is not sent when this field changes"
},
{
"name": "heading",
"type": "int32",
"description": "For live locations, a direction in which the location moves, in degrees; 1-360. If 0 the direction is unknown"
},
{
"name": "proximity_alert_radius",
"type": "int32",
"description": "For live locations, a maximum distance to another chat member for proximity alerts, in meters (0-100000). 0 if the notification is disabled. Available only for the message sender"
}
]
},
{
"name": "messageVenue",
"description": "A message with information about a venue",
"class": "MessageContent",
"properties": [
{
"name": "venue",
"type": "venue",
"description": "The venue description"
}
]
},
{
"name": "messageContact",
"description": "A message with a user contact",
"class": "MessageContent",
"properties": [
{
"name": "contact",
"type": "contact",
"description": "The contact description"
}
]
},
{
"name": "messageAnimatedEmoji",
"description": "A message with an animated emoji",
"class": "MessageContent",
"properties": [
{
"name": "animated_emoji",
"type": "animatedEmoji",
"description": "The animated emoji"
},
{
"name": "emoji",
"type": "string",
"description": "The corresponding emoji"
}
]
},
{
"name": "messageDice",
"description": "A dice message. The dice value is randomly generated by the server",
"class": "MessageContent",
"properties": [
{
"name": "initial_state",
"type": "DiceStickers",
"description": "The animated stickers with the initial dice animation; may be null if unknown. updateMessageContent will be sent when the sticker became known"
},
{
"name": "final_state",
"type": "DiceStickers",
"description": "The animated stickers with the final dice animation; may be null if unknown. updateMessageContent will be sent when the sticker became known"
},
{
"name": "emoji",
"type": "string",
"description": "Emoji on which the dice throw animation is based"
},
{
"name": "value",
"type": "int32",
"description": "The dice value. If the value is 0, the dice don't have final state yet"
},
{
"name": "success_animation_frame_number",
"type": "int32",
"description": "Number of frame after which a success animation like a shower of confetti needs to be shown on updateMessageSendSucceeded"
}
]
},
{
"name": "messageGame",
"description": "A message with a game",
"class": "MessageContent",
"properties": [
{
"name": "game",
"type": "game",
"description": "The game description"
}
]
},
{
"name": "messagePoll",
"description": "A message with a poll",
"class": "MessageContent",
"properties": [
{
"name": "poll",
"type": "poll",
"description": "The poll description"
}
]
},
{
"name": "messageInvoice",
"description": "A message with an invoice from a bot",
"class": "MessageContent",
"properties": [
{
"name": "title",
"type": "string",
"description": "Product title"
},
{
"name": "description",
"type": "string",
"description": "Product description"
},
{
"name": "photo",
"type": "photo",
"description": "Product photo; may be null"
},
{
"name": "currency",
"type": "string",
"description": "Currency for the product price"
},
{
"name": "total_amount",
"type": "int53",
"description": "Product total price in the smallest units of the currency"
},
{
"name": "start_parameter",
"type": "string",
"description": "Unique invoice bot start_parameter. To share an invoice use the URL https://t.me/{bot_username}?start={start_parameter}"
},
{
"name": "is_test",
"type": "Bool",
"description": "True, if the invoice is a test invoice"
},
{
"name": "need_shipping_address",
"type": "Bool",
"description": "True, if the shipping address must be specified"
},
{
"name": "receipt_message_id",
"type": "int53",
"description": "The identifier of the message with the receipt, after the product has been purchased"
}
]
},
{
"name": "messageCall",
"description": "A message with information about an ended call",
"class": "MessageContent",
"properties": [
{
"name": "is_video",
"type": "Bool",
"description": "True, if the call was a video call"
},
{
"name": "discard_reason",
"type": "CallDiscardReason",
"description": "Reason why the call was discarded"
},
{
"name": "duration",
"type": "int32",
"description": "Call duration, in seconds"
}
]
},
{
"name": "messageVideoChatScheduled",
"description": "A new video chat was scheduled",
"class": "MessageContent",
"properties": [
{
"name": "group_call_id",
"type": "int32",
"description": "Identifier of the video chat. The video chat can be received through the method getGroupCall"
},
{
"name": "start_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the group call is supposed to be started by an administrator"
}
]
},
{
"name": "messageVideoChatStarted",
"description": "A newly created video chat",
"class": "MessageContent",
"properties": [
{
"name": "group_call_id",
"type": "int32",
"description": "Identifier of the video chat. The video chat can be received through the method getGroupCall"
}
]
},
{
"name": "messageVideoChatEnded",
"description": "A message with information about an ended video chat",
"class": "MessageContent",
"properties": [
{
"name": "duration",
"type": "int32",
"description": "Call duration, in seconds"
}
]
},
{
"name": "messageInviteVideoChatParticipants",
"description": "A message with information about an invite to a video chat",
"class": "MessageContent",
"properties": [
{
"name": "group_call_id",
"type": "int32",
"description": "Identifier of the video chat. The video chat can be received through the method getGroupCall"
},
{
"name": "user_ids",
"type": "vector\u003cint53\u003e",
"description": "Invited user identifiers"
}
]
},
{
"name": "messageBasicGroupChatCreate",
"description": "A newly created basic group",
"class": "MessageContent",
"properties": [
{
"name": "title",
"type": "string",
"description": "Title of the basic group"
},
{
"name": "member_user_ids",
"type": "vector\u003cint53\u003e",
"description": "User identifiers of members in the basic group"
}
]
},
{
"name": "messageSupergroupChatCreate",
"description": "A newly created supergroup or channel",
"class": "MessageContent",
"properties": [
{
"name": "title",
"type": "string",
"description": "Title of the supergroup or channel"
}
]
},
{
"name": "messageChatChangeTitle",
"description": "An updated chat title",
"class": "MessageContent",
"properties": [
{
"name": "title",
"type": "string",
"description": "New chat title"
}
]
},
{
"name": "messageChatChangePhoto",
"description": "An updated chat photo",
"class": "MessageContent",
"properties": [
{
"name": "photo",
"type": "chatPhoto",
"description": "New chat photo"
}
]
},
{
"name": "messageChatDeletePhoto",
"description": "A deleted chat photo",
"class": "MessageContent",
"properties": []
},
{
"name": "messageChatAddMembers",
"description": "New chat members were added",
"class": "MessageContent",
"properties": [
{
"name": "member_user_ids",
"type": "vector\u003cint53\u003e",
"description": "User identifiers of the new members"
}
]
},
{
"name": "messageChatJoinByLink",
"description": "A new member joined the chat by invite link",
"class": "MessageContent",
"properties": []
},
{
"name": "messageChatJoinByRequest",
"description": "A new member was accepted to the chat by an administrator",
"class": "MessageContent",
"properties": []
},
{
"name": "messageChatDeleteMember",
"description": "A chat member was deleted",
"class": "MessageContent",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "User identifier of the deleted chat member"
}
]
},
{
"name": "messageChatUpgradeTo",
"description": "A basic group was upgraded to a supergroup and was deactivated as the result",
"class": "MessageContent",
"properties": [
{
"name": "supergroup_id",
"type": "int53",
"description": "Identifier of the supergroup to which the basic group was upgraded"
}
]
},
{
"name": "messageChatUpgradeFrom",
"description": "A supergroup has been created from a basic group",
"class": "MessageContent",
"properties": [
{
"name": "title",
"type": "string",
"description": "Title of the newly created supergroup"
},
{
"name": "basic_group_id",
"type": "int53",
"description": "The identifier of the original basic group"
}
]
},
{
"name": "messagePinMessage",
"description": "A message has been pinned",
"class": "MessageContent",
"properties": [
{
"name": "message_id",
"type": "int53",
"description": "Identifier of the pinned message, can be an identifier of a deleted message or 0"
}
]
},
{
"name": "messageScreenshotTaken",
"description": "A screenshot of a message in the chat has been taken",
"class": "MessageContent",
"properties": []
},
{
"name": "messageChatSetTheme",
"description": "A theme in the chat has been changed",
"class": "MessageContent",
"properties": [
{
"name": "theme_name",
"type": "string",
"description": "If non-empty, name of a new theme, set for the chat. Otherwise chat theme was reset to the default one"
}
]
},
{
"name": "messageChatSetTtl",
"description": "The TTL (Time To Live) setting for messages in the chat has been changed",
"class": "MessageContent",
"properties": [
{
"name": "ttl",
"type": "int32",
"description": "New message TTL setting"
}
]
},
{
"name": "messageCustomServiceAction",
"description": "A non-standard action has happened in the chat",
"class": "MessageContent",
"properties": [
{
"name": "text",
"type": "string",
"description": "Message text to be shown in the chat"
}
]
},
{
"name": "messageGameScore",
"description": "A new high score was achieved in a game",
"class": "MessageContent",
"properties": [
{
"name": "game_message_id",
"type": "int53",
"description": "Identifier of the message with the game, can be an identifier of a deleted message"
},
{
"name": "game_id",
"type": "int64",
"description": "Identifier of the game; may be different from the games presented in the message with the game"
},
{
"name": "score",
"type": "int32",
"description": "New score"
}
]
},
{
"name": "messagePaymentSuccessful",
"description": "A payment has been completed",
"class": "MessageContent",
"properties": [
{
"name": "invoice_chat_id",
"type": "int53",
"description": "Identifier of the chat, containing the corresponding invoice message; 0 if unknown"
},
{
"name": "invoice_message_id",
"type": "int53",
"description": "Identifier of the message with the corresponding invoice; can be an identifier of a deleted message"
},
{
"name": "currency",
"type": "string",
"description": "Currency for the price of the product"
},
{
"name": "total_amount",
"type": "int53",
"description": "Total price for the product, in the smallest units of the currency"
}
]
},
{
"name": "messagePaymentSuccessfulBot",
"description": "A payment has been completed; for bots only",
"class": "MessageContent",
"properties": [
{
"name": "currency",
"type": "string",
"description": "Currency for price of the product"
},
{
"name": "total_amount",
"type": "int53",
"description": "Total price for the product, in the smallest units of the currency"
},
{
"name": "invoice_payload",
"type": "bytes",
"description": "Invoice payload"
},
{
"name": "shipping_option_id",
"type": "string",
"description": "Identifier of the shipping option chosen by the user; may be empty if not applicable"
},
{
"name": "order_info",
"type": "orderInfo",
"description": "Information about the order; may be null"
},
{
"name": "telegram_payment_charge_id",
"type": "string",
"description": "Telegram payment identifier"
},
{
"name": "provider_payment_charge_id",
"type": "string",
"description": "Provider payment identifier"
}
]
},
{
"name": "messageContactRegistered",
"description": "A contact has registered with Telegram",
"class": "MessageContent",
"properties": []
},
{
"name": "messageWebsiteConnected",
"description": "The current user has connected a website by logging in using Telegram Login Widget on it",
"class": "MessageContent",
"properties": [
{
"name": "domain_name",
"type": "string",
"description": "Domain name of the connected website"
}
]
},
{
"name": "messagePassportDataSent",
"description": "Telegram Passport data has been sent",
"class": "MessageContent",
"properties": [
{
"name": "types",
"type": "vector\u003cPassportElementType\u003e",
"description": "List of Telegram Passport element types sent"
}
]
},
{
"name": "messagePassportDataReceived",
"description": "Telegram Passport data has been received; for bots only",
"class": "MessageContent",
"properties": [
{
"name": "elements",
"type": "vector\u003cencryptedPassportElement\u003e",
"description": "List of received Telegram Passport elements"
},
{
"name": "credentials",
"type": "encryptedCredentials",
"description": "Encrypted data credentials"
}
]
},
{
"name": "messageProximityAlertTriggered",
"description": "A user in the chat came within proximity alert range",
"class": "MessageContent",
"properties": [
{
"name": "traveler_id",
"type": "MessageSender",
"description": "The identifier of a user or chat that triggered the proximity alert"
},
{
"name": "watcher_id",
"type": "MessageSender",
"description": "The identifier of a user or chat that subscribed for the proximity alert"
},
{
"name": "distance",
"type": "int32",
"description": "The distance between the users"
}
]
},
{
"name": "messageUnsupported",
"description": "Message content that is not supported in the current TDLib version",
"class": "MessageContent",
"properties": []
},
{
"name": "textEntityTypeMention",
"description": "A mention of a user by their username",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeHashtag",
"description": "A hashtag text, beginning with \"#\"",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeCashtag",
"description": "A cashtag text, beginning with \"$\" and consisting of capital English letters (e.g., \"$USD\")",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeBotCommand",
"description": "A bot command, beginning with \"/\"",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeUrl",
"description": "An HTTP URL",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeEmailAddress",
"description": "An email address",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypePhoneNumber",
"description": "A phone number",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeBankCardNumber",
"description": "A bank card number. The getBankCardInfo method can be used to get information about the bank card",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeBold",
"description": "A bold text",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeItalic",
"description": "An italic text",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeUnderline",
"description": "An underlined text",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeStrikethrough",
"description": "A strikethrough text",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypeCode",
"description": "Text that must be formatted as if inside a code HTML tag",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypePre",
"description": "Text that must be formatted as if inside a pre HTML tag",
"class": "TextEntityType",
"properties": []
},
{
"name": "textEntityTypePreCode",
"description": "Text that must be formatted as if inside pre, and code HTML tags",
"class": "TextEntityType",
"properties": [
{
"name": "language",
"type": "string",
"description": "Programming language of the code; as defined by the sender"
}
]
},
{
"name": "textEntityTypeTextUrl",
"description": "A text description shown instead of a raw URL",
"class": "TextEntityType",
"properties": [
{
"name": "url",
"type": "string",
"description": "HTTP or tg:// URL to be opened when the link is clicked"
}
]
},
{
"name": "textEntityTypeMentionName",
"description": "A text shows instead of a raw mention of the user (e.g., when the user has no username)",
"class": "TextEntityType",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "Identifier of the mentioned user"
}
]
},
{
"name": "textEntityTypeMediaTimestamp",
"description": "A media timestamp",
"class": "TextEntityType",
"properties": [
{
"name": "media_timestamp",
"type": "int32",
"description": "Timestamp from which a video/audio/video note/voice note playing must start, in seconds. The media can be in the content or the web page preview of the current message, or in the same places in the replied message"
}
]
},
{
"name": "inputThumbnail",
"description": "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",
"class": "InputThumbnail",
"properties": [
{
"name": "thumbnail",
"type": "InputFile",
"description": "Thumbnail file to send. Sending thumbnails by file_id is currently not supported"
},
{
"name": "width",
"type": "int32",
"description": "Thumbnail width, usually shouldn't exceed 320. Use 0 if unknown"
},
{
"name": "height",
"type": "int32",
"description": "Thumbnail height, usually shouldn't exceed 320. Use 0 if unknown"
}
]
},
{
"name": "messageSchedulingStateSendAtDate",
"description": "The message will be sent at the specified date",
"class": "MessageSchedulingState",
"properties": [
{
"name": "send_date",
"type": "int32",
"description": "Date the message will be sent. The date must be within 367 days in the future"
}
]
},
{
"name": "messageSchedulingStateSendWhenOnline",
"description": "The message will be sent when the peer will be online. Applicable to private chats only and when the exact online status of the peer is known",
"class": "MessageSchedulingState",
"properties": []
},
{
"name": "messageSendOptions",
"description": "Options to be used when a message is sent",
"class": "MessageSendOptions",
"properties": [
{
"name": "disable_notification",
"type": "Bool",
"description": "Pass true to disable notification for the message"
},
{
"name": "from_background",
"type": "Bool",
"description": "Pass true if the message is sent from the background"
},
{
"name": "scheduling_state",
"type": "MessageSchedulingState",
"description": "Message scheduling state; pass null to send message immediately. Messages sent to a secret chat, live location messages and self-destructing messages can't be scheduled"
}
]
},
{
"name": "messageCopyOptions",
"description": "Options to be used when a message content is copied without reference to the original sender. Service messages and messageInvoice can't be copied",
"class": "MessageCopyOptions",
"properties": [
{
"name": "send_copy",
"type": "Bool",
"description": "True, if content of the message needs to be copied without reference to the original sender. Always true if the message is forwarded to a secret chat or is local"
},
{
"name": "replace_caption",
"type": "Bool",
"description": "True, if media caption of the message copy needs to be replaced. Ignored if send_copy is false"
},
{
"name": "new_caption",
"type": "formattedText",
"description": "New message caption; pass null to copy message without caption. Ignored if replace_caption is false"
}
]
},
{
"name": "inputMessageText",
"description": "A text message",
"class": "InputMessageContent",
"properties": [
{
"name": "text",
"type": "formattedText",
"description": "Formatted text to be sent; 1-GetOption(\"message_text_length_max\") characters. Only Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities are allowed to be specified manually"
},
{
"name": "disable_web_page_preview",
"type": "Bool",
"description": "True, if rich web page previews for URLs in the message text must be disabled"
},
{
"name": "clear_draft",
"type": "Bool",
"description": "True, if a chat message draft must be deleted"
}
]
},
{
"name": "inputMessageAnimation",
"description": "An animation message (GIF-style).",
"class": "InputMessageContent",
"properties": [
{
"name": "animation",
"type": "InputFile",
"description": "Animation file to be sent"
},
{
"name": "thumbnail",
"type": "inputThumbnail",
"description": "Animation thumbnail; pass null to skip thumbnail uploading"
},
{
"name": "added_sticker_file_ids",
"type": "vector\u003cint32\u003e",
"description": "File identifiers of the stickers added to the animation, if applicable"
},
{
"name": "duration",
"type": "int32",
"description": "Duration of the animation, in seconds"
},
{
"name": "width",
"type": "int32",
"description": "Width of the animation; may be replaced by the server"
},
{
"name": "height",
"type": "int32",
"description": "Height of the animation; may be replaced by the server"
},
{
"name": "caption",
"type": "formattedText",
"description": "Animation caption; pass null to use an empty caption; 0-GetOption(\"message_caption_length_max\") characters"
}
]
},
{
"name": "inputMessageAudio",
"description": "An audio message",
"class": "InputMessageContent",
"properties": [
{
"name": "audio",
"type": "InputFile",
"description": "Audio file to be sent"
},
{
"name": "album_cover_thumbnail",
"type": "inputThumbnail",
"description": "Thumbnail of the cover for the album; pass null to skip thumbnail uploading"
},
{
"name": "duration",
"type": "int32",
"description": "Duration of the audio, in seconds; may be replaced by the server"
},
{
"name": "title",
"type": "string",
"description": "Title of the audio; 0-64 characters; may be replaced by the server"
},
{
"name": "performer",
"type": "string",
"description": "Performer of the audio; 0-64 characters, may be replaced by the server"
},
{
"name": "caption",
"type": "formattedText",
"description": "Audio caption; pass null to use an empty caption; 0-GetOption(\"message_caption_length_max\") characters"
}
]
},
{
"name": "inputMessageDocument",
"description": "A document message (general file)",
"class": "InputMessageContent",
"properties": [
{
"name": "document",
"type": "InputFile",
"description": "Document to be sent"
},
{
"name": "thumbnail",
"type": "inputThumbnail",
"description": "Document thumbnail; pass null to skip thumbnail uploading"
},
{
"name": "disable_content_type_detection",
"type": "Bool",
"description": "If true, automatic file type detection will be disabled and the document will be always sent as file. Always true for files sent to secret chats"
},
{
"name": "caption",
"type": "formattedText",
"description": "Document caption; pass null to use an empty caption; 0-GetOption(\"message_caption_length_max\") characters"
}
]
},
{
"name": "inputMessagePhoto",
"description": "A photo message",
"class": "InputMessageContent",
"properties": [
{
"name": "photo",
"type": "InputFile",
"description": "Photo to send"
},
{
"name": "thumbnail",
"type": "inputThumbnail",
"description": "Photo thumbnail to be sent; pass null to skip thumbnail uploading. The thumbnail is sent to the other party only in secret chats"
},
{
"name": "added_sticker_file_ids",
"type": "vector\u003cint32\u003e",
"description": "File identifiers of the stickers added to the photo, if applicable"
},
{
"name": "width",
"type": "int32",
"description": "Photo width"
},
{
"name": "height",
"type": "int32",
"description": "Photo height"
},
{
"name": "caption",
"type": "formattedText",
"description": "Photo caption; pass null to use an empty caption; 0-GetOption(\"message_caption_length_max\") characters"
},
{
"name": "ttl",
"type": "int32",
"description": "Photo TTL (Time To Live), in seconds (0-60). A non-zero TTL can be specified only in private chats"
}
]
},
{
"name": "inputMessageSticker",
"description": "A sticker message",
"class": "InputMessageContent",
"properties": [
{
"name": "sticker",
"type": "InputFile",
"description": "Sticker to be sent"
},
{
"name": "thumbnail",
"type": "inputThumbnail",
"description": "Sticker thumbnail; pass null to skip thumbnail uploading"
},
{
"name": "width",
"type": "int32",
"description": "Sticker width"
},
{
"name": "height",
"type": "int32",
"description": "Sticker height"
},
{
"name": "emoji",
"type": "string",
"description": "Emoji used to choose the sticker"
}
]
},
{
"name": "inputMessageVideo",
"description": "A video message",
"class": "InputMessageContent",
"properties": [
{
"name": "video",
"type": "InputFile",
"description": "Video to be sent"
},
{
"name": "thumbnail",
"type": "inputThumbnail",
"description": "Video thumbnail; pass null to skip thumbnail uploading"
},
{
"name": "added_sticker_file_ids",
"type": "vector\u003cint32\u003e",
"description": "File identifiers of the stickers added to the video, if applicable"
},
{
"name": "duration",
"type": "int32",
"description": "Duration of the video, in seconds"
},
{
"name": "width",
"type": "int32",
"description": "Video width"
},
{
"name": "height",
"type": "int32",
"description": "Video height"
},
{
"name": "supports_streaming",
"type": "Bool",
"description": "True, if the video is supposed to be streamed"
},
{
"name": "caption",
"type": "formattedText",
"description": "Video caption; pass null to use an empty caption; 0-GetOption(\"message_caption_length_max\") characters"
},
{
"name": "ttl",
"type": "int32",
"description": "Video TTL (Time To Live), in seconds (0-60). A non-zero TTL can be specified only in private chats"
}
]
},
{
"name": "inputMessageVideoNote",
"description": "A video note message",
"class": "InputMessageContent",
"properties": [
{
"name": "video_note",
"type": "InputFile",
"description": "Video note to be sent"
},
{
"name": "thumbnail",
"type": "inputThumbnail",
"description": "Video thumbnail; pass null to skip thumbnail uploading"
},
{
"name": "duration",
"type": "int32",
"description": "Duration of the video, in seconds"
},
{
"name": "length",
"type": "int32",
"description": "Video width and height; must be positive and not greater than 640"
}
]
},
{
"name": "inputMessageVoiceNote",
"description": "A voice note message",
"class": "InputMessageContent",
"properties": [
{
"name": "voice_note",
"type": "InputFile",
"description": "Voice note to be sent"
},
{
"name": "duration",
"type": "int32",
"description": "Duration of the voice note, in seconds"
},
{
"name": "waveform",
"type": "bytes",
"description": "Waveform representation of the voice note, in 5-bit format"
},
{
"name": "caption",
"type": "formattedText",
"description": "Voice note caption; pass null to use an empty caption; 0-GetOption(\"message_caption_length_max\") characters"
}
]
},
{
"name": "inputMessageLocation",
"description": "A message with a location",
"class": "InputMessageContent",
"properties": [
{
"name": "location",
"type": "location",
"description": "Location to be sent"
},
{
"name": "live_period",
"type": "int32",
"description": "Period for which the location can be updated, in seconds; must be between 60 and 86400 for a live location and 0 otherwise"
},
{
"name": "heading",
"type": "int32",
"description": "For live locations, a direction in which the location moves, in degrees; 1-360. Pass 0 if unknown"
},
{
"name": "proximity_alert_radius",
"type": "int32",
"description": "For live locations, a maximum distance to another chat member for proximity alerts, in meters (0-100000). Pass 0 if the notification is disabled. Can't be enabled in channels and Saved Messages"
}
]
},
{
"name": "inputMessageVenue",
"description": "A message with information about a venue",
"class": "InputMessageContent",
"properties": [
{
"name": "venue",
"type": "venue",
"description": "Venue to send"
}
]
},
{
"name": "inputMessageContact",
"description": "A message containing a user contact",
"class": "InputMessageContent",
"properties": [
{
"name": "contact",
"type": "contact",
"description": "Contact to send"
}
]
},
{
"name": "inputMessageDice",
"description": "A dice message",
"class": "InputMessageContent",
"properties": [
{
"name": "emoji",
"type": "string",
"description": "Emoji on which the dice throw animation is based"
},
{
"name": "clear_draft",
"type": "Bool",
"description": "True, if the chat message draft must be deleted"
}
]
},
{
"name": "inputMessageGame",
"description": "A message with a game; not supported for channels or secret chats",
"class": "InputMessageContent",
"properties": [
{
"name": "bot_user_id",
"type": "int53",
"description": "User identifier of the bot that owns the game"
},
{
"name": "game_short_name",
"type": "string",
"description": "Short name of the game"
}
]
},
{
"name": "inputMessageInvoice",
"description": "A message with an invoice; can be used only by bots",
"class": "InputMessageContent",
"properties": [
{
"name": "invoice",
"type": "invoice",
"description": "Invoice"
},
{
"name": "title",
"type": "string",
"description": "Product title; 1-32 characters"
},
{
"name": "description",
"type": "string",
"description": "Product description; 0-255 characters"
},
{
"name": "photo_url",
"type": "string",
"description": "Product photo URL; optional"
},
{
"name": "photo_size",
"type": "int32",
"description": "Product photo size"
},
{
"name": "photo_width",
"type": "int32",
"description": "Product photo width"
},
{
"name": "photo_height",
"type": "int32",
"description": "Product photo height"
},
{
"name": "payload",
"type": "bytes",
"description": "The invoice payload"
},
{
"name": "provider_token",
"type": "string",
"description": "Payment provider token"
},
{
"name": "provider_data",
"type": "string",
"description": "JSON-encoded data about the invoice, which will be shared with the payment provider"
},
{
"name": "start_parameter",
"type": "string",
"description": "Unique invoice bot deep link parameter for the generation of this invoice. If empty, it would be possible to pay directly from forwards of the invoice message"
}
]
},
{
"name": "inputMessagePoll",
"description": "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",
"class": "InputMessageContent",
"properties": [
{
"name": "question",
"type": "string",
"description": "Poll question; 1-255 characters (up to 300 characters for bots)"
},
{
"name": "options",
"type": "vector\u003cstring\u003e",
"description": "List of poll answer options, 2-10 strings 1-100 characters each"
},
{
"name": "is_anonymous",
"type": "Bool",
"description": "True, if the poll voters are anonymous. Non-anonymous polls can't be sent or forwarded to channels"
},
{
"name": "type",
"type": "PollType",
"description": "Type of the poll"
},
{
"name": "open_period",
"type": "int32",
"description": "Amount of time the poll will be active after creation, in seconds; for bots only"
},
{
"name": "close_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the poll will automatically be closed; for bots only"
},
{
"name": "is_closed",
"type": "Bool",
"description": "True, if the poll needs to be sent already closed; for bots only"
}
]
},
{
"name": "inputMessageForwarded",
"description": "A forwarded message",
"class": "InputMessageContent",
"properties": [
{
"name": "from_chat_id",
"type": "int53",
"description": "Identifier for the chat this forwarded message came from"
},
{
"name": "message_id",
"type": "int53",
"description": "Identifier of the message to forward"
},
{
"name": "in_game_share",
"type": "Bool",
"description": "True, if a game message is being shared from a launched game; applies only to game messages"
},
{
"name": "copy_options",
"type": "messageCopyOptions",
"description": "Options to be used to copy content of the message without reference to the original sender; pass null to try to forward the message as usual"
}
]
},
{
"name": "searchMessagesFilterEmpty",
"description": "Returns all found messages, no filter is applied",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterAnimation",
"description": "Returns only animation messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterAudio",
"description": "Returns only audio messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterDocument",
"description": "Returns only document messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterPhoto",
"description": "Returns only photo messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterVideo",
"description": "Returns only video messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterVoiceNote",
"description": "Returns only voice note messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterPhotoAndVideo",
"description": "Returns only photo and video messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterUrl",
"description": "Returns only messages containing URLs",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterChatPhoto",
"description": "Returns only messages containing chat photos",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterCall",
"description": "Returns only call messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterMissedCall",
"description": "Returns only incoming call messages with missed/declined discard reasons",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterVideoNote",
"description": "Returns only video note messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterVoiceAndVideoNote",
"description": "Returns only voice and video note messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterMention",
"description": "Returns only messages with mentions of the current user, or messages that are replies to their messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterUnreadMention",
"description": "Returns only messages with unread mentions of the current user, or messages that are replies to their messages. When using this filter the results can't be additionally filtered by a query, a message thread or by the sending user",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterFailedToSend",
"description": "Returns only failed to send messages. This filter can be used only if the message database is used",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "searchMessagesFilterPinned",
"description": "Returns only pinned messages",
"class": "SearchMessagesFilter",
"properties": []
},
{
"name": "chatActionTyping",
"description": "The user is typing a message",
"class": "ChatAction",
"properties": []
},
{
"name": "chatActionRecordingVideo",
"description": "The user is recording a video",
"class": "ChatAction",
"properties": []
},
{
"name": "chatActionUploadingVideo",
"description": "The user is uploading a video",
"class": "ChatAction",
"properties": [
{
"name": "progress",
"type": "int32",
"description": "Upload progress, as a percentage"
}
]
},
{
"name": "chatActionRecordingVoiceNote",
"description": "The user is recording a voice note",
"class": "ChatAction",
"properties": []
},
{
"name": "chatActionUploadingVoiceNote",
"description": "The user is uploading a voice note",
"class": "ChatAction",
"properties": [
{
"name": "progress",
"type": "int32",
"description": "Upload progress, as a percentage"
}
]
},
{
"name": "chatActionUploadingPhoto",
"description": "The user is uploading a photo",
"class": "ChatAction",
"properties": [
{
"name": "progress",
"type": "int32",
"description": "Upload progress, as a percentage"
}
]
},
{
"name": "chatActionUploadingDocument",
"description": "The user is uploading a document",
"class": "ChatAction",
"properties": [
{
"name": "progress",
"type": "int32",
"description": "Upload progress, as a percentage"
}
]
},
{
"name": "chatActionChoosingSticker",
"description": "The user is picking a sticker to send",
"class": "ChatAction",
"properties": []
},
{
"name": "chatActionChoosingLocation",
"description": "The user is picking a location or venue to send",
"class": "ChatAction",
"properties": []
},
{
"name": "chatActionChoosingContact",
"description": "The user is picking a contact to send",
"class": "ChatAction",
"properties": []
},
{
"name": "chatActionStartPlayingGame",
"description": "The user has started to play a game",
"class": "ChatAction",
"properties": []
},
{
"name": "chatActionRecordingVideoNote",
"description": "The user is recording a video note",
"class": "ChatAction",
"properties": []
},
{
"name": "chatActionUploadingVideoNote",
"description": "The user is uploading a video note",
"class": "ChatAction",
"properties": [
{
"name": "progress",
"type": "int32",
"description": "Upload progress, as a percentage"
}
]
},
{
"name": "chatActionWatchingAnimations",
"description": "The user is watching animations sent by the other party by clicking on an animated emoji",
"class": "ChatAction",
"properties": [
{
"name": "emoji",
"type": "string",
"description": "The animated emoji"
}
]
},
{
"name": "chatActionCancel",
"description": "The user has canceled the previous action",
"class": "ChatAction",
"properties": []
},
{
"name": "userStatusEmpty",
"description": "The user status was never changed",
"class": "UserStatus",
"properties": []
},
{
"name": "userStatusOnline",
"description": "The user is online",
"class": "UserStatus",
"properties": [
{
"name": "expires",
"type": "int32",
"description": "Point in time (Unix timestamp) when the user's online status will expire"
}
]
},
{
"name": "userStatusOffline",
"description": "The user is offline",
"class": "UserStatus",
"properties": [
{
"name": "was_online",
"type": "int32",
"description": "Point in time (Unix timestamp) when the user was last online"
}
]
},
{
"name": "userStatusRecently",
"description": "The user was online recently",
"class": "UserStatus",
"properties": []
},
{
"name": "userStatusLastWeek",
"description": "The user is offline, but was online last week",
"class": "UserStatus",
"properties": []
},
{
"name": "userStatusLastMonth",
"description": "The user is offline, but was online last month",
"class": "UserStatus",
"properties": []
},
{
"name": "stickers",
"description": "Represents a list of stickers",
"class": "Stickers",
"properties": [
{
"name": "stickers",
"type": "vector\u003csticker\u003e",
"description": "List of stickers"
}
]
},
{
"name": "emojis",
"description": "Represents a list of emoji",
"class": "Emojis",
"properties": [
{
"name": "emojis",
"type": "vector\u003cstring\u003e",
"description": "List of emojis"
}
]
},
{
"name": "stickerSet",
"description": "Represents a sticker set",
"class": "StickerSet",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Identifier of the sticker set"
},
{
"name": "title",
"type": "string",
"description": "Title of the sticker set"
},
{
"name": "name",
"type": "string",
"description": "Name of the sticker set"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null. The file can be downloaded only before the thumbnail is changed"
},
{
"name": "thumbnail_outline",
"type": "vector\u003cclosedVectorPath\u003e",
"description": "Sticker set thumbnail's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner"
},
{
"name": "is_installed",
"type": "Bool",
"description": "True, if the sticker set has been installed by the current user"
},
{
"name": "is_archived",
"type": "Bool",
"description": "True, if the sticker set has been archived. A sticker set can't be installed and archived simultaneously"
},
{
"name": "is_official",
"type": "Bool",
"description": "True, if the sticker set is official"
},
{
"name": "is_animated",
"type": "Bool",
"description": "True, is the stickers in the set are animated"
},
{
"name": "is_masks",
"type": "Bool",
"description": "True, if the stickers in the set are masks"
},
{
"name": "is_viewed",
"type": "Bool",
"description": "True for already viewed trending sticker sets"
},
{
"name": "stickers",
"type": "vector\u003csticker\u003e",
"description": "List of stickers in this set"
},
{
"name": "emojis",
"type": "vector\u003cemojis\u003e",
"description": "A list of emoji corresponding to the stickers in the same order. The list is only for informational purposes, because a sticker is always sent with a fixed emoji from the corresponding Sticker object"
}
]
},
{
"name": "stickerSetInfo",
"description": "Represents short information about a sticker set",
"class": "StickerSetInfo",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Identifier of the sticker set"
},
{
"name": "title",
"type": "string",
"description": "Title of the sticker set"
},
{
"name": "name",
"type": "string",
"description": "Name of the sticker set"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null"
},
{
"name": "thumbnail_outline",
"type": "vector\u003cclosedVectorPath\u003e",
"description": "Sticker set thumbnail's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner"
},
{
"name": "is_installed",
"type": "Bool",
"description": "True, if the sticker set has been installed by the current user"
},
{
"name": "is_archived",
"type": "Bool",
"description": "True, if the sticker set has been archived. A sticker set can't be installed and archived simultaneously"
},
{
"name": "is_official",
"type": "Bool",
"description": "True, if the sticker set is official"
},
{
"name": "is_animated",
"type": "Bool",
"description": "True, is the stickers in the set are animated"
},
{
"name": "is_masks",
"type": "Bool",
"description": "True, if the stickers in the set are masks"
},
{
"name": "is_viewed",
"type": "Bool",
"description": "True for already viewed trending sticker sets"
},
{
"name": "size",
"type": "int32",
"description": "Total number of stickers in the set"
},
{
"name": "covers",
"type": "vector\u003csticker\u003e",
"description": "Up to the first 5 stickers from the set, depending on the context. If the application needs more stickers the full sticker set needs to be requested"
}
]
},
{
"name": "stickerSets",
"description": "Represents a list of sticker sets",
"class": "StickerSets",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Approximate total number of sticker sets found"
},
{
"name": "sets",
"type": "vector\u003cstickerSetInfo\u003e",
"description": "List of sticker sets"
}
]
},
{
"name": "callDiscardReasonEmpty",
"description": "The call wasn't discarded, or the reason is unknown",
"class": "CallDiscardReason",
"properties": []
},
{
"name": "callDiscardReasonMissed",
"description": "The call was ended before the conversation started. It was canceled by the caller or missed by the other party",
"class": "CallDiscardReason",
"properties": []
},
{
"name": "callDiscardReasonDeclined",
"description": "The call was ended before the conversation started. It was declined by the other party",
"class": "CallDiscardReason",
"properties": []
},
{
"name": "callDiscardReasonDisconnected",
"description": "The call was ended during the conversation because the users were disconnected",
"class": "CallDiscardReason",
"properties": []
},
{
"name": "callDiscardReasonHungUp",
"description": "The call was ended because one of the parties hung up",
"class": "CallDiscardReason",
"properties": []
},
{
"name": "callProtocol",
"description": "Specifies the supported call protocols",
"class": "CallProtocol",
"properties": [
{
"name": "udp_p2p",
"type": "Bool",
"description": "True, if UDP peer-to-peer connections are supported"
},
{
"name": "udp_reflector",
"type": "Bool",
"description": "True, if connection through UDP reflectors is supported"
},
{
"name": "min_layer",
"type": "int32",
"description": "The minimum supported API layer; use 65"
},
{
"name": "max_layer",
"type": "int32",
"description": "The maximum supported API layer; use 65"
},
{
"name": "library_versions",
"type": "vector\u003cstring\u003e",
"description": "List of supported tgcalls versions"
}
]
},
{
"name": "callServerTypeTelegramReflector",
"description": "A Telegram call reflector",
"class": "CallServerType",
"properties": [
{
"name": "peer_tag",
"type": "bytes",
"description": "A peer tag to be used with the reflector"
}
]
},
{
"name": "callServerTypeWebrtc",
"description": "A WebRTC server",
"class": "CallServerType",
"properties": [
{
"name": "username",
"type": "string",
"description": "Username to be used for authentication"
},
{
"name": "password",
"type": "string",
"description": "Authentication password"
},
{
"name": "supports_turn",
"type": "Bool",
"description": "True, if the server supports TURN"
},
{
"name": "supports_stun",
"type": "Bool",
"description": "True, if the server supports STUN"
}
]
},
{
"name": "callServer",
"description": "Describes a server for relaying call data",
"class": "CallServer",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Server identifier"
},
{
"name": "ip_address",
"type": "string",
"description": "Server IPv4 address"
},
{
"name": "ipv6_address",
"type": "string",
"description": "Server IPv6 address"
},
{
"name": "port",
"type": "int32",
"description": "Server port number"
},
{
"name": "type",
"type": "CallServerType",
"description": "Server type"
}
]
},
{
"name": "callId",
"description": "Contains the call identifier",
"class": "CallId",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Call identifier"
}
]
},
{
"name": "groupCallId",
"description": "Contains the group call identifier",
"class": "GroupCallId",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Group call identifier"
}
]
},
{
"name": "callStatePending",
"description": "The call is pending, waiting to be accepted by a user",
"class": "CallState",
"properties": [
{
"name": "is_created",
"type": "Bool",
"description": "True, if the call has already been created by the server"
},
{
"name": "is_received",
"type": "Bool",
"description": "True, if the call has already been received by the other party"
}
]
},
{
"name": "callStateExchangingKeys",
"description": "The call has been answered and encryption keys are being exchanged",
"class": "CallState",
"properties": []
},
{
"name": "callStateReady",
"description": "The call is ready to use",
"class": "CallState",
"properties": [
{
"name": "protocol",
"type": "callProtocol",
"description": "Call protocols supported by the peer"
},
{
"name": "servers",
"type": "vector\u003ccallServer\u003e",
"description": "List of available call servers"
},
{
"name": "config",
"type": "string",
"description": "A JSON-encoded call config"
},
{
"name": "encryption_key",
"type": "bytes",
"description": "Call encryption key"
},
{
"name": "emojis",
"type": "vector\u003cstring\u003e",
"description": "Encryption key emojis fingerprint"
},
{
"name": "allow_p2p",
"type": "Bool",
"description": "True, if peer-to-peer connection is allowed by users privacy settings"
}
]
},
{
"name": "callStateHangingUp",
"description": "The call is hanging up after discardCall has been called",
"class": "CallState",
"properties": []
},
{
"name": "callStateDiscarded",
"description": "The call has ended successfully",
"class": "CallState",
"properties": [
{
"name": "reason",
"type": "CallDiscardReason",
"description": "The reason, why the call has ended"
},
{
"name": "need_rating",
"type": "Bool",
"description": "True, if the call rating must be sent to the server"
},
{
"name": "need_debug_information",
"type": "Bool",
"description": "True, if the call debug information must be sent to the server"
}
]
},
{
"name": "callStateError",
"description": "The call has ended with an error",
"class": "CallState",
"properties": [
{
"name": "error",
"type": "error",
"description": "Error. An error with the code 4005000 will be returned if an outgoing call is missed because of an expired timeout"
}
]
},
{
"name": "groupCallVideoQualityThumbnail",
"description": "The worst available video quality",
"class": "GroupCallVideoQuality",
"properties": []
},
{
"name": "groupCallVideoQualityMedium",
"description": "The medium video quality",
"class": "GroupCallVideoQuality",
"properties": []
},
{
"name": "groupCallVideoQualityFull",
"description": "The best available video quality",
"class": "GroupCallVideoQuality",
"properties": []
},
{
"name": "groupCallRecentSpeaker",
"description": "Describes a recently speaking participant in a group call",
"class": "GroupCallRecentSpeaker",
"properties": [
{
"name": "participant_id",
"type": "MessageSender",
"description": "Group call participant identifier"
},
{
"name": "is_speaking",
"type": "Bool",
"description": "True, is the user has spoken recently"
}
]
},
{
"name": "groupCall",
"description": "Describes a group call",
"class": "GroupCall",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Group call identifier"
},
{
"name": "title",
"type": "string",
"description": "Group call title"
},
{
"name": "scheduled_start_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the group call is supposed to be started by an administrator; 0 if it is already active or was ended"
},
{
"name": "enabled_start_notification",
"type": "Bool",
"description": "True, if the group call is scheduled and the current user will receive a notification when the group call will start"
},
{
"name": "is_active",
"type": "Bool",
"description": "True, if the call is active"
},
{
"name": "is_joined",
"type": "Bool",
"description": "True, if the call is joined"
},
{
"name": "need_rejoin",
"type": "Bool",
"description": "True, if user was kicked from the call because of network loss and the call needs to be rejoined"
},
{
"name": "can_be_managed",
"type": "Bool",
"description": "True, if the current user can manage the group call"
},
{
"name": "participant_count",
"type": "int32",
"description": "Number of participants in the group call"
},
{
"name": "loaded_all_participants",
"type": "Bool",
"description": "True, if all group call participants are loaded"
},
{
"name": "recent_speakers",
"type": "vector\u003cgroupCallRecentSpeaker\u003e",
"description": "Recently speaking users in the group call"
},
{
"name": "is_my_video_enabled",
"type": "Bool",
"description": "True, if the current user's video is enabled"
},
{
"name": "is_my_video_paused",
"type": "Bool",
"description": "True, if the current user's video is paused"
},
{
"name": "can_enable_video",
"type": "Bool",
"description": "True, if the current user can broadcast video or share screen"
},
{
"name": "mute_new_participants",
"type": "Bool",
"description": "True, if only group call administrators can unmute new participants"
},
{
"name": "can_toggle_mute_new_participants",
"type": "Bool",
"description": "True, if the current user can enable or disable mute_new_participants setting"
},
{
"name": "record_duration",
"type": "int32",
"description": "Duration of the ongoing group call recording, in seconds; 0 if none. An updateGroupCall update is not triggered when value of this field changes, but the same recording goes on"
},
{
"name": "is_video_recorded",
"type": "Bool",
"description": "True, if a video file is being recorded for the call"
},
{
"name": "duration",
"type": "int32",
"description": "Call duration, in seconds; for ended calls only"
}
]
},
{
"name": "groupCallVideoSourceGroup",
"description": "Describes a group of video synchronization source identifiers",
"class": "GroupCallVideoSourceGroup",
"properties": [
{
"name": "semantics",
"type": "string",
"description": "The semantics of sources, one of \"SIM\" or \"FID\""
},
{
"name": "source_ids",
"type": "vector\u003cint32\u003e",
"description": "The list of synchronization source identifiers"
}
]
},
{
"name": "groupCallParticipantVideoInfo",
"description": "Contains information about a group call participant's video channel",
"class": "GroupCallParticipantVideoInfo",
"properties": [
{
"name": "source_groups",
"type": "vector\u003cgroupCallVideoSourceGroup\u003e",
"description": "List of synchronization source groups of the video"
},
{
"name": "endpoint_id",
"type": "string",
"description": "Video channel endpoint identifier"
},
{
"name": "is_paused",
"type": "Bool",
"description": "True if the video is paused. This flag needs to be ignored, if new video frames are received"
}
]
},
{
"name": "groupCallParticipant",
"description": "Represents a group call participant",
"class": "GroupCallParticipant",
"properties": [
{
"name": "participant_id",
"type": "MessageSender",
"description": "Identifier of the group call participant"
},
{
"name": "audio_source_id",
"type": "int32",
"description": "User's audio channel synchronization source identifier"
},
{
"name": "screen_sharing_audio_source_id",
"type": "int32",
"description": "User's screen sharing audio channel synchronization source identifier"
},
{
"name": "video_info",
"type": "groupCallParticipantVideoInfo",
"description": "Information about user's video channel; may be null if there is no active video"
},
{
"name": "screen_sharing_video_info",
"type": "groupCallParticipantVideoInfo",
"description": "Information about user's screen sharing video channel; may be null if there is no active screen sharing video"
},
{
"name": "bio",
"type": "string",
"description": "The participant user's bio or the participant chat's description"
},
{
"name": "is_current_user",
"type": "Bool",
"description": "True, if the participant is the current user"
},
{
"name": "is_speaking",
"type": "Bool",
"description": "True, if the participant is speaking as set by setGroupCallParticipantIsSpeaking"
},
{
"name": "is_hand_raised",
"type": "Bool",
"description": "True, if the participant hand is raised"
},
{
"name": "can_be_muted_for_all_users",
"type": "Bool",
"description": "True, if the current user can mute the participant for all other group call participants"
},
{
"name": "can_be_unmuted_for_all_users",
"type": "Bool",
"description": "True, if the current user can allow the participant to unmute themselves or unmute the participant (if the participant is the current user)"
},
{
"name": "can_be_muted_for_current_user",
"type": "Bool",
"description": "True, if the current user can mute the participant only for self"
},
{
"name": "can_be_unmuted_for_current_user",
"type": "Bool",
"description": "True, if the current user can unmute the participant for self"
},
{
"name": "is_muted_for_all_users",
"type": "Bool",
"description": "True, if the participant is muted for all users"
},
{
"name": "is_muted_for_current_user",
"type": "Bool",
"description": "True, if the participant is muted for the current user"
},
{
"name": "can_unmute_self",
"type": "Bool",
"description": "True, if the participant is muted for all users, but can unmute themselves"
},
{
"name": "volume_level",
"type": "int32",
"description": "Participant's volume level; 1-20000 in hundreds of percents"
},
{
"name": "order",
"type": "string",
"description": "User's order in the group call participant list. Orders must be compared lexicographically. The bigger is order, the higher is user in the list. If order is empty, the user must be removed from the participant list"
}
]
},
{
"name": "callProblemEcho",
"description": "The user heard their own voice",
"class": "CallProblem",
"properties": []
},
{
"name": "callProblemNoise",
"description": "The user heard background noise",
"class": "CallProblem",
"properties": []
},
{
"name": "callProblemInterruptions",
"description": "The other side kept disappearing",
"class": "CallProblem",
"properties": []
},
{
"name": "callProblemDistortedSpeech",
"description": "The speech was distorted",
"class": "CallProblem",
"properties": []
},
{
"name": "callProblemSilentLocal",
"description": "The user couldn't hear the other side",
"class": "CallProblem",
"properties": []
},
{
"name": "callProblemSilentRemote",
"description": "The other side couldn't hear the user",
"class": "CallProblem",
"properties": []
},
{
"name": "callProblemDropped",
"description": "The call ended unexpectedly",
"class": "CallProblem",
"properties": []
},
{
"name": "callProblemDistortedVideo",
"description": "The video was distorted",
"class": "CallProblem",
"properties": []
},
{
"name": "callProblemPixelatedVideo",
"description": "The video was pixelated",
"class": "CallProblem",
"properties": []
},
{
"name": "call",
"description": "Describes a call",
"class": "Call",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Call identifier, not persistent"
},
{
"name": "user_id",
"type": "int53",
"description": "Peer user identifier"
},
{
"name": "is_outgoing",
"type": "Bool",
"description": "True, if the call is outgoing"
},
{
"name": "is_video",
"type": "Bool",
"description": "True, if the call is a video call"
},
{
"name": "state",
"type": "CallState",
"description": "Call state"
}
]
},
{
"name": "phoneNumberAuthenticationSettings",
"description": "Contains settings for the authentication of the user's phone number",
"class": "PhoneNumberAuthenticationSettings",
"properties": [
{
"name": "allow_flash_call",
"type": "Bool",
"description": "Pass true if the authentication code may be sent via a flash call to the specified phone number"
},
{
"name": "allow_missed_call",
"type": "Bool",
"description": "Pass true if the authentication code may be sent via a missed call to the specified phone number"
},
{
"name": "is_current_phone_number",
"type": "Bool",
"description": "Pass true if the authenticated phone number is used on the current device"
},
{
"name": "allow_sms_retriever_api",
"type": "Bool",
"description": "For official applications only. True, if the application can use Android SMS Retriever API (requires Google Play Services \u003e= 10.2) to automatically receive the authentication code from the SMS. See https://developers.google.com/identity/sms-retriever/ for more details"
},
{
"name": "authentication_tokens",
"type": "vector\u003cstring\u003e",
"description": "List of authentication tokens, received in updateOption(\"authentication_token\") in previously logged out sessions"
}
]
},
{
"name": "animations",
"description": "Represents a list of animations",
"class": "Animations",
"properties": [
{
"name": "animations",
"type": "vector\u003canimation\u003e",
"description": "List of animations"
}
]
},
{
"name": "diceStickersRegular",
"description": "A regular animated sticker",
"class": "DiceStickers",
"properties": [
{
"name": "sticker",
"type": "sticker",
"description": "The animated sticker with the dice animation"
}
]
},
{
"name": "diceStickersSlotMachine",
"description": "Animated stickers to be combined into a slot machine",
"class": "DiceStickers",
"properties": [
{
"name": "background",
"type": "sticker",
"description": "The animated sticker with the slot machine background. The background animation must start playing after all reel animations finish"
},
{
"name": "lever",
"type": "sticker",
"description": "The animated sticker with the lever animation. The lever animation must play once in the initial dice state"
},
{
"name": "left_reel",
"type": "sticker",
"description": "The animated sticker with the left reel"
},
{
"name": "center_reel",
"type": "sticker",
"description": "The animated sticker with the center reel"
},
{
"name": "right_reel",
"type": "sticker",
"description": "The animated sticker with the right reel"
}
]
},
{
"name": "importedContacts",
"description": "Represents the result of an ImportContacts request",
"class": "ImportedContacts",
"properties": [
{
"name": "user_ids",
"type": "vector\u003cint53\u003e",
"description": "User identifiers of the imported contacts in the same order as they were specified in the request; 0 if the contact is not yet a registered user"
},
{
"name": "importer_count",
"type": "vector\u003cint32\u003e",
"description": "The number of users that imported the corresponding contact; 0 for already registered users or if unavailable"
}
]
},
{
"name": "httpUrl",
"description": "Contains an HTTP URL",
"class": "HttpUrl",
"properties": [
{
"name": "url",
"type": "string",
"description": "The URL"
}
]
},
{
"name": "inputInlineQueryResultAnimation",
"description": "Represents a link to an animated GIF or an animated (i.e., without sound) H.264/MPEG-4 AVC video",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "title",
"type": "string",
"description": "Title of the query result"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "URL of the result thumbnail (JPEG, GIF, or MPEG4), if it exists"
},
{
"name": "thumbnail_mime_type",
"type": "string",
"description": "MIME type of the video thumbnail. If non-empty, must be one of \"image/jpeg\", \"image/gif\" and \"video/mp4\""
},
{
"name": "video_url",
"type": "string",
"description": "The URL of the video file (file size must not exceed 1MB)"
},
{
"name": "video_mime_type",
"type": "string",
"description": "MIME type of the video file. Must be one of \"image/gif\" and \"video/mp4\""
},
{
"name": "video_duration",
"type": "int32",
"description": "Duration of the video, in seconds"
},
{
"name": "video_width",
"type": "int32",
"description": "Width of the video"
},
{
"name": "video_height",
"type": "int32",
"description": "Height of the video"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageAnimation, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultArticle",
"description": "Represents a link to an article or web page",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "url",
"type": "string",
"description": "URL of the result, if it exists"
},
{
"name": "hide_url",
"type": "Bool",
"description": "True, if the URL must be not shown"
},
{
"name": "title",
"type": "string",
"description": "Title of the result"
},
{
"name": "description",
"type": "string",
"description": "A short description of the result"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "URL of the result thumbnail, if it exists"
},
{
"name": "thumbnail_width",
"type": "int32",
"description": "Thumbnail width, if known"
},
{
"name": "thumbnail_height",
"type": "int32",
"description": "Thumbnail height, if known"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultAudio",
"description": "Represents a link to an MP3 audio file",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "title",
"type": "string",
"description": "Title of the audio file"
},
{
"name": "performer",
"type": "string",
"description": "Performer of the audio file"
},
{
"name": "audio_url",
"type": "string",
"description": "The URL of the audio file"
},
{
"name": "audio_duration",
"type": "int32",
"description": "Audio file duration, in seconds"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageAudio, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultContact",
"description": "Represents a user contact",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "contact",
"type": "contact",
"description": "User contact"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "URL of the result thumbnail, if it exists"
},
{
"name": "thumbnail_width",
"type": "int32",
"description": "Thumbnail width, if known"
},
{
"name": "thumbnail_height",
"type": "int32",
"description": "Thumbnail height, if known"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultDocument",
"description": "Represents a link to a file",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "title",
"type": "string",
"description": "Title of the resulting file"
},
{
"name": "description",
"type": "string",
"description": "Short description of the result, if known"
},
{
"name": "document_url",
"type": "string",
"description": "URL of the file"
},
{
"name": "mime_type",
"type": "string",
"description": "MIME type of the file content; only \"application/pdf\" and \"application/zip\" are currently allowed"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "The URL of the file thumbnail, if it exists"
},
{
"name": "thumbnail_width",
"type": "int32",
"description": "Width of the thumbnail"
},
{
"name": "thumbnail_height",
"type": "int32",
"description": "Height of the thumbnail"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageDocument, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultGame",
"description": "Represents a game",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "game_short_name",
"type": "string",
"description": "Short name of the game"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
}
]
},
{
"name": "inputInlineQueryResultLocation",
"description": "Represents a point on the map",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "location",
"type": "location",
"description": "Location result"
},
{
"name": "live_period",
"type": "int32",
"description": "Amount of time relative to the message sent time until the location can be updated, in seconds"
},
{
"name": "title",
"type": "string",
"description": "Title of the result"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "URL of the result thumbnail, if it exists"
},
{
"name": "thumbnail_width",
"type": "int32",
"description": "Thumbnail width, if known"
},
{
"name": "thumbnail_height",
"type": "int32",
"description": "Thumbnail height, if known"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultPhoto",
"description": "Represents link to a JPEG image",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "title",
"type": "string",
"description": "Title of the result, if known"
},
{
"name": "description",
"type": "string",
"description": "A short description of the result, if known"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "URL of the photo thumbnail, if it exists"
},
{
"name": "photo_url",
"type": "string",
"description": "The URL of the JPEG photo (photo size must not exceed 5MB)"
},
{
"name": "photo_width",
"type": "int32",
"description": "Width of the photo"
},
{
"name": "photo_height",
"type": "int32",
"description": "Height of the photo"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessagePhoto, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultSticker",
"description": "Represents a link to a WEBP or TGS sticker",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "URL of the sticker thumbnail, if it exists"
},
{
"name": "sticker_url",
"type": "string",
"description": "The URL of the WEBP or TGS sticker (sticker file size must not exceed 5MB)"
},
{
"name": "sticker_width",
"type": "int32",
"description": "Width of the sticker"
},
{
"name": "sticker_height",
"type": "int32",
"description": "Height of the sticker"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageSticker, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultVenue",
"description": "Represents information about a venue",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "venue",
"type": "venue",
"description": "Venue result"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "URL of the result thumbnail, if it exists"
},
{
"name": "thumbnail_width",
"type": "int32",
"description": "Thumbnail width, if known"
},
{
"name": "thumbnail_height",
"type": "int32",
"description": "Thumbnail height, if known"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultVideo",
"description": "Represents a link to a page containing an embedded video player or a video file",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "title",
"type": "string",
"description": "Title of the result"
},
{
"name": "description",
"type": "string",
"description": "A short description of the result, if known"
},
{
"name": "thumbnail_url",
"type": "string",
"description": "The URL of the video thumbnail (JPEG), if it exists"
},
{
"name": "video_url",
"type": "string",
"description": "URL of the embedded video player or video file"
},
{
"name": "mime_type",
"type": "string",
"description": "MIME type of the content of the video URL, only \"text/html\" or \"video/mp4\" are currently supported"
},
{
"name": "video_width",
"type": "int32",
"description": "Width of the video"
},
{
"name": "video_height",
"type": "int32",
"description": "Height of the video"
},
{
"name": "video_duration",
"type": "int32",
"description": "Video duration, in seconds"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageVideo, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inputInlineQueryResultVoiceNote",
"description": "Represents a link to an opus-encoded audio file within an OGG container, single channel audio",
"class": "InputInlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "title",
"type": "string",
"description": "Title of the voice note"
},
{
"name": "voice_note_url",
"type": "string",
"description": "The URL of the voice note file"
},
{
"name": "voice_note_duration",
"type": "int32",
"description": "Duration of the voice note, in seconds"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null"
},
{
"name": "input_message_content",
"type": "InputMessageContent",
"description": "The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageVoiceNote, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact"
}
]
},
{
"name": "inlineQueryResultArticle",
"description": "Represents a link to an article or web page",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "url",
"type": "string",
"description": "URL of the result, if it exists"
},
{
"name": "hide_url",
"type": "Bool",
"description": "True, if the URL must be not shown"
},
{
"name": "title",
"type": "string",
"description": "Title of the result"
},
{
"name": "description",
"type": "string",
"description": "A short description of the result"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Result thumbnail in JPEG format; may be null"
}
]
},
{
"name": "inlineQueryResultContact",
"description": "Represents a user contact",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "contact",
"type": "contact",
"description": "A user contact"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Result thumbnail in JPEG format; may be null"
}
]
},
{
"name": "inlineQueryResultLocation",
"description": "Represents a point on the map",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "location",
"type": "location",
"description": "Location result"
},
{
"name": "title",
"type": "string",
"description": "Title of the result"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Result thumbnail in JPEG format; may be null"
}
]
},
{
"name": "inlineQueryResultVenue",
"description": "Represents information about a venue",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "venue",
"type": "venue",
"description": "Venue result"
},
{
"name": "thumbnail",
"type": "thumbnail",
"description": "Result thumbnail in JPEG format; may be null"
}
]
},
{
"name": "inlineQueryResultGame",
"description": "Represents information about a game",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "game",
"type": "game",
"description": "Game result"
}
]
},
{
"name": "inlineQueryResultAnimation",
"description": "Represents an animation file",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "animation",
"type": "animation",
"description": "Animation file"
},
{
"name": "title",
"type": "string",
"description": "Animation title"
}
]
},
{
"name": "inlineQueryResultAudio",
"description": "Represents an audio file",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "audio",
"type": "audio",
"description": "Audio file"
}
]
},
{
"name": "inlineQueryResultDocument",
"description": "Represents a document",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "document",
"type": "document",
"description": "Document"
},
{
"name": "title",
"type": "string",
"description": "Document title"
},
{
"name": "description",
"type": "string",
"description": "Document description"
}
]
},
{
"name": "inlineQueryResultPhoto",
"description": "Represents a photo",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "photo",
"type": "photo",
"description": "Photo"
},
{
"name": "title",
"type": "string",
"description": "Title of the result, if known"
},
{
"name": "description",
"type": "string",
"description": "A short description of the result, if known"
}
]
},
{
"name": "inlineQueryResultSticker",
"description": "Represents a sticker",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "sticker",
"type": "sticker",
"description": "Sticker"
}
]
},
{
"name": "inlineQueryResultVideo",
"description": "Represents a video",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "video",
"type": "video",
"description": "Video"
},
{
"name": "title",
"type": "string",
"description": "Title of the video"
},
{
"name": "description",
"type": "string",
"description": "Description of the video"
}
]
},
{
"name": "inlineQueryResultVoiceNote",
"description": "Represents a voice note",
"class": "InlineQueryResult",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique identifier of the query result"
},
{
"name": "voice_note",
"type": "voiceNote",
"description": "Voice note"
},
{
"name": "title",
"type": "string",
"description": "Title of the voice note"
}
]
},
{
"name": "inlineQueryResults",
"description": "Represents the results of the inline query. Use sendInlineQueryResultMessage to send the result of the query",
"class": "InlineQueryResults",
"properties": [
{
"name": "inline_query_id",
"type": "int64",
"description": "Unique identifier of the inline query"
},
{
"name": "next_offset",
"type": "string",
"description": "The offset for the next request. If empty, there are no more results"
},
{
"name": "results",
"type": "vector\u003cInlineQueryResult\u003e",
"description": "Results of the query"
},
{
"name": "switch_pm_text",
"type": "string",
"description": "If non-empty, this text must be shown on the button, which opens a private chat with the bot and sends the bot a start message with the switch_pm_parameter"
},
{
"name": "switch_pm_parameter",
"type": "string",
"description": "Parameter for the bot start message"
}
]
},
{
"name": "callbackQueryPayloadData",
"description": "The payload for a general callback button",
"class": "CallbackQueryPayload",
"properties": [
{
"name": "data",
"type": "bytes",
"description": "Data that was attached to the callback button"
}
]
},
{
"name": "callbackQueryPayloadDataWithPassword",
"description": "The payload for a callback button requiring password",
"class": "CallbackQueryPayload",
"properties": [
{
"name": "password",
"type": "string",
"description": "The password for the current user"
},
{
"name": "data",
"type": "bytes",
"description": "Data that was attached to the callback button"
}
]
},
{
"name": "callbackQueryPayloadGame",
"description": "The payload for a game callback button",
"class": "CallbackQueryPayload",
"properties": [
{
"name": "game_short_name",
"type": "string",
"description": "A short name of the game that was attached to the callback button"
}
]
},
{
"name": "callbackQueryAnswer",
"description": "Contains a bot's answer to a callback query",
"class": "CallbackQueryAnswer",
"properties": [
{
"name": "text",
"type": "string",
"description": "Text of the answer"
},
{
"name": "show_alert",
"type": "Bool",
"description": "True, if an alert must be shown to the user instead of a toast notification"
},
{
"name": "url",
"type": "string",
"description": "URL to be opened"
}
]
},
{
"name": "customRequestResult",
"description": "Contains the result of a custom request",
"class": "CustomRequestResult",
"properties": [
{
"name": "result",
"type": "string",
"description": "A JSON-serialized result"
}
]
},
{
"name": "gameHighScore",
"description": "Contains one row of the game high score table",
"class": "GameHighScore",
"properties": [
{
"name": "position",
"type": "int32",
"description": "Position in the high score table"
},
{
"name": "user_id",
"type": "int53",
"description": "User identifier"
},
{
"name": "score",
"type": "int32",
"description": "User score"
}
]
},
{
"name": "gameHighScores",
"description": "Contains a list of game high scores",
"class": "GameHighScores",
"properties": [
{
"name": "scores",
"type": "vector\u003cgameHighScore\u003e",
"description": "A list of game high scores"
}
]
},
{
"name": "chatEventMessageEdited",
"description": "A message was edited",
"class": "ChatEventAction",
"properties": [
{
"name": "old_message",
"type": "message",
"description": "The original message before the edit"
},
{
"name": "new_message",
"type": "message",
"description": "The message after it was edited"
}
]
},
{
"name": "chatEventMessageDeleted",
"description": "A message was deleted",
"class": "ChatEventAction",
"properties": [
{
"name": "message",
"type": "message",
"description": "Deleted message"
}
]
},
{
"name": "chatEventPollStopped",
"description": "A poll in a message was stopped",
"class": "ChatEventAction",
"properties": [
{
"name": "message",
"type": "message",
"description": "The message with the poll"
}
]
},
{
"name": "chatEventMessagePinned",
"description": "A message was pinned",
"class": "ChatEventAction",
"properties": [
{
"name": "message",
"type": "message",
"description": "Pinned message"
}
]
},
{
"name": "chatEventMessageUnpinned",
"description": "A message was unpinned",
"class": "ChatEventAction",
"properties": [
{
"name": "message",
"type": "message",
"description": "Unpinned message"
}
]
},
{
"name": "chatEventMemberJoined",
"description": "A new member joined the chat",
"class": "ChatEventAction",
"properties": []
},
{
"name": "chatEventMemberJoinedByInviteLink",
"description": "A new member joined the chat by an invite link",
"class": "ChatEventAction",
"properties": [
{
"name": "invite_link",
"type": "chatInviteLink",
"description": "Invite link used to join the chat"
}
]
},
{
"name": "chatEventMemberJoinedByRequest",
"description": "A new member was accepted to the chat by an administrator",
"class": "ChatEventAction",
"properties": [
{
"name": "approver_user_id",
"type": "int53",
"description": "User identifier of the chat administrator, approved user join request"
},
{
"name": "invite_link",
"type": "chatInviteLink",
"description": "Invite link used to join the chat; may be null"
}
]
},
{
"name": "chatEventMemberLeft",
"description": "A member left the chat",
"class": "ChatEventAction",
"properties": []
},
{
"name": "chatEventMemberInvited",
"description": "A new chat member was invited",
"class": "ChatEventAction",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "New member user identifier"
},
{
"name": "status",
"type": "ChatMemberStatus",
"description": "New member status"
}
]
},
{
"name": "chatEventMemberPromoted",
"description": "A chat member has gained/lost administrator status, or the list of their administrator privileges has changed",
"class": "ChatEventAction",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "Affected chat member user identifier"
},
{
"name": "old_status",
"type": "ChatMemberStatus",
"description": "Previous status of the chat member"
},
{
"name": "new_status",
"type": "ChatMemberStatus",
"description": "New status of the chat member"
}
]
},
{
"name": "chatEventMemberRestricted",
"description": "A chat member was restricted/unrestricted or banned/unbanned, or the list of their restrictions has changed",
"class": "ChatEventAction",
"properties": [
{
"name": "member_id",
"type": "MessageSender",
"description": "Affected chat member identifier"
},
{
"name": "old_status",
"type": "ChatMemberStatus",
"description": "Previous status of the chat member"
},
{
"name": "new_status",
"type": "ChatMemberStatus",
"description": "New status of the chat member"
}
]
},
{
"name": "chatEventTitleChanged",
"description": "The chat title was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_title",
"type": "string",
"description": "Previous chat title"
},
{
"name": "new_title",
"type": "string",
"description": "New chat title"
}
]
},
{
"name": "chatEventPermissionsChanged",
"description": "The chat permissions was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_permissions",
"type": "chatPermissions",
"description": "Previous chat permissions"
},
{
"name": "new_permissions",
"type": "chatPermissions",
"description": "New chat permissions"
}
]
},
{
"name": "chatEventDescriptionChanged",
"description": "The chat description was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_description",
"type": "string",
"description": "Previous chat description"
},
{
"name": "new_description",
"type": "string",
"description": "New chat description"
}
]
},
{
"name": "chatEventUsernameChanged",
"description": "The chat username was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_username",
"type": "string",
"description": "Previous chat username"
},
{
"name": "new_username",
"type": "string",
"description": "New chat username"
}
]
},
{
"name": "chatEventPhotoChanged",
"description": "The chat photo was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_photo",
"type": "chatPhoto",
"description": "Previous chat photo value; may be null"
},
{
"name": "new_photo",
"type": "chatPhoto",
"description": "New chat photo value; may be null"
}
]
},
{
"name": "chatEventInvitesToggled",
"description": "The can_invite_users permission of a supergroup chat was toggled",
"class": "ChatEventAction",
"properties": [
{
"name": "can_invite_users",
"type": "Bool",
"description": "New value of can_invite_users permission"
}
]
},
{
"name": "chatEventLinkedChatChanged",
"description": "The linked chat of a supergroup was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_linked_chat_id",
"type": "int53",
"description": "Previous supergroup linked chat identifier"
},
{
"name": "new_linked_chat_id",
"type": "int53",
"description": "New supergroup linked chat identifier"
}
]
},
{
"name": "chatEventSlowModeDelayChanged",
"description": "The slow_mode_delay setting of a supergroup was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_slow_mode_delay",
"type": "int32",
"description": "Previous value of slow_mode_delay, in seconds"
},
{
"name": "new_slow_mode_delay",
"type": "int32",
"description": "New value of slow_mode_delay, in seconds"
}
]
},
{
"name": "chatEventMessageTtlSettingChanged",
"description": "The message TTL setting was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_message_ttl_setting",
"type": "int32",
"description": "Previous value of message_ttl_setting"
},
{
"name": "new_message_ttl_setting",
"type": "int32",
"description": "New value of message_ttl_setting"
}
]
},
{
"name": "chatEventSignMessagesToggled",
"description": "The sign_messages setting of a channel was toggled",
"class": "ChatEventAction",
"properties": [
{
"name": "sign_messages",
"type": "Bool",
"description": "New value of sign_messages"
}
]
},
{
"name": "chatEventHasProtectedContentToggled",
"description": "The has_protected_content setting of a channel was toggled",
"class": "ChatEventAction",
"properties": [
{
"name": "has_protected_content",
"type": "Bool",
"description": "New value of has_protected_content"
}
]
},
{
"name": "chatEventStickerSetChanged",
"description": "The supergroup sticker set was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_sticker_set_id",
"type": "int64",
"description": "Previous identifier of the chat sticker set; 0 if none"
},
{
"name": "new_sticker_set_id",
"type": "int64",
"description": "New identifier of the chat sticker set; 0 if none"
}
]
},
{
"name": "chatEventLocationChanged",
"description": "The supergroup location was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "old_location",
"type": "chatLocation",
"description": "Previous location; may be null"
},
{
"name": "new_location",
"type": "chatLocation",
"description": "New location; may be null"
}
]
},
{
"name": "chatEventIsAllHistoryAvailableToggled",
"description": "The is_all_history_available setting of a supergroup was toggled",
"class": "ChatEventAction",
"properties": [
{
"name": "is_all_history_available",
"type": "Bool",
"description": "New value of is_all_history_available"
}
]
},
{
"name": "chatEventInviteLinkEdited",
"description": "A chat invite link was edited",
"class": "ChatEventAction",
"properties": [
{
"name": "old_invite_link",
"type": "chatInviteLink",
"description": "Previous information about the invite link"
},
{
"name": "new_invite_link",
"type": "chatInviteLink",
"description": "New information about the invite link"
}
]
},
{
"name": "chatEventInviteLinkRevoked",
"description": "A chat invite link was revoked",
"class": "ChatEventAction",
"properties": [
{
"name": "invite_link",
"type": "chatInviteLink",
"description": "The invite link"
}
]
},
{
"name": "chatEventInviteLinkDeleted",
"description": "A revoked chat invite link was deleted",
"class": "ChatEventAction",
"properties": [
{
"name": "invite_link",
"type": "chatInviteLink",
"description": "The invite link"
}
]
},
{
"name": "chatEventVideoChatCreated",
"description": "A video chat was created",
"class": "ChatEventAction",
"properties": [
{
"name": "group_call_id",
"type": "int32",
"description": "Identifier of the video chat. The video chat can be received through the method getGroupCall"
}
]
},
{
"name": "chatEventVideoChatDiscarded",
"description": "A video chat was discarded",
"class": "ChatEventAction",
"properties": [
{
"name": "group_call_id",
"type": "int32",
"description": "Identifier of the video chat. The video chat can be received through the method getGroupCall"
}
]
},
{
"name": "chatEventVideoChatParticipantIsMutedToggled",
"description": "A video chat participant was muted or unmuted",
"class": "ChatEventAction",
"properties": [
{
"name": "participant_id",
"type": "MessageSender",
"description": "Identifier of the affected group call participant"
},
{
"name": "is_muted",
"type": "Bool",
"description": "New value of is_muted"
}
]
},
{
"name": "chatEventVideoChatParticipantVolumeLevelChanged",
"description": "A video chat participant volume level was changed",
"class": "ChatEventAction",
"properties": [
{
"name": "participant_id",
"type": "MessageSender",
"description": "Identifier of the affected group call participant"
},
{
"name": "volume_level",
"type": "int32",
"description": "New value of volume_level; 1-20000 in hundreds of percents"
}
]
},
{
"name": "chatEventVideoChatMuteNewParticipantsToggled",
"description": "The mute_new_participants setting of a video chat was toggled",
"class": "ChatEventAction",
"properties": [
{
"name": "mute_new_participants",
"type": "Bool",
"description": "New value of the mute_new_participants setting"
}
]
},
{
"name": "chatEvent",
"description": "Represents a chat event",
"class": "ChatEvent",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Chat event identifier"
},
{
"name": "date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the event happened"
},
{
"name": "user_id",
"type": "int53",
"description": "Identifier of the user who performed the action that triggered the event"
},
{
"name": "action",
"type": "ChatEventAction",
"description": "Action performed by the user"
}
]
},
{
"name": "chatEvents",
"description": "Contains a list of chat events",
"class": "ChatEvents",
"properties": [
{
"name": "events",
"type": "vector\u003cchatEvent\u003e",
"description": "List of events"
}
]
},
{
"name": "chatEventLogFilters",
"description": "Represents a set of filters used to obtain a chat event log",
"class": "ChatEventLogFilters",
"properties": [
{
"name": "message_edits",
"type": "Bool",
"description": "True, if message edits need to be returned"
},
{
"name": "message_deletions",
"type": "Bool",
"description": "True, if message deletions need to be returned"
},
{
"name": "message_pins",
"type": "Bool",
"description": "True, if pin/unpin events need to be returned"
},
{
"name": "member_joins",
"type": "Bool",
"description": "True, if members joining events need to be returned"
},
{
"name": "member_leaves",
"type": "Bool",
"description": "True, if members leaving events need to be returned"
},
{
"name": "member_invites",
"type": "Bool",
"description": "True, if invited member events need to be returned"
},
{
"name": "member_promotions",
"type": "Bool",
"description": "True, if member promotion/demotion events need to be returned"
},
{
"name": "member_restrictions",
"type": "Bool",
"description": "True, if member restricted/unrestricted/banned/unbanned events need to be returned"
},
{
"name": "info_changes",
"type": "Bool",
"description": "True, if changes in chat information need to be returned"
},
{
"name": "setting_changes",
"type": "Bool",
"description": "True, if changes in chat settings need to be returned"
},
{
"name": "invite_link_changes",
"type": "Bool",
"description": "True, if changes to invite links need to be returned"
},
{
"name": "video_chat_changes",
"type": "Bool",
"description": "True, if video chat actions need to be returned"
}
]
},
{
"name": "languagePackStringValueOrdinary",
"description": "An ordinary language pack string",
"class": "LanguagePackStringValue",
"properties": [
{
"name": "value",
"type": "string",
"description": "String value"
}
]
},
{
"name": "languagePackStringValuePluralized",
"description": "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 info",
"class": "LanguagePackStringValue",
"properties": [
{
"name": "zero_value",
"type": "string",
"description": "Value for zero objects"
},
{
"name": "one_value",
"type": "string",
"description": "Value for one object"
},
{
"name": "two_value",
"type": "string",
"description": "Value for two objects"
},
{
"name": "few_value",
"type": "string",
"description": "Value for few objects"
},
{
"name": "many_value",
"type": "string",
"description": "Value for many objects"
},
{
"name": "other_value",
"type": "string",
"description": "Default value"
}
]
},
{
"name": "languagePackStringValueDeleted",
"description": "A deleted language pack string, the value must be taken from the built-in English language pack",
"class": "LanguagePackStringValue",
"properties": []
},
{
"name": "languagePackString",
"description": "Represents one language pack string",
"class": "LanguagePackString",
"properties": [
{
"name": "key",
"type": "string",
"description": "String key"
},
{
"name": "value",
"type": "LanguagePackStringValue",
"description": "String value; pass null if the string needs to be taken from the built-in English language pack"
}
]
},
{
"name": "languagePackStrings",
"description": "Contains a list of language pack strings",
"class": "LanguagePackStrings",
"properties": [
{
"name": "strings",
"type": "vector\u003clanguagePackString\u003e",
"description": "A list of language pack strings"
}
]
},
{
"name": "languagePackInfo",
"description": "Contains information about a language pack",
"class": "LanguagePackInfo",
"properties": [
{
"name": "id",
"type": "string",
"description": "Unique language pack identifier"
},
{
"name": "base_language_pack_id",
"type": "string",
"description": "Identifier of a base language pack; may be empty. If a string is missed in the language pack, then it must be fetched from base language pack. Unsupported in custom language packs"
},
{
"name": "name",
"type": "string",
"description": "Language name"
},
{
"name": "native_name",
"type": "string",
"description": "Name of the language in that language"
},
{
"name": "plural_code",
"type": "string",
"description": "A language code to be used to apply plural forms. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info"
},
{
"name": "is_official",
"type": "Bool",
"description": "True, if the language pack is official"
},
{
"name": "is_rtl",
"type": "Bool",
"description": "True, if the language pack strings are RTL"
},
{
"name": "is_beta",
"type": "Bool",
"description": "True, if the language pack is a beta language pack"
},
{
"name": "is_installed",
"type": "Bool",
"description": "True, if the language pack is installed by the current user"
},
{
"name": "total_string_count",
"type": "int32",
"description": "Total number of non-deleted strings from the language pack"
},
{
"name": "translated_string_count",
"type": "int32",
"description": "Total number of translated strings from the language pack"
},
{
"name": "local_string_count",
"type": "int32",
"description": "Total number of non-deleted strings from the language pack available locally"
},
{
"name": "translation_url",
"type": "string",
"description": "Link to language translation interface; empty for custom local language packs"
}
]
},
{
"name": "localizationTargetInfo",
"description": "Contains information about the current localization target",
"class": "LocalizationTargetInfo",
"properties": [
{
"name": "language_packs",
"type": "vector\u003clanguagePackInfo\u003e",
"description": "List of available language packs for this application"
}
]
},
{
"name": "deviceTokenFirebaseCloudMessaging",
"description": "A token for Firebase Cloud Messaging",
"class": "DeviceToken",
"properties": [
{
"name": "token",
"type": "string",
"description": "Device registration token; may be empty to de-register a device"
},
{
"name": "encrypt",
"type": "Bool",
"description": "True, if push notifications must be additionally encrypted"
}
]
},
{
"name": "deviceTokenApplePush",
"description": "A token for Apple Push Notification service",
"class": "DeviceToken",
"properties": [
{
"name": "device_token",
"type": "string",
"description": "Device token; may be empty to de-register a device"
},
{
"name": "is_app_sandbox",
"type": "Bool",
"description": "True, if App Sandbox is enabled"
}
]
},
{
"name": "deviceTokenApplePushVoIP",
"description": "A token for Apple Push Notification service VoIP notifications",
"class": "DeviceToken",
"properties": [
{
"name": "device_token",
"type": "string",
"description": "Device token; may be empty to de-register a device"
},
{
"name": "is_app_sandbox",
"type": "Bool",
"description": "True, if App Sandbox is enabled"
},
{
"name": "encrypt",
"type": "Bool",
"description": "True, if push notifications must be additionally encrypted"
}
]
},
{
"name": "deviceTokenWindowsPush",
"description": "A token for Windows Push Notification Services",
"class": "DeviceToken",
"properties": [
{
"name": "access_token",
"type": "string",
"description": "The access token that will be used to send notifications; may be empty to de-register a device"
}
]
},
{
"name": "deviceTokenMicrosoftPush",
"description": "A token for Microsoft Push Notification Service",
"class": "DeviceToken",
"properties": [
{
"name": "channel_uri",
"type": "string",
"description": "Push notification channel URI; may be empty to de-register a device"
}
]
},
{
"name": "deviceTokenMicrosoftPushVoIP",
"description": "A token for Microsoft Push Notification Service VoIP channel",
"class": "DeviceToken",
"properties": [
{
"name": "channel_uri",
"type": "string",
"description": "Push notification channel URI; may be empty to de-register a device"
}
]
},
{
"name": "deviceTokenWebPush",
"description": "A token for web Push API",
"class": "DeviceToken",
"properties": [
{
"name": "endpoint",
"type": "string",
"description": "Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device"
},
{
"name": "p256dh_base64url",
"type": "string",
"description": "Base64url-encoded P-256 elliptic curve Diffie-Hellman public key"
},
{
"name": "auth_base64url",
"type": "string",
"description": "Base64url-encoded authentication secret"
}
]
},
{
"name": "deviceTokenSimplePush",
"description": "A token for Simple Push API for Firefox OS",
"class": "DeviceToken",
"properties": [
{
"name": "endpoint",
"type": "string",
"description": "Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device"
}
]
},
{
"name": "deviceTokenUbuntuPush",
"description": "A token for Ubuntu Push Client service",
"class": "DeviceToken",
"properties": [
{
"name": "token",
"type": "string",
"description": "Token; may be empty to de-register a device"
}
]
},
{
"name": "deviceTokenBlackBerryPush",
"description": "A token for BlackBerry Push Service",
"class": "DeviceToken",
"properties": [
{
"name": "token",
"type": "string",
"description": "Token; may be empty to de-register a device"
}
]
},
{
"name": "deviceTokenTizenPush",
"description": "A token for Tizen Push Service",
"class": "DeviceToken",
"properties": [
{
"name": "reg_id",
"type": "string",
"description": "Push service registration identifier; may be empty to de-register a device"
}
]
},
{
"name": "pushReceiverId",
"description": "Contains a globally unique push receiver identifier, which can be used to identify which account has received a push notification",
"class": "PushReceiverId",
"properties": [
{
"name": "id",
"type": "int64",
"description": "The globally unique identifier of push notification subscription"
}
]
},
{
"name": "backgroundFillSolid",
"description": "Describes a solid fill of a background",
"class": "BackgroundFill",
"properties": [
{
"name": "color",
"type": "int32",
"description": "A color of the background in the RGB24 format"
}
]
},
{
"name": "backgroundFillGradient",
"description": "Describes a gradient fill of a background",
"class": "BackgroundFill",
"properties": [
{
"name": "top_color",
"type": "int32",
"description": "A top color of the background in the RGB24 format"
},
{
"name": "bottom_color",
"type": "int32",
"description": "A bottom color of the background in the RGB24 format"
},
{
"name": "rotation_angle",
"type": "int32",
"description": "Clockwise rotation angle of the gradient, in degrees; 0-359. Must be always divisible by 45"
}
]
},
{
"name": "backgroundFillFreeformGradient",
"description": "Describes a freeform gradient fill of a background",
"class": "BackgroundFill",
"properties": [
{
"name": "colors",
"type": "vector\u003cint32\u003e",
"description": "A list of 3 or 4 colors of the freeform gradients in the RGB24 format"
}
]
},
{
"name": "backgroundTypeWallpaper",
"description": "A wallpaper in JPEG format",
"class": "BackgroundType",
"properties": [
{
"name": "is_blurred",
"type": "Bool",
"description": "True, if the wallpaper must be downscaled to fit in 450x450 square and then box-blurred with radius 12"
},
{
"name": "is_moving",
"type": "Bool",
"description": "True, if the background needs to be slightly moved when device is tilted"
}
]
},
{
"name": "backgroundTypePattern",
"description": "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",
"class": "BackgroundType",
"properties": [
{
"name": "fill",
"type": "BackgroundFill",
"description": "Fill of the background"
},
{
"name": "intensity",
"type": "int32",
"description": "Intensity of the pattern when it is shown above the filled background; 0-100."
},
{
"name": "is_inverted",
"type": "Bool",
"description": "True, if the background fill must be applied only to the pattern itself. All other pixels are black in this case. For dark themes only"
},
{
"name": "is_moving",
"type": "Bool",
"description": "True, if the background needs to be slightly moved when device is tilted"
}
]
},
{
"name": "backgroundTypeFill",
"description": "A filled background",
"class": "BackgroundType",
"properties": [
{
"name": "fill",
"type": "BackgroundFill",
"description": "The background fill"
}
]
},
{
"name": "background",
"description": "Describes a chat background",
"class": "Background",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Unique background identifier"
},
{
"name": "is_default",
"type": "Bool",
"description": "True, if this is one of default backgrounds"
},
{
"name": "is_dark",
"type": "Bool",
"description": "True, if the background is dark and is recommended to be used with dark theme"
},
{
"name": "name",
"type": "string",
"description": "Unique background name"
},
{
"name": "document",
"type": "document",
"description": "Document with the background; may be null. Null only for filled backgrounds"
},
{
"name": "type",
"type": "BackgroundType",
"description": "Type of the background"
}
]
},
{
"name": "backgrounds",
"description": "Contains a list of backgrounds",
"class": "Backgrounds",
"properties": [
{
"name": "backgrounds",
"type": "vector\u003cbackground\u003e",
"description": "A list of backgrounds"
}
]
},
{
"name": "inputBackgroundLocal",
"description": "A background from a local file",
"class": "InputBackground",
"properties": [
{
"name": "background",
"type": "InputFile",
"description": "Background file to use. Only inputFileLocal and inputFileGenerated are supported. The file must be in JPEG format for wallpapers and in PNG format for patterns"
}
]
},
{
"name": "inputBackgroundRemote",
"description": "A background from the server",
"class": "InputBackground",
"properties": [
{
"name": "background_id",
"type": "int64",
"description": "The background identifier"
}
]
},
{
"name": "themeSettings",
"description": "Describes theme settings",
"class": "ThemeSettings",
"properties": [
{
"name": "accent_color",
"type": "int32",
"description": "Theme accent color in ARGB format"
},
{
"name": "background",
"type": "background",
"description": "The background to be used in chats; may be null"
},
{
"name": "outgoing_message_fill",
"type": "BackgroundFill",
"description": "The fill to be used as a background for outgoing messages"
},
{
"name": "animate_outgoing_message_fill",
"type": "Bool",
"description": "If true, the freeform gradient fill needs to be animated on every sent message"
},
{
"name": "outgoing_message_accent_color",
"type": "int32",
"description": "Accent color of outgoing messages in ARGB format"
}
]
},
{
"name": "chatTheme",
"description": "Describes a chat theme",
"class": "ChatTheme",
"properties": [
{
"name": "name",
"type": "string",
"description": "Theme name"
},
{
"name": "light_settings",
"type": "themeSettings",
"description": "Theme settings for a light chat theme"
},
{
"name": "dark_settings",
"type": "themeSettings",
"description": "Theme settings for a dark chat theme"
}
]
},
{
"name": "hashtags",
"description": "Contains a list of hashtags",
"class": "Hashtags",
"properties": [
{
"name": "hashtags",
"type": "vector\u003cstring\u003e",
"description": "A list of hashtags"
}
]
},
{
"name": "canTransferOwnershipResultOk",
"description": "The session can be used",
"class": "CanTransferOwnershipResult",
"properties": []
},
{
"name": "canTransferOwnershipResultPasswordNeeded",
"description": "The 2-step verification needs to be enabled first",
"class": "CanTransferOwnershipResult",
"properties": []
},
{
"name": "canTransferOwnershipResultPasswordTooFresh",
"description": "The 2-step verification was enabled recently, user needs to wait",
"class": "CanTransferOwnershipResult",
"properties": [
{
"name": "retry_after",
"type": "int32",
"description": "Time left before the session can be used to transfer ownership of a chat, in seconds"
}
]
},
{
"name": "canTransferOwnershipResultSessionTooFresh",
"description": "The session was created recently, user needs to wait",
"class": "CanTransferOwnershipResult",
"properties": [
{
"name": "retry_after",
"type": "int32",
"description": "Time left before the session can be used to transfer ownership of a chat, in seconds"
}
]
},
{
"name": "checkChatUsernameResultOk",
"description": "The username can be set",
"class": "CheckChatUsernameResult",
"properties": []
},
{
"name": "checkChatUsernameResultUsernameInvalid",
"description": "The username is invalid",
"class": "CheckChatUsernameResult",
"properties": []
},
{
"name": "checkChatUsernameResultUsernameOccupied",
"description": "The username is occupied",
"class": "CheckChatUsernameResult",
"properties": []
},
{
"name": "checkChatUsernameResultPublicChatsTooMuch",
"description": "The user has too much chats with username, one of them must be made private first",
"class": "CheckChatUsernameResult",
"properties": []
},
{
"name": "checkChatUsernameResultPublicGroupsUnavailable",
"description": "The user can't be a member of a public supergroup",
"class": "CheckChatUsernameResult",
"properties": []
},
{
"name": "checkStickerSetNameResultOk",
"description": "The name can be set",
"class": "CheckStickerSetNameResult",
"properties": []
},
{
"name": "checkStickerSetNameResultNameInvalid",
"description": "The name is invalid",
"class": "CheckStickerSetNameResult",
"properties": []
},
{
"name": "checkStickerSetNameResultNameOccupied",
"description": "The name is occupied",
"class": "CheckStickerSetNameResult",
"properties": []
},
{
"name": "resetPasswordResultOk",
"description": "The password was reset",
"class": "ResetPasswordResult",
"properties": []
},
{
"name": "resetPasswordResultPending",
"description": "The password reset request is pending",
"class": "ResetPasswordResult",
"properties": [
{
"name": "pending_reset_date",
"type": "int32",
"description": "Point in time (Unix timestamp) after which the password can be reset immediately using resetPassword"
}
]
},
{
"name": "resetPasswordResultDeclined",
"description": "The password reset request was declined",
"class": "ResetPasswordResult",
"properties": [
{
"name": "retry_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the password reset can be retried"
}
]
},
{
"name": "messageFileTypePrivate",
"description": "The messages was exported from a private chat",
"class": "MessageFileType",
"properties": [
{
"name": "name",
"type": "string",
"description": "Name of the other party; may be empty if unrecognized"
}
]
},
{
"name": "messageFileTypeGroup",
"description": "The messages was exported from a group chat",
"class": "MessageFileType",
"properties": [
{
"name": "title",
"type": "string",
"description": "Title of the group chat; may be empty if unrecognized"
}
]
},
{
"name": "messageFileTypeUnknown",
"description": "The messages was exported from a chat of unknown type",
"class": "MessageFileType",
"properties": []
},
{
"name": "pushMessageContentHidden",
"description": "A general message with hidden content",
"class": "PushMessageContent",
"properties": [
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentAnimation",
"description": "An animation message (GIF-style).",
"class": "PushMessageContent",
"properties": [
{
"name": "animation",
"type": "animation",
"description": "Message content; may be null"
},
{
"name": "caption",
"type": "string",
"description": "Animation caption"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentAudio",
"description": "An audio message",
"class": "PushMessageContent",
"properties": [
{
"name": "audio",
"type": "audio",
"description": "Message content; may be null"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentContact",
"description": "A message with a user contact",
"class": "PushMessageContent",
"properties": [
{
"name": "name",
"type": "string",
"description": "Contact's name"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentContactRegistered",
"description": "A contact has registered with Telegram",
"class": "PushMessageContent",
"properties": []
},
{
"name": "pushMessageContentDocument",
"description": "A document message (a general file)",
"class": "PushMessageContent",
"properties": [
{
"name": "document",
"type": "document",
"description": "Message content; may be null"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentGame",
"description": "A message with a game",
"class": "PushMessageContent",
"properties": [
{
"name": "title",
"type": "string",
"description": "Game title, empty for pinned game message"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentGameScore",
"description": "A new high score was achieved in a game",
"class": "PushMessageContent",
"properties": [
{
"name": "title",
"type": "string",
"description": "Game title, empty for pinned message"
},
{
"name": "score",
"type": "int32",
"description": "New score, 0 for pinned message"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentInvoice",
"description": "A message with an invoice from a bot",
"class": "PushMessageContent",
"properties": [
{
"name": "price",
"type": "string",
"description": "Product price"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentLocation",
"description": "A message with a location",
"class": "PushMessageContent",
"properties": [
{
"name": "is_live",
"type": "Bool",
"description": "True, if the location is live"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentPhoto",
"description": "A photo message",
"class": "PushMessageContent",
"properties": [
{
"name": "photo",
"type": "photo",
"description": "Message content; may be null"
},
{
"name": "caption",
"type": "string",
"description": "Photo caption"
},
{
"name": "is_secret",
"type": "Bool",
"description": "True, if the photo is secret"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentPoll",
"description": "A message with a poll",
"class": "PushMessageContent",
"properties": [
{
"name": "question",
"type": "string",
"description": "Poll question"
},
{
"name": "is_regular",
"type": "Bool",
"description": "True, if the poll is regular and not in quiz mode"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentScreenshotTaken",
"description": "A screenshot of a message in the chat has been taken",
"class": "PushMessageContent",
"properties": []
},
{
"name": "pushMessageContentSticker",
"description": "A message with a sticker",
"class": "PushMessageContent",
"properties": [
{
"name": "sticker",
"type": "sticker",
"description": "Message content; may be null"
},
{
"name": "emoji",
"type": "string",
"description": "Emoji corresponding to the sticker; may be empty"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentText",
"description": "A text message",
"class": "PushMessageContent",
"properties": [
{
"name": "text",
"type": "string",
"description": "Message text"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentVideo",
"description": "A video message",
"class": "PushMessageContent",
"properties": [
{
"name": "video",
"type": "video",
"description": "Message content; may be null"
},
{
"name": "caption",
"type": "string",
"description": "Video caption"
},
{
"name": "is_secret",
"type": "Bool",
"description": "True, if the video is secret"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentVideoNote",
"description": "A video note message",
"class": "PushMessageContent",
"properties": [
{
"name": "video_note",
"type": "videoNote",
"description": "Message content; may be null"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentVoiceNote",
"description": "A voice note message",
"class": "PushMessageContent",
"properties": [
{
"name": "voice_note",
"type": "voiceNote",
"description": "Message content; may be null"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is a pinned message with the specified content"
}
]
},
{
"name": "pushMessageContentBasicGroupChatCreate",
"description": "A newly created basic group",
"class": "PushMessageContent",
"properties": []
},
{
"name": "pushMessageContentChatAddMembers",
"description": "New chat members were invited to a group",
"class": "PushMessageContent",
"properties": [
{
"name": "member_name",
"type": "string",
"description": "Name of the added member"
},
{
"name": "is_current_user",
"type": "Bool",
"description": "True, if the current user was added to the group"
},
{
"name": "is_returned",
"type": "Bool",
"description": "True, if the user has returned to the group themselves"
}
]
},
{
"name": "pushMessageContentChatChangePhoto",
"description": "A chat photo was edited",
"class": "PushMessageContent",
"properties": []
},
{
"name": "pushMessageContentChatChangeTitle",
"description": "A chat title was edited",
"class": "PushMessageContent",
"properties": [
{
"name": "title",
"type": "string",
"description": "New chat title"
}
]
},
{
"name": "pushMessageContentChatSetTheme",
"description": "A chat theme was edited",
"class": "PushMessageContent",
"properties": [
{
"name": "theme_name",
"type": "string",
"description": "If non-empty, name of a new theme, set for the chat. Otherwise chat theme was reset to the default one"
}
]
},
{
"name": "pushMessageContentChatDeleteMember",
"description": "A chat member was deleted",
"class": "PushMessageContent",
"properties": [
{
"name": "member_name",
"type": "string",
"description": "Name of the deleted member"
},
{
"name": "is_current_user",
"type": "Bool",
"description": "True, if the current user was deleted from the group"
},
{
"name": "is_left",
"type": "Bool",
"description": "True, if the user has left the group themselves"
}
]
},
{
"name": "pushMessageContentChatJoinByLink",
"description": "A new member joined the chat by invite link",
"class": "PushMessageContent",
"properties": []
},
{
"name": "pushMessageContentChatJoinByRequest",
"description": "A new member was accepted to the chat by an administrator",
"class": "PushMessageContent",
"properties": []
},
{
"name": "pushMessageContentMessageForwards",
"description": "A forwarded messages",
"class": "PushMessageContent",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Number of forwarded messages"
}
]
},
{
"name": "pushMessageContentMediaAlbum",
"description": "A media album",
"class": "PushMessageContent",
"properties": [
{
"name": "total_count",
"type": "int32",
"description": "Number of messages in the album"
},
{
"name": "has_photos",
"type": "Bool",
"description": "True, if the album has at least one photo"
},
{
"name": "has_videos",
"type": "Bool",
"description": "True, if the album has at least one video"
},
{
"name": "has_audios",
"type": "Bool",
"description": "True, if the album has at least one audio file"
},
{
"name": "has_documents",
"type": "Bool",
"description": "True, if the album has at least one document"
}
]
},
{
"name": "notificationTypeNewMessage",
"description": "New message was received",
"class": "NotificationType",
"properties": [
{
"name": "message",
"type": "message",
"description": "The message"
}
]
},
{
"name": "notificationTypeNewSecretChat",
"description": "New secret chat was created",
"class": "NotificationType",
"properties": []
},
{
"name": "notificationTypeNewCall",
"description": "New call was received",
"class": "NotificationType",
"properties": [
{
"name": "call_id",
"type": "int32",
"description": "Call identifier"
}
]
},
{
"name": "notificationTypeNewPushMessage",
"description": "New message was received through a push notification",
"class": "NotificationType",
"properties": [
{
"name": "message_id",
"type": "int53",
"description": "The message identifier. The message will not be available in the chat history, but the ID can be used in viewMessages, or as reply_to_message_id"
},
{
"name": "sender_id",
"type": "MessageSender",
"description": "Identifier of the sender of the message. Corresponding user or chat may be inaccessible"
},
{
"name": "sender_name",
"type": "string",
"description": "Name of the sender"
},
{
"name": "is_outgoing",
"type": "Bool",
"description": "True, if the message is outgoing"
},
{
"name": "content",
"type": "PushMessageContent",
"description": "Push message content"
}
]
},
{
"name": "notificationGroupTypeMessages",
"description": "A group containing notifications of type notificationTypeNewMessage and notificationTypeNewPushMessage with ordinary unread messages",
"class": "NotificationGroupType",
"properties": []
},
{
"name": "notificationGroupTypeMentions",
"description": "A group containing notifications of type notificationTypeNewMessage and notificationTypeNewPushMessage with unread mentions of the current user, replies to their messages, or a pinned message",
"class": "NotificationGroupType",
"properties": []
},
{
"name": "notificationGroupTypeSecretChat",
"description": "A group containing a notification of type notificationTypeNewSecretChat",
"class": "NotificationGroupType",
"properties": []
},
{
"name": "notificationGroupTypeCalls",
"description": "A group containing notifications of type notificationTypeNewCall",
"class": "NotificationGroupType",
"properties": []
},
{
"name": "notification",
"description": "Contains information about a notification",
"class": "Notification",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Unique persistent identifier of this notification"
},
{
"name": "date",
"type": "int32",
"description": "Notification date"
},
{
"name": "is_silent",
"type": "Bool",
"description": "True, if the notification was initially silent"
},
{
"name": "type",
"type": "NotificationType",
"description": "Notification type"
}
]
},
{
"name": "notificationGroup",
"description": "Describes a group of notifications",
"class": "NotificationGroup",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Unique persistent auto-incremented from 1 identifier of the notification group"
},
{
"name": "type",
"type": "NotificationGroupType",
"description": "Type of the group"
},
{
"name": "chat_id",
"type": "int53",
"description": "Identifier of a chat to which all notifications in the group belong"
},
{
"name": "total_count",
"type": "int32",
"description": "Total number of active notifications in the group"
},
{
"name": "notifications",
"type": "vector\u003cnotification\u003e",
"description": "The list of active notifications"
}
]
},
{
"name": "optionValueBoolean",
"description": "Represents a boolean option",
"class": "OptionValue",
"properties": [
{
"name": "value",
"type": "Bool",
"description": "The value of the option"
}
]
},
{
"name": "optionValueEmpty",
"description": "Represents an unknown option or an option which has a default value",
"class": "OptionValue",
"properties": []
},
{
"name": "optionValueInteger",
"description": "Represents an integer option",
"class": "OptionValue",
"properties": [
{
"name": "value",
"type": "int64",
"description": "The value of the option"
}
]
},
{
"name": "optionValueString",
"description": "Represents a string option",
"class": "OptionValue",
"properties": [
{
"name": "value",
"type": "string",
"description": "The value of the option"
}
]
},
{
"name": "jsonObjectMember",
"description": "Represents one member of a JSON object",
"class": "JsonObjectMember",
"properties": [
{
"name": "key",
"type": "string",
"description": "Member's key"
},
{
"name": "value",
"type": "JsonValue",
"description": "Member's value"
}
]
},
{
"name": "jsonValueNull",
"description": "Represents a null JSON value",
"class": "JsonValue",
"properties": []
},
{
"name": "jsonValueBoolean",
"description": "Represents a boolean JSON value",
"class": "JsonValue",
"properties": [
{
"name": "value",
"type": "Bool",
"description": "The value"
}
]
},
{
"name": "jsonValueNumber",
"description": "Represents a numeric JSON value",
"class": "JsonValue",
"properties": [
{
"name": "value",
"type": "double",
"description": "The value"
}
]
},
{
"name": "jsonValueString",
"description": "Represents a string JSON value",
"class": "JsonValue",
"properties": [
{
"name": "value",
"type": "string",
"description": "The value"
}
]
},
{
"name": "jsonValueArray",
"description": "Represents a JSON array",
"class": "JsonValue",
"properties": [
{
"name": "values",
"type": "vector\u003cJsonValue\u003e",
"description": "The list of array elements"
}
]
},
{
"name": "jsonValueObject",
"description": "Represents a JSON object",
"class": "JsonValue",
"properties": [
{
"name": "members",
"type": "vector\u003cjsonObjectMember\u003e",
"description": "The list of object members"
}
]
},
{
"name": "userPrivacySettingRuleAllowAll",
"description": "A rule to allow all users to do something",
"class": "UserPrivacySettingRule",
"properties": []
},
{
"name": "userPrivacySettingRuleAllowContacts",
"description": "A rule to allow all of a user's contacts to do something",
"class": "UserPrivacySettingRule",
"properties": []
},
{
"name": "userPrivacySettingRuleAllowUsers",
"description": "A rule to allow certain specified users to do something",
"class": "UserPrivacySettingRule",
"properties": [
{
"name": "user_ids",
"type": "vector\u003cint53\u003e",
"description": "The user identifiers, total number of users in all rules must not exceed 1000"
}
]
},
{
"name": "userPrivacySettingRuleAllowChatMembers",
"description": "A rule to allow all members of certain specified basic groups and supergroups to doing something",
"class": "UserPrivacySettingRule",
"properties": [
{
"name": "chat_ids",
"type": "vector\u003cint53\u003e",
"description": "The chat identifiers, total number of chats in all rules must not exceed 20"
}
]
},
{
"name": "userPrivacySettingRuleRestrictAll",
"description": "A rule to restrict all users from doing something",
"class": "UserPrivacySettingRule",
"properties": []
},
{
"name": "userPrivacySettingRuleRestrictContacts",
"description": "A rule to restrict all contacts of a user from doing something",
"class": "UserPrivacySettingRule",
"properties": []
},
{
"name": "userPrivacySettingRuleRestrictUsers",
"description": "A rule to restrict all specified users from doing something",
"class": "UserPrivacySettingRule",
"properties": [
{
"name": "user_ids",
"type": "vector\u003cint53\u003e",
"description": "The user identifiers, total number of users in all rules must not exceed 1000"
}
]
},
{
"name": "userPrivacySettingRuleRestrictChatMembers",
"description": "A rule to restrict all members of specified basic groups and supergroups from doing something",
"class": "UserPrivacySettingRule",
"properties": [
{
"name": "chat_ids",
"type": "vector\u003cint53\u003e",
"description": "The chat identifiers, total number of chats in all rules must not exceed 20"
}
]
},
{
"name": "userPrivacySettingRules",
"description": "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",
"class": "UserPrivacySettingRules",
"properties": [
{
"name": "rules",
"type": "vector\u003cUserPrivacySettingRule\u003e",
"description": "A list of rules"
}
]
},
{
"name": "userPrivacySettingShowStatus",
"description": "A privacy setting for managing whether the user's online status is visible",
"class": "UserPrivacySetting",
"properties": []
},
{
"name": "userPrivacySettingShowProfilePhoto",
"description": "A privacy setting for managing whether the user's profile photo is visible",
"class": "UserPrivacySetting",
"properties": []
},
{
"name": "userPrivacySettingShowLinkInForwardedMessages",
"description": "A privacy setting for managing whether a link to the user's account is included in forwarded messages",
"class": "UserPrivacySetting",
"properties": []
},
{
"name": "userPrivacySettingShowPhoneNumber",
"description": "A privacy setting for managing whether the user's phone number is visible",
"class": "UserPrivacySetting",
"properties": []
},
{
"name": "userPrivacySettingAllowChatInvites",
"description": "A privacy setting for managing whether the user can be invited to chats",
"class": "UserPrivacySetting",
"properties": []
},
{
"name": "userPrivacySettingAllowCalls",
"description": "A privacy setting for managing whether the user can be called",
"class": "UserPrivacySetting",
"properties": []
},
{
"name": "userPrivacySettingAllowPeerToPeerCalls",
"description": "A privacy setting for managing whether peer-to-peer connections can be used for calls",
"class": "UserPrivacySetting",
"properties": []
},
{
"name": "userPrivacySettingAllowFindingByPhoneNumber",
"description": "A privacy setting for managing whether the user can be found by their phone number. Checked only if the phone number is not known to the other user. Can be set only to \"Allow contacts\" or \"Allow all\"",
"class": "UserPrivacySetting",
"properties": []
},
{
"name": "accountTtl",
"description": "Contains information about the period of inactivity after which the current user's account will automatically be deleted",
"class": "AccountTtl",
"properties": [
{
"name": "days",
"type": "int32",
"description": "Number of days of inactivity before the account will be flagged for deletion; 30-366 days"
}
]
},
{
"name": "session",
"description": "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",
"class": "Session",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Session identifier"
},
{
"name": "is_current",
"type": "Bool",
"description": "True, if this session is the current session"
},
{
"name": "is_password_pending",
"type": "Bool",
"description": "True, if a password is needed to complete authorization of the session"
},
{
"name": "can_accept_secret_chats",
"type": "Bool",
"description": "True, if incoming secret chats can be accepted by the session"
},
{
"name": "can_accept_calls",
"type": "Bool",
"description": "True, if incoming calls can be accepted by the session"
},
{
"name": "api_id",
"type": "int32",
"description": "Telegram API identifier, as provided by the application"
},
{
"name": "application_name",
"type": "string",
"description": "Name of the application, as provided by the application"
},
{
"name": "application_version",
"type": "string",
"description": "The version of the application, as provided by the application"
},
{
"name": "is_official_application",
"type": "Bool",
"description": "True, if the application is an official application or uses the api_id of an official application"
},
{
"name": "device_model",
"type": "string",
"description": "Model of the device the application has been run or is running on, as provided by the application"
},
{
"name": "platform",
"type": "string",
"description": "Operating system the application has been run or is running on, as provided by the application"
},
{
"name": "system_version",
"type": "string",
"description": "Version of the operating system the application has been run or is running on, as provided by the application"
},
{
"name": "log_in_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the user has logged in"
},
{
"name": "last_active_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the session was last used"
},
{
"name": "ip",
"type": "string",
"description": "IP address from which the session was created, in human-readable format"
},
{
"name": "country",
"type": "string",
"description": "A two-letter country code for the country from which the session was created, based on the IP address"
},
{
"name": "region",
"type": "string",
"description": "Region code from which the session was created, based on the IP address"
}
]
},
{
"name": "sessions",
"description": "Contains a list of sessions",
"class": "Sessions",
"properties": [
{
"name": "sessions",
"type": "vector\u003csession\u003e",
"description": "List of sessions"
},
{
"name": "inactive_session_ttl_days",
"type": "int32",
"description": "Number of days of inactivity before sessions will automatically be terminated; 1-366 days"
}
]
},
{
"name": "connectedWebsite",
"description": "Contains information about one website the current user is logged in with Telegram",
"class": "ConnectedWebsite",
"properties": [
{
"name": "id",
"type": "int64",
"description": "Website identifier"
},
{
"name": "domain_name",
"type": "string",
"description": "The domain name of the website"
},
{
"name": "bot_user_id",
"type": "int53",
"description": "User identifier of a bot linked with the website"
},
{
"name": "browser",
"type": "string",
"description": "The version of a browser used to log in"
},
{
"name": "platform",
"type": "string",
"description": "Operating system the browser is running on"
},
{
"name": "log_in_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the user was logged in"
},
{
"name": "last_active_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when obtained authorization was last used"
},
{
"name": "ip",
"type": "string",
"description": "IP address from which the user was logged in, in human-readable format"
},
{
"name": "location",
"type": "string",
"description": "Human-readable description of a country and a region, from which the user was logged in, based on the IP address"
}
]
},
{
"name": "connectedWebsites",
"description": "Contains a list of websites the current user is logged in with Telegram",
"class": "ConnectedWebsites",
"properties": [
{
"name": "websites",
"type": "vector\u003cconnectedWebsite\u003e",
"description": "List of connected websites"
}
]
},
{
"name": "chatReportReasonSpam",
"description": "The chat contains spam messages",
"class": "ChatReportReason",
"properties": []
},
{
"name": "chatReportReasonViolence",
"description": "The chat promotes violence",
"class": "ChatReportReason",
"properties": []
},
{
"name": "chatReportReasonPornography",
"description": "The chat contains pornographic messages",
"class": "ChatReportReason",
"properties": []
},
{
"name": "chatReportReasonChildAbuse",
"description": "The chat has child abuse related content",
"class": "ChatReportReason",
"properties": []
},
{
"name": "chatReportReasonCopyright",
"description": "The chat contains copyrighted content",
"class": "ChatReportReason",
"properties": []
},
{
"name": "chatReportReasonUnrelatedLocation",
"description": "The location-based chat is unrelated to its stated location",
"class": "ChatReportReason",
"properties": []
},
{
"name": "chatReportReasonFake",
"description": "The chat represents a fake account",
"class": "ChatReportReason",
"properties": []
},
{
"name": "chatReportReasonCustom",
"description": "A custom reason provided by the user",
"class": "ChatReportReason",
"properties": []
},
{
"name": "internalLinkTypeActiveSessions",
"description": "The link is a link to the active sessions section of the app. Use getActiveSessions to handle the link",
"class": "InternalLinkType",
"properties": []
},
{
"name": "internalLinkTypeAuthenticationCode",
"description": "The link contains an authentication code. Call checkAuthenticationCode with the code if the current authorization state is authorizationStateWaitCode",
"class": "InternalLinkType",
"properties": [
{
"name": "code",
"type": "string",
"description": "The authentication code"
}
]
},
{
"name": "internalLinkTypeBackground",
"description": "The link is a link to a background. Call searchBackground with the given background name to process the link",
"class": "InternalLinkType",
"properties": [
{
"name": "background_name",
"type": "string",
"description": "Name of the background"
}
]
},
{
"name": "internalLinkTypeBotStart",
"description": "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",
"class": "InternalLinkType",
"properties": [
{
"name": "bot_username",
"type": "string",
"description": "Username of the bot"
},
{
"name": "start_parameter",
"type": "string",
"description": "The parameter to be passed to sendBotStartMessage"
}
]
},
{
"name": "internalLinkTypeBotStartInGroup",
"description": "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 group to add the bot to, and then call sendBotStartMessage with the given start parameter and the chosen group chat. Bots can be added to a public group only by administrators of the group",
"class": "InternalLinkType",
"properties": [
{
"name": "bot_username",
"type": "string",
"description": "Username of the bot"
},
{
"name": "start_parameter",
"type": "string",
"description": "The parameter to be passed to sendBotStartMessage"
}
]
},
{
"name": "internalLinkTypeChangePhoneNumber",
"description": "The link is a link to the change phone number section of the app",
"class": "InternalLinkType",
"properties": []
},
{
"name": "internalLinkTypeChatInvite",
"description": "The link is a chat invite link. Call checkChatInviteLink with the given invite link to process the link",
"class": "InternalLinkType",
"properties": [
{
"name": "invite_link",
"type": "string",
"description": "Internal representation of the invite link"
}
]
},
{
"name": "internalLinkTypeFilterSettings",
"description": "The link is a link to the filter settings section of the app",
"class": "InternalLinkType",
"properties": []
},
{
"name": "internalLinkTypeGame",
"description": "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",
"class": "InternalLinkType",
"properties": [
{
"name": "bot_username",
"type": "string",
"description": "Username of the bot that owns the game"
},
{
"name": "game_short_name",
"type": "string",
"description": "Short name of the game"
}
]
},
{
"name": "internalLinkTypeLanguagePack",
"description": "The link is a link to a language pack. Call getLanguagePackInfo with the given language pack identifier to process the link",
"class": "InternalLinkType",
"properties": [
{
"name": "language_pack_id",
"type": "string",
"description": "Language pack identifier"
}
]
},
{
"name": "internalLinkTypeMessage",
"description": "The link is a link to a Telegram message. Call getMessageLinkInfo with the given URL to process the link",
"class": "InternalLinkType",
"properties": [
{
"name": "url",
"type": "string",
"description": "URL to be passed to getMessageLinkInfo"
}
]
},
{
"name": "internalLinkTypeMessageDraft",
"description": "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",
"class": "InternalLinkType",
"properties": [
{
"name": "text",
"type": "formattedText",
"description": "Message draft text"
},
{
"name": "contains_link",
"type": "Bool",
"description": "True, if the first line of the text contains a link. If true, the input field needs to be focused and the text after the link must be selected"
}
]
},
{
"name": "internalLinkTypePassportDataRequest",
"description": "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 app, otherwise ignore it",
"class": "InternalLinkType",
"properties": [
{
"name": "bot_user_id",
"type": "int53",
"description": "User identifier of the service's bot"
},
{
"name": "scope",
"type": "string",
"description": "Telegram Passport element types requested by the service"
},
{
"name": "public_key",
"type": "string",
"description": "Service's public key"
},
{
"name": "nonce",
"type": "string",
"description": "Unique request identifier provided by the service"
},
{
"name": "callback_url",
"type": "string",
"description": "An HTTP URL to open once the request is finished or canceled with the parameter tg_passport=success or tg_passport=cancel respectively. If empty, then the link tgbot{bot_user_id}://passport/success or tgbot{bot_user_id}://passport/cancel needs to be opened instead"
}
]
},
{
"name": "internalLinkTypePhoneNumberConfirmation",
"description": "The link can be used to confirm ownership of a phone number to prevent account deletion. Call sendPhoneNumberConfirmationCode with the given hash and phone number to process the link",
"class": "InternalLinkType",
"properties": [
{
"name": "hash",
"type": "string",
"description": "Hash value from the link"
},
{
"name": "phone_number",
"type": "string",
"description": "Phone number value from the link"
}
]
},
{
"name": "internalLinkTypeProxy",
"description": "The link is a link to a proxy. Call addProxy with the given parameters to process the link and add the proxy",
"class": "InternalLinkType",
"properties": [
{
"name": "server",
"type": "string",
"description": "Proxy server IP address"
},
{
"name": "port",
"type": "int32",
"description": "Proxy server port"
},
{
"name": "type",
"type": "ProxyType",
"description": "Type of the proxy"
}
]
},
{
"name": "internalLinkTypePublicChat",
"description": "The link is a link to a chat by its username. Call searchPublicChat with the given chat username to process the link",
"class": "InternalLinkType",
"properties": [
{
"name": "chat_username",
"type": "string",
"description": "Username of the chat"
}
]
},
{
"name": "internalLinkTypeQrCodeAuthentication",
"description": "The link can be used to login the current user on another device, but it must be scanned from QR-code using in-app camera. An alert similar to \"This code can be used to allow someone to log in to your Telegram account. To confirm Telegram login, please go to Settings \u003e Devices \u003e Scan QR and scan the code\" needs to be shown",
"class": "InternalLinkType",
"properties": []
},
{
"name": "internalLinkTypeSettings",
"description": "The link is a link to app settings",
"class": "InternalLinkType",
"properties": []
},
{
"name": "internalLinkTypeStickerSet",
"description": "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",
"class": "InternalLinkType",
"properties": [
{
"name": "sticker_set_name",
"type": "string",
"description": "Name of the sticker set"
}
]
},
{
"name": "internalLinkTypeTheme",
"description": "The link is a link to a theme. TDLib has no theme support yet",
"class": "InternalLinkType",
"properties": [
{
"name": "theme_name",
"type": "string",
"description": "Name of the theme"
}
]
},
{
"name": "internalLinkTypeThemeSettings",
"description": "The link is a link to the theme settings section of the app",
"class": "InternalLinkType",
"properties": []
},
{
"name": "internalLinkTypeUnknownDeepLink",
"description": "The link is an unknown tg: link. Call getDeepLinkInfo to process the link",
"class": "InternalLinkType",
"properties": [
{
"name": "link",
"type": "string",
"description": "Link to be passed to getDeepLinkInfo"
}
]
},
{
"name": "internalLinkTypeUnsupportedProxy",
"description": "The link is a link to an unsupported proxy. An alert can be shown to the user",
"class": "InternalLinkType",
"properties": []
},
{
"name": "internalLinkTypeVideoChat",
"description": "The link is a link to a video chat. Call searchPublicChat with the given chat username, and then joinGoupCall with the given invite hash to process the link",
"class": "InternalLinkType",
"properties": [
{
"name": "chat_username",
"type": "string",
"description": "Username of the chat with the video chat"
},
{
"name": "invite_hash",
"type": "string",
"description": "If non-empty, invite hash to be used to join the video chat without being muted by administrators"
},
{
"name": "is_live_stream",
"type": "Bool",
"description": "True, if the video chat is expected to be a live stream in a channel or a broadcast group"
}
]
},
{
"name": "messageLink",
"description": "Contains an HTTPS link to a message in a supergroup or channel",
"class": "MessageLink",
"properties": [
{
"name": "link",
"type": "string",
"description": "Message link"
},
{
"name": "is_public",
"type": "Bool",
"description": "True, if the link will work for non-members of the chat"
}
]
},
{
"name": "messageLinkInfo",
"description": "Contains information about a link to a message in a chat",
"class": "MessageLinkInfo",
"properties": [
{
"name": "is_public",
"type": "Bool",
"description": "True, if the link is a public link for a message in a chat"
},
{
"name": "chat_id",
"type": "int53",
"description": "If found, identifier of the chat to which the message belongs, 0 otherwise"
},
{
"name": "message",
"type": "message",
"description": "If found, the linked message; may be null"
},
{
"name": "media_timestamp",
"type": "int32",
"description": "Timestamp from which the video/audio/video note/voice note playing must start, in seconds; 0 if not specified. The media can be in the message content or in its web page preview"
},
{
"name": "for_album",
"type": "Bool",
"description": "True, if the whole media album to which the message belongs is linked"
},
{
"name": "for_comment",
"type": "Bool",
"description": "True, if the message is linked as a channel post comment or from a message thread"
}
]
},
{
"name": "filePart",
"description": "Contains a part of a file",
"class": "FilePart",
"properties": [
{
"name": "data",
"type": "bytes",
"description": "File bytes"
}
]
},
{
"name": "fileTypeNone",
"description": "The data is not a file",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeAnimation",
"description": "The file is an animation",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeAudio",
"description": "The file is an audio file",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeDocument",
"description": "The file is a document",
"class": "FileType",
"properties": []
},
{
"name": "fileTypePhoto",
"description": "The file is a photo",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeProfilePhoto",
"description": "The file is a profile photo",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeSecret",
"description": "The file was sent to a secret chat (the file type is not known to the server)",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeSecretThumbnail",
"description": "The file is a thumbnail of a file from a secret chat",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeSecure",
"description": "The file is a file from Secure storage used for storing Telegram Passport files",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeSticker",
"description": "The file is a sticker",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeThumbnail",
"description": "The file is a thumbnail of another file",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeUnknown",
"description": "The file type is not yet known",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeVideo",
"description": "The file is a video",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeVideoNote",
"description": "The file is a video note",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeVoiceNote",
"description": "The file is a voice note",
"class": "FileType",
"properties": []
},
{
"name": "fileTypeWallpaper",
"description": "The file is a wallpaper or a background pattern",
"class": "FileType",
"properties": []
},
{
"name": "storageStatisticsByFileType",
"description": "Contains the storage usage statistics for a specific file type",
"class": "StorageStatisticsByFileType",
"properties": [
{
"name": "file_type",
"type": "FileType",
"description": "File type"
},
{
"name": "size",
"type": "int53",
"description": "Total size of the files, in bytes"
},
{
"name": "count",
"type": "int32",
"description": "Total number of files"
}
]
},
{
"name": "storageStatisticsByChat",
"description": "Contains the storage usage statistics for a specific chat",
"class": "StorageStatisticsByChat",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier; 0 if none"
},
{
"name": "size",
"type": "int53",
"description": "Total size of the files in the chat, in bytes"
},
{
"name": "count",
"type": "int32",
"description": "Total number of files in the chat"
},
{
"name": "by_file_type",
"type": "vector\u003cstorageStatisticsByFileType\u003e",
"description": "Statistics split by file types"
}
]
},
{
"name": "storageStatistics",
"description": "Contains the exact storage usage statistics split by chats and file type",
"class": "StorageStatistics",
"properties": [
{
"name": "size",
"type": "int53",
"description": "Total size of files, in bytes"
},
{
"name": "count",
"type": "int32",
"description": "Total number of files"
},
{
"name": "by_chat",
"type": "vector\u003cstorageStatisticsByChat\u003e",
"description": "Statistics split by chats"
}
]
},
{
"name": "storageStatisticsFast",
"description": "Contains approximate storage usage statistics, excluding files of unknown file type",
"class": "StorageStatisticsFast",
"properties": [
{
"name": "files_size",
"type": "int53",
"description": "Approximate total size of files, in bytes"
},
{
"name": "file_count",
"type": "int32",
"description": "Approximate number of files"
},
{
"name": "database_size",
"type": "int53",
"description": "Size of the database"
},
{
"name": "language_pack_database_size",
"type": "int53",
"description": "Size of the language pack database"
},
{
"name": "log_size",
"type": "int53",
"description": "Size of the TDLib internal log"
}
]
},
{
"name": "databaseStatistics",
"description": "Contains database statistics",
"class": "DatabaseStatistics",
"properties": [
{
"name": "statistics",
"type": "string",
"description": "Database statistics in an unspecified human-readable format"
}
]
},
{
"name": "networkTypeNone",
"description": "The network is not available",
"class": "NetworkType",
"properties": []
},
{
"name": "networkTypeMobile",
"description": "A mobile network",
"class": "NetworkType",
"properties": []
},
{
"name": "networkTypeMobileRoaming",
"description": "A mobile roaming network",
"class": "NetworkType",
"properties": []
},
{
"name": "networkTypeWiFi",
"description": "A Wi-Fi network",
"class": "NetworkType",
"properties": []
},
{
"name": "networkTypeOther",
"description": "A different network type (e.g., Ethernet network)",
"class": "NetworkType",
"properties": []
},
{
"name": "networkStatisticsEntryFile",
"description": "Contains information about the total amount of data that was used to send and receive files",
"class": "NetworkStatisticsEntry",
"properties": [
{
"name": "file_type",
"type": "FileType",
"description": "Type of the file the data is part of; pass null if the data isn't related to files"
},
{
"name": "network_type",
"type": "NetworkType",
"description": "Type of the network the data was sent through. Call setNetworkType to maintain the actual network type"
},
{
"name": "sent_bytes",
"type": "int53",
"description": "Total number of bytes sent"
},
{
"name": "received_bytes",
"type": "int53",
"description": "Total number of bytes received"
}
]
},
{
"name": "networkStatisticsEntryCall",
"description": "Contains information about the total amount of data that was used for calls",
"class": "NetworkStatisticsEntry",
"properties": [
{
"name": "network_type",
"type": "NetworkType",
"description": "Type of the network the data was sent through. Call setNetworkType to maintain the actual network type"
},
{
"name": "sent_bytes",
"type": "int53",
"description": "Total number of bytes sent"
},
{
"name": "received_bytes",
"type": "int53",
"description": "Total number of bytes received"
},
{
"name": "duration",
"type": "double",
"description": "Total call duration, in seconds"
}
]
},
{
"name": "networkStatistics",
"description": "A full list of available network statistic entries",
"class": "NetworkStatistics",
"properties": [
{
"name": "since_date",
"type": "int32",
"description": "Point in time (Unix timestamp) from which the statistics are collected"
},
{
"name": "entries",
"type": "vector\u003cNetworkStatisticsEntry\u003e",
"description": "Network statistics entries"
}
]
},
{
"name": "autoDownloadSettings",
"description": "Contains auto-download settings",
"class": "AutoDownloadSettings",
"properties": [
{
"name": "is_auto_download_enabled",
"type": "Bool",
"description": "True, if the auto-download is enabled"
},
{
"name": "max_photo_file_size",
"type": "int32",
"description": "The maximum size of a photo file to be auto-downloaded, in bytes"
},
{
"name": "max_video_file_size",
"type": "int32",
"description": "The maximum size of a video file to be auto-downloaded, in bytes"
},
{
"name": "max_other_file_size",
"type": "int32",
"description": "The maximum size of other file types to be auto-downloaded, in bytes"
},
{
"name": "video_upload_bitrate",
"type": "int32",
"description": "The maximum suggested bitrate for uploaded videos, in kbit/s"
},
{
"name": "preload_large_videos",
"type": "Bool",
"description": "True, if the beginning of video files needs to be preloaded for instant playback"
},
{
"name": "preload_next_audio",
"type": "Bool",
"description": "True, if the next audio track needs to be preloaded while the user is listening to an audio file"
},
{
"name": "use_less_data_for_calls",
"type": "Bool",
"description": "True, if \"use less data for calls\" option needs to be enabled"
}
]
},
{
"name": "autoDownloadSettingsPresets",
"description": "Contains auto-download settings presets for the current user",
"class": "AutoDownloadSettingsPresets",
"properties": [
{
"name": "low",
"type": "autoDownloadSettings",
"description": "Preset with lowest settings; supposed to be used by default when roaming"
},
{
"name": "medium",
"type": "autoDownloadSettings",
"description": "Preset with medium settings; supposed to be used by default when using mobile data"
},
{
"name": "high",
"type": "autoDownloadSettings",
"description": "Preset with highest settings; supposed to be used by default when connected on Wi-Fi"
}
]
},
{
"name": "connectionStateWaitingForNetwork",
"description": "Currently waiting for the network to become available. Use setNetworkType to change the available network type",
"class": "ConnectionState",
"properties": []
},
{
"name": "connectionStateConnectingToProxy",
"description": "Currently establishing a connection with a proxy server",
"class": "ConnectionState",
"properties": []
},
{
"name": "connectionStateConnecting",
"description": "Currently establishing a connection to the Telegram servers",
"class": "ConnectionState",
"properties": []
},
{
"name": "connectionStateUpdating",
"description": "Downloading data received while the application was offline",
"class": "ConnectionState",
"properties": []
},
{
"name": "connectionStateReady",
"description": "There is a working connection to the Telegram servers",
"class": "ConnectionState",
"properties": []
},
{
"name": "topChatCategoryUsers",
"description": "A category containing frequently used private chats with non-bot users",
"class": "TopChatCategory",
"properties": []
},
{
"name": "topChatCategoryBots",
"description": "A category containing frequently used private chats with bot users",
"class": "TopChatCategory",
"properties": []
},
{
"name": "topChatCategoryGroups",
"description": "A category containing frequently used basic groups and supergroups",
"class": "TopChatCategory",
"properties": []
},
{
"name": "topChatCategoryChannels",
"description": "A category containing frequently used channels",
"class": "TopChatCategory",
"properties": []
},
{
"name": "topChatCategoryInlineBots",
"description": "A category containing frequently used chats with inline bots sorted by their usage in inline mode",
"class": "TopChatCategory",
"properties": []
},
{
"name": "topChatCategoryCalls",
"description": "A category containing frequently used chats used for calls",
"class": "TopChatCategory",
"properties": []
},
{
"name": "topChatCategoryForwardChats",
"description": "A category containing frequently used chats used to forward messages",
"class": "TopChatCategory",
"properties": []
},
{
"name": "tMeUrlTypeUser",
"description": "A URL linking to a user",
"class": "TMeUrlType",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "Identifier of the user"
}
]
},
{
"name": "tMeUrlTypeSupergroup",
"description": "A URL linking to a public supergroup or channel",
"class": "TMeUrlType",
"properties": [
{
"name": "supergroup_id",
"type": "int53",
"description": "Identifier of the supergroup or channel"
}
]
},
{
"name": "tMeUrlTypeChatInvite",
"description": "A chat invite link",
"class": "TMeUrlType",
"properties": [
{
"name": "info",
"type": "chatInviteLinkInfo",
"description": "Chat invite link info"
}
]
},
{
"name": "tMeUrlTypeStickerSet",
"description": "A URL linking to a sticker set",
"class": "TMeUrlType",
"properties": [
{
"name": "sticker_set_id",
"type": "int64",
"description": "Identifier of the sticker set"
}
]
},
{
"name": "tMeUrl",
"description": "Represents a URL linking to an internal Telegram entity",
"class": "TMeUrl",
"properties": [
{
"name": "url",
"type": "string",
"description": "URL"
},
{
"name": "type",
"type": "TMeUrlType",
"description": "Type of the URL"
}
]
},
{
"name": "tMeUrls",
"description": "Contains a list of t.me URLs",
"class": "TMeUrls",
"properties": [
{
"name": "urls",
"type": "vector\u003ctMeUrl\u003e",
"description": "List of URLs"
}
]
},
{
"name": "suggestedActionEnableArchiveAndMuteNewChats",
"description": "Suggests the user to enable \"archive_and_mute_new_chats_from_unknown_users\" option",
"class": "SuggestedAction",
"properties": []
},
{
"name": "suggestedActionCheckPassword",
"description": "Suggests the user to check whether 2-step verification password is still remembered",
"class": "SuggestedAction",
"properties": []
},
{
"name": "suggestedActionCheckPhoneNumber",
"description": "Suggests the user to check whether authorization phone number is correct and change the phone number if it is inaccessible",
"class": "SuggestedAction",
"properties": []
},
{
"name": "suggestedActionSeeTicksHint",
"description": "Suggests the user to see a hint about meaning of one and two ticks on sent message",
"class": "SuggestedAction",
"properties": []
},
{
"name": "suggestedActionConvertToBroadcastGroup",
"description": "Suggests the user to convert specified supergroup to a broadcast group",
"class": "SuggestedAction",
"properties": [
{
"name": "supergroup_id",
"type": "int53",
"description": "Supergroup identifier"
}
]
},
{
"name": "suggestedActionSetPassword",
"description": "Suggests the user to set a 2-step verification password to be able to log in again",
"class": "SuggestedAction",
"properties": [
{
"name": "authorization_delay",
"type": "int32",
"description": "The number of days to pass between consecutive authorizations if the user declines to set password"
}
]
},
{
"name": "count",
"description": "Contains a counter",
"class": "Count",
"properties": [
{
"name": "count",
"type": "int32",
"description": "Count"
}
]
},
{
"name": "text",
"description": "Contains some text",
"class": "Text",
"properties": [
{
"name": "text",
"type": "string",
"description": "Text"
}
]
},
{
"name": "seconds",
"description": "Contains a value representing a number of seconds",
"class": "Seconds",
"properties": [
{
"name": "seconds",
"type": "double",
"description": "Number of seconds"
}
]
},
{
"name": "deepLinkInfo",
"description": "Contains information about a tg: deep link",
"class": "DeepLinkInfo",
"properties": [
{
"name": "text",
"type": "formattedText",
"description": "Text to be shown to the user"
},
{
"name": "need_update_application",
"type": "Bool",
"description": "True, if the user must be asked to update the application"
}
]
},
{
"name": "textParseModeMarkdown",
"description": "The text uses Markdown-style formatting",
"class": "TextParseMode",
"properties": [
{
"name": "version",
"type": "int32",
"description": "Version of the parser: 0 or 1 - Telegram Bot API \"Markdown\" parse mode, 2 - Telegram Bot API \"MarkdownV2\" parse mode"
}
]
},
{
"name": "textParseModeHTML",
"description": "The text uses HTML-style formatting. The same as Telegram Bot API \"HTML\" parse mode",
"class": "TextParseMode",
"properties": []
},
{
"name": "proxyTypeSocks5",
"description": "A SOCKS5 proxy server",
"class": "ProxyType",
"properties": [
{
"name": "username",
"type": "string",
"description": "Username for logging in; may be empty"
},
{
"name": "password",
"type": "string",
"description": "Password for logging in; may be empty"
}
]
},
{
"name": "proxyTypeHttp",
"description": "A HTTP transparent proxy server",
"class": "ProxyType",
"properties": [
{
"name": "username",
"type": "string",
"description": "Username for logging in; may be empty"
},
{
"name": "password",
"type": "string",
"description": "Password for logging in; may be empty"
},
{
"name": "http_only",
"type": "Bool",
"description": "Pass true if the proxy supports only HTTP requests and doesn't support transparent TCP connections via HTTP CONNECT method"
}
]
},
{
"name": "proxyTypeMtproto",
"description": "An MTProto proxy server",
"class": "ProxyType",
"properties": [
{
"name": "secret",
"type": "string",
"description": "The proxy's secret in hexadecimal encoding"
}
]
},
{
"name": "proxy",
"description": "Contains information about a proxy server",
"class": "Proxy",
"properties": [
{
"name": "id",
"type": "int32",
"description": "Unique identifier of the proxy"
},
{
"name": "server",
"type": "string",
"description": "Proxy server IP address"
},
{
"name": "port",
"type": "int32",
"description": "Proxy server port"
},
{
"name": "last_used_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the proxy was last used; 0 if never"
},
{
"name": "is_enabled",
"type": "Bool",
"description": "True, if the proxy is enabled now"
},
{
"name": "type",
"type": "ProxyType",
"description": "Type of the proxy"
}
]
},
{
"name": "proxies",
"description": "Represents a list of proxy servers",
"class": "Proxies",
"properties": [
{
"name": "proxies",
"type": "vector\u003cproxy\u003e",
"description": "List of proxy servers"
}
]
},
{
"name": "inputStickerStatic",
"description": "A static sticker in PNG format, which will be converted to WEBP server-side",
"class": "InputSticker",
"properties": [
{
"name": "sticker",
"type": "InputFile",
"description": "PNG image with the sticker; must be up to 512 KB in size and fit in a 512x512 square"
},
{
"name": "emojis",
"type": "string",
"description": "Emojis corresponding to the sticker"
},
{
"name": "mask_position",
"type": "maskPosition",
"description": "For masks, position where the mask is placed; pass null if unspecified"
}
]
},
{
"name": "inputStickerAnimated",
"description": "An animated sticker in TGS format",
"class": "InputSticker",
"properties": [
{
"name": "sticker",
"type": "InputFile",
"description": "File with the animated sticker. Only local or uploaded within a week files are supported. See https://core.telegram.org/animated_stickers#technical-requirements for technical requirements"
},
{
"name": "emojis",
"type": "string",
"description": "Emojis corresponding to the sticker"
}
]
},
{
"name": "dateRange",
"description": "Represents a date range",
"class": "DateRange",
"properties": [
{
"name": "start_date",
"type": "int32",
"description": "Point in time (Unix timestamp) at which the date range begins"
},
{
"name": "end_date",
"type": "int32",
"description": "Point in time (Unix timestamp) at which the date range ends"
}
]
},
{
"name": "statisticalValue",
"description": "A value with information about its recent changes",
"class": "StatisticalValue",
"properties": [
{
"name": "value",
"type": "double",
"description": "The current value"
},
{
"name": "previous_value",
"type": "double",
"description": "The value for the previous day"
},
{
"name": "growth_rate_percentage",
"type": "double",
"description": "The growth rate of the value, as a percentage"
}
]
},
{
"name": "statisticalGraphData",
"description": "A graph data",
"class": "StatisticalGraph",
"properties": [
{
"name": "json_data",
"type": "string",
"description": "Graph data in JSON format"
},
{
"name": "zoom_token",
"type": "string",
"description": "If non-empty, a token which can be used to receive a zoomed in graph"
}
]
},
{
"name": "statisticalGraphAsync",
"description": "The graph data to be asynchronously loaded through getStatisticalGraph",
"class": "StatisticalGraph",
"properties": [
{
"name": "token",
"type": "string",
"description": "The token to use for data loading"
}
]
},
{
"name": "statisticalGraphError",
"description": "An error message to be shown to the user instead of the graph",
"class": "StatisticalGraph",
"properties": [
{
"name": "error_message",
"type": "string",
"description": "The error message"
}
]
},
{
"name": "chatStatisticsMessageInteractionInfo",
"description": "Contains statistics about interactions with a message",
"class": "ChatStatisticsMessageInteractionInfo",
"properties": [
{
"name": "message_id",
"type": "int53",
"description": "Message identifier"
},
{
"name": "view_count",
"type": "int32",
"description": "Number of times the message was viewed"
},
{
"name": "forward_count",
"type": "int32",
"description": "Number of times the message was forwarded"
}
]
},
{
"name": "chatStatisticsMessageSenderInfo",
"description": "Contains statistics about messages sent by a user",
"class": "ChatStatisticsMessageSenderInfo",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "User identifier"
},
{
"name": "sent_message_count",
"type": "int32",
"description": "Number of sent messages"
},
{
"name": "average_character_count",
"type": "int32",
"description": "Average number of characters in sent messages; 0 if unknown"
}
]
},
{
"name": "chatStatisticsAdministratorActionsInfo",
"description": "Contains statistics about administrator actions done by a user",
"class": "ChatStatisticsAdministratorActionsInfo",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "Administrator user identifier"
},
{
"name": "deleted_message_count",
"type": "int32",
"description": "Number of messages deleted by the administrator"
},
{
"name": "banned_user_count",
"type": "int32",
"description": "Number of users banned by the administrator"
},
{
"name": "restricted_user_count",
"type": "int32",
"description": "Number of users restricted by the administrator"
}
]
},
{
"name": "chatStatisticsInviterInfo",
"description": "Contains statistics about number of new members invited by a user",
"class": "ChatStatisticsInviterInfo",
"properties": [
{
"name": "user_id",
"type": "int53",
"description": "User identifier"
},
{
"name": "added_member_count",
"type": "int32",
"description": "Number of new members invited by the user"
}
]
},
{
"name": "chatStatisticsSupergroup",
"description": "A detailed statistics about a supergroup chat",
"class": "ChatStatistics",
"properties": [
{
"name": "period",
"type": "dateRange",
"description": "A period to which the statistics applies"
},
{
"name": "member_count",
"type": "statisticalValue",
"description": "Number of members in the chat"
},
{
"name": "message_count",
"type": "statisticalValue",
"description": "Number of messages sent to the chat"
},
{
"name": "viewer_count",
"type": "statisticalValue",
"description": "Number of users who viewed messages in the chat"
},
{
"name": "sender_count",
"type": "statisticalValue",
"description": "Number of users who sent messages to the chat"
},
{
"name": "member_count_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of members in the chat"
},
{
"name": "join_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of members joined and left the chat"
},
{
"name": "join_by_source_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of new member joins per source"
},
{
"name": "language_graph",
"type": "StatisticalGraph",
"description": "A graph containing distribution of active users per language"
},
{
"name": "message_content_graph",
"type": "StatisticalGraph",
"description": "A graph containing distribution of sent messages by content type"
},
{
"name": "action_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of different actions in the chat"
},
{
"name": "day_graph",
"type": "StatisticalGraph",
"description": "A graph containing distribution of message views per hour"
},
{
"name": "week_graph",
"type": "StatisticalGraph",
"description": "A graph containing distribution of message views per day of week"
},
{
"name": "top_senders",
"type": "vector\u003cchatStatisticsMessageSenderInfo\u003e",
"description": "List of users sent most messages in the last week"
},
{
"name": "top_administrators",
"type": "vector\u003cchatStatisticsAdministratorActionsInfo\u003e",
"description": "List of most active administrators in the last week"
},
{
"name": "top_inviters",
"type": "vector\u003cchatStatisticsInviterInfo\u003e",
"description": "List of most active inviters of new members in the last week"
}
]
},
{
"name": "chatStatisticsChannel",
"description": "A detailed statistics about a channel chat",
"class": "ChatStatistics",
"properties": [
{
"name": "period",
"type": "dateRange",
"description": "A period to which the statistics applies"
},
{
"name": "member_count",
"type": "statisticalValue",
"description": "Number of members in the chat"
},
{
"name": "mean_view_count",
"type": "statisticalValue",
"description": "Mean number of times the recently sent messages was viewed"
},
{
"name": "mean_share_count",
"type": "statisticalValue",
"description": "Mean number of times the recently sent messages was shared"
},
{
"name": "enabled_notifications_percentage",
"type": "double",
"description": "A percentage of users with enabled notifications for the chat"
},
{
"name": "member_count_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of members in the chat"
},
{
"name": "join_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of members joined and left the chat"
},
{
"name": "mute_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of members muted and unmuted the chat"
},
{
"name": "view_count_by_hour_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of message views in a given hour in the last two weeks"
},
{
"name": "view_count_by_source_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of message views per source"
},
{
"name": "join_by_source_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of new member joins per source"
},
{
"name": "language_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of users viewed chat messages per language"
},
{
"name": "message_interaction_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of chat message views and shares"
},
{
"name": "instant_view_interaction_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of views of associated with the chat instant views"
},
{
"name": "recent_message_interactions",
"type": "vector\u003cchatStatisticsMessageInteractionInfo\u003e",
"description": "Detailed statistics about number of views and shares of recently sent messages"
}
]
},
{
"name": "messageStatistics",
"description": "A detailed statistics about a message",
"class": "MessageStatistics",
"properties": [
{
"name": "message_interaction_graph",
"type": "StatisticalGraph",
"description": "A graph containing number of message views and shares"
}
]
},
{
"name": "point",
"description": "A point on a Cartesian plane",
"class": "Point",
"properties": [
{
"name": "x",
"type": "double",
"description": "The point's first coordinate"
},
{
"name": "y",
"type": "double",
"description": "The point's second coordinate"
}
]
},
{
"name": "vectorPathCommandLine",
"description": "A straight line to a given point",
"class": "VectorPathCommand",
"properties": [
{
"name": "end_point",
"type": "point",
"description": "The end point of the straight line"
}
]
},
{
"name": "vectorPathCommandCubicBezierCurve",
"description": "A cubic Bézier curve to a given point",
"class": "VectorPathCommand",
"properties": [
{
"name": "start_control_point",
"type": "point",
"description": "The start control point of the curve"
},
{
"name": "end_control_point",
"type": "point",
"description": "The end control point of the curve"
},
{
"name": "end_point",
"type": "point",
"description": "The end point of the curve"
}
]
},
{
"name": "botCommandScopeDefault",
"description": "A scope covering all users",
"class": "BotCommandScope",
"properties": []
},
{
"name": "botCommandScopeAllPrivateChats",
"description": "A scope covering all private chats",
"class": "BotCommandScope",
"properties": []
},
{
"name": "botCommandScopeAllGroupChats",
"description": "A scope covering all group and supergroup chats",
"class": "BotCommandScope",
"properties": []
},
{
"name": "botCommandScopeAllChatAdministrators",
"description": "A scope covering all group and supergroup chat administrators",
"class": "BotCommandScope",
"properties": []
},
{
"name": "botCommandScopeChat",
"description": "A scope covering all members of a chat",
"class": "BotCommandScope",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
}
]
},
{
"name": "botCommandScopeChatAdministrators",
"description": "A scope covering all administrators of a chat",
"class": "BotCommandScope",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
}
]
},
{
"name": "botCommandScopeChatMember",
"description": "A scope covering a member of a chat",
"class": "BotCommandScope",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "user_id",
"type": "int53",
"description": "User identifier"
}
]
},
{
"name": "updateAuthorizationState",
"description": "The user authorization state has changed",
"class": "Update",
"properties": [
{
"name": "authorization_state",
"type": "AuthorizationState",
"description": "New authorization state"
}
]
},
{
"name": "updateNewMessage",
"description": "A new message was received; can also be an outgoing message",
"class": "Update",
"properties": [
{
"name": "message",
"type": "message",
"description": "The new message"
}
]
},
{
"name": "updateMessageSendAcknowledged",
"description": "A request to send a message has reached the Telegram server. This doesn't mean that the message will be sent successfully or even that the send message request will be processed. This update will be sent only if the option \"use_quick_ack\" is set to true. This update may be sent multiple times for the same message",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "The chat identifier of the sent message"
},
{
"name": "message_id",
"type": "int53",
"description": "A temporary message identifier"
}
]
},
{
"name": "updateMessageSendSucceeded",
"description": "A message has been successfully sent",
"class": "Update",
"properties": [
{
"name": "message",
"type": "message",
"description": "The sent message. Usually only the message identifier, date, and content are changed, but almost all other fields can also change"
},
{
"name": "old_message_id",
"type": "int53",
"description": "The previous temporary message identifier"
}
]
},
{
"name": "updateMessageSendFailed",
"description": "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",
"class": "Update",
"properties": [
{
"name": "message",
"type": "message",
"description": "The failed to send message"
},
{
"name": "old_message_id",
"type": "int53",
"description": "The previous temporary message identifier"
},
{
"name": "error_code",
"type": "int32",
"description": "An error code"
},
{
"name": "error_message",
"type": "string",
"description": "Error message"
}
]
},
{
"name": "updateMessageContent",
"description": "The message content has changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "message_id",
"type": "int53",
"description": "Message identifier"
},
{
"name": "new_content",
"type": "MessageContent",
"description": "New message content"
}
]
},
{
"name": "updateMessageEdited",
"description": "A message was edited. Changes in the message content will come in a separate updateMessageContent",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "message_id",
"type": "int53",
"description": "Message identifier"
},
{
"name": "edit_date",
"type": "int32",
"description": "Point in time (Unix timestamp) when the message was edited"
},
{
"name": "reply_markup",
"type": "ReplyMarkup",
"description": "New message reply markup; may be null"
}
]
},
{
"name": "updateMessageIsPinned",
"description": "The message pinned state was changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "message_id",
"type": "int53",
"description": "The message identifier"
},
{
"name": "is_pinned",
"type": "Bool",
"description": "True, if the message is pinned"
}
]
},
{
"name": "updateMessageInteractionInfo",
"description": "The information about interactions with a message has changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "message_id",
"type": "int53",
"description": "Message identifier"
},
{
"name": "interaction_info",
"type": "messageInteractionInfo",
"description": "New information about interactions with the message; may be null"
}
]
},
{
"name": "updateMessageContentOpened",
"description": "The message content was opened. Updates voice note messages to \"listened\", video note messages to \"viewed\" and starts the TTL timer for self-destructing messages",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "message_id",
"type": "int53",
"description": "Message identifier"
}
]
},
{
"name": "updateMessageMentionRead",
"description": "A message with an unread mention was read",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "message_id",
"type": "int53",
"description": "Message identifier"
},
{
"name": "unread_mention_count",
"type": "int32",
"description": "The new number of unread mention messages left in the chat"
}
]
},
{
"name": "updateMessageLiveLocationViewed",
"description": "A message with a live location was viewed. When the update is received, the application is supposed to update the live location",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Identifier of the chat with the live location message"
},
{
"name": "message_id",
"type": "int53",
"description": "Identifier of the message with live location"
}
]
},
{
"name": "updateNewChat",
"description": "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",
"class": "Update",
"properties": [
{
"name": "chat",
"type": "chat",
"description": "The chat"
}
]
},
{
"name": "updateChatTitle",
"description": "The title of a chat was changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "title",
"type": "string",
"description": "The new chat title"
}
]
},
{
"name": "updateChatPhoto",
"description": "A chat photo was changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "photo",
"type": "chatPhotoInfo",
"description": "The new chat photo; may be null"
}
]
},
{
"name": "updateChatPermissions",
"description": "Chat permissions was changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "permissions",
"type": "chatPermissions",
"description": "The new chat permissions"
}
]
},
{
"name": "updateChatLastMessage",
"description": "The last message of a chat was changed. If last_message is null, then the last message in the chat became unknown. Some new unknown messages might be added to the chat in this case",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "last_message",
"type": "message",
"description": "The new last message in the chat; may be null"
},
{
"name": "positions",
"type": "vector\u003cchatPosition\u003e",
"description": "The new chat positions in the chat lists"
}
]
},
{
"name": "updateChatPosition",
"description": "The position of a chat in a chat list has changed. Instead of this update updateChatLastMessage or updateChatDraftMessage might be sent",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "position",
"type": "chatPosition",
"description": "New chat position. If new order is 0, then the chat needs to be removed from the list"
}
]
},
{
"name": "updateChatDefaultMessageSenderId",
"description": "The default message sender that is chosen to send messages in a chat has changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "default_message_sender_id",
"type": "MessageSender",
"description": "New value of default_message_sender_id; may be null if the user can't change message sender"
}
]
},
{
"name": "updateChatHasProtectedContent",
"description": "A chat content was allowed or restricted for saving",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "has_protected_content",
"type": "Bool",
"description": "New value of has_protected_content"
}
]
},
{
"name": "updateChatIsMarkedAsUnread",
"description": "A chat was marked as unread or was read",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "is_marked_as_unread",
"type": "Bool",
"description": "New value of is_marked_as_unread"
}
]
},
{
"name": "updateChatIsBlocked",
"description": "A chat was blocked or unblocked",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "is_blocked",
"type": "Bool",
"description": "New value of is_blocked"
}
]
},
{
"name": "updateChatHasScheduledMessages",
"description": "A chat's has_scheduled_messages field has changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "has_scheduled_messages",
"type": "Bool",
"description": "New value of has_scheduled_messages"
}
]
},
{
"name": "updateChatVideoChat",
"description": "A chat video chat state has changed",
"class": "Update",
"properties": [
{
"name": "chat_id",
"type": "int53",
"description": "Chat identifier"
},
{
"name": "video_chat",
"type": "videoChat",
"description": "New value of video_chat"
}
]
},
{