5289 lines
399 KiB
Plaintext
5289 lines
399 KiB
Plaintext
double ? = Double;
|
|
string ? = String;
|
|
|
|
int32 = Int32;
|
|
int53 = Int53;
|
|
int64 = Int64;
|
|
bytes = Bytes;
|
|
|
|
boolFalse = Bool;
|
|
boolTrue = Bool;
|
|
|
|
vector {t:Type} # [ t ] = Vector t;
|
|
|
|
|
|
//@description An object of this type can be returned on every function call, in case of an error
|
|
//@code 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
|
|
//@message Error message; subject to future changes
|
|
error code:int32 message:string = Error;
|
|
|
|
|
|
//@description An object of this type is returned on a successful function call for certain functions
|
|
ok = Ok;
|
|
|
|
|
|
//@description Contains parameters for TDLib initialization
|
|
//@use_test_dc If set to true, the Telegram test environment will be used instead of the production environment
|
|
//@database_directory The path to the directory for the persistent database; if empty, the current working directory will be used
|
|
//@files_directory The path to the directory for storing files; if empty, database_directory will be used
|
|
//@use_file_database If set to true, information about downloaded and uploaded files will be saved between application restarts
|
|
//@use_chat_info_database If set to true, the library will maintain a cache of users, basic groups, supergroups, channels and secret chats. Implies use_file_database
|
|
//@use_message_database If set to true, the library will maintain a cache of chats and messages. Implies use_chat_info_database
|
|
//@use_secret_chats If set to true, support for secret chats will be enabled
|
|
//@api_id Application identifier for Telegram API access, which can be obtained at https://my.telegram.org
|
|
//@api_hash Application identifier hash for Telegram API access, which can be obtained at https://my.telegram.org
|
|
//@system_language_code IETF language tag of the user's operating system language; must be non-empty
|
|
//@device_model Model of the device the application is being run on; must be non-empty
|
|
//@system_version Version of the operating system the application is being run on. If empty, the version is automatically detected by TDLib
|
|
//@application_version Application version; must be non-empty
|
|
//@enable_storage_optimizer If set to true, old files will automatically be deleted
|
|
//@ignore_file_names 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
|
|
tdlibParameters use_test_dc:Bool database_directory:string files_directory:string use_file_database:Bool use_chat_info_database:Bool use_message_database:Bool use_secret_chats:Bool api_id:int32 api_hash:string system_language_code:string device_model:string system_version:string application_version:string enable_storage_optimizer:Bool ignore_file_names:Bool = TdlibParameters;
|
|
|
|
|
|
//@class AuthenticationCodeType @description Provides information about the method by which an authentication code is delivered to the user
|
|
|
|
//@description An authentication code is delivered via a private Telegram message, which can be viewed from another active session @length Length of the code
|
|
authenticationCodeTypeTelegramMessage length:int32 = AuthenticationCodeType;
|
|
|
|
//@description An authentication code is delivered via an SMS message to the specified phone number @length Length of the code
|
|
authenticationCodeTypeSms length:int32 = AuthenticationCodeType;
|
|
|
|
//@description An authentication code is delivered via a phone call to the specified phone number @length Length of the code
|
|
authenticationCodeTypeCall length:int32 = AuthenticationCodeType;
|
|
|
|
//@description An authentication code is delivered by an immediately cancelled call to the specified phone number. The number from which the call was made is the code @pattern Pattern of the phone number from which the call will be made
|
|
authenticationCodeTypeFlashCall pattern:string = AuthenticationCodeType;
|
|
|
|
|
|
//@description Information about the authentication code that was sent @phone_number A phone number that is being authenticated @type Describes the way the code was sent to the user @next_type Describes the way the next code will be sent to the user; may be null @timeout Timeout before the code should be re-sent, in seconds
|
|
authenticationCodeInfo phone_number:string type:AuthenticationCodeType next_type:AuthenticationCodeType timeout:int32 = AuthenticationCodeInfo;
|
|
|
|
//@description Information about the email address authentication code that was sent @email_address_pattern Pattern of the email address to which an authentication code was sent @length Length of the code; 0 if unknown
|
|
emailAddressAuthenticationCodeInfo email_address_pattern:string length:int32 = EmailAddressAuthenticationCodeInfo;
|
|
|
|
|
|
//@description Represents a part of the text that needs to be formatted in some unusual way @offset Offset of the entity, in UTF-16 code units @length Length of the entity, in UTF-16 code units @type Type of the entity
|
|
textEntity offset:int32 length:int32 type:TextEntityType = TextEntity;
|
|
|
|
//@description Contains a list of text entities @entities List of text entities
|
|
textEntities entities:vector<textEntity> = TextEntities;
|
|
|
|
//@description A text with some entities @text The text @entities 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
|
|
formattedText text:string entities:vector<textEntity> = FormattedText;
|
|
|
|
|
|
//@description Contains Telegram terms of service @text Text of the terms of service @min_user_age The minimum age of a user to be able to accept the terms; 0 if any @show_popup True, if a blocking popup with terms of service must be shown to the user
|
|
termsOfService text:formattedText min_user_age:int32 show_popup:Bool = TermsOfService;
|
|
|
|
|
|
//@class AuthorizationState @description Represents the current authorization state of the TDLib client
|
|
|
|
//@description TDLib needs TdlibParameters for initialization
|
|
authorizationStateWaitTdlibParameters = AuthorizationState;
|
|
|
|
//@description TDLib needs an encryption key to decrypt the local database @is_encrypted True, if the database is currently encrypted
|
|
authorizationStateWaitEncryptionKey is_encrypted:Bool = AuthorizationState;
|
|
|
|
//@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
|
|
authorizationStateWaitPhoneNumber = AuthorizationState;
|
|
|
|
//@description TDLib needs the user's authentication code to authorize @code_info Information about the authorization code that was sent
|
|
authorizationStateWaitCode code_info:authenticationCodeInfo = AuthorizationState;
|
|
|
|
//@description The user needs to confirm authorization on another logged in device by scanning a QR code with the provided link @link A tg:// URL for the QR code. The link will be updated frequently
|
|
authorizationStateWaitOtherDeviceConfirmation link:string = AuthorizationState;
|
|
|
|
//@description The user is unregistered and need to accept terms of service and enter their first name and last name to finish registration @terms_of_service Telegram terms of service
|
|
authorizationStateWaitRegistration terms_of_service:termsOfService = AuthorizationState;
|
|
|
|
//@description The user has been authorized, but needs to enter a password to start using the application @password_hint Hint for the password; may be empty @has_recovery_email_address True, if a recovery email address has been set up
|
|
//@recovery_email_address_pattern Pattern of the email address to which the recovery email was sent; empty until a recovery email has been sent
|
|
authorizationStateWaitPassword password_hint:string has_recovery_email_address:Bool recovery_email_address_pattern:string = AuthorizationState;
|
|
|
|
//@description The user has been successfully authorized. TDLib is now ready to answer queries
|
|
authorizationStateReady = AuthorizationState;
|
|
|
|
//@description The user is currently logging out
|
|
authorizationStateLoggingOut = AuthorizationState;
|
|
|
|
//@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
|
|
authorizationStateClosing = AuthorizationState;
|
|
|
|
//@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 should create a new instance of the TDLib client
|
|
authorizationStateClosed = AuthorizationState;
|
|
|
|
|
|
//@description Represents the current state of 2-step verification @has_password True, if a 2-step verification password is set @password_hint Hint for the password; may be empty
|
|
//@has_recovery_email_address True, if a recovery email is set @has_passport_data True, if some Telegram Passport elements were saved
|
|
//@recovery_email_address_code_info Information about the recovery email address to which the confirmation email was sent; may be null
|
|
passwordState has_password:Bool password_hint:string has_recovery_email_address:Bool has_passport_data:Bool recovery_email_address_code_info:emailAddressAuthenticationCodeInfo = PasswordState;
|
|
|
|
//@description Contains information about the current recovery email address @recovery_email_address Recovery email address
|
|
recoveryEmailAddress recovery_email_address:string = RecoveryEmailAddress;
|
|
|
|
|
|
//@description Returns information about the availability of a temporary password, which can be used for payments @has_password True, if a temporary password is available @valid_for Time left before the temporary password expires, in seconds
|
|
temporaryPasswordState has_password:Bool valid_for:int32 = TemporaryPasswordState;
|
|
|
|
|
|
//@description Represents a local file
|
|
//@path Local path to the locally available file part; may be empty
|
|
//@can_be_downloaded True, if it is possible to try to download or generate the file
|
|
//@can_be_deleted True, if the file can be deleted
|
|
//@is_downloading_active True, if the file is currently being downloaded (or a local copy is being generated by some other means)
|
|
//@is_downloading_completed True, if the local copy is fully available
|
|
//@download_offset Download will be started from this offset. downloaded_prefix_size is calculated from this offset
|
|
//@downloaded_prefix_size 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
|
|
//@downloaded_size Total downloaded file bytes. Should be used only for calculating download progress. The actual file size may be bigger, and some parts of it may contain garbage
|
|
localFile path:string can_be_downloaded:Bool can_be_deleted:Bool is_downloading_active:Bool is_downloading_completed:Bool download_offset:int32 downloaded_prefix_size:int32 downloaded_size:int32 = LocalFile;
|
|
|
|
//@description Represents a remote file
|
|
//@id 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 should generate the file by downloading it to the specified location
|
|
//@unique_id 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
|
|
//@is_uploading_active True, if the file is currently being uploaded (or a remote copy is being generated by some other means)
|
|
//@is_uploading_completed True, if a remote copy is fully available
|
|
//@uploaded_size Size of the remote available part of the file; 0 if unknown
|
|
remoteFile id:string unique_id:string is_uploading_active:Bool is_uploading_completed:Bool uploaded_size:int32 = RemoteFile;
|
|
|
|
//@description Represents a file
|
|
//@id Unique file identifier
|
|
//@size File size; 0 if unknown
|
|
//@expected_size Expected file size in case the exact file size is unknown, but an approximate size is known. Can be used to show download/upload progress
|
|
//@local Information about the local copy of the file
|
|
//@remote Information about the remote copy of the file
|
|
file id:int32 size:int32 expected_size:int32 local:localFile remote:remoteFile = File;
|
|
|
|
|
|
//@class InputFile @description Points to a file
|
|
|
|
//@description A file defined by its unique ID @id Unique file identifier
|
|
inputFileId id:int32 = InputFile;
|
|
|
|
//@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
|
|
//@id Remote file identifier
|
|
inputFileRemote id:string = InputFile;
|
|
|
|
//@description A file defined by a local path @path Local path to the file
|
|
inputFileLocal path:string = InputFile;
|
|
|
|
//@description A file generated by the application @original_path Local path to a file from which the file is generated; may be empty if there is no such file
|
|
//@conversion String specifying the conversion applied to the original file; should be persistent across application restarts. Conversions beginning with '#' are reserved for internal TDLib usage
|
|
//@expected_size Expected size of the generated file; 0 if unknown
|
|
inputFileGenerated original_path:string conversion:string expected_size:int32 = InputFile;
|
|
|
|
|
|
//@description Describes an image in JPEG format @type Image type (see https://core.telegram.org/constructor/photoSize)
|
|
//@photo Information about the image file @width Image width @height Image height
|
|
//@progressive_sizes Sizes of progressive JPEG file prefixes, which can be used to preliminarily show the image
|
|
photoSize type:string photo:file width:int32 height:int32 progressive_sizes:vector<int32> = PhotoSize;
|
|
|
|
//@description Thumbnail image of a very poor quality and low resolution @width Thumbnail width, usually doesn't exceed 40 @height Thumbnail height, usually doesn't exceed 40 @data The thumbnail in JPEG format
|
|
minithumbnail width:int32 height:int32 data:bytes = Minithumbnail;
|
|
|
|
|
|
//@class ThumbnailFormat @description Describes format of the thumbnail
|
|
|
|
//@description The thumbnail is in JPEG format
|
|
thumbnailFormatJpeg = ThumbnailFormat;
|
|
|
|
//@description The thumbnail is in PNG format. It will be used only for background patterns
|
|
thumbnailFormatPng = ThumbnailFormat;
|
|
|
|
//@description The thumbnail is in WEBP format. It will be used only for some stickers
|
|
thumbnailFormatWebp = ThumbnailFormat;
|
|
|
|
//@description The thumbnail is in static GIF format. It will be used only for some bot inline results
|
|
thumbnailFormatGif = ThumbnailFormat;
|
|
|
|
//@description The thumbnail is in TGS format. It will be used only for animated sticker sets
|
|
thumbnailFormatTgs = ThumbnailFormat;
|
|
|
|
//@description The thumbnail is in MPEG4 format. It will be used only for some animations and videos
|
|
thumbnailFormatMpeg4 = ThumbnailFormat;
|
|
|
|
|
|
//@description Represents a thumbnail @format Thumbnail format @width Thumbnail width @height Thumbnail height @file The thumbnail
|
|
thumbnail format:ThumbnailFormat width:int32 height:int32 file:file = Thumbnail;
|
|
|
|
|
|
//@class MaskPoint @description Part of the face, relative to which a mask should be placed
|
|
|
|
//@description A mask should be placed relatively to the forehead
|
|
maskPointForehead = MaskPoint;
|
|
|
|
//@description A mask should be placed relatively to the eyes
|
|
maskPointEyes = MaskPoint;
|
|
|
|
//@description A mask should be placed relatively to the mouth
|
|
maskPointMouth = MaskPoint;
|
|
|
|
//@description A mask should be placed relatively to the chin
|
|
maskPointChin = MaskPoint;
|
|
|
|
//@description Position on a photo where a mask should be placed @point Part of the face, relative to which the mask should be placed
|
|
//@x_shift 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)
|
|
//@y_shift 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)
|
|
//@scale Mask scaling coefficient. (For example, 2.0 means a doubled size)
|
|
maskPosition point:MaskPoint x_shift:double y_shift:double scale:double = MaskPosition;
|
|
|
|
|
|
//@description Represents a closed vector path. The path begins at the end point of the last command @commands List of vector path commands
|
|
closedVectorPath commands:vector<VectorPathCommand> = ClosedVectorPath;
|
|
|
|
|
|
//@description Describes one answer option of a poll @text Option text; 1-100 characters @voter_count Number of voters for this option, available only for closed or voted polls @vote_percentage The percentage of votes for this option; 0-100
|
|
//@is_chosen True, if the option was chosen by the user @is_being_chosen True, if the option is being chosen by a pending setPollAnswer request
|
|
pollOption text:string voter_count:int32 vote_percentage:int32 is_chosen:Bool is_being_chosen:Bool = PollOption;
|
|
|
|
|
|
//@class PollType @description Describes the type of a poll
|
|
|
|
//@description A regular poll @allow_multiple_answers True, if multiple answer options can be chosen simultaneously
|
|
pollTypeRegular allow_multiple_answers:Bool = PollType;
|
|
|
|
//@description A poll in quiz mode, which has exactly one correct answer option and can be answered only once
|
|
//@correct_option_id 0-based identifier of the correct answer option; -1 for a yet unanswered poll
|
|
//@explanation 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
|
|
pollTypeQuiz correct_option_id:int32 explanation:formattedText = PollType;
|
|
|
|
|
|
//@description Describes an animation file. The animation must be encoded in GIF or MPEG4 format @duration Duration of the animation, in seconds; as defined by the sender @width Width of the animation @height Height of the animation
|
|
//@file_name Original name of the file; as defined by the sender @mime_type MIME type of the file, usually "image/gif" or "video/mp4"
|
|
//@has_stickers True, if stickers were added to the animation. The list of corresponding sticker set can be received using getAttachedStickerSets
|
|
//@minithumbnail Animation minithumbnail; may be null @thumbnail Animation thumbnail in JPEG or MPEG4 format; may be null @animation File containing the animation
|
|
animation duration:int32 width:int32 height:int32 file_name:string mime_type:string has_stickers:Bool minithumbnail:minithumbnail thumbnail:thumbnail animation:file = Animation;
|
|
|
|
//@description Describes an audio file. Audio is usually in MP3 or M4A format @duration Duration of the audio, in seconds; as defined by the sender @title Title of the audio; as defined by the sender @performer Performer of the audio; as defined by the sender
|
|
//@file_name Original name of the file; as defined by the sender @mime_type The MIME type of the file; as defined by the sender @album_cover_minithumbnail The minithumbnail of the album cover; may be null
|
|
//@album_cover_thumbnail The thumbnail of the album cover in JPEG format; as defined by the sender. The full size thumbnail should be extracted from the downloaded file; may be null @audio File containing the audio
|
|
audio duration:int32 title:string performer:string file_name:string mime_type:string album_cover_minithumbnail:minithumbnail album_cover_thumbnail:thumbnail audio:file = Audio;
|
|
|
|
//@description Describes a document of any type @file_name Original name of the file; as defined by the sender @mime_type MIME type of the file; as defined by the sender
|
|
//@minithumbnail Document minithumbnail; may be null @thumbnail Document thumbnail in JPEG or PNG format (PNG will be used only for background patterns); as defined by the sender; may be null @document File containing the document
|
|
document file_name:string mime_type:string minithumbnail:minithumbnail thumbnail:thumbnail document:file = Document;
|
|
|
|
//@description Describes a photo @has_stickers True, if stickers were added to the photo. The list of corresponding sticker sets can be received using getAttachedStickerSets
|
|
//@minithumbnail Photo minithumbnail; may be null @sizes Available variants of the photo, in different sizes
|
|
photo has_stickers:Bool minithumbnail:minithumbnail sizes:vector<photoSize> = Photo;
|
|
|
|
//@description Describes a sticker @set_id The identifier of the sticker set to which the sticker belongs; 0 if none @width Sticker width; as defined by the sender @height Sticker height; as defined by the sender
|
|
//@emoji Emoji corresponding to the sticker @is_animated True, if the sticker is an animated sticker in TGS format @is_mask True, if the sticker is a mask @mask_position Position where the mask should be placed; may be null
|
|
//@outline Sticker's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner @thumbnail Sticker thumbnail in WEBP or JPEG format; may be null @sticker File containing the sticker
|
|
sticker set_id:int64 width:int32 height:int32 emoji:string is_animated:Bool is_mask:Bool mask_position:maskPosition outline:vector<closedVectorPath> thumbnail:thumbnail sticker:file = Sticker;
|
|
|
|
//@description Describes a video file @duration Duration of the video, in seconds; as defined by the sender @width Video width; as defined by the sender @height Video height; as defined by the sender
|
|
//@file_name Original name of the file; as defined by the sender @mime_type MIME type of the file; as defined by the sender
|
|
//@has_stickers True, if stickers were added to the video. The list of corresponding sticker sets can be received using getAttachedStickerSets
|
|
//@supports_streaming True, if the video should be tried to be streamed @minithumbnail Video minithumbnail; may be null
|
|
//@thumbnail Video thumbnail in JPEG or MPEG4 format; as defined by the sender; may be null @video File containing the video
|
|
video duration:int32 width:int32 height:int32 file_name:string mime_type:string has_stickers:Bool supports_streaming:Bool minithumbnail:minithumbnail thumbnail:thumbnail video:file = Video;
|
|
|
|
//@description Describes a video note. The video must be equal in width and height, cropped to a circle, and stored in MPEG4 format @duration Duration of the video, in seconds; as defined by the sender
|
|
//@length Video width and height; as defined by the sender @minithumbnail Video minithumbnail; may be null
|
|
//@thumbnail Video thumbnail in JPEG format; as defined by the sender; may be null @video File containing the video
|
|
videoNote duration:int32 length:int32 minithumbnail:minithumbnail thumbnail:thumbnail video:file = VideoNote;
|
|
|
|
//@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 @duration Duration of the voice note, in seconds; as defined by the sender
|
|
//@waveform A waveform representation of the voice note in 5-bit format @mime_type MIME type of the file; as defined by the sender @voice File containing the voice note
|
|
voiceNote duration:int32 waveform:bytes mime_type:string voice:file = VoiceNote;
|
|
|
|
//@description Describes a user contact @phone_number Phone number of the user @first_name First name of the user; 1-255 characters in length @last_name Last name of the user @vcard Additional data about the user in a form of vCard; 0-2048 bytes in length @user_id Identifier of the user, if known; otherwise 0
|
|
contact phone_number:string first_name:string last_name:string vcard:string user_id:int32 = Contact;
|
|
|
|
//@description Describes a location on planet Earth @latitude Latitude of the location in degrees; as defined by the sender @longitude Longitude of the location, in degrees; as defined by the sender
|
|
//@horizontal_accuracy The estimated horizontal accuracy of the location, in meters; as defined by the sender. 0 if unknown
|
|
location latitude:double longitude:double horizontal_accuracy:double = Location;
|
|
|
|
//@description Describes a venue @location Venue location; as defined by the sender @title Venue name; as defined by the sender @address Venue address; as defined by the sender @provider Provider of the venue database; as defined by the sender. Currently only "foursquare" and "gplaces" (Google Places) need to be supported
|
|
//@id Identifier of the venue in the provider database; as defined by the sender @type Type of the venue in the provider database; as defined by the sender
|
|
venue location:location title:string address:string provider:string id:string type:string = Venue;
|
|
|
|
//@description Describes a game @id Game ID @short_name Game short name. To share a game use the URL https://t.me/{bot_username}?game={game_short_name} @title Game title @text Game text, usually containing scoreboards for a game
|
|
//@param_description Game description @photo Game photo @animation Game animation; may be null
|
|
game id:int64 short_name:string title:string text:formattedText description:string photo:photo animation:animation = Game;
|
|
|
|
//@description Describes a poll @id Unique poll identifier @question Poll question; 1-300 characters @options List of poll answer options
|
|
//@total_voter_count Total number of voters, participating in the poll @recent_voter_user_ids User identifiers of recent voters, if the poll is non-anonymous
|
|
//@is_anonymous True, if the poll is anonymous @type Type of the poll
|
|
//@open_period Amount of time the poll will be active after creation, in seconds @close_date Point in time (Unix timestamp) when the poll will be automatically closed @is_closed True, if the poll is closed
|
|
poll id:int64 question:string options:vector<pollOption> total_voter_count:int32 recent_voter_user_ids:vector<int32> is_anonymous:Bool type:PollType open_period:int32 close_date:int32 is_closed:Bool = Poll;
|
|
|
|
|
|
//@description Describes a user profile photo @id Photo identifier; 0 for an empty photo. Can be used to find a photo in a list of user profile photos
|
|
//@small A small (160x160) user profile photo. The file can be downloaded only before the photo is changed
|
|
//@big A big (640x640) user profile photo. The file can be downloaded only before the photo is changed
|
|
//@has_animation True, if the photo has animated variant
|
|
profilePhoto id:int64 small:file big:file has_animation:Bool = ProfilePhoto;
|
|
|
|
//@description Contains basic information about the photo of a chat
|
|
//@small A small (160x160) chat photo variant in JPEG format. The file can be downloaded only before the photo is changed
|
|
//@big A big (640x640) chat photo variant in JPEG format. The file can be downloaded only before the photo is changed
|
|
//@has_animation True, if the photo has animated variant
|
|
chatPhotoInfo small:file big:file has_animation:Bool = ChatPhotoInfo;
|
|
|
|
|
|
//@class UserType @description Represents the type of a user. The following types are possible: regular users, deleted users and bots
|
|
|
|
//@description A regular user
|
|
userTypeRegular = UserType;
|
|
|
|
//@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
|
|
userTypeDeleted = UserType;
|
|
|
|
//@description A bot (see https://core.telegram.org/bots) @can_join_groups True, if the bot can be invited to basic group and supergroup chats
|
|
//@can_read_all_group_messages 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
|
|
//@is_inline True, if the bot supports inline queries @inline_query_placeholder Placeholder for inline queries (displayed on the application input field) @need_location True, if the location of the user should be sent with every inline query to this bot
|
|
userTypeBot can_join_groups:Bool can_read_all_group_messages:Bool is_inline:Bool inline_query_placeholder:string need_location:Bool = UserType;
|
|
|
|
//@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
|
|
userTypeUnknown = UserType;
|
|
|
|
|
|
//@description Represents a command supported by a bot @command Text of the bot command @param_description Description of the bot command
|
|
botCommand command:string description:string = BotCommand;
|
|
|
|
//@description Provides information about a bot and its supported commands @param_description Long description shown on the user info page @commands A list of commands supported by the bot
|
|
botInfo description:string commands:vector<botCommand> = BotInfo;
|
|
|
|
|
|
//@description Represents a location to which a chat is connected @location The location @address Location address; 1-64 characters, as defined by the chat owner
|
|
chatLocation location:location address:string = ChatLocation;
|
|
|
|
|
|
//@description Animated variant of a chat photo in MPEG4 format
|
|
//@length Animation width and height
|
|
//@file Information about the animation file
|
|
//@main_frame_timestamp Timestamp of the frame, used as a static chat photo
|
|
animatedChatPhoto length:int32 file:file main_frame_timestamp:double = AnimatedChatPhoto;
|
|
|
|
|
|
//@description Describes a chat or user profile photo
|
|
//@id Unique photo identifier
|
|
//@added_date Point in time (Unix timestamp) when the photo has been added
|
|
//@minithumbnail Photo minithumbnail; may be null
|
|
//@sizes Available variants of the photo in JPEG format, in different size
|
|
//@animation Animated variant of the photo in MPEG4 format; may be null
|
|
chatPhoto id:int64 added_date:int32 minithumbnail:minithumbnail sizes:vector<photoSize> animation:animatedChatPhoto = ChatPhoto;
|
|
|
|
//@description Contains a list of chat or user profile photos @total_count Total number of photos @photos List of photos
|
|
chatPhotos total_count:int32 photos:vector<chatPhoto> = ChatPhotos;
|
|
|
|
|
|
//@class InputChatPhoto @description Describes a photo to be set as a user profile or chat photo
|
|
|
|
//@description A previously used profile photo of the current user @chat_photo_id Identifier of the current user's profile photo to reuse
|
|
inputChatPhotoPrevious chat_photo_id:int64 = InputChatPhoto;
|
|
|
|
//@description A static photo in JPEG format @photo Photo to be set as profile photo. Only inputFileLocal and inputFileGenerated are allowed
|
|
inputChatPhotoStatic photo:InputFile = InputChatPhoto;
|
|
|
|
//@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
|
|
//@animation Animation to be set as profile photo. Only inputFileLocal and inputFileGenerated are allowed
|
|
//@main_frame_timestamp Timestamp of the frame, which will be used as static chat photo
|
|
inputChatPhotoAnimation animation:InputFile main_frame_timestamp:double = InputChatPhoto;
|
|
|
|
|
|
//@description Represents a user
|
|
//@id User identifier
|
|
//@first_name First name of the user
|
|
//@last_name Last name of the user
|
|
//@username Username of the user
|
|
//@phone_number Phone number of the user
|
|
//@status Current online status of the user
|
|
//@profile_photo Profile photo of the user; may be null
|
|
//@is_contact The user is a contact of the current user
|
|
//@is_mutual_contact The user is a contact of the current user and the current user is a contact of the user
|
|
//@is_verified True, if the user is verified
|
|
//@is_support True, if the user is Telegram support account
|
|
//@restriction_reason If non-empty, it contains a human-readable description of the reason why access to this user must be restricted
|
|
//@is_scam True, if many users reported this user as a scam
|
|
//@is_fake True, if many users reported this user as a fake account
|
|
//@have_access 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
|
|
//@type Type of the user
|
|
//@language_code IETF language tag of the user's language; only available to bots
|
|
user id:int32 first_name:string last_name:string username:string phone_number:string status:UserStatus profile_photo:profilePhoto is_contact:Bool is_mutual_contact:Bool is_verified:Bool is_support:Bool restriction_reason:string is_scam:Bool is_fake:Bool have_access:Bool type:UserType language_code:string = User;
|
|
|
|
//@description Contains full information about a user
|
|
//@photo User profile photo; may be null
|
|
//@is_blocked True, if the user is blocked by the current user
|
|
//@can_be_called True, if the user can be called
|
|
//@supports_video_calls True, if a video call can be created with the user
|
|
//@has_private_calls True, if the user can't be called due to their privacy settings
|
|
//@need_phone_number_privacy_exception True, if the current user needs to explicitly allow to share their phone number with the user when the method addContact is used
|
|
//@bio A short user bio @share_text For bots, the text that is included with the link when users share the bot
|
|
//@group_in_common_count Number of group chats where both the other user and the current user are a member; 0 for the current user
|
|
//@bot_info If the user is a bot, information about the bot; may be null
|
|
userFullInfo photo:chatPhoto is_blocked:Bool can_be_called:Bool supports_video_calls:Bool has_private_calls:Bool need_phone_number_privacy_exception:Bool bio:string share_text:string group_in_common_count:int32 bot_info:botInfo = UserFullInfo;
|
|
|
|
//@description Represents a list of users @total_count Approximate total count of users found @user_ids A list of user identifiers
|
|
users total_count:int32 user_ids:vector<int32> = Users;
|
|
|
|
|
|
//@description Contains information about a chat administrator @user_id User identifier of the administrator @custom_title Custom title of the administrator @is_owner True, if the user is the owner of the chat
|
|
chatAdministrator user_id:int32 custom_title:string is_owner:Bool = ChatAdministrator;
|
|
|
|
//@description Represents a list of chat administrators @administrators A list of chat administrators
|
|
chatAdministrators administrators:vector<chatAdministrator> = ChatAdministrators;
|
|
|
|
|
|
//@description Describes actions that a user is allowed to take in a chat
|
|
//@can_send_messages True, if the user can send text messages, contacts, locations, and venues
|
|
//@can_send_media_messages True, if the user can send audio files, documents, photos, videos, video notes, and voice notes. Implies can_send_messages permissions
|
|
//@can_send_polls True, if the user can send polls. Implies can_send_messages permissions
|
|
//@can_send_other_messages True, if the user can send animations, games, stickers, and dice and use inline bots. Implies can_send_messages permissions
|
|
//@can_add_web_page_previews True, if the user may add a web page preview to their messages. Implies can_send_messages permissions
|
|
//@can_change_info True, if the user can change the chat title, photo, and other settings
|
|
//@can_invite_users True, if the user can invite new users to the chat
|
|
//@can_pin_messages True, if the user can pin messages
|
|
chatPermissions can_send_messages:Bool can_send_media_messages:Bool can_send_polls:Bool can_send_other_messages:Bool can_add_web_page_previews:Bool can_change_info:Bool can_invite_users:Bool can_pin_messages:Bool = ChatPermissions;
|
|
|
|
|
|
//@class ChatMemberStatus @description Provides information about the status of a member in a chat
|
|
|
|
//@description The user is the owner of a chat and has all the administrator privileges
|
|
//@custom_title A custom title of the owner; 0-16 characters without emojis; applicable to supergroups only
|
|
//@is_anonymous True, if the creator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only
|
|
//@is_member True, if the user is a member of the chat
|
|
chatMemberStatusCreator custom_title:string is_anonymous:Bool is_member:Bool = ChatMemberStatus;
|
|
|
|
//@description The user is a member of a 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 voice chats. In supergroups and channels, there are more detailed options for administrator privileges
|
|
//@custom_title A custom title of the administrator; 0-16 characters without emojis; applicable to supergroups only
|
|
//@can_be_edited True, if the current user can edit the administrator privileges for the called user
|
|
//@can_manage_chat 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
|
|
//@can_change_info True, if the administrator can change the chat title, photo, and other settings
|
|
//@can_post_messages True, if the administrator can create channel posts; applicable to channels only
|
|
//@can_edit_messages True, if the administrator can edit messages of other users and pin messages; applicable to channels only
|
|
//@can_delete_messages True, if the administrator can delete messages of other users
|
|
//@can_invite_users True, if the administrator can invite new users to the chat
|
|
//@can_restrict_members True, if the administrator can restrict, ban, or unban chat members
|
|
//@can_pin_messages True, if the administrator can pin messages; applicable to basic groups and supergroups only
|
|
//@can_promote_members 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
|
|
//@can_manage_voice_chats True, if the administrator can manage voice chats
|
|
//@is_anonymous True, if the administrator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only
|
|
chatMemberStatusAdministrator custom_title:string can_be_edited:Bool can_manage_chat:Bool can_change_info:Bool can_post_messages:Bool can_edit_messages:Bool can_delete_messages:Bool can_invite_users:Bool can_restrict_members:Bool can_pin_messages:Bool can_promote_members:Bool can_manage_voice_chats:Bool is_anonymous:Bool = ChatMemberStatus;
|
|
|
|
//@description The user is a member of a chat, without any additional privileges or restrictions
|
|
chatMemberStatusMember = ChatMemberStatus;
|
|
|
|
//@description The user is under certain restrictions in the chat. Not supported in basic groups and channels
|
|
//@is_member True, if the user is a member of the chat
|
|
//@restricted_until_date 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
|
|
//@permissions User permissions in the chat
|
|
chatMemberStatusRestricted is_member:Bool restricted_until_date:int32 permissions:chatPermissions = ChatMemberStatus;
|
|
|
|
//@description The user is not a chat member
|
|
chatMemberStatusLeft = ChatMemberStatus;
|
|
|
|
//@description The user was banned (and hence is not a member of the chat). Implies the user can't return to the chat or view messages
|
|
//@banned_until_date 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
|
|
chatMemberStatusBanned banned_until_date:int32 = ChatMemberStatus;
|
|
|
|
|
|
//@description A user with information about joining/leaving a chat @user_id User identifier of the chat member
|
|
//@inviter_user_id Identifier of a user that invited/promoted/banned this member in the chat; 0 if unknown
|
|
//@joined_chat_date Point in time (Unix timestamp) when the user joined the chat
|
|
//@status Status of the member in the chat
|
|
//@bot_info If the user is a bot, information about the bot; may be null. Can be null even for a bot if the bot is not the chat member
|
|
chatMember user_id:int32 inviter_user_id:int32 joined_chat_date:int32 status:ChatMemberStatus bot_info:botInfo = ChatMember;
|
|
|
|
//@description Contains a list of chat members @total_count Approximate total count of chat members found @members A list of chat members
|
|
chatMembers total_count:int32 members:vector<chatMember> = ChatMembers;
|
|
|
|
|
|
//@class ChatMembersFilter @description Specifies the kind of chat members to return in searchChatMembers
|
|
|
|
//@description Returns contacts of the user
|
|
chatMembersFilterContacts = ChatMembersFilter;
|
|
|
|
//@description Returns the owner and administrators
|
|
chatMembersFilterAdministrators = ChatMembersFilter;
|
|
|
|
//@description Returns all chat members, including restricted chat members
|
|
chatMembersFilterMembers = ChatMembersFilter;
|
|
|
|
//@description Returns users which can be mentioned in the chat @message_thread_id If non-zero, the identifier of the current message thread
|
|
chatMembersFilterMention message_thread_id:int53 = ChatMembersFilter;
|
|
|
|
//@description Returns users under certain restrictions in the chat; can be used only by administrators in a supergroup
|
|
chatMembersFilterRestricted = ChatMembersFilter;
|
|
|
|
//@description Returns users banned from the chat; can be used only by administrators in a supergroup or in a channel
|
|
chatMembersFilterBanned = ChatMembersFilter;
|
|
|
|
//@description Returns bot members of the chat
|
|
chatMembersFilterBots = ChatMembersFilter;
|
|
|
|
|
|
//@class SupergroupMembersFilter @description Specifies the kind of chat members to return in getSupergroupMembers
|
|
|
|
//@description Returns recently active users in reverse chronological order
|
|
supergroupMembersFilterRecent = SupergroupMembersFilter;
|
|
|
|
//@description Returns contacts of the user, which are members of the supergroup or channel @query Query to search for
|
|
supergroupMembersFilterContacts query:string = SupergroupMembersFilter;
|
|
|
|
//@description Returns the owner and administrators
|
|
supergroupMembersFilterAdministrators = SupergroupMembersFilter;
|
|
|
|
//@description Used to search for supergroup or channel members via a (string) query @query Query to search for
|
|
supergroupMembersFilterSearch query:string = SupergroupMembersFilter;
|
|
|
|
//@description Returns restricted supergroup members; can be used only by administrators @query Query to search for
|
|
supergroupMembersFilterRestricted query:string = SupergroupMembersFilter;
|
|
|
|
//@description Returns users banned from the supergroup or channel; can be used only by administrators @query Query to search for
|
|
supergroupMembersFilterBanned query:string = SupergroupMembersFilter;
|
|
|
|
//@description Returns users which can be mentioned in the supergroup @query Query to search for @message_thread_id If non-zero, the identifier of the current message thread
|
|
supergroupMembersFilterMention query:string message_thread_id:int53 = SupergroupMembersFilter;
|
|
|
|
//@description Returns bot members of the supergroup or channel
|
|
supergroupMembersFilterBots = SupergroupMembersFilter;
|
|
|
|
|
|
//@description Contains a chat invite link @invite_link Chat invite link @creator_user_id User identifier of an administrator created the link
|
|
//@date Point in time (Unix timestamp) when the link was created
|
|
//@edit_date Point in time (Unix timestamp) when the link was last edited; 0 if never or unknown
|
|
//@expire_date Point in time (Unix timestamp) when the link will expire; 0 if never
|
|
//@member_limit Maximum number of members, which can join the chat using the link simultaneously; 0 if not limited
|
|
//@member_count Number of chat members, which joined the chat using the link
|
|
//@is_primary True, if the link is primary. Primary invite link can't have expire date or usage limit. There is exactly one primary invite link for each administrator with can_invite_users right at a given time
|
|
//@is_revoked True, if the link was revoked
|
|
chatInviteLink invite_link:string creator_user_id:int32 date:int32 edit_date:int32 expire_date:int32 member_limit:int32 member_count:int32 is_primary:Bool is_revoked:Bool = ChatInviteLink;
|
|
|
|
//@description Contains a list of chat invite links @total_count Approximate total count of chat invite links found @invite_links List of invite links
|
|
chatInviteLinks total_count:int32 invite_links:vector<chatInviteLink> = ChatInviteLinks;
|
|
|
|
//@description Describes a chat administrator with a number of active and revoked chat invite links
|
|
//@user_id Administrator's user identifier
|
|
//@invite_link_count Number of active invite links
|
|
//@revoked_invite_link_count Number of revoked invite links
|
|
chatInviteLinkCount user_id:int32 invite_link_count:int32 revoked_invite_link_count:int32 = ChatInviteLinkCount;
|
|
|
|
//@description Contains a list of chat invite link counts @invite_link_counts List of invite linkcounts
|
|
chatInviteLinkCounts invite_link_counts:vector<chatInviteLinkCount> = ChatInviteLinkCounts;
|
|
|
|
//@description Describes a chat member joined a chat by an invite link @user_id User identifier @joined_chat_date Point in time (Unix timestamp) when the user joined the chat
|
|
chatInviteLinkMember user_id:int32 joined_chat_date:int32 = ChatInviteLinkMember;
|
|
|
|
//@description Contains a list of chat members joined a chat by an invite link @total_count Approximate total count of chat members found @members List of chat members, joined a chat by an invite link
|
|
chatInviteLinkMembers total_count:int32 members:vector<chatInviteLinkMember> = ChatInviteLinkMembers;
|
|
|
|
//@description Contains information about a chat invite link
|
|
//@chat_id Chat identifier of the invite link; 0 if the user has no access to the chat before joining
|
|
//@accessible_for If non-zero, the amount of time for which read access to the chat will remain available, in seconds
|
|
//@type Contains information about the type of the chat
|
|
//@title Title of the chat
|
|
//@photo Chat photo; may be null
|
|
//@member_count Number of members in the chat
|
|
//@member_user_ids User identifiers of some chat members that may be known to the current user
|
|
//@is_public True, if the chat is a public supergroup or channel, i.e. it has a username or it is a location-based supergroup
|
|
chatInviteLinkInfo chat_id:int53 accessible_for:int32 type:ChatType title:string photo:chatPhotoInfo member_count:int32 member_user_ids:vector<int32> is_public:Bool = ChatInviteLinkInfo;
|
|
|
|
|
|
//@description Represents a basic group of 0-200 users (must be upgraded to a supergroup to accommodate more than 200 users)
|
|
//@id Group identifier
|
|
//@member_count Number of members in the group
|
|
//@status Status of the current user in the group
|
|
//@is_active True, if the group is active
|
|
//@upgraded_to_supergroup_id Identifier of the supergroup to which this group was upgraded; 0 if none
|
|
basicGroup id:int32 member_count:int32 status:ChatMemberStatus is_active:Bool upgraded_to_supergroup_id:int32 = BasicGroup;
|
|
|
|
//@description Contains full information about a basic group
|
|
//@photo Chat photo; may be null
|
|
//@param_description Group description. Updated only after the basic group is opened
|
|
//@creator_user_id User identifier of the creator of the group; 0 if unknown
|
|
//@members Group members
|
|
//@invite_link 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
|
|
basicGroupFullInfo photo:chatPhoto description:string creator_user_id:int32 members:vector<chatMember> invite_link:chatInviteLink = BasicGroupFullInfo;
|
|
|
|
|
|
//@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
|
|
//@id Supergroup or channel identifier
|
|
//@username Username of the supergroup or channel; empty for private supergroups or channels
|
|
//@date 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
|
|
//@status Status of the current user in the supergroup or channel; custom title will be always empty
|
|
//@member_count 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
|
|
//@has_linked_chat True, if the channel has a discussion group, or the supergroup is the designated discussion group for a channel
|
|
//@has_location True, if the supergroup is connected to a location, i.e. the supergroup is a location-based supergroup
|
|
//@sign_messages True, if messages sent to the channel should contain information about the sender. This field is only applicable to channels
|
|
//@is_slow_mode_enabled True, if the slow mode is enabled in the supergroup
|
|
//@is_channel True, if the supergroup is a channel
|
|
//@is_broadcast_group True, if the supergroup is a broadcast group, i.e. only administrators can send messages and there is no limit on number of members
|
|
//@is_verified True, if the supergroup or channel is verified
|
|
//@restriction_reason If non-empty, contains a human-readable description of the reason why access to this supergroup or channel must be restricted
|
|
//@is_scam True, if many users reported this supergroup or channel as a scam
|
|
//@is_fake True, if many users reported this supergroup or channel as a fake account
|
|
supergroup id:int32 username:string date:int32 status:ChatMemberStatus member_count:int32 has_linked_chat:Bool has_location:Bool sign_messages:Bool is_slow_mode_enabled:Bool is_channel:Bool is_broadcast_group:Bool is_verified:Bool restriction_reason:string is_scam:Bool is_fake:Bool = Supergroup;
|
|
|
|
//@description Contains full information about a supergroup or channel
|
|
//@photo Chat photo; may be null
|
|
//@param_description Supergroup or channel description
|
|
//@member_count Number of members in the supergroup or channel; 0 if unknown
|
|
//@administrator_count Number of privileged users in the supergroup or channel; 0 if unknown
|
|
//@restricted_count Number of restricted users in the supergroup; 0 if unknown
|
|
//@banned_count Number of users banned from chat; 0 if unknown
|
|
//@linked_chat_id 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
|
|
//@slow_mode_delay Delay between consecutive sent messages for non-administrator supergroup members, in seconds
|
|
//@slow_mode_delay_expires_in 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
|
|
//@can_get_members True, if members of the chat can be retrieved
|
|
//@can_set_username True, if the chat username can be changed
|
|
//@can_set_sticker_set True, if the supergroup sticker set can be changed
|
|
//@can_set_location True, if the supergroup location can be changed
|
|
//@can_get_statistics True, if the supergroup or channel statistics are available
|
|
//@is_all_history_available 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
|
|
//@sticker_set_id Identifier of the supergroup sticker set; 0 if none
|
|
//@location Location to which the supergroup is connected; may be null
|
|
//@invite_link Primary invite link for this chat; may be null. For chat administrators with can_invite_users right only
|
|
//@upgraded_from_basic_group_id Identifier of the basic group from which supergroup was upgraded; 0 if none
|
|
//@upgraded_from_max_message_id Identifier of the last message in the basic group from which supergroup was upgraded; 0 if none
|
|
supergroupFullInfo photo:chatPhoto description:string member_count:int32 administrator_count:int32 restricted_count:int32 banned_count:int32 linked_chat_id:int53 slow_mode_delay:int32 slow_mode_delay_expires_in:double can_get_members:Bool can_set_username:Bool can_set_sticker_set:Bool can_set_location:Bool can_get_statistics:Bool is_all_history_available:Bool sticker_set_id:int64 location:chatLocation invite_link:chatInviteLink upgraded_from_basic_group_id:int32 upgraded_from_max_message_id:int53 = SupergroupFullInfo;
|
|
|
|
|
|
//@class SecretChatState @description Describes the current secret chat state
|
|
|
|
//@description The secret chat is not yet created; waiting for the other user to get online
|
|
secretChatStatePending = SecretChatState;
|
|
|
|
//@description The secret chat is ready to use
|
|
secretChatStateReady = SecretChatState;
|
|
|
|
//@description The secret chat is closed
|
|
secretChatStateClosed = SecretChatState;
|
|
|
|
|
|
//@description Represents a secret chat
|
|
//@id Secret chat identifier
|
|
//@user_id Identifier of the chat partner
|
|
//@state State of the secret chat
|
|
//@is_outbound True, if the chat was created by the current user; otherwise false
|
|
//@key_hash 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
|
|
//@layer Secret chat layer; determines features supported by the chat partner's application. Video notes are supported if the layer >= 66; nested text entities and underline and strikethrough entities are supported if the layer >= 101
|
|
secretChat id:int32 user_id:int32 state:SecretChatState is_outbound:Bool key_hash:bytes layer:int32 = SecretChat;
|
|
|
|
|
|
//@class MessageSender @description Contains information about the sender of a message
|
|
|
|
//@description The message was sent by a known user @user_id Identifier of the user that sent the message
|
|
messageSenderUser user_id:int32 = MessageSender;
|
|
|
|
//@description The message was sent on behalf of a chat @chat_id Identifier of the chat that sent the message
|
|
messageSenderChat chat_id:int53 = MessageSender;
|
|
|
|
|
|
//@description Represents a list of message senders @total_count Approximate total count of messages senders found @senders List of message senders
|
|
messageSenders total_count:int32 senders:vector<MessageSender> = MessageSenders;
|
|
|
|
|
|
//@class MessageForwardOrigin @description Contains information about the origin of a forwarded message
|
|
|
|
//@description The message was originally sent by a known user @sender_user_id Identifier of the user that originally sent the message
|
|
messageForwardOriginUser sender_user_id:int32 = MessageForwardOrigin;
|
|
|
|
//@description The message was originally sent by an anonymous chat administrator on behalf of the chat
|
|
//@sender_chat_id Identifier of the chat that originally sent the message
|
|
//@author_signature Original message author signature
|
|
messageForwardOriginChat sender_chat_id:int53 author_signature:string = MessageForwardOrigin;
|
|
|
|
//@description The message was originally sent by a user, which is hidden by their privacy settings @sender_name Name of the sender
|
|
messageForwardOriginHiddenUser sender_name:string = MessageForwardOrigin;
|
|
|
|
//@description The message was originally a post in a channel
|
|
//@chat_id Identifier of the chat from which the message was originally forwarded
|
|
//@message_id Message identifier of the original message
|
|
//@author_signature Original post author signature
|
|
messageForwardOriginChannel chat_id:int53 message_id:int53 author_signature:string = MessageForwardOrigin;
|
|
|
|
//@description The message was imported from an exported message history @sender_name Name of the sender
|
|
messageForwardOriginMessageImport sender_name:string = MessageForwardOrigin;
|
|
|
|
|
|
//@description Contains information about a forwarded message
|
|
//@origin Origin of a forwarded message
|
|
//@date Point in time (Unix timestamp) when the message was originally sent
|
|
//@public_service_announcement_type The type of a public service announcement for the forwarded message
|
|
//@from_chat_id 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
|
|
//@from_message_id 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
|
|
messageForwardInfo origin:MessageForwardOrigin date:int32 public_service_announcement_type:string from_chat_id:int53 from_message_id:int53 = MessageForwardInfo;
|
|
|
|
//@description Contains information about replies to a message
|
|
//@reply_count Number of times the message was directly or indirectly replied
|
|
//@recent_repliers Recent repliers to the message; available in channels with a discussion supergroup
|
|
//@last_read_inbox_message_id Identifier of the last read incoming reply to the message
|
|
//@last_read_outbox_message_id Identifier of the last read outgoing reply to the message
|
|
//@last_message_id Identifier of the last reply to the message
|
|
messageReplyInfo reply_count:int32 recent_repliers:vector<MessageSender> last_read_inbox_message_id:int53 last_read_outbox_message_id:int53 last_message_id:int53 = MessageReplyInfo;
|
|
|
|
//@description Contains information about interactions with a message
|
|
//@view_count Number of times the message was viewed
|
|
//@forward_count Number of times the message was forwarded
|
|
//@reply_info Contains 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
|
|
messageInteractionInfo view_count:int32 forward_count:int32 reply_info:messageReplyInfo = MessageInteractionInfo;
|
|
|
|
|
|
//@class MessageSendingState @description Contains information about the sending state of the message
|
|
|
|
//@description The message is being sent now, but has not yet been delivered to the server
|
|
messageSendingStatePending = MessageSendingState;
|
|
|
|
//@description The message failed to be sent @error_code An error code; 0 if unknown @error_message Error message
|
|
//@can_retry True, if the message can be re-sent @retry_after Time left before the message can be re-sent, in seconds. No update is sent when this field changes
|
|
messageSendingStateFailed error_code:int32 error_message:string can_retry:Bool retry_after:double = MessageSendingState;
|
|
|
|
|
|
//@description Describes a message
|
|
//@id Message identifier; unique for the chat to which the message belongs
|
|
//@sender The sender of the message
|
|
//@chat_id Chat identifier
|
|
//@sending_state Information about the sending state of the message; may be null
|
|
//@scheduling_state Information about the scheduling state of the message; may be null
|
|
//@is_outgoing True, if the message is outgoing
|
|
//@is_pinned True, if the message is pinned
|
|
//@can_be_edited 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
|
|
//@can_be_forwarded True, if the message can be forwarded
|
|
//@can_be_deleted_only_for_self True, if the message can be deleted only for the current user while other users will continue to see it
|
|
//@can_be_deleted_for_all_users True, if the message can be deleted for all users
|
|
//@can_get_statistics True, if the message statistics are available
|
|
//@can_get_message_thread True, if the message thread info is available
|
|
//@is_channel_post True, if the message is a channel post. All messages to channels are channel posts, all other messages are not channel posts
|
|
//@contains_unread_mention True, if the message contains an unread mention for the current user
|
|
//@date Point in time (Unix timestamp) when the message was sent
|
|
//@edit_date Point in time (Unix timestamp) when the message was last edited
|
|
//@forward_info Information about the initial message sender; may be null
|
|
//@interaction_info Information about interactions with the message; may be null
|
|
//@reply_in_chat_id 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
|
|
//@reply_to_message_id If non-zero, the identifier of the message this message is replying to; can be the identifier of a deleted message
|
|
//@message_thread_id If non-zero, the identifier of the message thread the message belongs to; unique within the chat to which the message belongs
|
|
//@ttl 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
|
|
//@ttl_expires_in Time left before the message expires, in seconds
|
|
//@via_bot_user_id If non-zero, the user identifier of the bot through which this message was sent
|
|
//@author_signature For channel posts and anonymous group messages, optional author signature
|
|
//@media_album_id Unique identifier of an album this message belongs to. Only audios, documents, photos and videos can be grouped together in albums
|
|
//@restriction_reason If non-empty, contains a human-readable description of the reason why access to this message must be restricted
|
|
//@content Content of the message
|
|
//@reply_markup Reply markup for the message; may be null
|
|
message id:int53 sender:MessageSender chat_id:int53 sending_state:MessageSendingState scheduling_state:MessageSchedulingState is_outgoing:Bool is_pinned:Bool can_be_edited:Bool can_be_forwarded:Bool can_be_deleted_only_for_self:Bool can_be_deleted_for_all_users:Bool can_get_statistics:Bool can_get_message_thread:Bool is_channel_post:Bool contains_unread_mention:Bool date:int32 edit_date:int32 forward_info:messageForwardInfo interaction_info:messageInteractionInfo reply_in_chat_id:int53 reply_to_message_id:int53 message_thread_id:int53 ttl:int32 ttl_expires_in:double via_bot_user_id:int32 author_signature:string media_album_id:int64 restriction_reason:string content:MessageContent reply_markup:ReplyMarkup = Message;
|
|
|
|
//@description Contains a list of messages @total_count Approximate total count of messages found @messages List of messages; messages may be null
|
|
messages total_count:int32 messages:vector<message> = Messages;
|
|
|
|
//@description Contains a list of messages found by a search @total_count Approximate total count of messages found; -1 if unknown @messages List of messages @next_offset The offset for the next request. If empty, there are no more results
|
|
foundMessages total_count:int32 messages:vector<message> next_offset:string = FoundMessages;
|
|
|
|
|
|
//@class NotificationSettingsScope @description Describes the types of chats to which notification settings are applied
|
|
|
|
//@description Notification settings applied to all private and secret chats when the corresponding chat setting has a default value
|
|
notificationSettingsScopePrivateChats = NotificationSettingsScope;
|
|
|
|
//@description Notification settings applied to all basic groups and supergroups when the corresponding chat setting has a default value
|
|
notificationSettingsScopeGroupChats = NotificationSettingsScope;
|
|
|
|
//@description Notification settings applied to all channels when the corresponding chat setting has a default value
|
|
notificationSettingsScopeChannelChats = NotificationSettingsScope;
|
|
|
|
|
|
//@description Contains information about notification settings for a chat
|
|
//@use_default_mute_for If true, mute_for is ignored and the value for the relevant type of chat is used instead @mute_for Time left before notifications will be unmuted, in seconds
|
|
//@use_default_sound If true, sound is ignored and the value for the relevant type of chat is used instead @sound The name of an audio file to be used for notification sounds; only applies to iOS applications
|
|
//@use_default_show_preview If true, show_preview is ignored and the value for the relevant type of chat is used instead @show_preview True, if message content should be displayed in notifications
|
|
//@use_default_disable_pinned_message_notifications If true, disable_pinned_message_notifications is ignored and the value for the relevant type of chat is used instead @disable_pinned_message_notifications If true, notifications for incoming pinned messages will be created as for an ordinary unread message
|
|
//@use_default_disable_mention_notifications If true, disable_mention_notifications is ignored and the value for the relevant type of chat is used instead @disable_mention_notifications If true, notifications for messages with mentions will be created as for an ordinary unread message
|
|
chatNotificationSettings use_default_mute_for:Bool mute_for:int32 use_default_sound:Bool sound:string use_default_show_preview:Bool show_preview:Bool use_default_disable_pinned_message_notifications:Bool disable_pinned_message_notifications:Bool use_default_disable_mention_notifications:Bool disable_mention_notifications:Bool = ChatNotificationSettings;
|
|
|
|
//@description Contains information about notification settings for several chats
|
|
//@mute_for Time left before notifications will be unmuted, in seconds
|
|
//@sound The name of an audio file to be used for notification sounds; only applies to iOS applications
|
|
//@show_preview True, if message content should be displayed in notifications
|
|
//@disable_pinned_message_notifications True, if notifications for incoming pinned messages will be created as for an ordinary unread message
|
|
//@disable_mention_notifications True, if notifications for messages with mentions will be created as for an ordinary unread message
|
|
scopeNotificationSettings mute_for:int32 sound:string show_preview:Bool disable_pinned_message_notifications:Bool disable_mention_notifications:Bool = ScopeNotificationSettings;
|
|
|
|
|
|
//@description Contains information about a message draft
|
|
//@reply_to_message_id Identifier of the message to reply to; 0 if none
|
|
//@date Point in time (Unix timestamp) when the draft was created
|
|
//@input_message_text Content of the message draft; this should always be of type inputMessageText
|
|
draftMessage reply_to_message_id:int53 date:int32 input_message_text:InputMessageContent = DraftMessage;
|
|
|
|
|
|
//@class ChatType @description Describes the type of a chat
|
|
|
|
//@description An ordinary chat with a user @user_id User identifier
|
|
chatTypePrivate user_id:int32 = ChatType;
|
|
|
|
//@description A basic group (i.e., a chat with 0-200 other users) @basic_group_id Basic group identifier
|
|
chatTypeBasicGroup basic_group_id:int32 = ChatType;
|
|
|
|
//@description A supergroup (i.e. a chat with up to GetOption("supergroup_max_size") other users), or channel (with unlimited members) @supergroup_id Supergroup or channel identifier @is_channel True, if the supergroup is a channel
|
|
chatTypeSupergroup supergroup_id:int32 is_channel:Bool = ChatType;
|
|
|
|
//@description A secret chat with a user @secret_chat_id Secret chat identifier @user_id User identifier of the secret chat peer
|
|
chatTypeSecret secret_chat_id:int32 user_id:int32 = ChatType;
|
|
|
|
|
|
//@description Represents a filter of user chats
|
|
//@title The title of the filter; 1-12 characters without line feeds
|
|
//@icon_name 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
|
|
//@pinned_chat_ids The chat identifiers of pinned chats in the filtered chat list
|
|
//@included_chat_ids The chat identifiers of always included chats in the filtered chat list
|
|
//@excluded_chat_ids The chat identifiers of always excluded chats in the filtered chat list
|
|
//@exclude_muted True, if muted chats need to be excluded
|
|
//@exclude_read True, if read chats need to be excluded
|
|
//@exclude_archived True, if archived chats need to be excluded
|
|
//@include_contacts True, if contacts need to be included
|
|
//@include_non_contacts True, if non-contact users need to be included
|
|
//@include_bots True, if bots need to be included
|
|
//@include_groups True, if basic groups and supergroups need to be included
|
|
//@include_channels True, if channels need to be included
|
|
chatFilter title:string icon_name:string pinned_chat_ids:vector<int53> included_chat_ids:vector<int53> excluded_chat_ids:vector<int53> exclude_muted:Bool exclude_read:Bool exclude_archived:Bool include_contacts:Bool include_non_contacts:Bool include_bots:Bool include_groups:Bool include_channels:Bool = ChatFilter;
|
|
|
|
//@description Contains basic information about a chat filter
|
|
//@id Unique chat filter identifier
|
|
//@title The title of the filter; 1-12 characters without line feeds
|
|
//@icon_name 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"
|
|
chatFilterInfo id:int32 title:string icon_name:string = ChatFilterInfo;
|
|
|
|
//@description Describes a recommended chat filter @filter The chat filter @param_description Chat filter description
|
|
recommendedChatFilter filter:chatFilter description:string = RecommendedChatFilter;
|
|
|
|
//@description Contains a list of recommended chat filters @chat_filters List of recommended chat filters
|
|
recommendedChatFilters chat_filters:vector<recommendedChatFilter> = RecommendedChatFilters;
|
|
|
|
|
|
//@class ChatList @description Describes a list of chats
|
|
|
|
//@description A main list of chats
|
|
chatListMain = ChatList;
|
|
|
|
//@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
|
|
chatListArchive = ChatList;
|
|
|
|
//@description A list of chats belonging to a chat filter @chat_filter_id Chat filter identifier
|
|
chatListFilter chat_filter_id:int32 = ChatList;
|
|
|
|
//@description Contains a list of chat lists @chat_lists List of chat lists
|
|
chatLists chat_lists:vector<ChatList> = ChatLists;
|
|
|
|
|
|
//@class ChatSource @description Describes a reason why an external chat is shown in a chat list
|
|
|
|
//@description The chat is sponsored by the user's MTProxy server
|
|
chatSourceMtprotoProxy = ChatSource;
|
|
|
|
//@description The chat contains a public service announcement @type The type of the announcement @text The text of the announcement
|
|
chatSourcePublicServiceAnnouncement type:string text:string = ChatSource;
|
|
|
|
|
|
//@description Describes a position of a chat in a chat list
|
|
//@list The chat list
|
|
//@order 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
|
|
//@is_pinned True, if the chat is pinned in the chat list
|
|
//@source Source of the chat in the chat list; may be null
|
|
chatPosition list:ChatList order:int64 is_pinned:Bool source:ChatSource = ChatPosition;
|
|
|
|
|
|
//@description Describes a voice chat
|
|
//@group_call_id Group call identifier of an active voice chat; 0 if none. Full informationa about the voice chat can be received through the method getGroupCall
|
|
//@has_participants True, if the voice chat has participants
|
|
//@default_participant_alias Default group call participant identifier to join the voice chat; may be null
|
|
voiceChat group_call_id:int32 has_participants:Bool default_participant_alias:MessageSender = VoiceChat;
|
|
|
|
|
|
//@description A chat. (Can be a private chat, basic group, supergroup, or secret chat)
|
|
//@id Chat unique identifier
|
|
//@type Type of the chat
|
|
//@title Chat title
|
|
//@photo Chat photo; may be null
|
|
//@permissions Actions that non-administrator chat members are allowed to take in the chat
|
|
//@last_message Last message in the chat; may be null
|
|
//@positions Positions of the chat in chat lists
|
|
//@is_marked_as_unread True, if the chat is marked as unread
|
|
//@is_blocked True, if the chat is blocked by the current user and private messages from the chat can't be received
|
|
//@has_scheduled_messages True, if the chat has scheduled messages
|
|
//@can_be_deleted_only_for_self True, if the chat messages can be deleted only for the current user while other users will continue to see the messages
|
|
//@can_be_deleted_for_all_users True, if the chat messages can be deleted for all users
|
|
//@can_be_reported True, if the chat can be reported to Telegram moderators through reportChat or reportChatPhoto
|
|
//@default_disable_notification Default value of the disable_notification parameter, used when a message is sent to the chat
|
|
//@unread_count Number of unread messages in the chat
|
|
//@last_read_inbox_message_id Identifier of the last read incoming message
|
|
//@last_read_outbox_message_id Identifier of the last read outgoing message
|
|
//@unread_mention_count Number of unread messages with a mention/reply in the chat
|
|
//@notification_settings Notification settings for this chat
|
|
//@message_ttl_setting 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
|
|
//@action_bar Describes actions which should be possible to do through a chat action bar; may be null
|
|
//@voice_chat Contains information about voice chat of the chat
|
|
//@reply_markup_message_id Identifier of the message from which reply markup needs to be used; 0 if there is no default custom reply markup in the chat
|
|
//@draft_message A draft of a message in the chat; may be null
|
|
//@client_data Contains 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
|
|
chat id:int53 type:ChatType title:string photo:chatPhotoInfo permissions:chatPermissions last_message:message positions:vector<chatPosition> is_marked_as_unread:Bool is_blocked:Bool has_scheduled_messages:Bool can_be_deleted_only_for_self:Bool can_be_deleted_for_all_users:Bool can_be_reported:Bool default_disable_notification:Bool unread_count:int32 last_read_inbox_message_id:int53 last_read_outbox_message_id:int53 unread_mention_count:int32 notification_settings:chatNotificationSettings message_ttl_setting:int32 action_bar:ChatActionBar voice_chat:voiceChat reply_markup_message_id:int53 draft_message:draftMessage client_data:string = Chat;
|
|
|
|
//@description Represents a list of chats @total_count Approximate total count of chats found @chat_ids List of chat identifiers
|
|
chats total_count:int32 chat_ids:vector<int53> = Chats;
|
|
|
|
|
|
//@description Describes a chat located nearby @chat_id Chat identifier @distance Distance to the chat location, in meters
|
|
chatNearby chat_id:int53 distance:int32 = ChatNearby;
|
|
|
|
//@description Represents a list of chats located nearby @users_nearby List of users nearby @supergroups_nearby List of location-based supergroups nearby
|
|
chatsNearby users_nearby:vector<chatNearby> supergroups_nearby:vector<chatNearby> = ChatsNearby;
|
|
|
|
|
|
//@class PublicChatType @description Describes a type of public chats
|
|
|
|
//@description The chat is public, because it has username
|
|
publicChatTypeHasUsername = PublicChatType;
|
|
|
|
//@description The chat is public, because it is a location-based supergroup
|
|
publicChatTypeIsLocationBased = PublicChatType;
|
|
|
|
|
|
//@class ChatActionBar @description Describes actions which should be possible to do through a chat action bar
|
|
|
|
//@description The chat can be reported as spam using the method reportChat with the reason chatReportReasonSpam
|
|
//@can_unarchive 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
|
|
chatActionBarReportSpam can_unarchive:Bool = ChatActionBar;
|
|
|
|
//@description The chat is a location-based supergroup, which can be reported as having unrelated location using the method reportChat with the reason chatReportReasonUnrelatedLocation
|
|
chatActionBarReportUnrelatedLocation = ChatActionBar;
|
|
|
|
//@description The chat is a recently created group chat, to which new members can be invited
|
|
chatActionBarInviteMembers = ChatActionBar;
|
|
|
|
//@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 blockUser, or the other user can be added to the contact list using the method addContact
|
|
//@can_unarchive 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
|
|
//@distance If non-negative, the current user was found by the peer through searchChatsNearby and this is the distance between the users
|
|
chatActionBarReportAddBlock can_unarchive:Bool distance:int32 = ChatActionBar;
|
|
|
|
//@description The chat is a private or secret chat and the other user can be added to the contact list using the method addContact
|
|
chatActionBarAddContact = ChatActionBar;
|
|
|
|
//@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
|
|
chatActionBarSharePhoneNumber = ChatActionBar;
|
|
|
|
|
|
//@class KeyboardButtonType @description Describes a keyboard button type
|
|
|
|
//@description A simple button, with text that should be sent when the button is pressed
|
|
keyboardButtonTypeText = KeyboardButtonType;
|
|
|
|
//@description A button that sends the user's phone number when pressed; available only in private chats
|
|
keyboardButtonTypeRequestPhoneNumber = KeyboardButtonType;
|
|
|
|
//@description A button that sends the user's location when pressed; available only in private chats
|
|
keyboardButtonTypeRequestLocation = KeyboardButtonType;
|
|
|
|
//@description A button that allows the user to create and send a poll when pressed; available only in private chats @force_regular If true, only regular polls must be allowed to create @force_quiz If true, only polls in quiz mode must be allowed to create
|
|
keyboardButtonTypeRequestPoll force_regular:Bool force_quiz:Bool = KeyboardButtonType;
|
|
|
|
|
|
//@description Represents a single button in a bot keyboard @text Text of the button @type Type of the button
|
|
keyboardButton text:string type:KeyboardButtonType = KeyboardButton;
|
|
|
|
|
|
//@class InlineKeyboardButtonType @description Describes the type of an inline keyboard button
|
|
|
|
//@description A button that opens a specified URL @url HTTP or tg:// URL to open
|
|
inlineKeyboardButtonTypeUrl url:string = InlineKeyboardButtonType;
|
|
|
|
//@description A button that opens a specified URL and automatically authorize the current user if allowed to do so @url An HTTP URL to open @id Unique button identifier @forward_text If non-empty, new text of the button in forwarded messages
|
|
inlineKeyboardButtonTypeLoginUrl url:string id:int32 forward_text:string = InlineKeyboardButtonType;
|
|
|
|
//@description A button that sends a callback query to a bot @data Data to be sent to the bot via a callback query
|
|
inlineKeyboardButtonTypeCallback data:bytes = InlineKeyboardButtonType;
|
|
|
|
//@description A button that asks for password of the current user and then sends a callback query to a bot @data Data to be sent to the bot via a callback query
|
|
inlineKeyboardButtonTypeCallbackWithPassword data:bytes = InlineKeyboardButtonType;
|
|
|
|
//@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
|
|
inlineKeyboardButtonTypeCallbackGame = InlineKeyboardButtonType;
|
|
|
|
//@description A button that forces an inline query to the bot to be inserted in the input field @query Inline query to be sent to the bot @in_current_chat True, if the inline query should be sent from the current chat
|
|
inlineKeyboardButtonTypeSwitchInline query:string in_current_chat:Bool = InlineKeyboardButtonType;
|
|
|
|
//@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
|
|
inlineKeyboardButtonTypeBuy = InlineKeyboardButtonType;
|
|
|
|
|
|
//@description Represents a single button in an inline keyboard @text Text of the button @type Type of the button
|
|
inlineKeyboardButton text:string type:InlineKeyboardButtonType = InlineKeyboardButton;
|
|
|
|
|
|
//@class ReplyMarkup @description Contains a description of a custom keyboard and actions that can be done with it to quickly reply to bots
|
|
|
|
//@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
|
|
//@is_personal True, if the keyboard is removed only for the mentioned users or the target user of a reply
|
|
replyMarkupRemoveKeyboard is_personal:Bool = ReplyMarkup;
|
|
|
|
//@description Instructs application to force a reply to this message
|
|
//@is_personal 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
|
|
replyMarkupForceReply is_personal:Bool = ReplyMarkup;
|
|
|
|
//@description Contains a custom keyboard layout to quickly reply to bots
|
|
//@rows A list of rows of bot keyboard buttons
|
|
//@resize_keyboard True, if the application needs to resize the keyboard vertically
|
|
//@one_time True, if the application needs to hide the keyboard after use
|
|
//@is_personal 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
|
|
replyMarkupShowKeyboard rows:vector<vector<keyboardButton>> resize_keyboard:Bool one_time:Bool is_personal:Bool = ReplyMarkup;
|
|
|
|
//@description Contains an inline keyboard layout
|
|
//@rows A list of rows of inline keyboard buttons
|
|
replyMarkupInlineKeyboard rows:vector<vector<inlineKeyboardButton>> = ReplyMarkup;
|
|
|
|
|
|
//@class LoginUrlInfo @description Contains information about an inline button of type inlineKeyboardButtonTypeLoginUrl
|
|
|
|
//@description An HTTP url needs to be open @url The URL to open @skip_confirm True, if there is no need to show an ordinary open URL confirm
|
|
loginUrlInfoOpen url:string skip_confirm:Bool = LoginUrlInfo;
|
|
|
|
//@description An authorization confirmation dialog needs to be shown to the user @url An HTTP URL to be opened @domain A domain of the URL
|
|
//@bot_user_id User identifier of a bot linked with the website @request_write_access True, if the user needs to be requested to give the permission to the bot to send them messages
|
|
loginUrlInfoRequestConfirmation url:string domain:string bot_user_id:int32 request_write_access:Bool = LoginUrlInfo;
|
|
|
|
|
|
//@description Contains information about a message thread
|
|
//@chat_id Identifier of the chat to which the message thread belongs
|
|
//@message_thread_id Message thread identifier, unique within the chat
|
|
//@reply_info Contains information about the message thread
|
|
//@messages The messages from which the thread starts. The messages are returned in a reverse chronological order (i.e., in order of decreasing message_id)
|
|
//@draft_message A draft of a message in the message thread; may be null
|
|
messageThreadInfo chat_id:int53 message_thread_id:int53 reply_info:messageReplyInfo messages:vector<message> draft_message:draftMessage = MessageThreadInfo;
|
|
|
|
|
|
//@class RichText @description Describes a text object inside an instant-view web page
|
|
|
|
//@description A plain text @text Text
|
|
richTextPlain text:string = RichText;
|
|
|
|
//@description A bold rich text @text Text
|
|
richTextBold text:RichText = RichText;
|
|
|
|
//@description An italicized rich text @text Text
|
|
richTextItalic text:RichText = RichText;
|
|
|
|
//@description An underlined rich text @text Text
|
|
richTextUnderline text:RichText = RichText;
|
|
|
|
//@description A strikethrough rich text @text Text
|
|
richTextStrikethrough text:RichText = RichText;
|
|
|
|
//@description A fixed-width rich text @text Text
|
|
richTextFixed text:RichText = RichText;
|
|
|
|
//@description A rich text URL link @text Text @url URL @is_cached True, if the URL has cached instant view server-side
|
|
richTextUrl text:RichText url:string is_cached:Bool = RichText;
|
|
|
|
//@description A rich text email link @text Text @email_address Email address
|
|
richTextEmailAddress text:RichText email_address:string = RichText;
|
|
|
|
//@description A subscript rich text @text Text
|
|
richTextSubscript text:RichText = RichText;
|
|
|
|
//@description A superscript rich text @text Text
|
|
richTextSuperscript text:RichText = RichText;
|
|
|
|
//@description A marked rich text @text Text
|
|
richTextMarked text:RichText = RichText;
|
|
|
|
//@description A rich text phone number @text Text @phone_number Phone number
|
|
richTextPhoneNumber text:RichText phone_number:string = RichText;
|
|
|
|
//@description A small image inside the text @document The image represented as a document. The image can be in GIF, JPEG or PNG format
|
|
//@width Width of a bounding box in which the image should be shown; 0 if unknown
|
|
//@height Height of a bounding box in which the image should be shown; 0 if unknown
|
|
richTextIcon document:document width:int32 height:int32 = RichText;
|
|
|
|
//@description A reference to a richTexts object on the same web page @text The text @anchor_name The name of a richTextAnchor object, which is the first element of the target richTexts object @url An HTTP URL, opening the reference
|
|
richTextReference text:RichText anchor_name:string url:string = RichText;
|
|
|
|
//@description An anchor @name Anchor name
|
|
richTextAnchor name:string = RichText;
|
|
|
|
//@description A link to an anchor on the same web page @text The link text @anchor_name The anchor name. If the name is empty, the link should bring back to top @url An HTTP URL, opening the anchor
|
|
richTextAnchorLink text:RichText anchor_name:string url:string = RichText;
|
|
|
|
//@description A concatenation of rich texts @texts Texts
|
|
richTexts texts:vector<RichText> = RichText;
|
|
|
|
|
|
//@description Contains a caption of an instant view web page block, consisting of a text and a trailing credit @text Content of the caption @credit Block credit (like HTML tag <cite>)
|
|
pageBlockCaption text:RichText credit:RichText = PageBlockCaption;
|
|
|
|
//@description Describes an item of a list page block @label Item label @page_blocks Item blocks
|
|
pageBlockListItem label:string page_blocks:vector<PageBlock> = PageBlockListItem;
|
|
|
|
//@class PageBlockHorizontalAlignment @description Describes a horizontal alignment of a table cell content
|
|
|
|
//@description The content should be left-aligned
|
|
pageBlockHorizontalAlignmentLeft = PageBlockHorizontalAlignment;
|
|
|
|
//@description The content should be center-aligned
|
|
pageBlockHorizontalAlignmentCenter = PageBlockHorizontalAlignment;
|
|
|
|
//@description The content should be right-aligned
|
|
pageBlockHorizontalAlignmentRight = PageBlockHorizontalAlignment;
|
|
|
|
//@class PageBlockVerticalAlignment @description Describes a Vertical alignment of a table cell content
|
|
|
|
//@description The content should be top-aligned
|
|
pageBlockVerticalAlignmentTop = PageBlockVerticalAlignment;
|
|
|
|
//@description The content should be middle-aligned
|
|
pageBlockVerticalAlignmentMiddle = PageBlockVerticalAlignment;
|
|
|
|
//@description The content should be bottom-aligned
|
|
pageBlockVerticalAlignmentBottom = PageBlockVerticalAlignment;
|
|
|
|
//@description Represents a cell of a table @text Cell text; may be null. If the text is null, then the cell should be invisible @is_header True, if it is a header cell
|
|
//@colspan The number of columns the cell should span @rowspan The number of rows the cell should span
|
|
//@align Horizontal cell content alignment @valign Vertical cell content alignment
|
|
pageBlockTableCell text:RichText is_header:Bool colspan:int32 rowspan:int32 align:PageBlockHorizontalAlignment valign:PageBlockVerticalAlignment = PageBlockTableCell;
|
|
|
|
//@description Contains information about a related article @url Related article URL @title Article title; may be empty @param_description Article description; may be empty
|
|
//@photo Article photo; may be null @author Article author; may be empty @publish_date Point in time (Unix timestamp) when the article was published; 0 if unknown
|
|
pageBlockRelatedArticle url:string title:string description:string photo:photo author:string publish_date:int32 = PageBlockRelatedArticle;
|
|
|
|
|
|
//@class PageBlock @description Describes a block of an instant view web page
|
|
|
|
//@description The title of a page @title Title
|
|
pageBlockTitle title:RichText = PageBlock;
|
|
|
|
//@description The subtitle of a page @subtitle Subtitle
|
|
pageBlockSubtitle subtitle:RichText = PageBlock;
|
|
|
|
//@description The author and publishing date of a page @author Author @publish_date Point in time (Unix timestamp) when the article was published; 0 if unknown
|
|
pageBlockAuthorDate author:RichText publish_date:int32 = PageBlock;
|
|
|
|
//@description A header @header Header
|
|
pageBlockHeader header:RichText = PageBlock;
|
|
|
|
//@description A subheader @subheader Subheader
|
|
pageBlockSubheader subheader:RichText = PageBlock;
|
|
|
|
//@description A kicker @kicker Kicker
|
|
pageBlockKicker kicker:RichText = PageBlock;
|
|
|
|
//@description A text paragraph @text Paragraph text
|
|
pageBlockParagraph text:RichText = PageBlock;
|
|
|
|
//@description A preformatted text paragraph @text Paragraph text @language Programming language for which the text should be formatted
|
|
pageBlockPreformatted text:RichText language:string = PageBlock;
|
|
|
|
//@description The footer of a page @footer Footer
|
|
pageBlockFooter footer:RichText = PageBlock;
|
|
|
|
//@description An empty block separating a page
|
|
pageBlockDivider = PageBlock;
|
|
|
|
//@description An invisible anchor on a page, which can be used in a URL to open the page from the specified anchor @name Name of the anchor
|
|
pageBlockAnchor name:string = PageBlock;
|
|
|
|
//@description A list of data blocks @items The items of the list
|
|
pageBlockList items:vector<pageBlockListItem> = PageBlock;
|
|
|
|
//@description A block quote @text Quote text @credit Quote credit
|
|
pageBlockBlockQuote text:RichText credit:RichText = PageBlock;
|
|
|
|
//@description A pull quote @text Quote text @credit Quote credit
|
|
pageBlockPullQuote text:RichText credit:RichText = PageBlock;
|
|
|
|
//@description An animation @animation Animation file; may be null @caption Animation caption @need_autoplay True, if the animation should be played automatically
|
|
pageBlockAnimation animation:animation caption:pageBlockCaption need_autoplay:Bool = PageBlock;
|
|
|
|
//@description An audio file @audio Audio file; may be null @caption Audio file caption
|
|
pageBlockAudio audio:audio caption:pageBlockCaption = PageBlock;
|
|
|
|
//@description A photo @photo Photo file; may be null @caption Photo caption @url URL that needs to be opened when the photo is clicked
|
|
pageBlockPhoto photo:photo caption:pageBlockCaption url:string = PageBlock;
|
|
|
|
//@description A video @video Video file; may be null @caption Video caption @need_autoplay True, if the video should be played automatically @is_looped True, if the video should be looped
|
|
pageBlockVideo video:video caption:pageBlockCaption need_autoplay:Bool is_looped:Bool = PageBlock;
|
|
|
|
//@description A voice note @voice_note Voice note; may be null @caption Voice note caption
|
|
pageBlockVoiceNote voice_note:voiceNote caption:pageBlockCaption = PageBlock;
|
|
|
|
//@description A page cover @cover Cover
|
|
pageBlockCover cover:PageBlock = PageBlock;
|
|
|
|
//@description An embedded web page @url Web page URL, if available @html HTML-markup of the embedded page @poster_photo Poster photo, if available; may be null @width Block width; 0 if unknown @height Block height; 0 if unknown @caption Block caption @is_full_width True, if the block should be full width @allow_scrolling True, if scrolling should be allowed
|
|
pageBlockEmbedded url:string html:string poster_photo:photo width:int32 height:int32 caption:pageBlockCaption is_full_width:Bool allow_scrolling:Bool = PageBlock;
|
|
|
|
//@description An embedded post @url Web page URL @author Post author @author_photo Post author photo; may be null @date Point in time (Unix timestamp) when the post was created; 0 if unknown @page_blocks Post content @caption Post caption
|
|
pageBlockEmbeddedPost url:string author:string author_photo:photo date:int32 page_blocks:vector<PageBlock> caption:pageBlockCaption = PageBlock;
|
|
|
|
//@description A collage @page_blocks Collage item contents @caption Block caption
|
|
pageBlockCollage page_blocks:vector<PageBlock> caption:pageBlockCaption = PageBlock;
|
|
|
|
//@description A slideshow @page_blocks Slideshow item contents @caption Block caption
|
|
pageBlockSlideshow page_blocks:vector<PageBlock> caption:pageBlockCaption = PageBlock;
|
|
|
|
//@description A link to a chat @title Chat title @photo Chat photo; may be null @username Chat username, by which all other information about the chat should be resolved
|
|
pageBlockChatLink title:string photo:chatPhotoInfo username:string = PageBlock;
|
|
|
|
//@description A table @caption Table caption @cells Table cells @is_bordered True, if the table is bordered @is_striped True, if the table is striped
|
|
pageBlockTable caption:RichText cells:vector<vector<pageBlockTableCell>> is_bordered:Bool is_striped:Bool = PageBlock;
|
|
|
|
//@description A collapsible block @header Always visible heading for the block @page_blocks Block contents @is_open True, if the block is open by default
|
|
pageBlockDetails header:RichText page_blocks:vector<PageBlock> is_open:Bool = PageBlock;
|
|
|
|
//@description Related articles @header Block header @articles List of related articles
|
|
pageBlockRelatedArticles header:RichText articles:vector<pageBlockRelatedArticle> = PageBlock;
|
|
|
|
//@description A map @location Location of the map center @zoom Map zoom level @width Map width @height Map height @caption Block caption
|
|
pageBlockMap location:location zoom:int32 width:int32 height:int32 caption:pageBlockCaption = PageBlock;
|
|
|
|
|
|
//@description Describes an instant view page for a web page
|
|
//@page_blocks Content of the web page
|
|
//@view_count Number of the instant view views; 0 if unknown
|
|
//@version Version of the instant view, currently can be 1 or 2
|
|
//@is_rtl True, if the instant view must be shown from right to left
|
|
//@is_full True, if the instant view contains the full page. A network request might be needed to get the full web page instant view
|
|
webPageInstantView page_blocks:vector<PageBlock> view_count:int32 version:int32 is_rtl:Bool is_full:Bool = WebPageInstantView;
|
|
|
|
|
|
//@description Describes a web page preview
|
|
//@url Original URL of the link
|
|
//@display_url URL to display
|
|
//@type Type of the web page. Can be: article, photo, audio, video, document, profile, app, or something else
|
|
//@site_name Short name of the site (e.g., Google Docs, App Store)
|
|
//@title Title of the content
|
|
//@param_description Description of the content
|
|
//@photo Image representing the content; may be null
|
|
//@embed_url URL to show in the embedded preview
|
|
//@embed_type MIME type of the embedded preview, (e.g., text/html or video/mp4)
|
|
//@embed_width Width of the embedded preview
|
|
//@embed_height Height of the embedded preview
|
|
//@duration Duration of the content, in seconds
|
|
//@author Author of the content
|
|
//@animation Preview of the content as an animation, if available; may be null
|
|
//@audio Preview of the content as an audio file, if available; may be null
|
|
//@document Preview of the content as a document, if available (currently only available for small PDF files and ZIP archives); may be null
|
|
//@sticker Preview of the content as a sticker for small WEBP files, if available; may be null
|
|
//@video Preview of the content as a video, if available; may be null
|
|
//@video_note Preview of the content as a video note, if available; may be null
|
|
//@voice_note Preview of the content as a voice note, if available; may be null
|
|
//@instant_view_version Version of instant view, available for the web page (currently can be 1 or 2), 0 if none
|
|
webPage url:string display_url:string type:string site_name:string title:string description:formattedText photo:photo embed_url:string embed_type:string embed_width:int32 embed_height:int32 duration:int32 author:string animation:animation audio:audio document:document sticker:sticker video:video video_note:videoNote voice_note:voiceNote instant_view_version:int32 = WebPage;
|
|
|
|
|
|
//@description Contains information about a country
|
|
//@country_code A two-letter ISO 3166-1 alpha-2 country code
|
|
//@name Native name of the country
|
|
//@english_name English name of the country
|
|
//@is_hidden True, if the country should be hidden from the list of all countries
|
|
//@calling_codes List of country calling codes
|
|
countryInfo country_code:string name:string english_name:string is_hidden:Bool calling_codes:vector<string> = CountryInfo;
|
|
|
|
//@description Contains information about countries @countries The list of countries
|
|
countries countries:vector<countryInfo> = Countries;
|
|
|
|
//@description Contains information about a phone number
|
|
//@country Information about the country to which the phone number belongs; may be null
|
|
//@country_calling_code The part of the phone number denoting country calling code or its part
|
|
//@formatted_phone_number The phone number without country calling code formatted accordingly to local rules
|
|
phoneNumberInfo country:countryInfo country_calling_code:string formatted_phone_number:string = PhoneNumberInfo;
|
|
|
|
|
|
//@description Describes an action associated with a bank card number @text Action text @url The URL to be opened
|
|
bankCardActionOpenUrl text:string url:string = BankCardActionOpenUrl;
|
|
|
|
//@description Information about a bank card @title Title of the bank card description @actions Actions that can be done with the bank card number
|
|
bankCardInfo title:string actions:vector<bankCardActionOpenUrl> = BankCardInfo;
|
|
|
|
|
|
//@description Describes an address @country_code A two-letter ISO 3166-1 alpha-2 country code @state State, if applicable @city City @street_line1 First line of the address @street_line2 Second line of the address @postal_code Address postal code
|
|
address country_code:string state:string city:string street_line1:string street_line2:string postal_code:string = Address;
|
|
|
|
|
|
//@description Portion of the price of a product (e.g., "delivery cost", "tax amount") @label Label for this portion of the product price @amount Currency amount in minimal quantity of the currency
|
|
labeledPricePart label:string amount:int53 = LabeledPricePart;
|
|
|
|
//@description Product invoice @currency ISO 4217 currency code @price_parts A list of objects used to calculate the total price of the product @is_test True, if the payment is a test payment
|
|
//@need_name True, if the user's name is needed for payment @need_phone_number True, if the user's phone number is needed for payment @need_email_address True, if the user's email address is needed for payment
|
|
//@need_shipping_address True, if the user's shipping address is needed for payment @send_phone_number_to_provider True, if the user's phone number will be sent to the provider
|
|
//@send_email_address_to_provider True, if the user's email address will be sent to the provider @is_flexible True, if the total price depends on the shipping method
|
|
invoice currency:string price_parts:vector<labeledPricePart> is_test:Bool need_name:Bool need_phone_number:Bool need_email_address:Bool need_shipping_address:Bool send_phone_number_to_provider:Bool send_email_address_to_provider:Bool is_flexible:Bool = Invoice;
|
|
|
|
//@description Order information @name Name of the user @phone_number Phone number of the user @email_address Email address of the user @shipping_address Shipping address for this order; may be null
|
|
orderInfo name:string phone_number:string email_address:string shipping_address:address = OrderInfo;
|
|
|
|
//@description One shipping option @id Shipping option identifier @title Option title @price_parts A list of objects used to calculate the total shipping costs
|
|
shippingOption id:string title:string price_parts:vector<labeledPricePart> = ShippingOption;
|
|
|
|
//@description Contains information about saved card credentials @id Unique identifier of the saved credentials @title Title of the saved credentials
|
|
savedCredentials id:string title:string = SavedCredentials;
|
|
|
|
//@class InputCredentials @description Contains information about the payment method chosen by the user
|
|
|
|
//@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 @saved_credentials_id Identifier of the saved credentials
|
|
inputCredentialsSaved saved_credentials_id:string = InputCredentials;
|
|
|
|
//@description Applies if a user enters new credentials on a payment provider website @data Contains JSON-encoded data with a credential identifier from the payment provider @allow_save True, if the credential identifier can be saved on the server side
|
|
inputCredentialsNew data:string allow_save:Bool = InputCredentials;
|
|
|
|
//@description Applies if a user enters new credentials using Apple Pay @data JSON-encoded data with the credential identifier
|
|
inputCredentialsApplePay data:string = InputCredentials;
|
|
|
|
//@description Applies if a user enters new credentials using Google Pay @data JSON-encoded data with the credential identifier
|
|
inputCredentialsGooglePay data:string = InputCredentials;
|
|
|
|
//@description Stripe payment provider @publishable_key Stripe API publishable key @need_country True, if the user country must be provided @need_postal_code True, if the user ZIP/postal code must be provided @need_cardholder_name True, if the cardholder name must be provided
|
|
paymentsProviderStripe publishable_key:string need_country:Bool need_postal_code:Bool need_cardholder_name:Bool = PaymentsProviderStripe;
|
|
|
|
//@description Contains information about an invoice payment form @invoice Full information of the invoice @url Payment form URL @payments_provider Contains information about the payment provider, if available, to support it natively without the need for opening the URL; may be null
|
|
//@saved_order_info Saved server-side order information; may be null @saved_credentials Contains information about saved card credentials; may be null @can_save_credentials True, if the user can choose to save credentials @need_password True, if the user will be able to save credentials protected by a password they set up
|
|
paymentForm invoice:invoice url:string payments_provider:paymentsProviderStripe saved_order_info:orderInfo saved_credentials:savedCredentials can_save_credentials:Bool need_password:Bool = PaymentForm;
|
|
|
|
//@description Contains a temporary identifier of validated order information, which is stored for one hour. Also contains the available shipping options @order_info_id Temporary identifier of the order information @shipping_options Available shipping options
|
|
validatedOrderInfo order_info_id:string shipping_options:vector<shippingOption> = ValidatedOrderInfo;
|
|
|
|
//@description Contains the result of a payment request @success True, if the payment request was successful; otherwise the verification_url will be not empty @verification_url URL for additional payment credentials verification
|
|
paymentResult success:Bool verification_url:string = PaymentResult;
|
|
|
|
//@description Contains information about a successful payment @date Point in time (Unix timestamp) when the payment was made @payments_provider_user_id User identifier of the payment provider bot @invoice Contains information about the invoice
|
|
//@order_info Contains order information; may be null @shipping_option Chosen shipping option; may be null @credentials_title Title of the saved credentials
|
|
paymentReceipt date:int32 payments_provider_user_id:int32 invoice:invoice order_info:orderInfo shipping_option:shippingOption credentials_title:string = PaymentReceipt;
|
|
|
|
|
|
//@description File with the date it was uploaded @file The file @date Point in time (Unix timestamp) when the file was uploaded
|
|
datedFile file:file date:int32 = DatedFile;
|
|
|
|
|
|
//@class PassportElementType @description Contains the type of a Telegram Passport element
|
|
|
|
//@description A Telegram Passport element containing the user's personal details
|
|
passportElementTypePersonalDetails = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's passport
|
|
passportElementTypePassport = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's driver license
|
|
passportElementTypeDriverLicense = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's identity card
|
|
passportElementTypeIdentityCard = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's internal passport
|
|
passportElementTypeInternalPassport = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's address
|
|
passportElementTypeAddress = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's utility bill
|
|
passportElementTypeUtilityBill = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's bank statement
|
|
passportElementTypeBankStatement = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's rental agreement
|
|
passportElementTypeRentalAgreement = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the registration page of the user's passport
|
|
passportElementTypePassportRegistration = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's temporary registration
|
|
passportElementTypeTemporaryRegistration = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's phone number
|
|
passportElementTypePhoneNumber = PassportElementType;
|
|
|
|
//@description A Telegram Passport element containing the user's email address
|
|
passportElementTypeEmailAddress = PassportElementType;
|
|
|
|
|
|
//@description Represents a date according to the Gregorian calendar @day Day of the month; 1-31 @month Month; 1-12 @year Year; 1-9999
|
|
date day:int32 month:int32 year:int32 = Date;
|
|
|
|
//@description Contains the user's personal details
|
|
//@first_name First name of the user written in English; 1-255 characters @middle_name Middle name of the user written in English; 0-255 characters @last_name Last name of the user written in English; 1-255 characters
|
|
//@native_first_name Native first name of the user; 1-255 characters @native_middle_name Native middle name of the user; 0-255 characters @native_last_name Native last name of the user; 1-255 characters
|
|
//@birthdate Birthdate of the user @gender Gender of the user, "male" or "female" @country_code A two-letter ISO 3166-1 alpha-2 country code of the user's country @residence_country_code A two-letter ISO 3166-1 alpha-2 country code of the user's residence country
|
|
personalDetails first_name:string middle_name:string last_name:string native_first_name:string native_middle_name:string native_last_name:string birthdate:date gender:string country_code:string residence_country_code:string = PersonalDetails;
|
|
|
|
//@description An identity document @number Document number; 1-24 characters @expiry_date Document expiry date; may be null @front_side Front side of the document
|
|
//@reverse_side Reverse side of the document; only for driver license and identity card @selfie Selfie with the document; may be null @translation List of files containing a certified English translation of the document
|
|
identityDocument number:string expiry_date:date front_side:datedFile reverse_side:datedFile selfie:datedFile translation:vector<datedFile> = IdentityDocument;
|
|
|
|
//@description An identity document to be saved to Telegram Passport @number Document number; 1-24 characters @expiry_date Document expiry date, if available @front_side Front side of the document
|
|
//@reverse_side Reverse side of the document; only for driver license and identity card @selfie Selfie with the document, if available @translation List of files containing a certified English translation of the document
|
|
inputIdentityDocument number:string expiry_date:date front_side:InputFile reverse_side:InputFile selfie:InputFile translation:vector<InputFile> = InputIdentityDocument;
|
|
|
|
//@description A personal document, containing some information about a user @files List of files containing the pages of the document @translation List of files containing a certified English translation of the document
|
|
personalDocument files:vector<datedFile> translation:vector<datedFile> = PersonalDocument;
|
|
|
|
//@description A personal document to be saved to Telegram Passport @files List of files containing the pages of the document @translation List of files containing a certified English translation of the document
|
|
inputPersonalDocument files:vector<InputFile> translation:vector<InputFile> = InputPersonalDocument;
|
|
|
|
|
|
//@class PassportElement @description Contains information about a Telegram Passport element
|
|
|
|
//@description A Telegram Passport element containing the user's personal details @personal_details Personal details of the user
|
|
passportElementPersonalDetails personal_details:personalDetails = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's passport @passport Passport
|
|
passportElementPassport passport:identityDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's driver license @driver_license Driver license
|
|
passportElementDriverLicense driver_license:identityDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's identity card @identity_card Identity card
|
|
passportElementIdentityCard identity_card:identityDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's internal passport @internal_passport Internal passport
|
|
passportElementInternalPassport internal_passport:identityDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's address @address Address
|
|
passportElementAddress address:address = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's utility bill @utility_bill Utility bill
|
|
passportElementUtilityBill utility_bill:personalDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's bank statement @bank_statement Bank statement
|
|
passportElementBankStatement bank_statement:personalDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's rental agreement @rental_agreement Rental agreement
|
|
passportElementRentalAgreement rental_agreement:personalDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's passport registration pages @passport_registration Passport registration pages
|
|
passportElementPassportRegistration passport_registration:personalDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's temporary registration @temporary_registration Temporary registration
|
|
passportElementTemporaryRegistration temporary_registration:personalDocument = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's phone number @phone_number Phone number
|
|
passportElementPhoneNumber phone_number:string = PassportElement;
|
|
|
|
//@description A Telegram Passport element containing the user's email address @email_address Email address
|
|
passportElementEmailAddress email_address:string = PassportElement;
|
|
|
|
|
|
//@class InputPassportElement @description Contains information about a Telegram Passport element to be saved
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's personal details @personal_details Personal details of the user
|
|
inputPassportElementPersonalDetails personal_details:personalDetails = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's passport @passport The passport to be saved
|
|
inputPassportElementPassport passport:inputIdentityDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's driver license @driver_license The driver license to be saved
|
|
inputPassportElementDriverLicense driver_license:inputIdentityDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's identity card @identity_card The identity card to be saved
|
|
inputPassportElementIdentityCard identity_card:inputIdentityDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's internal passport @internal_passport The internal passport to be saved
|
|
inputPassportElementInternalPassport internal_passport:inputIdentityDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's address @address The address to be saved
|
|
inputPassportElementAddress address:address = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's utility bill @utility_bill The utility bill to be saved
|
|
inputPassportElementUtilityBill utility_bill:inputPersonalDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's bank statement @bank_statement The bank statement to be saved
|
|
inputPassportElementBankStatement bank_statement:inputPersonalDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's rental agreement @rental_agreement The rental agreement to be saved
|
|
inputPassportElementRentalAgreement rental_agreement:inputPersonalDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's passport registration @passport_registration The passport registration page to be saved
|
|
inputPassportElementPassportRegistration passport_registration:inputPersonalDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's temporary registration @temporary_registration The temporary registration document to be saved
|
|
inputPassportElementTemporaryRegistration temporary_registration:inputPersonalDocument = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's phone number @phone_number The phone number to be saved
|
|
inputPassportElementPhoneNumber phone_number:string = InputPassportElement;
|
|
|
|
//@description A Telegram Passport element to be saved containing the user's email address @email_address The email address to be saved
|
|
inputPassportElementEmailAddress email_address:string = InputPassportElement;
|
|
|
|
|
|
//@description Contains information about saved Telegram Passport elements @elements Telegram Passport elements
|
|
passportElements elements:vector<PassportElement> = PassportElements;
|
|
|
|
|
|
//@class PassportElementErrorSource @description Contains the description of an error in a Telegram Passport element
|
|
|
|
//@description The element contains an error in an unspecified place. The error will be considered resolved when new data is added
|
|
passportElementErrorSourceUnspecified = PassportElementErrorSource;
|
|
|
|
//@description One of the data fields contains an error. The error will be considered resolved when the value of the field changes @field_name Field name
|
|
passportElementErrorSourceDataField field_name:string = PassportElementErrorSource;
|
|
|
|
//@description The front side of the document contains an error. The error will be considered resolved when the file with the front side changes
|
|
passportElementErrorSourceFrontSide = PassportElementErrorSource;
|
|
|
|
//@description The reverse side of the document contains an error. The error will be considered resolved when the file with the reverse side changes
|
|
passportElementErrorSourceReverseSide = PassportElementErrorSource;
|
|
|
|
//@description The selfie with the document contains an error. The error will be considered resolved when the file with the selfie changes
|
|
passportElementErrorSourceSelfie = PassportElementErrorSource;
|
|
|
|
//@description One of files with the translation of the document contains an error. The error will be considered resolved when the file changes @file_index Index of a file with the error
|
|
passportElementErrorSourceTranslationFile file_index:int32 = PassportElementErrorSource;
|
|
|
|
//@description The translation of the document contains an error. The error will be considered resolved when the list of translation files changes
|
|
passportElementErrorSourceTranslationFiles = PassportElementErrorSource;
|
|
|
|
//@description The file contains an error. The error will be considered resolved when the file changes @file_index Index of a file with the error
|
|
passportElementErrorSourceFile file_index:int32 = PassportElementErrorSource;
|
|
|
|
//@description The list of attached files contains an error. The error will be considered resolved when the list of files changes
|
|
passportElementErrorSourceFiles = PassportElementErrorSource;
|
|
|
|
|
|
//@description Contains the description of an error in a Telegram Passport element @type Type of the Telegram Passport element which has the error @message Error message @source Error source
|
|
passportElementError type:PassportElementType message:string source:PassportElementErrorSource = PassportElementError;
|
|
|
|
|
|
//@description Contains information about a Telegram Passport element that was requested by a service @type Type of the element @is_selfie_required True, if a selfie is required with the identity document
|
|
//@is_translation_required True, if a certified English translation is required with the document @is_native_name_required True, if personal details must include the user's name in the language of their country of residence
|
|
passportSuitableElement type:PassportElementType is_selfie_required:Bool is_translation_required:Bool is_native_name_required:Bool = PassportSuitableElement;
|
|
|
|
//@description Contains a description of the required Telegram Passport element that was requested by a service @suitable_elements List of Telegram Passport elements any of which is enough to provide
|
|
passportRequiredElement suitable_elements:vector<passportSuitableElement> = PassportRequiredElement;
|
|
|
|
//@description Contains information about a Telegram Passport authorization form that was requested @id Unique identifier of the authorization form
|
|
//@required_elements Information about the Telegram Passport elements that must be provided to complete the form
|
|
//@privacy_policy_url URL for the privacy policy of the service; may be empty
|
|
passportAuthorizationForm id:int32 required_elements:vector<passportRequiredElement> privacy_policy_url:string = PassportAuthorizationForm;
|
|
|
|
//@description Contains information about a Telegram Passport elements and corresponding errors @elements Telegram Passport elements @errors Errors in the elements that are already available
|
|
passportElementsWithErrors elements:vector<PassportElement> errors:vector<passportElementError> = PassportElementsWithErrors;
|
|
|
|
|
|
//@description Contains encrypted Telegram Passport data credentials @data The encrypted credentials @hash The decrypted data hash @secret Secret for data decryption, encrypted with the service's public key
|
|
encryptedCredentials data:bytes hash:bytes secret:bytes = EncryptedCredentials;
|
|
|
|
|
|
//@description Contains information about an encrypted Telegram Passport element; for bots only @type Type of Telegram Passport element @data Encrypted JSON-encoded data about the user @front_side The front side of an identity document @reverse_side The reverse side of an identity document; may be null @selfie Selfie with the document; may be null @translation List of files containing a certified English translation of the document @files List of attached files @value Unencrypted data, phone number or email address @hash Hash of the entire element
|
|
encryptedPassportElement type:PassportElementType data:bytes front_side:datedFile reverse_side:datedFile selfie:datedFile translation:vector<datedFile> files:vector<datedFile> value:string hash:string = EncryptedPassportElement;
|
|
|
|
|
|
//@class InputPassportElementErrorSource @description Contains the description of an error in a Telegram Passport element; for bots only
|
|
|
|
//@description The element contains an error in an unspecified place. The error will be considered resolved when new data is added @element_hash Current hash of the entire element
|
|
inputPassportElementErrorSourceUnspecified element_hash:bytes = InputPassportElementErrorSource;
|
|
|
|
//@description A data field contains an error. The error is considered resolved when the field's value changes @field_name Field name @data_hash Current data hash
|
|
inputPassportElementErrorSourceDataField field_name:string data_hash:bytes = InputPassportElementErrorSource;
|
|
|
|
//@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 @file_hash Current hash of the file containing the front side
|
|
inputPassportElementErrorSourceFrontSide file_hash:bytes = InputPassportElementErrorSource;
|
|
|
|
//@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 @file_hash Current hash of the file containing the reverse side
|
|
inputPassportElementErrorSourceReverseSide file_hash:bytes = InputPassportElementErrorSource;
|
|
|
|
//@description The selfie contains an error. The error is considered resolved when the file with the selfie changes @file_hash Current hash of the file containing the selfie
|
|
inputPassportElementErrorSourceSelfie file_hash:bytes = InputPassportElementErrorSource;
|
|
|
|
//@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 @file_hash Current hash of the file containing the translation
|
|
inputPassportElementErrorSourceTranslationFile file_hash:bytes = InputPassportElementErrorSource;
|
|
|
|
//@description The translation of the document contains an error. The error is considered resolved when the list of files changes @file_hashes Current hashes of all files with the translation
|
|
inputPassportElementErrorSourceTranslationFiles file_hashes:vector<bytes> = InputPassportElementErrorSource;
|
|
|
|
//@description The file contains an error. The error is considered resolved when the file changes @file_hash Current hash of the file which has the error
|
|
inputPassportElementErrorSourceFile file_hash:bytes = InputPassportElementErrorSource;
|
|
|
|
//@description The list of attached files contains an error. The error is considered resolved when the file list changes @file_hashes Current hashes of all attached files
|
|
inputPassportElementErrorSourceFiles file_hashes:vector<bytes> = InputPassportElementErrorSource;
|
|
|
|
|
|
//@description Contains the description of an error in a Telegram Passport element; for bots only @type Type of Telegram Passport element that has the error @message Error message @source Error source
|
|
inputPassportElementError type:PassportElementType message:string source:InputPassportElementErrorSource = InputPassportElementError;
|
|
|
|
|
|
//@class MessageContent @description Contains the content of a message
|
|
|
|
//@description A text message @text Text of the message @web_page A preview of the web page that's mentioned in the text; may be null
|
|
messageText text:formattedText web_page:webPage = MessageContent;
|
|
|
|
//@description An animation message (GIF-style). @animation The animation description @caption Animation caption @is_secret True, if the animation thumbnail must be blurred and the animation must be shown only while tapped
|
|
messageAnimation animation:animation caption:formattedText is_secret:Bool = MessageContent;
|
|
|
|
//@description An audio message @audio The audio description @caption Audio caption
|
|
messageAudio audio:audio caption:formattedText = MessageContent;
|
|
|
|
//@description A document message (general file) @document The document description @caption Document caption
|
|
messageDocument document:document caption:formattedText = MessageContent;
|
|
|
|
//@description A photo message @photo The photo description @caption Photo caption @is_secret True, if the photo must be blurred and must be shown only while tapped
|
|
messagePhoto photo:photo caption:formattedText is_secret:Bool = MessageContent;
|
|
|
|
//@description An expired photo message (self-destructed after TTL has elapsed)
|
|
messageExpiredPhoto = MessageContent;
|
|
|
|
//@description A sticker message @sticker The sticker description
|
|
messageSticker sticker:sticker = MessageContent;
|
|
|
|
//@description A video message @video The video description @caption Video caption @is_secret True, if the video thumbnail must be blurred and the video must be shown only while tapped
|
|
messageVideo video:video caption:formattedText is_secret:Bool = MessageContent;
|
|
|
|
//@description An expired video message (self-destructed after TTL has elapsed)
|
|
messageExpiredVideo = MessageContent;
|
|
|
|
//@description A video note message @video_note The video note description @is_viewed True, if at least one of the recipients has viewed the video note @is_secret True, if the video note thumbnail must be blurred and the video note must be shown only while tapped
|
|
messageVideoNote video_note:videoNote is_viewed:Bool is_secret:Bool = MessageContent;
|
|
|
|
//@description A voice note message @voice_note The voice note description @caption Voice note caption @is_listened True, if at least one of the recipients has listened to the voice note
|
|
messageVoiceNote voice_note:voiceNote caption:formattedText is_listened:Bool = MessageContent;
|
|
|
|
//@description A message with a location @location The location description @live_period Time relative to the message send date, for which the location can be updated, in seconds
|
|
//@expires_in Left time for which the location can be updated, in seconds. updateMessageContent is not sent when this field changes
|
|
//@heading For live locations, a direction in which the location moves, in degrees; 1-360. If 0 the direction is unknown
|
|
//@proximity_alert_radius 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
|
|
messageLocation location:location live_period:int32 expires_in:int32 heading:int32 proximity_alert_radius:int32 = MessageContent;
|
|
|
|
//@description A message with information about a venue @venue The venue description
|
|
messageVenue venue:venue = MessageContent;
|
|
|
|
//@description A message with a user contact @contact The contact description
|
|
messageContact contact:contact = MessageContent;
|
|
|
|
//@description A dice message. The dice value is randomly generated by the server
|
|
//@initial_state The animated stickers with the initial dice animation; may be null if unknown. updateMessageContent will be sent when the sticker became known
|
|
//@final_state The animated stickers with the final dice animation; may be null if unknown. updateMessageContent will be sent when the sticker became known
|
|
//@emoji Emoji on which the dice throw animation is based
|
|
//@value The dice value. If the value is 0, the dice don't have final state yet
|
|
//@success_animation_frame_number Number of frame after which a success animation like a shower of confetti needs to be shown on updateMessageSendSucceeded
|
|
messageDice initial_state:DiceStickers final_state:DiceStickers emoji:string value:int32 success_animation_frame_number:int32 = MessageContent;
|
|
|
|
//@description A message with a game @game The game description
|
|
messageGame game:game = MessageContent;
|
|
|
|
//@description A message with a poll @poll The poll description
|
|
messagePoll poll:poll = MessageContent;
|
|
|
|
//@description A message with an invoice from a bot @title Product title @param_description Product description @photo Product photo; may be null @currency Currency for the product price @total_amount Product total price in the minimal quantity of the currency
|
|
//@start_parameter Unique invoice bot start_parameter. To share an invoice use the URL https://t.me/{bot_username}?start={start_parameter} @is_test True, if the invoice is a test invoice
|
|
//@need_shipping_address True, if the shipping address should be specified @receipt_message_id The identifier of the message with the receipt, after the product has been purchased
|
|
messageInvoice title:string description:string photo:photo currency:string total_amount:int53 start_parameter:string is_test:Bool need_shipping_address:Bool receipt_message_id:int53 = MessageContent;
|
|
|
|
//@description A message with information about an ended call @is_video True, if the call was a video call @discard_reason Reason why the call was discarded @duration Call duration, in seconds
|
|
messageCall is_video:Bool discard_reason:CallDiscardReason duration:int32 = MessageContent;
|
|
|
|
//@description A newly created voice chat @group_call_id Identifier of the voice chat. The voice chat can be received through the method getGroupCall
|
|
messageVoiceChatStarted group_call_id:int32 = MessageContent;
|
|
|
|
//@description A message with information about an ended voice chat @duration Call duration
|
|
messageVoiceChatEnded duration:int32 = MessageContent;
|
|
|
|
//@description A message with information about an invite to a voice chat @group_call_id Identifier of the voice chat. The voice chat can be received through the method getGroupCall @user_ids Invited user identifiers
|
|
messageInviteVoiceChatParticipants group_call_id:int32 user_ids:vector<int32> = MessageContent;
|
|
|
|
//@description A newly created basic group @title Title of the basic group @member_user_ids User identifiers of members in the basic group
|
|
messageBasicGroupChatCreate title:string member_user_ids:vector<int32> = MessageContent;
|
|
|
|
//@description A newly created supergroup or channel @title Title of the supergroup or channel
|
|
messageSupergroupChatCreate title:string = MessageContent;
|
|
|
|
//@description An updated chat title @title New chat title
|
|
messageChatChangeTitle title:string = MessageContent;
|
|
|
|
//@description An updated chat photo @photo New chat photo
|
|
messageChatChangePhoto photo:chatPhoto = MessageContent;
|
|
|
|
//@description A deleted chat photo
|
|
messageChatDeletePhoto = MessageContent;
|
|
|
|
//@description New chat members were added @member_user_ids User identifiers of the new members
|
|
messageChatAddMembers member_user_ids:vector<int32> = MessageContent;
|
|
|
|
//@description A new member joined the chat by invite link
|
|
messageChatJoinByLink = MessageContent;
|
|
|
|
//@description A chat member was deleted @user_id User identifier of the deleted chat member
|
|
messageChatDeleteMember user_id:int32 = MessageContent;
|
|
|
|
//@description A basic group was upgraded to a supergroup and was deactivated as the result @supergroup_id Identifier of the supergroup to which the basic group was upgraded
|
|
messageChatUpgradeTo supergroup_id:int32 = MessageContent;
|
|
|
|
//@description A supergroup has been created from a basic group @title Title of the newly created supergroup @basic_group_id The identifier of the original basic group
|
|
messageChatUpgradeFrom title:string basic_group_id:int32 = MessageContent;
|
|
|
|
//@description A message has been pinned @message_id Identifier of the pinned message, can be an identifier of a deleted message or 0
|
|
messagePinMessage message_id:int53 = MessageContent;
|
|
|
|
//@description A screenshot of a message in the chat has been taken
|
|
messageScreenshotTaken = MessageContent;
|
|
|
|
//@description The TTL (Time To Live) setting for messages in the chat has been changed @ttl New message TTL setting
|
|
messageChatSetTtl ttl:int32 = MessageContent;
|
|
|
|
//@description A non-standard action has happened in the chat @text Message text to be shown in the chat
|
|
messageCustomServiceAction text:string = MessageContent;
|
|
|
|
//@description A new high score was achieved in a game @game_message_id Identifier of the message with the game, can be an identifier of a deleted message @game_id Identifier of the game; may be different from the games presented in the message with the game @score New score
|
|
messageGameScore game_message_id:int53 game_id:int64 score:int32 = MessageContent;
|
|
|
|
//@description A payment has been completed @invoice_message_id Identifier of the message with the corresponding invoice; can be an identifier of a deleted message @currency Currency for the price of the product @total_amount Total price for the product, in the minimal quantity of the currency
|
|
messagePaymentSuccessful invoice_message_id:int53 currency:string total_amount:int53 = MessageContent;
|
|
|
|
//@description A payment has been completed; for bots only @invoice_message_id Identifier of the message with the corresponding invoice; can be an identifier of a deleted message @currency Currency for price of the product
|
|
//@total_amount Total price for the product, in the minimal quantity of the currency @invoice_payload Invoice payload @shipping_option_id Identifier of the shipping option chosen by the user; may be empty if not applicable @order_info Information about the order; may be null
|
|
//@telegram_payment_charge_id Telegram payment identifier @provider_payment_charge_id Provider payment identifier
|
|
messagePaymentSuccessfulBot invoice_message_id:int53 currency:string total_amount:int53 invoice_payload:bytes shipping_option_id:string order_info:orderInfo telegram_payment_charge_id:string provider_payment_charge_id:string = MessageContent;
|
|
|
|
//@description A contact has registered with Telegram
|
|
messageContactRegistered = MessageContent;
|
|
|
|
//@description The current user has connected a website by logging in using Telegram Login Widget on it @domain_name Domain name of the connected website
|
|
messageWebsiteConnected domain_name:string = MessageContent;
|
|
|
|
//@description Telegram Passport data has been sent @types List of Telegram Passport element types sent
|
|
messagePassportDataSent types:vector<PassportElementType> = MessageContent;
|
|
|
|
//@description Telegram Passport data has been received; for bots only @elements List of received Telegram Passport elements @credentials Encrypted data credentials
|
|
messagePassportDataReceived elements:vector<encryptedPassportElement> credentials:encryptedCredentials = MessageContent;
|
|
|
|
//@description A user in the chat came within proximity alert range @traveler The user or chat, which triggered the proximity alert @watcher The user or chat, which subscribed for the proximity alert @distance The distance between the users
|
|
messageProximityAlertTriggered traveler:MessageSender watcher:MessageSender distance:int32 = MessageContent;
|
|
|
|
//@description Message content that is not supported in the current TDLib version
|
|
messageUnsupported = MessageContent;
|
|
|
|
|
|
//@class TextEntityType @description Represents a part of the text which must be formatted differently
|
|
|
|
//@description A mention of a user by their username
|
|
textEntityTypeMention = TextEntityType;
|
|
|
|
//@description A hashtag text, beginning with "#"
|
|
textEntityTypeHashtag = TextEntityType;
|
|
|
|
//@description A cashtag text, beginning with "$" and consisting of capital english letters (i.e. "$USD")
|
|
textEntityTypeCashtag = TextEntityType;
|
|
|
|
//@description A bot command, beginning with "/". This shouldn't be highlighted if there are no bots in the chat
|
|
textEntityTypeBotCommand = TextEntityType;
|
|
|
|
//@description An HTTP URL
|
|
textEntityTypeUrl = TextEntityType;
|
|
|
|
//@description An email address
|
|
textEntityTypeEmailAddress = TextEntityType;
|
|
|
|
//@description A phone number
|
|
textEntityTypePhoneNumber = TextEntityType;
|
|
|
|
//@description A bank card number. The getBankCardInfo method can be used to get information about the bank card
|
|
textEntityTypeBankCardNumber = TextEntityType;
|
|
|
|
//@description A bold text
|
|
textEntityTypeBold = TextEntityType;
|
|
|
|
//@description An italic text
|
|
textEntityTypeItalic = TextEntityType;
|
|
|
|
//@description An underlined text
|
|
textEntityTypeUnderline = TextEntityType;
|
|
|
|
//@description A strikethrough text
|
|
textEntityTypeStrikethrough = TextEntityType;
|
|
|
|
//@description Text that must be formatted as if inside a code HTML tag
|
|
textEntityTypeCode = TextEntityType;
|
|
|
|
//@description Text that must be formatted as if inside a pre HTML tag
|
|
textEntityTypePre = TextEntityType;
|
|
|
|
//@description Text that must be formatted as if inside pre, and code HTML tags @language Programming language of the code; as defined by the sender
|
|
textEntityTypePreCode language:string = TextEntityType;
|
|
|
|
//@description A text description shown instead of a raw URL @url HTTP or tg:// URL to be opened when the link is clicked
|
|
textEntityTypeTextUrl url:string = TextEntityType;
|
|
|
|
//@description A text shows instead of a raw mention of the user (e.g., when the user has no username) @user_id Identifier of the mentioned user
|
|
textEntityTypeMentionName user_id:int32 = TextEntityType;
|
|
|
|
|
|
//@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 @thumbnail Thumbnail file to send. Sending thumbnails by file_id is currently not supported
|
|
//@width Thumbnail width, usually shouldn't exceed 320. Use 0 if unknown @height Thumbnail height, usually shouldn't exceed 320. Use 0 if unknown
|
|
inputThumbnail thumbnail:InputFile width:int32 height:int32 = InputThumbnail;
|
|
|
|
|
|
//@class MessageSchedulingState @description Contains information about the time when a scheduled message will be sent
|
|
|
|
//@description The message will be sent at the specified date @send_date Date the message will be sent. The date must be within 367 days in the future
|
|
messageSchedulingStateSendAtDate send_date:int32 = MessageSchedulingState;
|
|
|
|
//@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
|
|
messageSchedulingStateSendWhenOnline = MessageSchedulingState;
|
|
|
|
|
|
//@description Options to be used when a message is sent
|
|
//@disable_notification Pass true to disable notification for the message
|
|
//@from_background Pass true if the message is sent from the background
|
|
//@scheduling_state Message scheduling state. Messages sent to a secret chat, live location messages and self-destructing messages can't be scheduled
|
|
messageSendOptions disable_notification:Bool from_background:Bool scheduling_state:MessageSchedulingState = MessageSendOptions;
|
|
|
|
//@description Options to be used when a message content is copied without a link to the original message
|
|
//@send_copy True, if content of the message needs to be copied without a link to the original message. Always true if the message is forwarded to a secret chat
|
|
//@replace_caption True, if media caption of the message copy needs to be replaced. Ignored if send_copy is false
|
|
//@new_caption New message caption. Ignored if replace_caption is false
|
|
messageCopyOptions send_copy:Bool replace_caption:Bool new_caption:formattedText = MessageCopyOptions;
|
|
|
|
|
|
//@class InputMessageContent @description The content of a message to send
|
|
|
|
//@description A text message @text 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
|
|
//@disable_web_page_preview True, if rich web page previews for URLs in the message text should be disabled @clear_draft True, if a chat message draft should be deleted
|
|
inputMessageText text:formattedText disable_web_page_preview:Bool clear_draft:Bool = InputMessageContent;
|
|
|
|
//@description An animation message (GIF-style). @animation Animation file to be sent @thumbnail Animation thumbnail, if available @added_sticker_file_ids File identifiers of the stickers added to the animation, if applicable
|
|
//@duration Duration of the animation, in seconds @width Width of the animation; may be replaced by the server @height Height of the animation; may be replaced by the server @caption Animation caption; 0-GetOption("message_caption_length_max") characters
|
|
inputMessageAnimation animation:InputFile thumbnail:inputThumbnail added_sticker_file_ids:vector<int32> duration:int32 width:int32 height:int32 caption:formattedText = InputMessageContent;
|
|
|
|
//@description An audio message @audio Audio file to be sent @album_cover_thumbnail Thumbnail of the cover for the album, if available @duration Duration of the audio, in seconds; may be replaced by the server @title Title of the audio; 0-64 characters; may be replaced by the server
|
|
//@performer Performer of the audio; 0-64 characters, may be replaced by the server @caption Audio caption; 0-GetOption("message_caption_length_max") characters
|
|
inputMessageAudio audio:InputFile album_cover_thumbnail:inputThumbnail duration:int32 title:string performer:string caption:formattedText = InputMessageContent;
|
|
|
|
//@description A document message (general file) @document Document to be sent @thumbnail Document thumbnail, if available @disable_content_type_detection 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 @caption Document caption; 0-GetOption("message_caption_length_max") characters
|
|
inputMessageDocument document:InputFile thumbnail:inputThumbnail disable_content_type_detection:Bool caption:formattedText = InputMessageContent;
|
|
|
|
//@description A photo message @photo Photo to send @thumbnail Photo thumbnail to be sent, this is sent to the other party in secret chats only @added_sticker_file_ids File identifiers of the stickers added to the photo, if applicable @width Photo width @height Photo height @caption Photo caption; 0-GetOption("message_caption_length_max") characters
|
|
//@ttl Photo TTL (Time To Live), in seconds (0-60). A non-zero TTL can be specified only in private chats
|
|
inputMessagePhoto photo:InputFile thumbnail:inputThumbnail added_sticker_file_ids:vector<int32> width:int32 height:int32 caption:formattedText ttl:int32 = InputMessageContent;
|
|
|
|
//@description A sticker message @sticker Sticker to be sent @thumbnail Sticker thumbnail, if available @width Sticker width @height Sticker height @emoji Emoji used to choose the sticker
|
|
inputMessageSticker sticker:InputFile thumbnail:inputThumbnail width:int32 height:int32 emoji:string = InputMessageContent;
|
|
|
|
//@description A video message @video Video to be sent @thumbnail Video thumbnail, if available @added_sticker_file_ids File identifiers of the stickers added to the video, if applicable
|
|
//@duration Duration of the video, in seconds @width Video width @height Video height @supports_streaming True, if the video should be tried to be streamed
|
|
//@caption Video caption; 0-GetOption("message_caption_length_max") characters @ttl Video TTL (Time To Live), in seconds (0-60). A non-zero TTL can be specified only in private chats
|
|
inputMessageVideo video:InputFile thumbnail:inputThumbnail added_sticker_file_ids:vector<int32> duration:int32 width:int32 height:int32 supports_streaming:Bool caption:formattedText ttl:int32 = InputMessageContent;
|
|
|
|
//@description A video note message @video_note Video note to be sent @thumbnail Video thumbnail, if available @duration Duration of the video, in seconds @length Video width and height; must be positive and not greater than 640
|
|
inputMessageVideoNote video_note:InputFile thumbnail:inputThumbnail duration:int32 length:int32 = InputMessageContent;
|
|
|
|
//@description A voice note message @voice_note Voice note to be sent @duration Duration of the voice note, in seconds @waveform Waveform representation of the voice note, in 5-bit format @caption Voice note caption; 0-GetOption("message_caption_length_max") characters
|
|
inputMessageVoiceNote voice_note:InputFile duration:int32 waveform:bytes caption:formattedText = InputMessageContent;
|
|
|
|
//@description A message with a location @location Location to be sent @live_period Period for which the location can be updated, in seconds; should be between 60 and 86400 for a live location and 0 otherwise
|
|
//@heading For live locations, a direction in which the location moves, in degrees; 1-360. Pass 0 if unknown
|
|
//@proximity_alert_radius 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
|
|
inputMessageLocation location:location live_period:int32 heading:int32 proximity_alert_radius:int32 = InputMessageContent;
|
|
|
|
//@description A message with information about a venue @venue Venue to send
|
|
inputMessageVenue venue:venue = InputMessageContent;
|
|
|
|
//@description A message containing a user contact @contact Contact to send
|
|
inputMessageContact contact:contact = InputMessageContent;
|
|
|
|
//@description A dice message @emoji Emoji on which the dice throw animation is based @clear_draft True, if a chat message draft should be deleted
|
|
inputMessageDice emoji:string clear_draft:Bool = InputMessageContent;
|
|
|
|
//@description A message with a game; not supported for channels or secret chats @bot_user_id User identifier of the bot that owns the game @game_short_name Short name of the game
|
|
inputMessageGame bot_user_id:int32 game_short_name:string = InputMessageContent;
|
|
|
|
//@description A message with an invoice; can be used only by bots and only in private chats @invoice Invoice @title Product title; 1-32 characters @param_description Product description; 0-255 characters @photo_url Product photo URL; optional @photo_size Product photo size @photo_width Product photo width @photo_height Product photo height
|
|
//@payload The invoice payload @provider_token Payment provider token @provider_data JSON-encoded data about the invoice, which will be shared with the payment provider @start_parameter Unique invoice bot start_parameter for the generation of this invoice
|
|
inputMessageInvoice invoice:invoice title:string description:string photo_url:string photo_size:int32 photo_width:int32 photo_height:int32 payload:bytes provider_token:string provider_data:string start_parameter:string = InputMessageContent;
|
|
|
|
//@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 @question Poll question; 1-255 characters (up to 300 characters for bots) @options List of poll answer options, 2-10 strings 1-100 characters each
|
|
//@is_anonymous True, if the poll voters are anonymous. Non-anonymous polls can't be sent or forwarded to channels @type Type of the poll
|
|
//@open_period Amount of time the poll will be active after creation, in seconds; for bots only
|
|
//@close_date Point in time (Unix timestamp) when the poll will be automatically closed; for bots only
|
|
//@is_closed True, if the poll needs to be sent already closed; for bots only
|
|
inputMessagePoll question:string options:vector<string> is_anonymous:Bool type:PollType open_period:int32 close_date:int32 is_closed:Bool = InputMessageContent;
|
|
|
|
//@description A forwarded message @from_chat_id Identifier for the chat this forwarded message came from @message_id Identifier of the message to forward
|
|
//@in_game_share True, if a game message should be shared within a launched game; applies only to game messages
|
|
//@copy_options Options to be used to copy content of the message without a link to the original message
|
|
inputMessageForwarded from_chat_id:int53 message_id:int53 in_game_share:Bool copy_options:messageCopyOptions = InputMessageContent;
|
|
|
|
|
|
//@class SearchMessagesFilter @description Represents a filter for message search results
|
|
|
|
//@description Returns all found messages, no filter is applied
|
|
searchMessagesFilterEmpty = SearchMessagesFilter;
|
|
|
|
//@description Returns only animation messages
|
|
searchMessagesFilterAnimation = SearchMessagesFilter;
|
|
|
|
//@description Returns only audio messages
|
|
searchMessagesFilterAudio = SearchMessagesFilter;
|
|
|
|
//@description Returns only document messages
|
|
searchMessagesFilterDocument = SearchMessagesFilter;
|
|
|
|
//@description Returns only photo messages
|
|
searchMessagesFilterPhoto = SearchMessagesFilter;
|
|
|
|
//@description Returns only video messages
|
|
searchMessagesFilterVideo = SearchMessagesFilter;
|
|
|
|
//@description Returns only voice note messages
|
|
searchMessagesFilterVoiceNote = SearchMessagesFilter;
|
|
|
|
//@description Returns only photo and video messages
|
|
searchMessagesFilterPhotoAndVideo = SearchMessagesFilter;
|
|
|
|
//@description Returns only messages containing URLs
|
|
searchMessagesFilterUrl = SearchMessagesFilter;
|
|
|
|
//@description Returns only messages containing chat photos
|
|
searchMessagesFilterChatPhoto = SearchMessagesFilter;
|
|
|
|
//@description Returns only call messages
|
|
searchMessagesFilterCall = SearchMessagesFilter;
|
|
|
|
//@description Returns only incoming call messages with missed/declined discard reasons
|
|
searchMessagesFilterMissedCall = SearchMessagesFilter;
|
|
|
|
//@description Returns only video note messages
|
|
searchMessagesFilterVideoNote = SearchMessagesFilter;
|
|
|
|
//@description Returns only voice and video note messages
|
|
searchMessagesFilterVoiceAndVideoNote = SearchMessagesFilter;
|
|
|
|
//@description Returns only messages with mentions of the current user, or messages that are replies to their messages
|
|
searchMessagesFilterMention = SearchMessagesFilter;
|
|
|
|
//@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
|
|
searchMessagesFilterUnreadMention = SearchMessagesFilter;
|
|
|
|
//@description Returns only failed to send messages. This filter can be used only if the message database is used
|
|
searchMessagesFilterFailedToSend = SearchMessagesFilter;
|
|
|
|
//@description Returns only pinned messages
|
|
searchMessagesFilterPinned = SearchMessagesFilter;
|
|
|
|
|
|
//@class ChatAction @description Describes the different types of activity in a chat
|
|
|
|
//@description The user is typing a message
|
|
chatActionTyping = ChatAction;
|
|
//@description The user is recording a video
|
|
chatActionRecordingVideo = ChatAction;
|
|
//@description The user is uploading a video @progress Upload progress, as a percentage
|
|
chatActionUploadingVideo progress:int32 = ChatAction;
|
|
//@description The user is recording a voice note
|
|
chatActionRecordingVoiceNote = ChatAction;
|
|
//@description The user is uploading a voice note @progress Upload progress, as a percentage
|
|
chatActionUploadingVoiceNote progress:int32 = ChatAction;
|
|
//@description The user is uploading a photo @progress Upload progress, as a percentage
|
|
chatActionUploadingPhoto progress:int32 = ChatAction;
|
|
//@description The user is uploading a document @progress Upload progress, as a percentage
|
|
chatActionUploadingDocument progress:int32 = ChatAction;
|
|
//@description The user is picking a location or venue to send
|
|
chatActionChoosingLocation = ChatAction;
|
|
//@description The user is picking a contact to send
|
|
chatActionChoosingContact = ChatAction;
|
|
//@description The user has started to play a game
|
|
chatActionStartPlayingGame = ChatAction;
|
|
//@description The user is recording a video note
|
|
chatActionRecordingVideoNote = ChatAction;
|
|
//@description The user is uploading a video note @progress Upload progress, as a percentage
|
|
chatActionUploadingVideoNote progress:int32 = ChatAction;
|
|
//@description The user has cancelled the previous action
|
|
chatActionCancel = ChatAction;
|
|
|
|
|
|
//@class UserStatus @description Describes the last time the user was online
|
|
|
|
//@description The user status was never changed
|
|
userStatusEmpty = UserStatus;
|
|
|
|
//@description The user is online @expires Point in time (Unix timestamp) when the user's online status will expire
|
|
userStatusOnline expires:int32 = UserStatus;
|
|
|
|
//@description The user is offline @was_online Point in time (Unix timestamp) when the user was last online
|
|
userStatusOffline was_online:int32 = UserStatus;
|
|
|
|
//@description The user was online recently
|
|
userStatusRecently = UserStatus;
|
|
|
|
//@description The user is offline, but was online last week
|
|
userStatusLastWeek = UserStatus;
|
|
|
|
//@description The user is offline, but was online last month
|
|
userStatusLastMonth = UserStatus;
|
|
|
|
|
|
//@description Represents a list of stickers @stickers List of stickers
|
|
stickers stickers:vector<sticker> = Stickers;
|
|
|
|
//@description Represents a list of emoji @emojis List of emojis
|
|
emojis emojis:vector<string> = Emojis;
|
|
|
|
//@description Represents a sticker set
|
|
//@id Identifier of the sticker set @title Title of the sticker set @name Name of the sticker set @thumbnail 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
|
|
//@thumbnail_outline 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
|
|
//@is_installed True, if the sticker set has been installed by the current user @is_archived True, if the sticker set has been archived. A sticker set can't be installed and archived simultaneously
|
|
//@is_official True, if the sticker set is official @is_animated True, is the stickers in the set are animated @is_masks True, if the stickers in the set are masks @is_viewed True for already viewed trending sticker sets
|
|
//@stickers List of stickers in this set @emojis 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
|
|
stickerSet id:int64 title:string name:string thumbnail:thumbnail thumbnail_outline:vector<closedVectorPath> is_installed:Bool is_archived:Bool is_official:Bool is_animated:Bool is_masks:Bool is_viewed:Bool stickers:vector<sticker> emojis:vector<emojis> = StickerSet;
|
|
|
|
//@description Represents short information about a sticker set
|
|
//@id Identifier of the sticker set @title Title of the sticker set @name Name of the sticker set @thumbnail Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null
|
|
//@thumbnail_outline 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
|
|
//@is_installed True, if the sticker set has been installed by the current user @is_archived True, if the sticker set has been archived. A sticker set can't be installed and archived simultaneously
|
|
//@is_official True, if the sticker set is official @is_animated True, is the stickers in the set are animated @is_masks True, if the stickers in the set are masks @is_viewed True for already viewed trending sticker sets
|
|
//@size Total number of stickers in the set @covers Contains up to the first 5 stickers from the set, depending on the context. If the application needs more stickers the full set should be requested
|
|
stickerSetInfo id:int64 title:string name:string thumbnail:thumbnail thumbnail_outline:vector<closedVectorPath> is_installed:Bool is_archived:Bool is_official:Bool is_animated:Bool is_masks:Bool is_viewed:Bool size:int32 covers:vector<sticker> = StickerSetInfo;
|
|
|
|
//@description Represents a list of sticker sets @total_count Approximate total number of sticker sets found @sets List of sticker sets
|
|
stickerSets total_count:int32 sets:vector<stickerSetInfo> = StickerSets;
|
|
|
|
|
|
//@class CallDiscardReason @description Describes the reason why a call was discarded
|
|
|
|
//@description The call wasn't discarded, or the reason is unknown
|
|
callDiscardReasonEmpty = CallDiscardReason;
|
|
|
|
//@description The call was ended before the conversation started. It was cancelled by the caller or missed by the other party
|
|
callDiscardReasonMissed = CallDiscardReason;
|
|
|
|
//@description The call was ended before the conversation started. It was declined by the other party
|
|
callDiscardReasonDeclined = CallDiscardReason;
|
|
|
|
//@description The call was ended during the conversation because the users were disconnected
|
|
callDiscardReasonDisconnected = CallDiscardReason;
|
|
|
|
//@description The call was ended because one of the parties hung up
|
|
callDiscardReasonHungUp = CallDiscardReason;
|
|
|
|
|
|
//@description Specifies the supported call protocols
|
|
//@udp_p2p True, if UDP peer-to-peer connections are supported
|
|
//@udp_reflector True, if connection through UDP reflectors is supported
|
|
//@min_layer The minimum supported API layer; use 65
|
|
//@max_layer The maximum supported API layer; use 65
|
|
//@library_versions List of supported tgcalls versions
|
|
callProtocol udp_p2p:Bool udp_reflector:Bool min_layer:int32 max_layer:int32 library_versions:vector<string> = CallProtocol;
|
|
|
|
|
|
//@class CallServerType @description Describes the type of a call server
|
|
|
|
//@description A Telegram call reflector @peer_tag A peer tag to be used with the reflector
|
|
callServerTypeTelegramReflector peer_tag:bytes = CallServerType;
|
|
|
|
//@description A WebRTC server @username Username to be used for authentication @password Authentication password @supports_turn True, if the server supports TURN @supports_stun True, if the server supports STUN
|
|
callServerTypeWebrtc username:string password:string supports_turn:Bool supports_stun:Bool = CallServerType;
|
|
|
|
|
|
//@description Describes a server for relaying call data @id Server identifier @ip_address Server IPv4 address @ipv6_address Server IPv6 address @port Server port number @type Server type
|
|
callServer id:int64 ip_address:string ipv6_address:string port:int32 type:CallServerType = CallServer;
|
|
|
|
|
|
//@description Contains the call identifier @id Call identifier
|
|
callId id:int32 = CallId;
|
|
|
|
//@description Contains the group call identifier @id Group call identifier
|
|
groupCallId id:int32 = GroupCallId;
|
|
|
|
|
|
//@class CallState @description Describes the current call state
|
|
|
|
//@description The call is pending, waiting to be accepted by a user @is_created True, if the call has already been created by the server @is_received True, if the call has already been received by the other party
|
|
callStatePending is_created:Bool is_received:Bool = CallState;
|
|
|
|
//@description The call has been answered and encryption keys are being exchanged
|
|
callStateExchangingKeys = CallState;
|
|
|
|
//@description The call is ready to use @protocol Call protocols supported by the peer @servers List of available call servers @config A JSON-encoded call config @encryption_key Call encryption key @emojis Encryption key emojis fingerprint @allow_p2p True, if peer-to-peer connection is allowed by users privacy settings
|
|
callStateReady protocol:callProtocol servers:vector<callServer> config:string encryption_key:bytes emojis:vector<string> allow_p2p:Bool = CallState;
|
|
|
|
//@description The call is hanging up after discardCall has been called
|
|
callStateHangingUp = CallState;
|
|
|
|
//@description The call has ended successfully @reason The reason, why the call has ended @need_rating True, if the call rating should be sent to the server @need_debug_information True, if the call debug information should be sent to the server
|
|
callStateDiscarded reason:CallDiscardReason need_rating:Bool need_debug_information:Bool = CallState;
|
|
|
|
//@description The call has ended with an error @error Error. An error with the code 4005000 will be returned if an outgoing call is missed because of an expired timeout
|
|
callStateError error:error = CallState;
|
|
|
|
|
|
//@description Describes a recently speaking participant in a group call @speaker Speaking participantt @is_speaking True, is the user has spoken recently
|
|
groupCallRecentSpeaker speaker:MessageSender is_speaking:Bool = GroupCallRecentSpeaker;
|
|
|
|
//@description Describes a group call
|
|
//@id Group call identifier
|
|
//@title Group call title
|
|
//@is_active True, if the call is active
|
|
//@is_joined True, if the call is joined
|
|
//@need_rejoin True, if user was kicked from the call because of network loss and the call needs to be rejoined
|
|
//@can_unmute_self True, if the current user can unmute themself
|
|
//@can_be_managed True, if the current user can manage the group call
|
|
//@participant_count Number of participants in the group call
|
|
//@loaded_all_participants True, if all group call participants are loaded
|
|
//@recent_speakers Recently speaking users in the group call
|
|
//@mute_new_participants True, if only group call administrators can unmute new participants
|
|
//@can_change_mute_new_participants True, if the current user can enable or disable mute_new_participants setting
|
|
//@record_duration 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
|
|
//@duration Call duration; for ended calls only
|
|
groupCall id:int32 title:string is_active:Bool is_joined:Bool need_rejoin:Bool can_unmute_self:Bool can_be_managed:Bool participant_count:int32 loaded_all_participants:Bool recent_speakers:vector<groupCallRecentSpeaker> mute_new_participants:Bool can_change_mute_new_participants:Bool record_duration:int32 duration:int32 = GroupCall;
|
|
|
|
//@description Describes a payload fingerprint for interaction with tgcalls @hash Value of the field hash @setup Value of the field setup @fingerprint Value of the field fingerprint
|
|
groupCallPayloadFingerprint hash:string setup:string fingerprint:string = GroupCallPayloadFingerprint;
|
|
|
|
//@description Describes a payload for interaction with tgcalls @ufrag Value of the field ufrag @pwd Value of the field pwd @fingerprints The list of fingerprints
|
|
groupCallPayload ufrag:string pwd:string fingerprints:vector<groupCallPayloadFingerprint> = GroupCallPayload;
|
|
|
|
//@description Describes a join response candidate for interaction with tgcalls @port Value of the field port @protocol Value of the field protocol @network Value of the field network
|
|
//@generation Value of the field generation @id Value of the field id @component Value of the field component @foundation Value of the field foundation @priority Value of the field priority
|
|
//@ip Value of the field ip @type Value of the field type @tcp_type Value of the field tcp_type @rel_addr Value of the field rel_addr @rel_port Value of the field rel_port
|
|
groupCallJoinResponseCandidate port:string protocol:string network:string generation:string id:string component:string foundation:string priority:string ip:string type:string tcp_type:string rel_addr:string rel_port:string = GroupCallJoinResponseCandidate;
|
|
|
|
|
|
//@class GroupCallJoinResponse @description Describes a group call join response
|
|
|
|
//@description Contains data needed to join the group call with WebRTC @payload Group call payload to pass to tgcalls @candidates Join response candidates to pass to tgcalls
|
|
groupCallJoinResponseWebrtc payload:groupCallPayload candidates:vector<groupCallJoinResponseCandidate> = GroupCallJoinResponse;
|
|
|
|
//@description Describes that group call needs to be joined as a stream
|
|
groupCallJoinResponseStream = GroupCallJoinResponse;
|
|
|
|
|
|
//@description Represents a group call participant
|
|
//@participant Identifier of the group call participant
|
|
//@source User's synchronization source
|
|
//@bio The participant user's bio or the participant chat's description
|
|
//@is_speaking True, if the participant is speaking as set by setGroupCallParticipantIsSpeaking
|
|
//@is_hand_raised True, if the participant hand is raised
|
|
//@can_be_muted_for_all_users True, if the current user can mute the participant for all other group call participants
|
|
//@can_be_unmuted_for_all_users True, if the current user can allow the participant to unmute themself or unmute the participant (if the participant is the current user)
|
|
//@can_be_muted_for_current_user True, if the current user can mute the participant only for self
|
|
//@can_be_unmuted_for_current_user True, if the current user can unmute the participant for self
|
|
//@is_muted_for_all_users True, if the participant is muted for all users
|
|
//@is_muted_for_current_user True, if the participant is muted for the current user
|
|
//@can_unmute_self True, if the participant is muted for all users, but can unmute themself
|
|
//@volume_level Participant's volume level; 1-20000 in hundreds of percents
|
|
//@order 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
|
|
groupCallParticipant participant:MessageSender source:int32 bio:string is_speaking:Bool is_hand_raised:Bool can_be_muted_for_all_users:Bool can_be_unmuted_for_all_users:Bool can_be_muted_for_current_user:Bool can_be_unmuted_for_current_user:Bool is_muted_for_all_users:Bool is_muted_for_current_user:Bool can_unmute_self:Bool volume_level:int32 order:string = GroupCallParticipant;
|
|
|
|
|
|
//@class CallProblem @description Describes the exact type of a problem with a call
|
|
|
|
//@description The user heard their own voice
|
|
callProblemEcho = CallProblem;
|
|
|
|
//@description The user heard background noise
|
|
callProblemNoise = CallProblem;
|
|
|
|
//@description The other side kept disappearing
|
|
callProblemInterruptions = CallProblem;
|
|
|
|
//@description The speech was distorted
|
|
callProblemDistortedSpeech = CallProblem;
|
|
|
|
//@description The user couldn't hear the other side
|
|
callProblemSilentLocal = CallProblem;
|
|
|
|
//@description The other side couldn't hear the user
|
|
callProblemSilentRemote = CallProblem;
|
|
|
|
//@description The call ended unexpectedly
|
|
callProblemDropped = CallProblem;
|
|
|
|
//@description The video was distorted
|
|
callProblemDistortedVideo = CallProblem;
|
|
|
|
//@description The video was pixelated
|
|
callProblemPixelatedVideo = CallProblem;
|
|
|
|
|
|
//@description Describes a call @id Call identifier, not persistent @user_id Peer user identifier @is_outgoing True, if the call is outgoing @is_video True, if the call is a video call @state Call state
|
|
call id:int32 user_id:int32 is_outgoing:Bool is_video:Bool state:CallState = Call;
|
|
|
|
|
|
//@description Contains settings for the authentication of the user's phone number
|
|
//@allow_flash_call Pass true if the authentication code may be sent via flash call to the specified phone number
|
|
//@is_current_phone_number Pass true if the authenticated phone number is used on the current device
|
|
//@allow_sms_retriever_api For official applications only. True, if the application can use Android SMS Retriever API (requires Google Play Services >= 10.2) to automatically receive the authentication code from the SMS. See https://developers.google.com/identity/sms-retriever/ for more details
|
|
phoneNumberAuthenticationSettings allow_flash_call:Bool is_current_phone_number:Bool allow_sms_retriever_api:Bool = PhoneNumberAuthenticationSettings;
|
|
|
|
|
|
//@description Represents a list of animations @animations List of animations
|
|
animations animations:vector<animation> = Animations;
|
|
|
|
|
|
//@class DiceStickers @description Contains animated stickers which should be used for dice animation rendering
|
|
|
|
//@description A regular animated sticker @sticker The animated sticker with the dice animation
|
|
diceStickersRegular sticker:sticker = DiceStickers;
|
|
|
|
//@description Animated stickers to be combined into a slot machine
|
|
//@background The animated sticker with the slot machine background. The background animation must start playing after all reel animations finish
|
|
//@lever The animated sticker with the lever animation. The lever animation must play once in the initial dice state
|
|
//@left_reel The animated sticker with the left reel
|
|
//@center_reel The animated sticker with the center reel
|
|
//@right_reel The animated sticker with the right reel
|
|
diceStickersSlotMachine background:sticker lever:sticker left_reel:sticker center_reel:sticker right_reel:sticker = DiceStickers;
|
|
|
|
|
|
//@description Represents the result of an ImportContacts request @user_ids 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
|
|
//@importer_count The number of users that imported the corresponding contact; 0 for already registered users or if unavailable
|
|
importedContacts user_ids:vector<int32> importer_count:vector<int32> = ImportedContacts;
|
|
|
|
|
|
//@description Contains an HTTP URL @url The URL
|
|
httpUrl url:string = HttpUrl;
|
|
|
|
|
|
//@class InputInlineQueryResult @description Represents a single result of an inline query; for bots only
|
|
|
|
//@description Represents a link to an animated GIF or an animated (i.e. without sound) H.264/MPEG-4 AVC video
|
|
//@id Unique identifier of the query result @title Title of the query result
|
|
//@thumbnail_url URL of the result thumbnail (JPEG, GIF, or MPEG4), if it exists @thumbnail_mime_type MIME type of the video thumbnail. If non-empty, must be one of "image/jpeg", "image/gif" and "video/mp4"
|
|
//@video_url The URL of the video file (file size must not exceed 1MB) @video_mime_type MIME type of the video file. Must be one of "image/gif" and "video/mp4"
|
|
//@video_duration Duration of the video, in seconds @video_width Width of the video @video_height Height of the video
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageAnimation, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultAnimation id:string title:string thumbnail_url:string thumbnail_mime_type:string video_url:string video_mime_type:string video_duration:int32 video_width:int32 video_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents a link to an article or web page @id Unique identifier of the query result @url URL of the result, if it exists @hide_url True, if the URL must be not shown @title Title of the result
|
|
//@param_description A short description of the result @thumbnail_url URL of the result thumbnail, if it exists @thumbnail_width Thumbnail width, if known @thumbnail_height Thumbnail height, if known
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultArticle id:string url:string hide_url:Bool title:string description:string thumbnail_url:string thumbnail_width:int32 thumbnail_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents a link to an MP3 audio file @id Unique identifier of the query result @title Title of the audio file @performer Performer of the audio file
|
|
//@audio_url The URL of the audio file @audio_duration Audio file duration, in seconds
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageAudio, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultAudio id:string title:string performer:string audio_url:string audio_duration:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents a user contact @id Unique identifier of the query result @contact User contact @thumbnail_url URL of the result thumbnail, if it exists @thumbnail_width Thumbnail width, if known @thumbnail_height Thumbnail height, if known
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultContact id:string contact:contact thumbnail_url:string thumbnail_width:int32 thumbnail_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents a link to a file @id Unique identifier of the query result @title Title of the resulting file @param_description Short description of the result, if known @document_url URL of the file @mime_type MIME type of the file content; only "application/pdf" and "application/zip" are currently allowed
|
|
//@thumbnail_url The URL of the file thumbnail, if it exists @thumbnail_width Width of the thumbnail @thumbnail_height Height of the thumbnail
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageDocument, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultDocument id:string title:string description:string document_url:string mime_type:string thumbnail_url:string thumbnail_width:int32 thumbnail_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents a game @id Unique identifier of the query result @game_short_name Short name of the game @reply_markup Message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
inputInlineQueryResultGame id:string game_short_name:string reply_markup:ReplyMarkup = InputInlineQueryResult;
|
|
|
|
//@description Represents a point on the map @id Unique identifier of the query result @location Location result
|
|
//@live_period Amount of time relative to the message sent time until the location can be updated, in seconds
|
|
//@title Title of the result @thumbnail_url URL of the result thumbnail, if it exists @thumbnail_width Thumbnail width, if known @thumbnail_height Thumbnail height, if known
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultLocation id:string location:location live_period:int32 title:string thumbnail_url:string thumbnail_width:int32 thumbnail_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents link to a JPEG image @id Unique identifier of the query result @title Title of the result, if known @param_description A short description of the result, if known @thumbnail_url URL of the photo thumbnail, if it exists
|
|
//@photo_url The URL of the JPEG photo (photo size must not exceed 5MB) @photo_width Width of the photo @photo_height Height of the photo
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessagePhoto, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultPhoto id:string title:string description:string thumbnail_url:string photo_url:string photo_width:int32 photo_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents a link to a WEBP or TGS sticker @id Unique identifier of the query result @thumbnail_url URL of the sticker thumbnail, if it exists
|
|
//@sticker_url The URL of the WEBP or TGS sticker (sticker file size must not exceed 5MB) @sticker_width Width of the sticker @sticker_height Height of the sticker
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, inputMessageSticker, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultSticker id:string thumbnail_url:string sticker_url:string sticker_width:int32 sticker_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents information about a venue @id Unique identifier of the query result @venue Venue result @thumbnail_url URL of the result thumbnail, if it exists @thumbnail_width Thumbnail width, if known @thumbnail_height Thumbnail height, if known
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultVenue id:string venue:venue thumbnail_url:string thumbnail_width:int32 thumbnail_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents a link to a page containing an embedded video player or a video file @id Unique identifier of the query result @title Title of the result @param_description A short description of the result, if known
|
|
//@thumbnail_url The URL of the video thumbnail (JPEG), if it exists @video_url URL of the embedded video player or video file @mime_type MIME type of the content of the video URL, only "text/html" or "video/mp4" are currently supported
|
|
//@video_width Width of the video @video_height Height of the video @video_duration Video duration, in seconds
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageVideo, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultVideo id:string title:string description:string thumbnail_url:string video_url:string mime_type:string video_width:int32 video_height:int32 video_duration:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
//@description Represents a link to an opus-encoded audio file within an OGG container, single channel audio @id Unique identifier of the query result @title Title of the voice note
|
|
//@voice_note_url The URL of the voice note file @voice_note_duration Duration of the voice note, in seconds
|
|
//@reply_markup The message reply markup. Must be of type replyMarkupInlineKeyboard or null
|
|
//@input_message_content The content of the message to be sent. Must be one of the following types: InputMessageText, InputMessageVoiceNote, InputMessageLocation, InputMessageVenue or InputMessageContact
|
|
inputInlineQueryResultVoiceNote id:string title:string voice_note_url:string voice_note_duration:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult;
|
|
|
|
|
|
//@class InlineQueryResult @description Represents a single result of an inline query
|
|
|
|
//@description Represents a link to an article or web page @id Unique identifier of the query result @url URL of the result, if it exists @hide_url True, if the URL must be not shown @title Title of the result
|
|
//@param_description A short description of the result @thumbnail Result thumbnail in JPEG format; may be null
|
|
inlineQueryResultArticle id:string url:string hide_url:Bool title:string description:string thumbnail:thumbnail = InlineQueryResult;
|
|
|
|
//@description Represents a user contact @id Unique identifier of the query result @contact A user contact @thumbnail Result thumbnail in JPEG format; may be null
|
|
inlineQueryResultContact id:string contact:contact thumbnail:thumbnail = InlineQueryResult;
|
|
|
|
//@description Represents a point on the map @id Unique identifier of the query result @location Location result @title Title of the result @thumbnail Result thumbnail in JPEG format; may be null
|
|
inlineQueryResultLocation id:string location:location title:string thumbnail:thumbnail = InlineQueryResult;
|
|
|
|
//@description Represents information about a venue @id Unique identifier of the query result @venue Venue result @thumbnail Result thumbnail in JPEG format; may be null
|
|
inlineQueryResultVenue id:string venue:venue thumbnail:thumbnail = InlineQueryResult;
|
|
|
|
//@description Represents information about a game @id Unique identifier of the query result @game Game result
|
|
inlineQueryResultGame id:string game:game = InlineQueryResult;
|
|
|
|
//@description Represents an animation file @id Unique identifier of the query result @animation Animation file @title Animation title
|
|
inlineQueryResultAnimation id:string animation:animation title:string = InlineQueryResult;
|
|
|
|
//@description Represents an audio file @id Unique identifier of the query result @audio Audio file
|
|
inlineQueryResultAudio id:string audio:audio = InlineQueryResult;
|
|
|
|
//@description Represents a document @id Unique identifier of the query result @document Document @title Document title @param_description Document description
|
|
inlineQueryResultDocument id:string document:document title:string description:string = InlineQueryResult;
|
|
|
|
//@description Represents a photo @id Unique identifier of the query result @photo Photo @title Title of the result, if known @param_description A short description of the result, if known
|
|
inlineQueryResultPhoto id:string photo:photo title:string description:string = InlineQueryResult;
|
|
|
|
//@description Represents a sticker @id Unique identifier of the query result @sticker Sticker
|
|
inlineQueryResultSticker id:string sticker:sticker = InlineQueryResult;
|
|
|
|
//@description Represents a video @id Unique identifier of the query result @video Video @title Title of the video @param_description Description of the video
|
|
inlineQueryResultVideo id:string video:video title:string description:string = InlineQueryResult;
|
|
|
|
//@description Represents a voice note @id Unique identifier of the query result @voice_note Voice note @title Title of the voice note
|
|
inlineQueryResultVoiceNote id:string voice_note:voiceNote title:string = InlineQueryResult;
|
|
|
|
|
|
//@description Represents the results of the inline query. Use sendInlineQueryResultMessage to send the result of the query @inline_query_id Unique identifier of the inline query @next_offset The offset for the next request. If empty, there are no more results @results Results of the query
|
|
//@switch_pm_text If non-empty, this text should 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 @switch_pm_parameter Parameter for the bot start message
|
|
inlineQueryResults inline_query_id:int64 next_offset:string results:vector<InlineQueryResult> switch_pm_text:string switch_pm_parameter:string = InlineQueryResults;
|
|
|
|
|
|
//@class CallbackQueryPayload @description Represents a payload of a callback query
|
|
|
|
//@description The payload for a general callback button @data Data that was attached to the callback button
|
|
callbackQueryPayloadData data:bytes = CallbackQueryPayload;
|
|
|
|
//@description The payload for a callback button requiring password @password The password for the current user @data Data that was attached to the callback button
|
|
callbackQueryPayloadDataWithPassword password:string data:bytes = CallbackQueryPayload;
|
|
|
|
//@description The payload for a game callback button @game_short_name A short name of the game that was attached to the callback button
|
|
callbackQueryPayloadGame game_short_name:string = CallbackQueryPayload;
|
|
|
|
|
|
//@description Contains a bot's answer to a callback query @text Text of the answer @show_alert True, if an alert should be shown to the user instead of a toast notification @url URL to be opened
|
|
callbackQueryAnswer text:string show_alert:Bool url:string = CallbackQueryAnswer;
|
|
|
|
|
|
//@description Contains the result of a custom request @result A JSON-serialized result
|
|
customRequestResult result:string = CustomRequestResult;
|
|
|
|
|
|
//@description Contains one row of the game high score table @position Position in the high score table @user_id User identifier @score User score
|
|
gameHighScore position:int32 user_id:int32 score:int32 = GameHighScore;
|
|
|
|
//@description Contains a list of game high scores @scores A list of game high scores
|
|
gameHighScores scores:vector<gameHighScore> = GameHighScores;
|
|
|
|
|
|
//@class ChatEventAction @description Represents a chat event
|
|
|
|
//@description A message was edited @old_message The original message before the edit @new_message The message after it was edited
|
|
chatEventMessageEdited old_message:message new_message:message = ChatEventAction;
|
|
|
|
//@description A message was deleted @message Deleted message
|
|
chatEventMessageDeleted message:message = ChatEventAction;
|
|
|
|
//@description A poll in a message was stopped @message The message with the poll
|
|
chatEventPollStopped message:message = ChatEventAction;
|
|
|
|
//@description A message was pinned @message Pinned message
|
|
chatEventMessagePinned message:message = ChatEventAction;
|
|
|
|
//@description A message was unpinned @message Unpinned message
|
|
chatEventMessageUnpinned message:message = ChatEventAction;
|
|
|
|
//@description A new member joined the chat
|
|
chatEventMemberJoined = ChatEventAction;
|
|
|
|
//@description A new member joined the chat by an invite link @invite_link Invite link used to join the chat
|
|
chatEventMemberJoinedByInviteLink invite_link:chatInviteLink = ChatEventAction;
|
|
|
|
//@description A member left the chat
|
|
chatEventMemberLeft = ChatEventAction;
|
|
|
|
//@description A new chat member was invited @user_id New member user identifier @status New member status
|
|
chatEventMemberInvited user_id:int32 status:ChatMemberStatus = ChatEventAction;
|
|
|
|
//@description A chat member has gained/lost administrator status, or the list of their administrator privileges has changed @user_id Chat member user identifier @old_status Previous status of the chat member @new_status New status of the chat member
|
|
chatEventMemberPromoted user_id:int32 old_status:ChatMemberStatus new_status:ChatMemberStatus = ChatEventAction;
|
|
|
|
//@description A chat member was restricted/unrestricted or banned/unbanned, or the list of their restrictions has changed @user_id Chat member user identifier @old_status Previous status of the chat member @new_status New status of the chat member
|
|
chatEventMemberRestricted user_id:int32 old_status:ChatMemberStatus new_status:ChatMemberStatus = ChatEventAction;
|
|
|
|
//@description The chat title was changed @old_title Previous chat title @new_title New chat title
|
|
chatEventTitleChanged old_title:string new_title:string = ChatEventAction;
|
|
|
|
//@description The chat permissions was changed @old_permissions Previous chat permissions @new_permissions New chat permissions
|
|
chatEventPermissionsChanged old_permissions:chatPermissions new_permissions:chatPermissions = ChatEventAction;
|
|
|
|
//@description The chat description was changed @old_description Previous chat description @new_description New chat description
|
|
chatEventDescriptionChanged old_description:string new_description:string = ChatEventAction;
|
|
|
|
//@description The chat username was changed @old_username Previous chat username @new_username New chat username
|
|
chatEventUsernameChanged old_username:string new_username:string = ChatEventAction;
|
|
|
|
//@description The chat photo was changed @old_photo Previous chat photo value; may be null @new_photo New chat photo value; may be null
|
|
chatEventPhotoChanged old_photo:chatPhoto new_photo:chatPhoto = ChatEventAction;
|
|
|
|
//@description The can_invite_users permission of a supergroup chat was toggled @can_invite_users New value of can_invite_users permission
|
|
chatEventInvitesToggled can_invite_users:Bool = ChatEventAction;
|
|
|
|
//@description The linked chat of a supergroup was changed @old_linked_chat_id Previous supergroup linked chat identifier @new_linked_chat_id New supergroup linked chat identifier
|
|
chatEventLinkedChatChanged old_linked_chat_id:int53 new_linked_chat_id:int53 = ChatEventAction;
|
|
|
|
//@description The slow_mode_delay setting of a supergroup was changed @old_slow_mode_delay Previous value of slow_mode_delay @new_slow_mode_delay New value of slow_mode_delay
|
|
chatEventSlowModeDelayChanged old_slow_mode_delay:int32 new_slow_mode_delay:int32 = ChatEventAction;
|
|
|
|
//@description The message TTL setting was changed @old_message_ttl_setting Previous value of message_ttl_setting @new_message_ttl_setting New value of message_ttl_setting
|
|
chatEventMessageTtlSettingChanged old_message_ttl_setting:int32 new_message_ttl_setting:int32 = ChatEventAction;
|
|
|
|
//@description The sign_messages setting of a channel was toggled @sign_messages New value of sign_messages
|
|
chatEventSignMessagesToggled sign_messages:Bool = ChatEventAction;
|
|
|
|
//@description The supergroup sticker set was changed @old_sticker_set_id Previous identifier of the chat sticker set; 0 if none @new_sticker_set_id New identifier of the chat sticker set; 0 if none
|
|
chatEventStickerSetChanged old_sticker_set_id:int64 new_sticker_set_id:int64 = ChatEventAction;
|
|
|
|
//@description The supergroup location was changed @old_location Previous location; may be null @new_location New location; may be null
|
|
chatEventLocationChanged old_location:chatLocation new_location:chatLocation = ChatEventAction;
|
|
|
|
//@description The is_all_history_available setting of a supergroup was toggled @is_all_history_available New value of is_all_history_available
|
|
chatEventIsAllHistoryAvailableToggled is_all_history_available:Bool = ChatEventAction;
|
|
|
|
//@description A chat invite link was edited @old_invite_link Previous information about the invite link @new_invite_link New information about the invite link
|
|
chatEventInviteLinkEdited old_invite_link:chatInviteLink new_invite_link:chatInviteLink = ChatEventAction;
|
|
|
|
//@description A chat invite link was revoked @invite_link The invite link
|
|
chatEventInviteLinkRevoked invite_link:chatInviteLink = ChatEventAction;
|
|
|
|
//@description A revoked chat invite link was deleted @invite_link The invite link
|
|
chatEventInviteLinkDeleted invite_link:chatInviteLink = ChatEventAction;
|
|
|
|
//@description A voice chat was created @group_call_id Identifier of the voice chat. The voice chat can be received through the method getGroupCall
|
|
chatEventVoiceChatCreated group_call_id:int32 = ChatEventAction;
|
|
|
|
//@description A voice chat was discarded @group_call_id Identifier of the voice chat. The voice chat can be received through the method getGroupCall
|
|
chatEventVoiceChatDiscarded group_call_id:int32 = ChatEventAction;
|
|
|
|
//@description A voice chat participant was muted or unmuted @participant Identifier of the affected group call participant @is_muted New value of is_muted
|
|
chatEventVoiceChatParticipantIsMutedToggled participant:MessageSender is_muted:Bool = ChatEventAction;
|
|
|
|
//@description A voice chat participant volume level was changed @participant Identifier of the affected group call participant @volume_level New value of volume_level; 1-20000 in hundreds of percents
|
|
chatEventVoiceChatParticipantVolumeLevelChanged participant:MessageSender volume_level:int32 = ChatEventAction;
|
|
|
|
//@description The mute_new_participants setting of a voice chat was toggled @mute_new_participants New value of the mute_new_participants setting
|
|
chatEventVoiceChatMuteNewParticipantsToggled mute_new_participants:Bool = ChatEventAction;
|
|
|
|
//@description Represents a chat event @id Chat event identifier @date Point in time (Unix timestamp) when the event happened @user_id Identifier of the user who performed the action that triggered the event @action Action performed by the user
|
|
chatEvent id:int64 date:int32 user_id:int32 action:ChatEventAction = ChatEvent;
|
|
|
|
//@description Contains a list of chat events @events List of events
|
|
chatEvents events:vector<chatEvent> = ChatEvents;
|
|
|
|
//@description Represents a set of filters used to obtain a chat event log
|
|
//@message_edits True, if message edits should be returned
|
|
//@message_deletions True, if message deletions should be returned
|
|
//@message_pins True, if pin/unpin events should be returned
|
|
//@member_joins True, if members joining events should be returned
|
|
//@member_leaves True, if members leaving events should be returned
|
|
//@member_invites True, if invited member events should be returned
|
|
//@member_promotions True, if member promotion/demotion events should be returned
|
|
//@member_restrictions True, if member restricted/unrestricted/banned/unbanned events should be returned
|
|
//@info_changes True, if changes in chat information should be returned
|
|
//@setting_changes True, if changes in chat settings should be returned
|
|
//@invite_link_changes True, if changes to invite links should be returned
|
|
//@voice_chat_changes True, if voice chat actions should be returned
|
|
chatEventLogFilters message_edits:Bool message_deletions:Bool message_pins:Bool member_joins:Bool member_leaves:Bool member_invites:Bool member_promotions:Bool member_restrictions:Bool info_changes:Bool setting_changes:Bool invite_link_changes:Bool voice_chat_changes:Bool = ChatEventLogFilters;
|
|
|
|
|
|
//@class LanguagePackStringValue @description Represents the value of a string in a language pack
|
|
|
|
//@description An ordinary language pack string @value String value
|
|
languagePackStringValueOrdinary value:string = LanguagePackStringValue;
|
|
|
|
//@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
|
|
//@zero_value Value for zero objects @one_value Value for one object @two_value Value for two objects
|
|
//@few_value Value for few objects @many_value Value for many objects @other_value Default value
|
|
languagePackStringValuePluralized zero_value:string one_value:string two_value:string few_value:string many_value:string other_value:string = LanguagePackStringValue;
|
|
|
|
//@description A deleted language pack string, the value should be taken from the built-in english language pack
|
|
languagePackStringValueDeleted = LanguagePackStringValue;
|
|
|
|
|
|
//@description Represents one language pack string @key String key @value String value
|
|
languagePackString key:string value:LanguagePackStringValue = LanguagePackString;
|
|
|
|
//@description Contains a list of language pack strings @strings A list of language pack strings
|
|
languagePackStrings strings:vector<languagePackString> = LanguagePackStrings;
|
|
|
|
//@description Contains information about a language pack @id Unique language pack identifier
|
|
//@base_language_pack_id Identifier of a base language pack; may be empty. If a string is missed in the language pack, then it should be fetched from base language pack. Unsupported in custom language packs
|
|
//@name Language name @native_name Name of the language in that language
|
|
//@plural_code 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
|
|
//@is_official True, if the language pack is official @is_rtl True, if the language pack strings are RTL @is_beta True, if the language pack is a beta language pack
|
|
//@is_installed True, if the language pack is installed by the current user
|
|
//@total_string_count Total number of non-deleted strings from the language pack @translated_string_count Total number of translated strings from the language pack
|
|
//@local_string_count Total number of non-deleted strings from the language pack available locally @translation_url Link to language translation interface; empty for custom local language packs
|
|
languagePackInfo id:string base_language_pack_id:string name:string native_name:string plural_code:string is_official:Bool is_rtl:Bool is_beta:Bool is_installed:Bool total_string_count:int32 translated_string_count:int32 local_string_count:int32 translation_url:string = LanguagePackInfo;
|
|
|
|
//@description Contains information about the current localization target @language_packs List of available language packs for this application
|
|
localizationTargetInfo language_packs:vector<languagePackInfo> = LocalizationTargetInfo;
|
|
|
|
|
|
//@class DeviceToken @description Represents a data needed to subscribe for push notifications through registerDevice method. To use specific push notification service, the correct application platform must be specified and a valid server authentication data must be uploaded at https://my.telegram.org
|
|
|
|
//@description A token for Firebase Cloud Messaging @token Device registration token; may be empty to de-register a device @encrypt True, if push notifications should be additionally encrypted
|
|
deviceTokenFirebaseCloudMessaging token:string encrypt:Bool = DeviceToken;
|
|
|
|
//@description A token for Apple Push Notification service @device_token Device token; may be empty to de-register a device @is_app_sandbox True, if App Sandbox is enabled
|
|
deviceTokenApplePush device_token:string is_app_sandbox:Bool = DeviceToken;
|
|
|
|
//@description A token for Apple Push Notification service VoIP notifications @device_token Device token; may be empty to de-register a device @is_app_sandbox True, if App Sandbox is enabled @encrypt True, if push notifications should be additionally encrypted
|
|
deviceTokenApplePushVoIP device_token:string is_app_sandbox:Bool encrypt:Bool = DeviceToken;
|
|
|
|
//@description A token for Windows Push Notification Services @access_token The access token that will be used to send notifications; may be empty to de-register a device
|
|
deviceTokenWindowsPush access_token:string = DeviceToken;
|
|
|
|
//@description A token for Microsoft Push Notification Service @channel_uri Push notification channel URI; may be empty to de-register a device
|
|
deviceTokenMicrosoftPush channel_uri:string = DeviceToken;
|
|
|
|
//@description A token for Microsoft Push Notification Service VoIP channel @channel_uri Push notification channel URI; may be empty to de-register a device
|
|
deviceTokenMicrosoftPushVoIP channel_uri:string = DeviceToken;
|
|
|
|
//@description A token for web Push API @endpoint Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device
|
|
//@p256dh_base64url Base64url-encoded P-256 elliptic curve Diffie-Hellman public key @auth_base64url Base64url-encoded authentication secret
|
|
deviceTokenWebPush endpoint:string p256dh_base64url:string auth_base64url:string = DeviceToken;
|
|
|
|
//@description A token for Simple Push API for Firefox OS @endpoint Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device
|
|
deviceTokenSimplePush endpoint:string = DeviceToken;
|
|
|
|
//@description A token for Ubuntu Push Client service @token Token; may be empty to de-register a device
|
|
deviceTokenUbuntuPush token:string = DeviceToken;
|
|
|
|
//@description A token for BlackBerry Push Service @token Token; may be empty to de-register a device
|
|
deviceTokenBlackBerryPush token:string = DeviceToken;
|
|
|
|
//@description A token for Tizen Push Service @reg_id Push service registration identifier; may be empty to de-register a device
|
|
deviceTokenTizenPush reg_id:string = DeviceToken;
|
|
|
|
|
|
//@description Contains a globally unique push receiver identifier, which can be used to identify which account has received a push notification @id The globally unique identifier of push notification subscription
|
|
pushReceiverId id:int64 = PushReceiverId;
|
|
|
|
|
|
//@class BackgroundFill @description Describes a fill of a background
|
|
|
|
//@description Describes a solid fill of a background @color A color of the background in the RGB24 format
|
|
backgroundFillSolid color:int32 = BackgroundFill;
|
|
|
|
//@description Describes a gradient fill of a background @top_color A top color of the background in the RGB24 format @bottom_color A bottom color of the background in the RGB24 format
|
|
//@rotation_angle Clockwise rotation angle of the gradient, in degrees; 0-359. Should be always divisible by 45
|
|
backgroundFillGradient top_color:int32 bottom_color:int32 rotation_angle:int32 = BackgroundFill;
|
|
|
|
|
|
//@class BackgroundType @description Describes the type of a background
|
|
|
|
//@description A wallpaper in JPEG format
|
|
//@is_blurred True, if the wallpaper must be downscaled to fit in 450x450 square and then box-blurred with radius 12
|
|
//@is_moving True, if the background needs to be slightly moved when device is tilted
|
|
backgroundTypeWallpaper is_blurred:Bool is_moving:Bool = BackgroundType;
|
|
|
|
//@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
|
|
//@fill Description of the background fill
|
|
//@intensity Intensity of the pattern when it is shown above the filled background; 0-100
|
|
//@is_moving True, if the background needs to be slightly moved when device is tilted
|
|
backgroundTypePattern fill:BackgroundFill intensity:int32 is_moving:Bool = BackgroundType;
|
|
|
|
//@description A filled background @fill Description of the background fill
|
|
backgroundTypeFill fill:BackgroundFill = BackgroundType;
|
|
|
|
|
|
//@description Describes a chat background
|
|
//@id Unique background identifier
|
|
//@is_default True, if this is one of default backgrounds
|
|
//@is_dark True, if the background is dark and is recommended to be used with dark theme
|
|
//@name Unique background name
|
|
//@document Document with the background; may be null. Null only for filled backgrounds
|
|
//@type Type of the background
|
|
background id:int64 is_default:Bool is_dark:Bool name:string document:document type:BackgroundType = Background;
|
|
|
|
//@description Contains a list of backgrounds @backgrounds A list of backgrounds
|
|
backgrounds backgrounds:vector<background> = Backgrounds;
|
|
|
|
|
|
//@class InputBackground @description Contains information about background to set
|
|
|
|
//@description A background from a local file
|
|
//@background 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
|
|
inputBackgroundLocal background:InputFile = InputBackground;
|
|
|
|
//@description A background from the server @background_id The background identifier
|
|
inputBackgroundRemote background_id:int64 = InputBackground;
|
|
|
|
|
|
//@description Contains a list of hashtags @hashtags A list of hashtags
|
|
hashtags hashtags:vector<string> = Hashtags;
|
|
|
|
|
|
//@class CanTransferOwnershipResult @description Represents result of checking whether the current session can be used to transfer a chat ownership to another user
|
|
|
|
//@description The session can be used
|
|
canTransferOwnershipResultOk = CanTransferOwnershipResult;
|
|
|
|
//@description The 2-step verification needs to be enabled first
|
|
canTransferOwnershipResultPasswordNeeded = CanTransferOwnershipResult;
|
|
|
|
//@description The 2-step verification was enabled recently, user needs to wait @retry_after Time left before the session can be used to transfer ownership of a chat, in seconds
|
|
canTransferOwnershipResultPasswordTooFresh retry_after:int32 = CanTransferOwnershipResult;
|
|
|
|
//@description The session was created recently, user needs to wait @retry_after Time left before the session can be used to transfer ownership of a chat, in seconds
|
|
canTransferOwnershipResultSessionTooFresh retry_after:int32 = CanTransferOwnershipResult;
|
|
|
|
|
|
//@class CheckChatUsernameResult @description Represents result of checking whether a username can be set for a chat
|
|
|
|
//@description The username can be set
|
|
checkChatUsernameResultOk = CheckChatUsernameResult;
|
|
|
|
//@description The username is invalid
|
|
checkChatUsernameResultUsernameInvalid = CheckChatUsernameResult;
|
|
|
|
//@description The username is occupied
|
|
checkChatUsernameResultUsernameOccupied = CheckChatUsernameResult;
|
|
|
|
//@description The user has too much chats with username, one of them should be made private first
|
|
checkChatUsernameResultPublicChatsTooMuch = CheckChatUsernameResult;
|
|
|
|
//@description The user can't be a member of a public supergroup
|
|
checkChatUsernameResultPublicGroupsUnavailable = CheckChatUsernameResult;
|
|
|
|
|
|
//@class MessageFileType @description Contains information about a file with messages exported from another app
|
|
|
|
//@description The messages was exported from a private chat @name Name of the other party; may be empty if unrecognized
|
|
messageFileTypePrivate name:string = MessageFileType;
|
|
|
|
//@description The messages was exported from a group chat @title Title of the group chat; may be empty if unrecognized
|
|
messageFileTypeGroup title:string = MessageFileType;
|
|
|
|
//@description The messages was exported from a chat of unknown type
|
|
messageFileTypeUnknown = MessageFileType;
|
|
|
|
|
|
//@class PushMessageContent @description Contains content of a push message notification
|
|
|
|
//@description A general message with hidden content @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentHidden is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description An animation message (GIF-style). @animation Message content; may be null @caption Animation caption @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentAnimation animation:animation caption:string is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description An audio message @audio Message content; may be null @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentAudio audio:audio is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A message with a user contact @name Contact's name @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentContact name:string is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A contact has registered with Telegram
|
|
pushMessageContentContactRegistered = PushMessageContent;
|
|
|
|
//@description A document message (a general file) @document Message content; may be null @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentDocument document:document is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A message with a game @title Game title, empty for pinned game message @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentGame title:string is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A new high score was achieved in a game @title Game title, empty for pinned message @score New score, 0 for pinned message @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentGameScore title:string score:int32 is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A message with an invoice from a bot @price Product price @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentInvoice price:string is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A message with a location @is_live True, if the location is live @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentLocation is_live:Bool is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A photo message @photo Message content; may be null @caption Photo caption @is_secret True, if the photo is secret @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentPhoto photo:photo caption:string is_secret:Bool is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A message with a poll @question Poll question @is_regular True, if the poll is regular and not in quiz mode @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentPoll question:string is_regular:Bool is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A screenshot of a message in the chat has been taken
|
|
pushMessageContentScreenshotTaken = PushMessageContent;
|
|
|
|
//@description A message with a sticker @sticker Message content; may be null @emoji Emoji corresponding to the sticker; may be empty @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentSticker sticker:sticker emoji:string is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A text message @text Message text @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentText text:string is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A video message @video Message content; may be null @caption Video caption @is_secret True, if the video is secret @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentVideo video:video caption:string is_secret:Bool is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A video note message @video_note Message content; may be null @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentVideoNote video_note:videoNote is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A voice note message @voice_note Message content; may be null @is_pinned True, if the message is a pinned message with the specified content
|
|
pushMessageContentVoiceNote voice_note:voiceNote is_pinned:Bool = PushMessageContent;
|
|
|
|
//@description A newly created basic group
|
|
pushMessageContentBasicGroupChatCreate = PushMessageContent;
|
|
|
|
//@description New chat members were invited to a group @member_name Name of the added member @is_current_user True, if the current user was added to the group
|
|
//@is_returned True, if the user has returned to the group themself
|
|
pushMessageContentChatAddMembers member_name:string is_current_user:Bool is_returned:Bool = PushMessageContent;
|
|
|
|
//@description A chat photo was edited
|
|
pushMessageContentChatChangePhoto = PushMessageContent;
|
|
|
|
//@description A chat title was edited @title New chat title
|
|
pushMessageContentChatChangeTitle title:string = PushMessageContent;
|
|
|
|
//@description A chat member was deleted @member_name Name of the deleted member @is_current_user True, if the current user was deleted from the group
|
|
//@is_left True, if the user has left the group themself
|
|
pushMessageContentChatDeleteMember member_name:string is_current_user:Bool is_left:Bool = PushMessageContent;
|
|
|
|
//@description A new member joined the chat by invite link
|
|
pushMessageContentChatJoinByLink = PushMessageContent;
|
|
|
|
//@description A forwarded messages @total_count Number of forwarded messages
|
|
pushMessageContentMessageForwards total_count:int32 = PushMessageContent;
|
|
|
|
//@description A media album @total_count Number of messages in the album @has_photos True, if the album has at least one photo @has_videos True, if the album has at least one video
|
|
//@has_audios True, if the album has at least one audio file @has_documents True, if the album has at least one document
|
|
pushMessageContentMediaAlbum total_count:int32 has_photos:Bool has_videos:Bool has_audios:Bool has_documents:Bool = PushMessageContent;
|
|
|
|
|
|
//@class NotificationType @description Contains detailed information about a notification
|
|
|
|
//@description New message was received @message The message
|
|
notificationTypeNewMessage message:message = NotificationType;
|
|
|
|
//@description New secret chat was created
|
|
notificationTypeNewSecretChat = NotificationType;
|
|
|
|
//@description New call was received @call_id Call identifier
|
|
notificationTypeNewCall call_id:int32 = NotificationType;
|
|
|
|
//@description New message was received through a push notification
|
|
//@message_id 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
|
|
//@sender The sender of the message. Corresponding user or chat may be inaccessible
|
|
//@sender_name Name of the sender
|
|
//@is_outgoing True, if the message is outgoing
|
|
//@content Push message content
|
|
notificationTypeNewPushMessage message_id:int53 sender:MessageSender sender_name:string is_outgoing:Bool content:PushMessageContent = NotificationType;
|
|
|
|
|
|
//@class NotificationGroupType @description Describes the type of notifications in a notification group
|
|
|
|
//@description A group containing notifications of type notificationTypeNewMessage and notificationTypeNewPushMessage with ordinary unread messages
|
|
notificationGroupTypeMessages = NotificationGroupType;
|
|
|
|
//@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
|
|
notificationGroupTypeMentions = NotificationGroupType;
|
|
|
|
//@description A group containing a notification of type notificationTypeNewSecretChat
|
|
notificationGroupTypeSecretChat = NotificationGroupType;
|
|
|
|
//@description A group containing notifications of type notificationTypeNewCall
|
|
notificationGroupTypeCalls = NotificationGroupType;
|
|
|
|
|
|
//@description Contains information about a notification @id Unique persistent identifier of this notification @date Notification date
|
|
//@is_silent True, if the notification was initially silent @type Notification type
|
|
notification id:int32 date:int32 is_silent:Bool type:NotificationType = Notification;
|
|
|
|
//@description Describes a group of notifications @id Unique persistent auto-incremented from 1 identifier of the notification group @type Type of the group
|
|
//@chat_id Identifier of a chat to which all notifications in the group belong
|
|
//@total_count Total number of active notifications in the group @notifications The list of active notifications
|
|
notificationGroup id:int32 type:NotificationGroupType chat_id:int53 total_count:int32 notifications:vector<notification> = NotificationGroup;
|
|
|
|
|
|
//@class OptionValue @description Represents the value of an option
|
|
|
|
//@description Represents a boolean option @value The value of the option
|
|
optionValueBoolean value:Bool = OptionValue;
|
|
|
|
//@description Represents an unknown option or an option which has a default value
|
|
optionValueEmpty = OptionValue;
|
|
|
|
//@description Represents an integer option @value The value of the option
|
|
optionValueInteger value:int64 = OptionValue;
|
|
|
|
//@description Represents a string option @value The value of the option
|
|
optionValueString value:string = OptionValue;
|
|
|
|
|
|
//@description Represents one member of a JSON object @key Member's key @value Member's value
|
|
jsonObjectMember key:string value:JsonValue = JsonObjectMember;
|
|
|
|
//@class JsonValue @description Represents a JSON value
|
|
|
|
//@description Represents a null JSON value
|
|
jsonValueNull = JsonValue;
|
|
|
|
//@description Represents a boolean JSON value @value The value
|
|
jsonValueBoolean value:Bool = JsonValue;
|
|
|
|
//@description Represents a numeric JSON value @value The value
|
|
jsonValueNumber value:double = JsonValue;
|
|
|
|
//@description Represents a string JSON value @value The value
|
|
jsonValueString value:string = JsonValue;
|
|
|
|
//@description Represents a JSON array @values The list of array elements
|
|
jsonValueArray values:vector<JsonValue> = JsonValue;
|
|
|
|
//@description Represents a JSON object @members The list of object members
|
|
jsonValueObject members:vector<jsonObjectMember> = JsonValue;
|
|
|
|
|
|
//@class UserPrivacySettingRule @description Represents a single rule for managing privacy settings
|
|
|
|
//@description A rule to allow all users to do something
|
|
userPrivacySettingRuleAllowAll = UserPrivacySettingRule;
|
|
|
|
//@description A rule to allow all of a user's contacts to do something
|
|
userPrivacySettingRuleAllowContacts = UserPrivacySettingRule;
|
|
|
|
//@description A rule to allow certain specified users to do something @user_ids The user identifiers, total number of users in all rules must not exceed 1000
|
|
userPrivacySettingRuleAllowUsers user_ids:vector<int32> = UserPrivacySettingRule;
|
|
|
|
//@description A rule to allow all members of certain specified basic groups and supergroups to doing something @chat_ids The chat identifiers, total number of chats in all rules must not exceed 20
|
|
userPrivacySettingRuleAllowChatMembers chat_ids:vector<int53> = UserPrivacySettingRule;
|
|
|
|
//@description A rule to restrict all users from doing something
|
|
userPrivacySettingRuleRestrictAll = UserPrivacySettingRule;
|
|
|
|
//@description A rule to restrict all contacts of a user from doing something
|
|
userPrivacySettingRuleRestrictContacts = UserPrivacySettingRule;
|
|
|
|
//@description A rule to restrict all specified users from doing something @user_ids The user identifiers, total number of users in all rules must not exceed 1000
|
|
userPrivacySettingRuleRestrictUsers user_ids:vector<int32> = UserPrivacySettingRule;
|
|
|
|
//@description A rule to restrict all members of specified basic groups and supergroups from doing something @chat_ids The chat identifiers, total number of chats in all rules must not exceed 20
|
|
userPrivacySettingRuleRestrictChatMembers chat_ids:vector<int53> = UserPrivacySettingRule;
|
|
|
|
//@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 @rules A list of rules
|
|
userPrivacySettingRules rules:vector<UserPrivacySettingRule> = UserPrivacySettingRules;
|
|
|
|
//@class UserPrivacySetting @description Describes available user privacy settings
|
|
|
|
//@description A privacy setting for managing whether the user's online status is visible
|
|
userPrivacySettingShowStatus = UserPrivacySetting;
|
|
|
|
//@description A privacy setting for managing whether the user's profile photo is visible
|
|
userPrivacySettingShowProfilePhoto = UserPrivacySetting;
|
|
|
|
//@description A privacy setting for managing whether a link to the user's account is included in forwarded messages
|
|
userPrivacySettingShowLinkInForwardedMessages = UserPrivacySetting;
|
|
|
|
//@description A privacy setting for managing whether the user's phone number is visible
|
|
userPrivacySettingShowPhoneNumber = UserPrivacySetting;
|
|
|
|
//@description A privacy setting for managing whether the user can be invited to chats
|
|
userPrivacySettingAllowChatInvites = UserPrivacySetting;
|
|
|
|
//@description A privacy setting for managing whether the user can be called
|
|
userPrivacySettingAllowCalls = UserPrivacySetting;
|
|
|
|
//@description A privacy setting for managing whether peer-to-peer connections can be used for calls
|
|
userPrivacySettingAllowPeerToPeerCalls = UserPrivacySetting;
|
|
|
|
//@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"
|
|
userPrivacySettingAllowFindingByPhoneNumber = UserPrivacySetting;
|
|
|
|
|
|
//@description Contains information about the period of inactivity after which the current user's account will automatically be deleted @days Number of days of inactivity before the account will be flagged for deletion; should range from 30-366 days
|
|
accountTtl days:int32 = AccountTtl;
|
|
|
|
|
|
//@description Contains information about one session in a Telegram application used by the current user. Sessions should be shown to the user in the returned order
|
|
//@id Session identifier @is_current True, if this session is the current session
|
|
//@is_password_pending True, if a password is needed to complete authorization of the session
|
|
//@api_id Telegram API identifier, as provided by the application @application_name Name of the application, as provided by the application
|
|
//@application_version The version of the application, as provided by the application @is_official_application True, if the application is an official application or uses the api_id of an official application
|
|
//@device_model Model of the device the application has been run or is running on, as provided by the application @platform Operating system the application has been run or is running on, as provided by the application
|
|
//@system_version Version of the operating system the application has been run or is running on, as provided by the application @log_in_date Point in time (Unix timestamp) when the user has logged in
|
|
//@last_active_date Point in time (Unix timestamp) when the session was last used @ip IP address from which the session was created, in human-readable format
|
|
//@country A two-letter country code for the country from which the session was created, based on the IP address @region Region code from which the session was created, based on the IP address
|
|
session id:int64 is_current:Bool is_password_pending:Bool api_id:int32 application_name:string application_version:string is_official_application:Bool device_model:string platform:string system_version:string log_in_date:int32 last_active_date:int32 ip:string country:string region:string = Session;
|
|
|
|
//@description Contains a list of sessions @sessions List of sessions
|
|
sessions sessions:vector<session> = Sessions;
|
|
|
|
|
|
//@description Contains information about one website the current user is logged in with Telegram
|
|
//@id Website identifier
|
|
//@domain_name The domain name of the website
|
|
//@bot_user_id User identifier of a bot linked with the website
|
|
//@browser The version of a browser used to log in
|
|
//@platform Operating system the browser is running on
|
|
//@log_in_date Point in time (Unix timestamp) when the user was logged in
|
|
//@last_active_date Point in time (Unix timestamp) when obtained authorization was last used
|
|
//@ip IP address from which the user was logged in, in human-readable format
|
|
//@location Human-readable description of a country and a region, from which the user was logged in, based on the IP address
|
|
connectedWebsite id:int64 domain_name:string bot_user_id:int32 browser:string platform:string log_in_date:int32 last_active_date:int32 ip:string location:string = ConnectedWebsite;
|
|
|
|
//@description Contains a list of websites the current user is logged in with Telegram @websites List of connected websites
|
|
connectedWebsites websites:vector<connectedWebsite> = ConnectedWebsites;
|
|
|
|
|
|
//@class ChatReportReason @description Describes the reason why a chat is reported
|
|
|
|
//@description The chat contains spam messages
|
|
chatReportReasonSpam = ChatReportReason;
|
|
|
|
//@description The chat promotes violence
|
|
chatReportReasonViolence = ChatReportReason;
|
|
|
|
//@description The chat contains pornographic messages
|
|
chatReportReasonPornography = ChatReportReason;
|
|
|
|
//@description The chat has child abuse related content
|
|
chatReportReasonChildAbuse = ChatReportReason;
|
|
|
|
//@description The chat contains copyrighted content
|
|
chatReportReasonCopyright = ChatReportReason;
|
|
|
|
//@description The location-based chat is unrelated to its stated location
|
|
chatReportReasonUnrelatedLocation = ChatReportReason;
|
|
|
|
//@description The chat represents a fake account
|
|
chatReportReasonFake = ChatReportReason;
|
|
|
|
//@description A custom reason provided by the user
|
|
chatReportReasonCustom = ChatReportReason;
|
|
|
|
|
|
//@description Contains an HTTPS link to a message in a supergroup or channel @link Message link @is_public True, if the link will work for non-members of the chat
|
|
messageLink link:string is_public:Bool = MessageLink;
|
|
|
|
//@description Contains information about a link to a message in a chat
|
|
//@is_public True, if the link is a public link for a message in a chat
|
|
//@chat_id If found, identifier of the chat to which the message belongs, 0 otherwise
|
|
//@message If found, the linked message; may be null
|
|
//@for_album True, if the whole media album to which the message belongs is linked
|
|
//@for_comment True, if the message is linked as a channel post comment or from a message thread
|
|
messageLinkInfo is_public:Bool chat_id:int53 message:message for_album:Bool for_comment:Bool = MessageLinkInfo;
|
|
|
|
|
|
//@description Contains a part of a file @data File bytes
|
|
filePart data:bytes = FilePart;
|
|
|
|
|
|
//@class FileType @description Represents the type of a file
|
|
|
|
//@description The data is not a file
|
|
fileTypeNone = FileType;
|
|
|
|
//@description The file is an animation
|
|
fileTypeAnimation = FileType;
|
|
|
|
//@description The file is an audio file
|
|
fileTypeAudio = FileType;
|
|
|
|
//@description The file is a document
|
|
fileTypeDocument = FileType;
|
|
|
|
//@description The file is a photo
|
|
fileTypePhoto = FileType;
|
|
|
|
//@description The file is a profile photo
|
|
fileTypeProfilePhoto = FileType;
|
|
|
|
//@description The file was sent to a secret chat (the file type is not known to the server)
|
|
fileTypeSecret = FileType;
|
|
|
|
//@description The file is a thumbnail of a file from a secret chat
|
|
fileTypeSecretThumbnail = FileType;
|
|
|
|
//@description The file is a file from Secure storage used for storing Telegram Passport files
|
|
fileTypeSecure = FileType;
|
|
|
|
//@description The file is a sticker
|
|
fileTypeSticker = FileType;
|
|
|
|
//@description The file is a thumbnail of another file
|
|
fileTypeThumbnail = FileType;
|
|
|
|
//@description The file type is not yet known
|
|
fileTypeUnknown = FileType;
|
|
|
|
//@description The file is a video
|
|
fileTypeVideo = FileType;
|
|
|
|
//@description The file is a video note
|
|
fileTypeVideoNote = FileType;
|
|
|
|
//@description The file is a voice note
|
|
fileTypeVoiceNote = FileType;
|
|
|
|
//@description The file is a wallpaper or a background pattern
|
|
fileTypeWallpaper = FileType;
|
|
|
|
|
|
//@description Contains the storage usage statistics for a specific file type @file_type File type @size Total size of the files @count Total number of files
|
|
storageStatisticsByFileType file_type:FileType size:int53 count:int32 = StorageStatisticsByFileType;
|
|
|
|
//@description Contains the storage usage statistics for a specific chat @chat_id Chat identifier; 0 if none @size Total size of the files in the chat @count Total number of files in the chat @by_file_type Statistics split by file types
|
|
storageStatisticsByChat chat_id:int53 size:int53 count:int32 by_file_type:vector<storageStatisticsByFileType> = StorageStatisticsByChat;
|
|
|
|
//@description Contains the exact storage usage statistics split by chats and file type @size Total size of files @count Total number of files @by_chat Statistics split by chats
|
|
storageStatistics size:int53 count:int32 by_chat:vector<storageStatisticsByChat> = StorageStatistics;
|
|
|
|
//@description Contains approximate storage usage statistics, excluding files of unknown file type @files_size Approximate total size of files @file_count Approximate number of files
|
|
//@database_size Size of the database @language_pack_database_size Size of the language pack database @log_size Size of the TDLib internal log
|
|
storageStatisticsFast files_size:int53 file_count:int32 database_size:int53 language_pack_database_size:int53 log_size:int53 = StorageStatisticsFast;
|
|
|
|
//@description Contains database statistics
|
|
//@statistics Database statistics in an unspecified human-readable format
|
|
databaseStatistics statistics:string = DatabaseStatistics;
|
|
|
|
|
|
//@class NetworkType @description Represents the type of a network
|
|
|
|
//@description The network is not available
|
|
networkTypeNone = NetworkType;
|
|
|
|
//@description A mobile network
|
|
networkTypeMobile = NetworkType;
|
|
|
|
//@description A mobile roaming network
|
|
networkTypeMobileRoaming = NetworkType;
|
|
|
|
//@description A Wi-Fi network
|
|
networkTypeWiFi = NetworkType;
|
|
|
|
//@description A different network type (e.g., Ethernet network)
|
|
networkTypeOther = NetworkType;
|
|
|
|
|
|
//@class NetworkStatisticsEntry @description Contains statistics about network usage
|
|
|
|
//@description Contains information about the total amount of data that was used to send and receive files @file_type Type of the file the data is part of @network_type Type of the network the data was sent through. Call setNetworkType to maintain the actual network type
|
|
//@sent_bytes Total number of bytes sent @received_bytes Total number of bytes received
|
|
networkStatisticsEntryFile file_type:FileType network_type:NetworkType sent_bytes:int53 received_bytes:int53 = NetworkStatisticsEntry;
|
|
|
|
//@description Contains information about the total amount of data that was used for calls @network_type Type of the network the data was sent through. Call setNetworkType to maintain the actual network type
|
|
//@sent_bytes Total number of bytes sent @received_bytes Total number of bytes received @duration Total call duration, in seconds
|
|
networkStatisticsEntryCall network_type:NetworkType sent_bytes:int53 received_bytes:int53 duration:double = NetworkStatisticsEntry;
|
|
|
|
//@description A full list of available network statistic entries @since_date Point in time (Unix timestamp) from which the statistics are collected @entries Network statistics entries
|
|
networkStatistics since_date:int32 entries:vector<NetworkStatisticsEntry> = NetworkStatistics;
|
|
|
|
|
|
//@description Contains auto-download settings
|
|
//@is_auto_download_enabled True, if the auto-download is enabled
|
|
//@max_photo_file_size The maximum size of a photo file to be auto-downloaded
|
|
//@max_video_file_size The maximum size of a video file to be auto-downloaded
|
|
//@max_other_file_size The maximum size of other file types to be auto-downloaded
|
|
//@video_upload_bitrate The maximum suggested bitrate for uploaded videos
|
|
//@preload_large_videos True, if the beginning of video files needs to be preloaded for instant playback
|
|
//@preload_next_audio True, if the next audio track needs to be preloaded while the user is listening to an audio file
|
|
//@use_less_data_for_calls True, if "use less data for calls" option needs to be enabled
|
|
autoDownloadSettings is_auto_download_enabled:Bool max_photo_file_size:int32 max_video_file_size:int32 max_other_file_size:int32 video_upload_bitrate:int32 preload_large_videos:Bool preload_next_audio:Bool use_less_data_for_calls:Bool = AutoDownloadSettings;
|
|
|
|
//@description Contains auto-download settings presets for the user
|
|
//@low Preset with lowest settings; supposed to be used by default when roaming
|
|
//@medium Preset with medium settings; supposed to be used by default when using mobile data
|
|
//@high Preset with highest settings; supposed to be used by default when connected on Wi-Fi
|
|
autoDownloadSettingsPresets low:autoDownloadSettings medium:autoDownloadSettings high:autoDownloadSettings = AutoDownloadSettingsPresets;
|
|
|
|
|
|
//@class ConnectionState @description Describes the current state of the connection to Telegram servers
|
|
|
|
//@description Currently waiting for the network to become available. Use setNetworkType to change the available network type
|
|
connectionStateWaitingForNetwork = ConnectionState;
|
|
|
|
//@description Currently establishing a connection with a proxy server
|
|
connectionStateConnectingToProxy = ConnectionState;
|
|
|
|
//@description Currently establishing a connection to the Telegram servers
|
|
connectionStateConnecting = ConnectionState;
|
|
|
|
//@description Downloading data received while the application was offline
|
|
connectionStateUpdating = ConnectionState;
|
|
|
|
//@description There is a working connection to the Telegram servers
|
|
connectionStateReady = ConnectionState;
|
|
|
|
|
|
//@class TopChatCategory @description Represents the categories of chats for which a list of frequently used chats can be retrieved
|
|
|
|
//@description A category containing frequently used private chats with non-bot users
|
|
topChatCategoryUsers = TopChatCategory;
|
|
|
|
//@description A category containing frequently used private chats with bot users
|
|
topChatCategoryBots = TopChatCategory;
|
|
|
|
//@description A category containing frequently used basic groups and supergroups
|
|
topChatCategoryGroups = TopChatCategory;
|
|
|
|
//@description A category containing frequently used channels
|
|
topChatCategoryChannels = TopChatCategory;
|
|
|
|
//@description A category containing frequently used chats with inline bots sorted by their usage in inline mode
|
|
topChatCategoryInlineBots = TopChatCategory;
|
|
|
|
//@description A category containing frequently used chats used for calls
|
|
topChatCategoryCalls = TopChatCategory;
|
|
|
|
//@description A category containing frequently used chats used to forward messages
|
|
topChatCategoryForwardChats = TopChatCategory;
|
|
|
|
|
|
//@class TMeUrlType @description Describes the type of a URL linking to an internal Telegram entity
|
|
|
|
//@description A URL linking to a user @user_id Identifier of the user
|
|
tMeUrlTypeUser user_id:int32 = TMeUrlType;
|
|
|
|
//@description A URL linking to a public supergroup or channel @supergroup_id Identifier of the supergroup or channel
|
|
tMeUrlTypeSupergroup supergroup_id:int53 = TMeUrlType;
|
|
|
|
//@description A chat invite link @info Chat invite link info
|
|
tMeUrlTypeChatInvite info:chatInviteLinkInfo = TMeUrlType;
|
|
|
|
//@description A URL linking to a sticker set @sticker_set_id Identifier of the sticker set
|
|
tMeUrlTypeStickerSet sticker_set_id:int64 = TMeUrlType;
|
|
|
|
//@description Represents a URL linking to an internal Telegram entity @url URL @type Type of the URL
|
|
tMeUrl url:string type:TMeUrlType = TMeUrl;
|
|
|
|
//@description Contains a list of t.me URLs @urls List of URLs
|
|
tMeUrls urls:vector<tMeUrl> = TMeUrls;
|
|
|
|
|
|
//@class SuggestedAction @description Describes an action suggested to the current user
|
|
|
|
//@description Suggests the user to enable "archive_and_mute_new_chats_from_unknown_users" option
|
|
suggestedActionEnableArchiveAndMuteNewChats = SuggestedAction;
|
|
|
|
//@description Suggests the user to check authorization phone number and change the phone number if it is inaccessible
|
|
suggestedActionCheckPhoneNumber = SuggestedAction;
|
|
|
|
//@description Suggests the user to see a hint about meaning of one and two ticks on sent message
|
|
suggestedActionSeeTicksHint = SuggestedAction;
|
|
|
|
//@description Suggests the user to convert specified supergroup to a broadcast group @supergroup_id Supergroup identifier
|
|
suggestedActionConvertToBroadcastGroup supergroup_id:int32 = SuggestedAction;
|
|
|
|
|
|
//@description Contains a counter @count Count
|
|
count count:int32 = Count;
|
|
|
|
//@description Contains some text @text Text
|
|
text text:string = Text;
|
|
|
|
//@description Contains a value representing a number of seconds @seconds Number of seconds
|
|
seconds seconds:double = Seconds;
|
|
|
|
|
|
//@description Contains information about a tg:// deep link @text Text to be shown to the user @need_update_application True, if user should be asked to update the application
|
|
deepLinkInfo text:formattedText need_update_application:Bool = DeepLinkInfo;
|
|
|
|
|
|
//@class TextParseMode @description Describes the way the text should be parsed for TextEntities
|
|
|
|
//@description The text uses Markdown-style formatting
|
|
//@version Version of the parser: 0 or 1 - Telegram Bot API "Markdown" parse mode, 2 - Telegram Bot API "MarkdownV2" parse mode
|
|
textParseModeMarkdown version:int32 = TextParseMode;
|
|
|
|
//@description The text uses HTML-style formatting. The same as Telegram Bot API "HTML" parse mode
|
|
textParseModeHTML = TextParseMode;
|
|
|
|
|
|
//@class ProxyType @description Describes the type of a proxy server
|
|
|
|
//@description A SOCKS5 proxy server @username Username for logging in; may be empty @password Password for logging in; may be empty
|
|
proxyTypeSocks5 username:string password:string = ProxyType;
|
|
|
|
//@description A HTTP transparent proxy server @username Username for logging in; may be empty @password Password for logging in; may be empty @http_only Pass true if the proxy supports only HTTP requests and doesn't support transparent TCP connections via HTTP CONNECT method
|
|
proxyTypeHttp username:string password:string http_only:Bool = ProxyType;
|
|
|
|
//@description An MTProto proxy server @secret The proxy's secret in hexadecimal encoding
|
|
proxyTypeMtproto secret:string = ProxyType;
|
|
|
|
|
|
//@description Contains information about a proxy server @id Unique identifier of the proxy @server Proxy server IP address @port Proxy server port @last_used_date Point in time (Unix timestamp) when the proxy was last used; 0 if never @is_enabled True, if the proxy is enabled now @type Type of the proxy
|
|
proxy id:int32 server:string port:int32 last_used_date:int32 is_enabled:Bool type:ProxyType = Proxy;
|
|
|
|
//@description Represents a list of proxy servers @proxies List of proxy servers
|
|
proxies proxies:vector<proxy> = Proxies;
|
|
|
|
|
|
//@class InputSticker @description Describes a sticker that needs to be added to a sticker set
|
|
|
|
//@description A static sticker in PNG format, which will be converted to WEBP server-side
|
|
//@sticker PNG image with the sticker; must be up to 512 KB in size and fit in a 512x512 square
|
|
//@emojis Emojis corresponding to the sticker
|
|
//@mask_position For masks, position where the mask should be placed; may be null
|
|
inputStickerStatic sticker:InputFile emojis:string mask_position:maskPosition = InputSticker;
|
|
|
|
//@description An animated sticker in TGS format
|
|
//@sticker 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
|
|
//@emojis Emojis corresponding to the sticker
|
|
inputStickerAnimated sticker:InputFile emojis:string = InputSticker;
|
|
|
|
|
|
//@description Represents a date range @start_date Point in time (Unix timestamp) at which the date range begins @end_date Point in time (Unix timestamp) at which the date range ends
|
|
dateRange start_date:int32 end_date:int32 = DateRange;
|
|
|
|
|
|
//@description A value with information about its recent changes @value The current value @previous_value The value for the previous day @growth_rate_percentage The growth rate of the value, as a percentage
|
|
statisticalValue value:double previous_value:double growth_rate_percentage:double = StatisticalValue;
|
|
|
|
|
|
//@class StatisticalGraph @description Describes a statistical graph
|
|
|
|
//@description A graph data @json_data Graph data in JSON format @zoom_token If non-empty, a token which can be used to receive a zoomed in graph
|
|
statisticalGraphData json_data:string zoom_token:string = StatisticalGraph;
|
|
|
|
//@description The graph data to be asynchronously loaded through getStatisticalGraph @token The token to use for data loading
|
|
statisticalGraphAsync token:string = StatisticalGraph;
|
|
|
|
//@description An error message to be shown to the user instead of the graph @error_message The error message
|
|
statisticalGraphError error_message:string = StatisticalGraph;
|
|
|
|
|
|
//@description Contains statistics about interactions with a message
|
|
//@message_id Message identifier
|
|
//@view_count Number of times the message was viewed
|
|
//@forward_count Number of times the message was forwarded
|
|
chatStatisticsMessageInteractionInfo message_id:int53 view_count:int32 forward_count:int32 = ChatStatisticsMessageInteractionInfo;
|
|
|
|
//@description Contains statistics about messages sent by a user
|
|
//@user_id User identifier
|
|
//@sent_message_count Number of sent messages
|
|
//@average_character_count Average number of characters in sent messages
|
|
chatStatisticsMessageSenderInfo user_id:int32 sent_message_count:int32 average_character_count:int32 = ChatStatisticsMessageSenderInfo;
|
|
|
|
//@description Contains statistics about administrator actions done by a user
|
|
//@user_id Administrator user identifier
|
|
//@deleted_message_count Number of messages deleted by the administrator
|
|
//@banned_user_count Number of users banned by the administrator
|
|
//@restricted_user_count Number of users restricted by the administrator
|
|
chatStatisticsAdministratorActionsInfo user_id:int32 deleted_message_count:int32 banned_user_count:int32 restricted_user_count:int32 = ChatStatisticsAdministratorActionsInfo;
|
|
|
|
//@description Contains statistics about number of new members invited by a user
|
|
//@user_id User identifier
|
|
//@added_member_count Number of new members invited by the user
|
|
chatStatisticsInviterInfo user_id:int32 added_member_count:int32 = ChatStatisticsInviterInfo;
|
|
|
|
|
|
//@class ChatStatistics @description Contains a detailed statistics about a chat
|
|
|
|
//@description A detailed statistics about a supergroup chat
|
|
//@period A period to which the statistics applies
|
|
//@member_count Number of members in the chat
|
|
//@message_count Number of messages sent to the chat
|
|
//@viewer_count Number of users who viewed messages in the chat
|
|
//@sender_count Number of users who sent messages to the chat
|
|
//@member_count_graph A graph containing number of members in the chat
|
|
//@join_graph A graph containing number of members joined and left the chat
|
|
//@join_by_source_graph A graph containing number of new member joins per source
|
|
//@language_graph A graph containing distribution of active users per language
|
|
//@message_content_graph A graph containing distribution of sent messages by content type
|
|
//@action_graph A graph containing number of different actions in the chat
|
|
//@day_graph A graph containing distribution of message views per hour
|
|
//@week_graph A graph containing distribution of message views per day of week
|
|
//@top_senders List of users sent most messages in the last week
|
|
//@top_administrators List of most active administrators in the last week
|
|
//@top_inviters List of most active inviters of new members in the last week
|
|
chatStatisticsSupergroup period:dateRange member_count:statisticalValue message_count:statisticalValue viewer_count:statisticalValue sender_count:statisticalValue member_count_graph:StatisticalGraph join_graph:StatisticalGraph join_by_source_graph:StatisticalGraph language_graph:StatisticalGraph message_content_graph:StatisticalGraph action_graph:StatisticalGraph day_graph:StatisticalGraph week_graph:StatisticalGraph top_senders:vector<chatStatisticsMessageSenderInfo> top_administrators:vector<chatStatisticsAdministratorActionsInfo> top_inviters:vector<chatStatisticsInviterInfo> = ChatStatistics;
|
|
|
|
//@description A detailed statistics about a channel chat
|
|
//@period A period to which the statistics applies
|
|
//@member_count Number of members in the chat
|
|
//@mean_view_count Mean number of times the recently sent messages was viewed
|
|
//@mean_share_count Mean number of times the recently sent messages was shared
|
|
//@enabled_notifications_percentage A percentage of users with enabled notifications for the chat
|
|
//@member_count_graph A graph containing number of members in the chat
|
|
//@join_graph A graph containing number of members joined and left the chat
|
|
//@mute_graph A graph containing number of members muted and unmuted the chat
|
|
//@view_count_by_hour_graph A graph containing number of message views in a given hour in the last two weeks
|
|
//@view_count_by_source_graph A graph containing number of message views per source
|
|
//@join_by_source_graph A graph containing number of new member joins per source
|
|
//@language_graph A graph containing number of users viewed chat messages per language
|
|
//@message_interaction_graph A graph containing number of chat message views and shares
|
|
//@instant_view_interaction_graph A graph containing number of views of associated with the chat instant views
|
|
//@recent_message_interactions Detailed statistics about number of views and shares of recently sent messages
|
|
chatStatisticsChannel period:dateRange member_count:statisticalValue mean_view_count:statisticalValue mean_share_count:statisticalValue enabled_notifications_percentage:double member_count_graph:StatisticalGraph join_graph:StatisticalGraph mute_graph:StatisticalGraph view_count_by_hour_graph:StatisticalGraph view_count_by_source_graph:StatisticalGraph join_by_source_graph:StatisticalGraph language_graph:StatisticalGraph message_interaction_graph:StatisticalGraph instant_view_interaction_graph:StatisticalGraph recent_message_interactions:vector<chatStatisticsMessageInteractionInfo> = ChatStatistics;
|
|
|
|
|
|
//@description A detailed statistics about a message @message_interaction_graph A graph containing number of message views and shares
|
|
messageStatistics message_interaction_graph:StatisticalGraph = MessageStatistics;
|
|
|
|
|
|
//@description A point on a Cartesian plane @x The point's first coordinate @y The point's second coordinate
|
|
point x:double y:double = Point;
|
|
|
|
|
|
//@class VectorPathCommand @description Represents a vector path command
|
|
|
|
//@description A straight line to a given point @end_point The end point of the straight line
|
|
vectorPathCommandLine end_point:point = VectorPathCommand;
|
|
|
|
//@description A cubic Bézier curve to a given point @start_control_point The start control point of the curve @end_control_point The end control point of the curve @end_point The end point of the curve
|
|
vectorPathCommandCubicBezierCurve start_control_point:point end_control_point:point end_point:point = VectorPathCommand;
|
|
|
|
|
|
//@class Update @description Contains notifications about data changes
|
|
|
|
//@description The user authorization state has changed @authorization_state New authorization state
|
|
updateAuthorizationState authorization_state:AuthorizationState = Update;
|
|
|
|
//@description A new message was received; can also be an outgoing message @message The new message
|
|
updateNewMessage message:message = Update;
|
|
|
|
//@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
|
|
//@chat_id The chat identifier of the sent message @message_id A temporary message identifier
|
|
updateMessageSendAcknowledged chat_id:int53 message_id:int53 = Update;
|
|
|
|
//@description A message has been successfully sent @message Information about the sent message. Usually only the message identifier, date, and content are changed, but almost all other fields can also change @old_message_id The previous temporary message identifier
|
|
updateMessageSendSucceeded message:message old_message_id:int53 = Update;
|
|
|
|
//@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
|
|
//@message Contains information about the message which failed to send @old_message_id The previous temporary message identifier @error_code An error code @error_message Error message
|
|
updateMessageSendFailed message:message old_message_id:int53 error_code:int32 error_message:string = Update;
|
|
|
|
//@description The message content has changed @chat_id Chat identifier @message_id Message identifier @new_content New message content
|
|
updateMessageContent chat_id:int53 message_id:int53 new_content:MessageContent = Update;
|
|
|
|
//@description A message was edited. Changes in the message content will come in a separate updateMessageContent @chat_id Chat identifier @message_id Message identifier @edit_date Point in time (Unix timestamp) when the message was edited @reply_markup New message reply markup; may be null
|
|
updateMessageEdited chat_id:int53 message_id:int53 edit_date:int32 reply_markup:ReplyMarkup = Update;
|
|
|
|
//@description The message pinned state was changed @chat_id Chat identifier @message_id The message identifier @is_pinned True, if the message is pinned
|
|
updateMessageIsPinned chat_id:int53 message_id:int53 is_pinned:Bool = Update;
|
|
|
|
//@description The information about interactions with a message has changed @chat_id Chat identifier @message_id Message identifier @interaction_info New information about interactions with the message; may be null
|
|
updateMessageInteractionInfo chat_id:int53 message_id:int53 interaction_info:messageInteractionInfo = Update;
|
|
|
|
//@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 @chat_id Chat identifier @message_id Message identifier
|
|
updateMessageContentOpened chat_id:int53 message_id:int53 = Update;
|
|
|
|
//@description A message with an unread mention was read @chat_id Chat identifier @message_id Message identifier @unread_mention_count The new number of unread mention messages left in the chat
|
|
updateMessageMentionRead chat_id:int53 message_id:int53 unread_mention_count:int32 = Update;
|
|
|
|
//@description A message with a live location was viewed. When the update is received, the application is supposed to update the live location
|
|
//@chat_id Identifier of the chat with the live location message @message_id Identifier of the message with live location
|
|
updateMessageLiveLocationViewed chat_id:int53 message_id:int53 = Update;
|
|
|
|
//@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 @chat The chat
|
|
updateNewChat chat:chat = Update;
|
|
|
|
//@description The title of a chat was changed @chat_id Chat identifier @title The new chat title
|
|
updateChatTitle chat_id:int53 title:string = Update;
|
|
|
|
//@description A chat photo was changed @chat_id Chat identifier @photo The new chat photo; may be null
|
|
updateChatPhoto chat_id:int53 photo:chatPhotoInfo = Update;
|
|
|
|
//@description Chat permissions was changed @chat_id Chat identifier @permissions The new chat permissions
|
|
updateChatPermissions chat_id:int53 permissions:chatPermissions = Update;
|
|
|
|
//@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 @chat_id Chat identifier @last_message The new last message in the chat; may be null @positions The new chat positions in the chat lists
|
|
updateChatLastMessage chat_id:int53 last_message:message positions:vector<chatPosition> = Update;
|
|
|
|
//@description The position of a chat in a chat list has changed. Instead of this update updateChatLastMessage or updateChatDraftMessage might be sent @chat_id Chat identifier @position New chat position. If new order is 0, then the chat needs to be removed from the list
|
|
updateChatPosition chat_id:int53 position:chatPosition = Update;
|
|
|
|
//@description A chat was marked as unread or was read @chat_id Chat identifier @is_marked_as_unread New value of is_marked_as_unread
|
|
updateChatIsMarkedAsUnread chat_id:int53 is_marked_as_unread:Bool = Update;
|
|
|
|
//@description A chat was blocked or unblocked @chat_id Chat identifier @is_blocked New value of is_blocked
|
|
updateChatIsBlocked chat_id:int53 is_blocked:Bool = Update;
|
|
|
|
//@description A chat's has_scheduled_messages field has changed @chat_id Chat identifier @has_scheduled_messages New value of has_scheduled_messages
|
|
updateChatHasScheduledMessages chat_id:int53 has_scheduled_messages:Bool = Update;
|
|
|
|
//@description A chat voice chat state has changed @chat_id Chat identifier @voice_chat New value of voice_chat
|
|
updateChatVoiceChat chat_id:int53 voice_chat:voiceChat = Update;
|
|
|
|
//@description The value of the default disable_notification parameter, used when a message is sent to the chat, was changed @chat_id Chat identifier @default_disable_notification The new default_disable_notification value
|
|
updateChatDefaultDisableNotification chat_id:int53 default_disable_notification:Bool = Update;
|
|
|
|
//@description Incoming messages were read or number of unread messages has been changed @chat_id Chat identifier @last_read_inbox_message_id Identifier of the last read incoming message @unread_count The number of unread messages left in the chat
|
|
updateChatReadInbox chat_id:int53 last_read_inbox_message_id:int53 unread_count:int32 = Update;
|
|
|
|
//@description Outgoing messages were read @chat_id Chat identifier @last_read_outbox_message_id Identifier of last read outgoing message
|
|
updateChatReadOutbox chat_id:int53 last_read_outbox_message_id:int53 = Update;
|
|
|
|
//@description The chat unread_mention_count has changed @chat_id Chat identifier @unread_mention_count The number of unread mention messages left in the chat
|
|
updateChatUnreadMentionCount chat_id:int53 unread_mention_count:int32 = Update;
|
|
|
|
//@description Notification settings for a chat were changed @chat_id Chat identifier @notification_settings The new notification settings
|
|
updateChatNotificationSettings chat_id:int53 notification_settings:chatNotificationSettings = Update;
|
|
|
|
//@description Notification settings for some type of chats were updated @scope Types of chats for which notification settings were updated @notification_settings The new notification settings
|
|
updateScopeNotificationSettings scope:NotificationSettingsScope notification_settings:scopeNotificationSettings = Update;
|
|
|
|
//@description The message Time To Live setting for a chat was changed @chat_id Chat identifier @message_ttl_setting New value of message_ttl_setting
|
|
updateChatMessageTtlSetting chat_id:int53 message_ttl_setting:int32 = Update;
|
|
|
|
//@description The chat action bar was changed @chat_id Chat identifier @action_bar The new value of the action bar; may be null
|
|
updateChatActionBar chat_id:int53 action_bar:ChatActionBar = Update;
|
|
|
|
//@description The default chat reply markup was changed. Can occur because new messages with reply markup were received or because an old reply markup was hidden by the user
|
|
//@chat_id Chat identifier @reply_markup_message_id Identifier of the message from which reply markup needs to be used; 0 if there is no default custom reply markup in the chat
|
|
updateChatReplyMarkup chat_id:int53 reply_markup_message_id:int53 = Update;
|
|
|
|
//@description A chat draft has changed. Be aware that the update may come in the currently opened chat but with old content of the draft. If the user has changed the content of the draft, this update shouldn't be applied @chat_id Chat identifier @draft_message The new draft message; may be null @positions The new chat positions in the chat lists
|
|
updateChatDraftMessage chat_id:int53 draft_message:draftMessage positions:vector<chatPosition> = Update;
|
|
|
|
//@description The list of chat filters or a chat filter has changed @chat_filters The new list of chat filters
|
|
updateChatFilters chat_filters:vector<chatFilterInfo> = Update;
|
|
|
|
//@description The number of online group members has changed. This update with non-zero count is sent only for currently opened chats. There is no guarantee that it will be sent just after the count has changed @chat_id Identifier of the chat @online_member_count New number of online members in the chat, or 0 if unknown
|
|
updateChatOnlineMemberCount chat_id:int53 online_member_count:int32 = Update;
|
|
|
|
//@description A notification was changed @notification_group_id Unique notification group identifier @notification Changed notification
|
|
updateNotification notification_group_id:int32 notification:notification = Update;
|
|
|
|
//@description A list of active notifications in a notification group has changed
|
|
//@notification_group_id Unique notification group identifier
|
|
//@type New type of the notification group
|
|
//@chat_id Identifier of a chat to which all notifications in the group belong
|
|
//@notification_settings_chat_id Chat identifier, which notification settings must be applied to the added notifications
|
|
//@is_silent True, if the notifications should be shown without sound
|
|
//@total_count Total number of unread notifications in the group, can be bigger than number of active notifications
|
|
//@added_notifications List of added group notifications, sorted by notification ID @removed_notification_ids Identifiers of removed group notifications, sorted by notification ID
|
|
updateNotificationGroup notification_group_id:int32 type:NotificationGroupType chat_id:int53 notification_settings_chat_id:int53 is_silent:Bool total_count:int32 added_notifications:vector<notification> removed_notification_ids:vector<int32> = Update;
|
|
|
|
//@description Contains active notifications that was shown on previous application launches. This update is sent only if the message database is used. In that case it comes once before any updateNotification and updateNotificationGroup update @groups Lists of active notification groups
|
|
updateActiveNotifications groups:vector<notificationGroup> = Update;
|
|
|
|
//@description Describes whether there are some pending notification updates. Can be used to prevent application from killing, while there are some pending notifications
|
|
//@have_delayed_notifications True, if there are some delayed notification updates, which will be sent soon
|
|
//@have_unreceived_notifications True, if there can be some yet unreceived notifications, which are being fetched from the server
|
|
updateHavePendingNotifications have_delayed_notifications:Bool have_unreceived_notifications:Bool = Update;
|
|
|
|
//@description Some messages were deleted @chat_id Chat identifier @message_ids Identifiers of the deleted messages
|
|
//@is_permanent True, if the messages are permanently deleted by a user (as opposed to just becoming inaccessible)
|
|
//@from_cache True, if the messages are deleted only from the cache and can possibly be retrieved again in the future
|
|
updateDeleteMessages chat_id:int53 message_ids:vector<int53> is_permanent:Bool from_cache:Bool = Update;
|
|
|
|
//@description User activity in the chat has changed @chat_id Chat identifier @message_thread_id If not 0, a message thread identifier in which the action was performed @user_id Identifier of a user performing an action @action The action description
|
|
updateUserChatAction chat_id:int53 message_thread_id:int53 user_id:int32 action:ChatAction = Update;
|
|
|
|
//@description The user went online or offline @user_id User identifier @status New status of the user
|
|
updateUserStatus user_id:int32 status:UserStatus = Update;
|
|
|
|
//@description Some data of a user has changed. This update is guaranteed to come before the user identifier is returned to the application @user New data about the user
|
|
updateUser user:user = Update;
|
|
|
|
//@description Some data of a basic group has changed. This update is guaranteed to come before the basic group identifier is returned to the application @basic_group New data about the group
|
|
updateBasicGroup basic_group:basicGroup = Update;
|
|
|
|
//@description Some data of a supergroup or a channel has changed. This update is guaranteed to come before the supergroup identifier is returned to the application @supergroup New data about the supergroup
|
|
updateSupergroup supergroup:supergroup = Update;
|
|
|
|
//@description Some data of a secret chat has changed. This update is guaranteed to come before the secret chat identifier is returned to the application @secret_chat New data about the secret chat
|
|
updateSecretChat secret_chat:secretChat = Update;
|
|
|
|
//@description Some data from userFullInfo has been changed @user_id User identifier @user_full_info New full information about the user
|
|
updateUserFullInfo user_id:int32 user_full_info:userFullInfo = Update;
|
|
|
|
//@description Some data from basicGroupFullInfo has been changed @basic_group_id Identifier of a basic group @basic_group_full_info New full information about the group
|
|
updateBasicGroupFullInfo basic_group_id:int32 basic_group_full_info:basicGroupFullInfo = Update;
|
|
|
|
//@description Some data from supergroupFullInfo has been changed @supergroup_id Identifier of the supergroup or channel @supergroup_full_info New full information about the supergroup
|
|
updateSupergroupFullInfo supergroup_id:int32 supergroup_full_info:supergroupFullInfo = Update;
|
|
|
|
//@description Service notification from the server. Upon receiving this the application must show a popup with the content of the notification
|
|
//@type Notification type. If type begins with "AUTH_KEY_DROP_", then two buttons "Cancel" and "Log out" should be shown under notification; if user presses the second, all local data should be destroyed using Destroy method
|
|
//@content Notification content
|
|
updateServiceNotification type:string content:MessageContent = Update;
|
|
|
|
//@description Information about a file was updated @file New data about the file
|
|
updateFile file:file = Update;
|
|
|
|
//@description The file generation process needs to be started by the application
|
|
//@generation_id Unique identifier for the generation process
|
|
//@original_path The path to a file from which a new file is generated; may be empty
|
|
//@destination_path The path to a file that should be created and where the new file should be generated
|
|
//@conversion String specifying the conversion applied to the original file. If conversion is "#url#" than original_path contains an HTTP/HTTPS URL of a file, which should be downloaded by the application
|
|
updateFileGenerationStart generation_id:int64 original_path:string destination_path:string conversion:string = Update;
|
|
|
|
//@description File generation is no longer needed @generation_id Unique identifier for the generation process
|
|
updateFileGenerationStop generation_id:int64 = Update;
|
|
|
|
//@description New call was created or information about a call was updated @call New data about a call
|
|
updateCall call:call = Update;
|
|
|
|
//@description Information about a group call was updated @group_call New data about a group call
|
|
updateGroupCall group_call:groupCall = Update;
|
|
|
|
//@description Information about a group call participant was changed. The updates are sent only after the group call is received through getGroupCall and only if the call is joined or being joined
|
|
//@group_call_id Identifier of group call @participant New data about a participant
|
|
updateGroupCallParticipant group_call_id:int32 participant:groupCallParticipant = Update;
|
|
|
|
//@description New call signaling data arrived @call_id The call identifier @data The data
|
|
updateNewCallSignalingData call_id:int32 data:bytes = Update;
|
|
|
|
//@description Some privacy setting rules have been changed @setting The privacy setting @rules New privacy rules
|
|
updateUserPrivacySettingRules setting:UserPrivacySetting rules:userPrivacySettingRules = Update;
|
|
|
|
//@description Number of unread messages in a chat list has changed. This update is sent only if the message database is used @chat_list The chat list with changed number of unread messages
|
|
//@unread_count Total number of unread messages @unread_unmuted_count Total number of unread messages in unmuted chats
|
|
updateUnreadMessageCount chat_list:ChatList unread_count:int32 unread_unmuted_count:int32 = Update;
|
|
|
|
//@description Number of unread chats, i.e. with unread messages or marked as unread, has changed. This update is sent only if the message database is used
|
|
//@chat_list The chat list with changed number of unread messages
|
|
//@total_count Approximate total number of chats in the chat list
|
|
//@unread_count Total number of unread chats @unread_unmuted_count Total number of unread unmuted chats
|
|
//@marked_as_unread_count Total number of chats marked as unread @marked_as_unread_unmuted_count Total number of unmuted chats marked as unread
|
|
updateUnreadChatCount chat_list:ChatList total_count:int32 unread_count:int32 unread_unmuted_count:int32 marked_as_unread_count:int32 marked_as_unread_unmuted_count:int32 = Update;
|
|
|
|
//@description An option changed its value @name The option name @value The new option value
|
|
updateOption name:string value:OptionValue = Update;
|
|
|
|
//@description A sticker set has changed @sticker_set The sticker set
|
|
updateStickerSet sticker_set:stickerSet = Update;
|
|
|
|
//@description The list of installed sticker sets was updated @is_masks True, if the list of installed mask sticker sets was updated @sticker_set_ids The new list of installed ordinary sticker sets
|
|
updateInstalledStickerSets is_masks:Bool sticker_set_ids:vector<int64> = Update;
|
|
|
|
//@description The list of trending sticker sets was updated or some of them were viewed @sticker_sets The prefix of the list of trending sticker sets with the newest trending sticker sets
|
|
updateTrendingStickerSets sticker_sets:stickerSets = Update;
|
|
|
|
//@description The list of recently used stickers was updated @is_attached True, if the list of stickers attached to photo or video files was updated, otherwise the list of sent stickers is updated @sticker_ids The new list of file identifiers of recently used stickers
|
|
updateRecentStickers is_attached:Bool sticker_ids:vector<int32> = Update;
|
|
|
|
//@description The list of favorite stickers was updated @sticker_ids The new list of file identifiers of favorite stickers
|
|
updateFavoriteStickers sticker_ids:vector<int32> = Update;
|
|
|
|
//@description The list of saved animations was updated @animation_ids The new list of file identifiers of saved animations
|
|
updateSavedAnimations animation_ids:vector<int32> = Update;
|
|
|
|
//@description The selected background has changed @for_dark_theme True, if background for dark theme has changed @background The new selected background; may be null
|
|
updateSelectedBackground for_dark_theme:Bool background:background = Update;
|
|
|
|
//@description Some language pack strings have been updated @localization_target Localization target to which the language pack belongs @language_pack_id Identifier of the updated language pack @strings List of changed language pack strings
|
|
updateLanguagePackStrings localization_target:string language_pack_id:string strings:vector<languagePackString> = Update;
|
|
|
|
//@description The connection state has changed. This update must be used only to show a human-readable description of the connection state @state The new connection state
|
|
updateConnectionState state:ConnectionState = Update;
|
|
|
|
//@description New terms of service must be accepted by the user. If the terms of service are declined, then the deleteAccount method should be called with the reason "Decline ToS update" @terms_of_service_id Identifier of the terms of service @terms_of_service The new terms of service
|
|
updateTermsOfService terms_of_service_id:string terms_of_service:termsOfService = Update;
|
|
|
|
//@description The list of users nearby has changed. The update is guaranteed to be sent only 60 seconds after a successful searchChatsNearby request @users_nearby The new list of users nearby
|
|
updateUsersNearby users_nearby:vector<chatNearby> = Update;
|
|
|
|
//@description The list of supported dice emojis has changed @emojis The new list of supported dice emojis
|
|
updateDiceEmojis emojis:vector<string> = Update;
|
|
|
|
//@description The parameters of animation search through GetOption("animation_search_bot_username") bot has changed @provider Name of the animation search provider @emojis The new list of emojis suggested for searching
|
|
updateAnimationSearchParameters provider:string emojis:vector<string> = Update;
|
|
|
|
//@description The list of suggested to the user actions has changed @added_actions Added suggested actions @removed_actions Removed suggested actions
|
|
updateSuggestedActions added_actions:vector<SuggestedAction> removed_actions:vector<SuggestedAction> = Update;
|
|
|
|
//@description A new incoming inline query; for bots only @id Unique query identifier @sender_user_id Identifier of the user who sent the query @user_location User location; may be null
|
|
//@chat_type Contains information about the type of the chat, from which the query originated; may be null if unknown @query Text of the query @offset Offset of the first entry to return
|
|
updateNewInlineQuery id:int64 sender_user_id:int32 user_location:location chat_type:ChatType query:string offset:string = Update;
|
|
|
|
//@description The user has chosen a result of an inline query; for bots only @sender_user_id Identifier of the user who sent the query @user_location User location; may be null
|
|
//@query Text of the query @result_id Identifier of the chosen result @inline_message_id Identifier of the sent inline message, if known
|
|
updateNewChosenInlineResult sender_user_id:int32 user_location:location query:string result_id:string inline_message_id:string = Update;
|
|
|
|
//@description A new incoming callback query; for bots only @id Unique query identifier @sender_user_id Identifier of the user who sent the query
|
|
//@chat_id Identifier of the chat where the query was sent @message_id Identifier of the message, from which the query originated
|
|
//@chat_instance Identifier that uniquely corresponds to the chat to which the message was sent @payload Query payload
|
|
updateNewCallbackQuery id:int64 sender_user_id:int32 chat_id:int53 message_id:int53 chat_instance:int64 payload:CallbackQueryPayload = Update;
|
|
|
|
//@description A new incoming callback query from a message sent via a bot; for bots only @id Unique query identifier @sender_user_id Identifier of the user who sent the query @inline_message_id Identifier of the inline message, from which the query originated
|
|
//@chat_instance An identifier uniquely corresponding to the chat a message was sent to @payload Query payload
|
|
updateNewInlineCallbackQuery id:int64 sender_user_id:int32 inline_message_id:string chat_instance:int64 payload:CallbackQueryPayload = Update;
|
|
|
|
//@description A new incoming shipping query; for bots only. Only for invoices with flexible price @id Unique query identifier @sender_user_id Identifier of the user who sent the query @invoice_payload Invoice payload @shipping_address User shipping address
|
|
updateNewShippingQuery id:int64 sender_user_id:int32 invoice_payload:string shipping_address:address = Update;
|
|
|
|
//@description A new incoming pre-checkout query; for bots only. Contains full information about a checkout @id Unique query identifier @sender_user_id Identifier of the user who sent the query @currency Currency for the product price @total_amount Total price for the product, in the minimal quantity of the currency
|
|
//@invoice_payload Invoice payload @shipping_option_id Identifier of a shipping option chosen by the user; may be empty if not applicable @order_info Information about the order; may be null
|
|
updateNewPreCheckoutQuery id:int64 sender_user_id:int32 currency:string total_amount:int53 invoice_payload:bytes shipping_option_id:string order_info:orderInfo = Update;
|
|
|
|
//@description A new incoming event; for bots only @event A JSON-serialized event
|
|
updateNewCustomEvent event:string = Update;
|
|
|
|
//@description A new incoming query; for bots only @id The query identifier @data JSON-serialized query data @timeout Query timeout
|
|
updateNewCustomQuery id:int64 data:string timeout:int32 = Update;
|
|
|
|
//@description A poll was updated; for bots only @poll New data about the poll
|
|
updatePoll poll:poll = Update;
|
|
|
|
//@description A user changed the answer to a poll; for bots only @poll_id Unique poll identifier @user_id The user, who changed the answer to the poll @option_ids 0-based identifiers of answer options, chosen by the user
|
|
updatePollAnswer poll_id:int64 user_id:int32 option_ids:vector<int32> = Update;
|
|
|
|
//@description User rights changed in a chat; for bots only @chat_id Chat identifier @actor_user_id Identifier of the user, changing the rights
|
|
//@date Point in time (Unix timestamp) when the user rights was changed @invite_link If user has joined the chat using an invite link, the invite link; may be null
|
|
//@old_chat_member Previous chat member @new_chat_member New chat member
|
|
updateChatMember chat_id:int53 actor_user_id:int32 date:int32 invite_link:chatInviteLink old_chat_member:chatMember new_chat_member:chatMember = Update;
|
|
|
|
|
|
//@description Contains a list of updates @updates List of updates
|
|
updates updates:vector<Update> = Updates;
|
|
|
|
|
|
//@class LogStream @description Describes a stream to which TDLib internal log is written
|
|
|
|
//@description The log is written to stderr or an OS specific log
|
|
logStreamDefault = LogStream;
|
|
|
|
//@description The log is written to a file
|
|
//@path Path to the file to where the internal TDLib log will be written
|
|
//@max_file_size The maximum size of the file to where the internal TDLib log is written before the file will be auto-rotated
|
|
//@redirect_stderr Pass true to additionally redirect stderr to the log file. Ignored on Windows
|
|
logStreamFile path:string max_file_size:int53 redirect_stderr:Bool = LogStream;
|
|
|
|
//@description The log is written nowhere
|
|
logStreamEmpty = LogStream;
|
|
|
|
|
|
//@description Contains a TDLib internal log verbosity level @verbosity_level Log verbosity level
|
|
logVerbosityLevel verbosity_level:int32 = LogVerbosityLevel;
|
|
|
|
//@description Contains a list of available TDLib internal log tags @tags List of log tags
|
|
logTags tags:vector<string> = LogTags;
|
|
|
|
|
|
//@description A simple object containing a number; for testing only @value Number
|
|
testInt value:int32 = TestInt;
|
|
//@description A simple object containing a string; for testing only @value String
|
|
testString value:string = TestString;
|
|
//@description A simple object containing a sequence of bytes; for testing only @value Bytes
|
|
testBytes value:bytes = TestBytes;
|
|
//@description A simple object containing a vector of numbers; for testing only @value Vector of numbers
|
|
testVectorInt value:vector<int32> = TestVectorInt;
|
|
//@description A simple object containing a vector of objects that hold a number; for testing only @value Vector of objects
|
|
testVectorIntObject value:vector<testInt> = TestVectorIntObject;
|
|
//@description A simple object containing a vector of strings; for testing only @value Vector of strings
|
|
testVectorString value:vector<string> = TestVectorString;
|
|
//@description A simple object containing a vector of objects that hold a string; for testing only @value Vector of objects
|
|
testVectorStringObject value:vector<testString> = TestVectorStringObject;
|
|
|
|
---functions---
|
|
|
|
//@description Returns the current authorization state; this is an offline request. For informational purposes only. Use updateAuthorizationState instead to maintain the current authorization state. Can be called before initialization
|
|
getAuthorizationState = AuthorizationState;
|
|
|
|
|
|
//@description Sets the parameters for TDLib initialization. Works only when the current authorization state is authorizationStateWaitTdlibParameters @parameters Parameters
|
|
setTdlibParameters parameters:tdlibParameters = Ok;
|
|
|
|
//@description Checks the database encryption key for correctness. Works only when the current authorization state is authorizationStateWaitEncryptionKey @encryption_key Encryption key to check or set up
|
|
checkDatabaseEncryptionKey encryption_key:bytes = Ok;
|
|
|
|
//@description Sets the phone number of the user and sends an authentication code to the user. Works only when the current authorization state is authorizationStateWaitPhoneNumber,
|
|
//-or if there is no pending authentication query and the current authorization state is authorizationStateWaitCode, authorizationStateWaitRegistration, or authorizationStateWaitPassword
|
|
//@phone_number The phone number of the user, in international format @settings Settings for the authentication of the user's phone number
|
|
setAuthenticationPhoneNumber phone_number:string settings:phoneNumberAuthenticationSettings = Ok;
|
|
|
|
//@description Re-sends an authentication code to the user. Works only when the current authorization state is authorizationStateWaitCode and the next_code_type of the result is not null
|
|
resendAuthenticationCode = Ok;
|
|
|
|
//@description Checks the authentication code. Works only when the current authorization state is authorizationStateWaitCode @code The verification code received via SMS, Telegram message, phone call, or flash call
|
|
checkAuthenticationCode code:string = Ok;
|
|
|
|
//@description Requests QR code authentication by scanning a QR code on another logged in device. Works only when the current authorization state is authorizationStateWaitPhoneNumber,
|
|
//-or if there is no pending authentication query and the current authorization state is authorizationStateWaitCode, authorizationStateWaitRegistration, or authorizationStateWaitPassword
|
|
//@other_user_ids List of user identifiers of other users currently using the application
|
|
requestQrCodeAuthentication other_user_ids:vector<int32> = Ok;
|
|
|
|
//@description Finishes user registration. Works only when the current authorization state is authorizationStateWaitRegistration
|
|
//@first_name The first name of the user; 1-64 characters @last_name The last name of the user; 0-64 characters
|
|
registerUser first_name:string last_name:string = Ok;
|
|
|
|
//@description Checks the authentication password for correctness. Works only when the current authorization state is authorizationStateWaitPassword @password The password to check
|
|
checkAuthenticationPassword password:string = Ok;
|
|
|
|
//@description Requests to send a password recovery code to an email address that was previously set up. Works only when the current authorization state is authorizationStateWaitPassword
|
|
requestAuthenticationPasswordRecovery = Ok;
|
|
|
|
//@description Recovers the password with a password recovery code sent to an email address that was previously set up. Works only when the current authorization state is authorizationStateWaitPassword @recovery_code Recovery code to check
|
|
recoverAuthenticationPassword recovery_code:string = Ok;
|
|
|
|
//@description Checks the authentication token of a bot; to log in as a bot. Works only when the current authorization state is authorizationStateWaitPhoneNumber. Can be used instead of setAuthenticationPhoneNumber and checkAuthenticationCode to log in @token The bot token
|
|
checkAuthenticationBotToken token:string = Ok;
|
|
|
|
//@description Closes the TDLib instance after a proper logout. Requires an available network connection. All local data will be destroyed. After the logout completes, updateAuthorizationState with authorizationStateClosed will be sent
|
|
logOut = Ok;
|
|
|
|
//@description Closes the TDLib instance. All databases will be flushed to disk and properly closed. After the close completes, updateAuthorizationState with authorizationStateClosed will be sent. Can be called before initialization
|
|
close = Ok;
|
|
|
|
//@description Closes the TDLib instance, destroying all local data without a proper logout. The current user session will remain in the list of all active sessions. All local data will be destroyed. After the destruction completes updateAuthorizationState with authorizationStateClosed will be sent. Can be called before authorization
|
|
destroy = Ok;
|
|
|
|
|
|
//@description Confirms QR code authentication on another device. Returns created session on success @link A link from a QR code. The link must be scanned by the in-app camera
|
|
confirmQrCodeAuthentication link:string = Session;
|
|
|
|
|
|
//@description Returns all updates needed to restore current TDLib state, i.e. all actual UpdateAuthorizationState/UpdateUser/UpdateNewChat and others. This is especially useful if TDLib is run in a separate process. Can be called before initialization
|
|
getCurrentState = Updates;
|
|
|
|
|
|
//@description Changes the database encryption key. Usually the encryption key is never changed and is stored in some OS keychain @new_encryption_key New encryption key
|
|
setDatabaseEncryptionKey new_encryption_key:bytes = Ok;
|
|
|
|
|
|
//@description Returns the current state of 2-step verification
|
|
getPasswordState = PasswordState;
|
|
|
|
//@description Changes the password for the user. If a new recovery email address is specified, then the change will not be applied until the new recovery email address is confirmed
|
|
//@old_password Previous password of the user @new_password New password of the user; may be empty to remove the password @new_hint New password hint; may be empty @set_recovery_email_address Pass true if the recovery email address should be changed @new_recovery_email_address New recovery email address; may be empty
|
|
setPassword old_password:string new_password:string new_hint:string set_recovery_email_address:Bool new_recovery_email_address:string = PasswordState;
|
|
|
|
//@description Returns a 2-step verification recovery email address that was previously set up. This method can be used to verify a password provided by the user @password The password for the current user
|
|
getRecoveryEmailAddress password:string = RecoveryEmailAddress;
|
|
|
|
//@description Changes the 2-step verification recovery email address of the user. If a new recovery email address is specified, then the change will not be applied until the new recovery email address is confirmed.
|
|
//-If new_recovery_email_address is the same as the email address that is currently set up, this call succeeds immediately and aborts all other requests waiting for an email confirmation @password Password of the current user @new_recovery_email_address New recovery email address
|
|
setRecoveryEmailAddress password:string new_recovery_email_address:string = PasswordState;
|
|
|
|
//@description Checks the 2-step verification recovery email address verification code @code Verification code
|
|
checkRecoveryEmailAddressCode code:string = PasswordState;
|
|
|
|
//@description Resends the 2-step verification recovery email address verification code
|
|
resendRecoveryEmailAddressCode = PasswordState;
|
|
|
|
//@description Requests to send a password recovery code to an email address that was previously set up
|
|
requestPasswordRecovery = EmailAddressAuthenticationCodeInfo;
|
|
|
|
//@description Recovers the password using a recovery code sent to an email address that was previously set up @recovery_code Recovery code to check
|
|
recoverPassword recovery_code:string = PasswordState;
|
|
|
|
//@description Creates a new temporary password for processing payments @password Persistent user password @valid_for Time during which the temporary password will be valid, in seconds; should be between 60 and 86400
|
|
createTemporaryPassword password:string valid_for:int32 = TemporaryPasswordState;
|
|
|
|
//@description Returns information about the current temporary password
|
|
getTemporaryPasswordState = TemporaryPasswordState;
|
|
|
|
|
|
//@description Returns the current user
|
|
getMe = User;
|
|
|
|
//@description Returns information about a user by their identifier. This is an offline request if the current user is not a bot @user_id User identifier
|
|
getUser user_id:int32 = User;
|
|
|
|
//@description Returns full information about a user by their identifier @user_id User identifier
|
|
getUserFullInfo user_id:int32 = UserFullInfo;
|
|
|
|
//@description Returns information about a basic group by its identifier. This is an offline request if the current user is not a bot @basic_group_id Basic group identifier
|
|
getBasicGroup basic_group_id:int32 = BasicGroup;
|
|
|
|
//@description Returns full information about a basic group by its identifier @basic_group_id Basic group identifier
|
|
getBasicGroupFullInfo basic_group_id:int32 = BasicGroupFullInfo;
|
|
|
|
//@description Returns information about a supergroup or a channel by its identifier. This is an offline request if the current user is not a bot @supergroup_id Supergroup or channel identifier
|
|
getSupergroup supergroup_id:int32 = Supergroup;
|
|
|
|
//@description Returns full information about a supergroup or a channel by its identifier, cached for up to 1 minute @supergroup_id Supergroup or channel identifier
|
|
getSupergroupFullInfo supergroup_id:int32 = SupergroupFullInfo;
|
|
|
|
//@description Returns information about a secret chat by its identifier. This is an offline request @secret_chat_id Secret chat identifier
|
|
getSecretChat secret_chat_id:int32 = SecretChat;
|
|
|
|
//@description Returns information about a chat by its identifier, this is an offline request if the current user is not a bot @chat_id Chat identifier
|
|
getChat chat_id:int53 = Chat;
|
|
|
|
//@description Returns information about a message @chat_id Identifier of the chat the message belongs to @message_id Identifier of the message to get
|
|
getMessage chat_id:int53 message_id:int53 = Message;
|
|
|
|
//@description Returns information about a message, if it is available locally without sending network request. This is an offline request @chat_id Identifier of the chat the message belongs to @message_id Identifier of the message to get
|
|
getMessageLocally chat_id:int53 message_id:int53 = Message;
|
|
|
|
//@description Returns information about a message that is replied by a given message. Also returns the pinned message, the game message, and the invoice message for messages of the types messagePinMessage, messageGameScore, and messagePaymentSuccessful respectively
|
|
//@chat_id Identifier of the chat the message belongs to @message_id Identifier of the message reply to which to get
|
|
getRepliedMessage chat_id:int53 message_id:int53 = Message;
|
|
|
|
//@description Returns information about a newest pinned message in the chat @chat_id Identifier of the chat the message belongs to
|
|
getChatPinnedMessage chat_id:int53 = Message;
|
|
|
|
//@description Returns information about a message with the callback button that originated a callback query; for bots only @chat_id Identifier of the chat the message belongs to @message_id Message identifier @callback_query_id Identifier of the callback query
|
|
getCallbackQueryMessage chat_id:int53 message_id:int53 callback_query_id:int64 = Message;
|
|
|
|
//@description Returns information about messages. If a message is not found, returns null on the corresponding position of the result @chat_id Identifier of the chat the messages belong to @message_ids Identifiers of the messages to get
|
|
getMessages chat_id:int53 message_ids:vector<int53> = Messages;
|
|
|
|
//@description Returns information about a message thread. Can be used only if message.can_get_message_thread == true @chat_id Chat identifier @message_id Identifier of the message
|
|
getMessageThread chat_id:int53 message_id:int53 = MessageThreadInfo;
|
|
|
|
//@description Returns information about a file; this is an offline request @file_id Identifier of the file to get
|
|
getFile file_id:int32 = File;
|
|
|
|
//@description Returns information about a file by its remote ID; this is an offline request. Can be used to register a URL as a file for further uploading, or sending as a message. Even the request succeeds, the file can be used only if it is still accessible to the user.
|
|
//-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
|
|
//@remote_file_id Remote identifier of the file to get @file_type File type, if known
|
|
getRemoteFile remote_file_id:string file_type:FileType = File;
|
|
|
|
//@description Returns an ordered list of chats in a chat list. Chats are sorted by the pair (chat.position.order, chat.id) in descending order. (For example, to get a list of chats from the beginning, the offset_order should be equal to a biggest signed 64-bit number 9223372036854775807 == 2^63 - 1).
|
|
//-For optimal performance the number of returned chats is chosen by the library
|
|
//@chat_list The chat list in which to return chats
|
|
//@offset_order Chat order to return chats from @offset_chat_id Chat identifier to return chats from
|
|
//@limit The maximum number of chats to be returned. It is possible that fewer chats than the limit are returned even if the end of the list is not reached
|
|
getChats chat_list:ChatList offset_order:int64 offset_chat_id:int53 limit:int32 = Chats;
|
|
|
|
//@description Searches a public chat by its username. Currently only private chats, supergroups and channels can be public. Returns the chat if found; otherwise an error is returned @username Username to be resolved
|
|
searchPublicChat username:string = Chat;
|
|
|
|
//@description Searches public chats by looking for specified query in their username and title. Currently only private chats, supergroups and channels can be public. Returns a meaningful number of results. Returns nothing if the length of the searched username prefix is less than 5. Excludes private chats with contacts and chats from the chat list from the results @query Query to search for
|
|
searchPublicChats query:string = Chats;
|
|
|
|
//@description Searches for the specified query in the title and username of already known chats, this is an offline request. Returns chats in the order seen in the main chat list @query Query to search for. If the query is empty, returns up to 20 recently found chats @limit The maximum number of chats to be returned
|
|
searchChats query:string limit:int32 = Chats;
|
|
|
|
//@description Searches for the specified query in the title and username of already known chats via request to the server. Returns chats in the order seen in the main chat list @query Query to search for @limit The maximum number of chats to be returned
|
|
searchChatsOnServer query:string limit:int32 = Chats;
|
|
|
|
//@description Returns a list of users and location-based supergroups nearby. The list of users nearby will be updated for 60 seconds after the request by the updates updateUsersNearby. The request should be sent again every 25 seconds with adjusted location to not miss new chats @location Current user location
|
|
searchChatsNearby location:location = ChatsNearby;
|
|
|
|
//@description Returns a list of frequently used chats. Supported only if the chat info database is enabled @category Category of chats to be returned @limit The maximum number of chats to be returned; up to 30
|
|
getTopChats category:TopChatCategory limit:int32 = Chats;
|
|
|
|
//@description Removes a chat from the list of frequently used chats. Supported only if the chat info database is enabled @category Category of frequently used chats @chat_id Chat identifier
|
|
removeTopChat category:TopChatCategory chat_id:int53 = Ok;
|
|
|
|
//@description Adds a chat to the list of recently found chats. The chat is added to the beginning of the list. If the chat is already in the list, it will be removed from the list first @chat_id Identifier of the chat to add
|
|
addRecentlyFoundChat chat_id:int53 = Ok;
|
|
|
|
//@description Removes a chat from the list of recently found chats @chat_id Identifier of the chat to be removed
|
|
removeRecentlyFoundChat chat_id:int53 = Ok;
|
|
|
|
//@description Clears the list of recently found chats
|
|
clearRecentlyFoundChats = Ok;
|
|
|
|
//@description Checks whether a username can be set for a chat @chat_id Chat identifier; should be identifier of a supergroup chat, or a channel chat, or a private chat with self, or zero if chat is being created @username Username to be checked
|
|
checkChatUsername chat_id:int53 username:string = CheckChatUsernameResult;
|
|
|
|
//@description Returns a list of public chats of the specified type, owned by the user @type Type of the public chats to return
|
|
getCreatedPublicChats type:PublicChatType = Chats;
|
|
|
|
//@description Checks whether the maximum number of owned public chats has been reached. Returns corresponding error if the limit was reached @type Type of the public chats, for which to check the limit
|
|
checkCreatedPublicChatsLimit type:PublicChatType = Ok;
|
|
|
|
//@description Returns a list of basic group and supergroup chats, which can be used as a discussion group for a channel. Returned basic group chats must be first upgraded to supergroups before they can be set as a discussion group. To set a returned supergroup as a discussion group, access to its old messages must be enabled using toggleSupergroupIsAllHistoryAvailable first
|
|
getSuitableDiscussionChats = Chats;
|
|
|
|
//@description Returns a list of recently inactive supergroups and channels. Can be used when user reaches limit on the number of joined supergroups and channels and receives CHANNELS_TOO_MUCH error
|
|
getInactiveSupergroupChats = Chats;
|
|
|
|
|
|
//@description Returns a list of common group chats with a given user. Chats are sorted by their type and creation date @user_id User identifier @offset_chat_id Chat identifier starting from which to return chats; use 0 for the first request @limit The maximum number of chats to be returned; up to 100
|
|
getGroupsInCommon user_id:int32 offset_chat_id:int53 limit:int32 = Chats;
|
|
|
|
|
|
//@description Returns messages in a chat. The messages are returned in a reverse chronological order (i.e., in order of decreasing message_id).
|
|
//-For optimal performance the number of returned messages is chosen by the library. This is an offline request if only_local is true
|
|
//@chat_id Chat identifier
|
|
//@from_message_id Identifier of the message starting from which history must be fetched; use 0 to get results from the last message
|
|
//@offset Specify 0 to get results from exactly the from_message_id or a negative offset up to 99 to get additionally some newer messages
|
|
//@limit The maximum number of messages to be returned; must be positive and can't be greater than 100. If the offset is negative, the limit must be greater than or equal to -offset. Fewer messages may be returned than specified by the limit, even if the end of the message history has not been reached
|
|
//@only_local If true, returns only messages that are available locally without sending network requests
|
|
getChatHistory chat_id:int53 from_message_id:int53 offset:int32 limit:int32 only_local:Bool = Messages;
|
|
|
|
//@description Returns messages in a message thread of a message. Can be used only if message.can_get_message_thread == true. Message thread of a channel message is in the channel's linked supergroup.
|
|
//-The messages are returned in a reverse chronological order (i.e., in order of decreasing message_id). For optimal performance the number of returned messages is chosen by the library
|
|
//@chat_id Chat identifier
|
|
//@message_id Message identifier, which thread history needs to be returned
|
|
//@from_message_id Identifier of the message starting from which history must be fetched; use 0 to get results from the last message
|
|
//@offset Specify 0 to get results from exactly the from_message_id or a negative offset up to 99 to get additionally some newer messages
|
|
//@limit The maximum number of messages to be returned; must be positive and can't be greater than 100. If the offset is negative, the limit must be greater than or equal to -offset. Fewer messages may be returned than specified by the limit, even if the end of the message thread history has not been reached
|
|
getMessageThreadHistory chat_id:int53 message_id:int53 from_message_id:int53 offset:int32 limit:int32 = Messages;
|
|
|
|
//@description Deletes all messages in the chat. Use Chat.can_be_deleted_only_for_self and Chat.can_be_deleted_for_all_users fields to find whether and how the method can be applied to the chat
|
|
//@chat_id Chat identifier @remove_from_chat_list Pass true if the chat should be removed from the chat list @revoke Pass true to try to delete chat history for all users
|
|
deleteChatHistory chat_id:int53 remove_from_chat_list:Bool revoke:Bool = Ok;
|
|
|
|
//@description Deletes a chat along with all messages in the corresponding chat for all chat members; requires owner privileges. For group chats this will release the username and remove all members. Chats with more than 1000 members can't be deleted using this method @chat_id Chat identifier
|
|
deleteChat chat_id:int53 = Ok;
|
|
|
|
//@description Searches for messages with given words in the chat. Returns the results in reverse chronological order, i.e. in order of decreasing message_id. Cannot be used in secret chats with a non-empty query
|
|
//-(searchSecretMessages should be used instead), or without an enabled message database. For optimal performance the number of returned messages is chosen by the library
|
|
//@chat_id Identifier of the chat in which to search messages
|
|
//@query Query to search for
|
|
//@sender If not null, only messages sent by the specified sender will be returned. Not supported in secret chats
|
|
//@from_message_id Identifier of the message starting from which history must be fetched; use 0 to get results from the last message
|
|
//@offset Specify 0 to get results from exactly the from_message_id or a negative offset to get the specified message and some newer messages
|
|
//@limit The maximum number of messages to be returned; must be positive and can't be greater than 100. If the offset is negative, the limit must be greater than -offset. Fewer messages may be returned than specified by the limit, even if the end of the message history has not been reached
|
|
//@filter Filter for message content in the search results
|
|
//@message_thread_id If not 0, only messages in the specified thread will be returned; supergroups only
|
|
searchChatMessages chat_id:int53 query:string sender:MessageSender from_message_id:int53 offset:int32 limit:int32 filter:SearchMessagesFilter message_thread_id:int53 = Messages;
|
|
|
|
//@description Searches for messages in all chats except secret chats. Returns the results in reverse chronological order (i.e., in order of decreasing (date, chat_id, message_id)).
|
|
//-For optimal performance the number of returned messages is chosen by the library
|
|
//@chat_list Chat list in which to search messages; pass null to search in all chats regardless of their chat list. Only Main and Archive chat lists are supported
|
|
//@query Query to search for
|
|
//@offset_date The date of the message starting from which the results should be fetched. Use 0 or any date in the future to get results from the last message
|
|
//@offset_chat_id The chat identifier of the last found message, or 0 for the first request
|
|
//@offset_message_id The message identifier of the last found message, or 0 for the first request
|
|
//@limit The maximum number of messages to be returned; up to 100. Fewer messages may be returned than specified by the limit, even if the end of the message history has not been reached
|
|
//@filter Filter for message content in the search results; searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention, searchMessagesFilterUnreadMention, searchMessagesFilterFailedToSend and searchMessagesFilterPinned are unsupported in this function
|
|
//@min_date If not 0, the minimum date of the messages to return
|
|
//@max_date If not 0, the maximum date of the messages to return
|
|
searchMessages chat_list:ChatList query:string offset_date:int32 offset_chat_id:int53 offset_message_id:int53 limit:int32 filter:SearchMessagesFilter min_date:int32 max_date:int32 = Messages;
|
|
|
|
//@description Searches for messages in secret chats. Returns the results in reverse chronological order. For optimal performance the number of returned messages is chosen by the library
|
|
//@chat_id Identifier of the chat in which to search. Specify 0 to search in all secret chats
|
|
//@query Query to search for. If empty, searchChatMessages should be used instead
|
|
//@offset Offset of the first entry to return as received from the previous request; use empty string to get first chunk of results
|
|
//@limit The maximum number of messages to be returned; up to 100. Fewer messages may be returned than specified by the limit, even if the end of the message history has not been reached
|
|
//@filter A filter for message content in the search results
|
|
searchSecretMessages chat_id:int53 query:string offset:string limit:int32 filter:SearchMessagesFilter = FoundMessages;
|
|
|
|
//@description Searches for call messages. Returns the results in reverse chronological order (i. e., in order of decreasing message_id). For optimal performance the number of returned messages is chosen by the library
|
|
//@from_message_id Identifier of the message from which to search; use 0 to get results from the last message
|
|
//@limit The maximum number of messages to be returned; up to 100. Fewer messages may be returned than specified by the limit, even if the end of the message history has not been reached @only_missed If true, returns only messages with missed calls
|
|
searchCallMessages from_message_id:int53 limit:int32 only_missed:Bool = Messages;
|
|
|
|
//@description Deletes all call messages @revoke Pass true to delete the messages for all users
|
|
deleteAllCallMessages revoke:Bool = Ok;
|
|
|
|
//@description Returns information about the recent locations of chat members that were sent to the chat. Returns up to 1 location message per user @chat_id Chat identifier @limit The maximum number of messages to be returned
|
|
searchChatRecentLocationMessages chat_id:int53 limit:int32 = Messages;
|
|
|
|
//@description Returns all active live locations that should be updated by the application. The list is persistent across application restarts only if the message database is used
|
|
getActiveLiveLocationMessages = Messages;
|
|
|
|
//@description Returns the last message sent in a chat no later than the specified date @chat_id Chat identifier @date Point in time (Unix timestamp) relative to which to search for messages
|
|
getChatMessageByDate chat_id:int53 date:int32 = Message;
|
|
|
|
//@description Returns approximate number of messages of the specified type in the chat @chat_id Identifier of the chat in which to count messages @filter Filter for message content; searchMessagesFilterEmpty is unsupported in this function @return_local If true, returns count that is available locally without sending network requests, returning -1 if the number of messages is unknown
|
|
getChatMessageCount chat_id:int53 filter:SearchMessagesFilter return_local:Bool = Count;
|
|
|
|
//@description Returns all scheduled messages in a chat. The messages are returned in a reverse chronological order (i.e., in order of decreasing message_id) @chat_id Chat identifier
|
|
getChatScheduledMessages chat_id:int53 = Messages;
|
|
|
|
//@description Returns forwarded copies of a channel message to different public channels. For optimal performance the number of returned messages is chosen by the library
|
|
//@chat_id Chat identifier of the message
|
|
//@message_id Message identifier
|
|
//@offset Offset of the first entry to return as received from the previous request; use empty string to get first chunk of results
|
|
//@limit The maximum number of messages to be returned; must be positive and can't be greater than 100. Fewer messages may be returned than specified by the limit, even if the end of the list has not been reached
|
|
getMessagePublicForwards chat_id:int53 message_id:int53 offset:string limit:int32 = FoundMessages;
|
|
|
|
|
|
//@description Removes an active notification from notification list. Needs to be called only if the notification is removed by the current user @notification_group_id Identifier of notification group to which the notification belongs @notification_id Identifier of removed notification
|
|
removeNotification notification_group_id:int32 notification_id:int32 = Ok;
|
|
|
|
//@description Removes a group of active notifications. Needs to be called only if the notification group is removed by the current user @notification_group_id Notification group identifier @max_notification_id The maximum identifier of removed notifications
|
|
removeNotificationGroup notification_group_id:int32 max_notification_id:int32 = Ok;
|
|
|
|
|
|
//@description Returns an HTTPS link to a message in a chat. Available only for already sent messages in supergroups and channels. This is an offline request
|
|
//@chat_id Identifier of the chat to which the message belongs
|
|
//@message_id Identifier of the message
|
|
//@for_album Pass true to create a link for the whole media album
|
|
//@for_comment Pass true to create a link to the message as a channel post comment, or from a message thread
|
|
getMessageLink chat_id:int53 message_id:int53 for_album:Bool for_comment:Bool = MessageLink;
|
|
|
|
//@description Returns an HTML code for embedding the message. Available only for messages in supergroups and channels with a username
|
|
//@chat_id Identifier of the chat to which the message belongs
|
|
//@message_id Identifier of the message
|
|
//@for_album Pass true to return an HTML code for embedding of the whole media album
|
|
getMessageEmbeddingCode chat_id:int53 message_id:int53 for_album:Bool = Text;
|
|
|
|
//@description Returns information about a public or private message link @url The message link in the format "https://t.me/c/...", or "tg://privatepost?...", or "https://t.me/username/...", or "tg://resolve?..."
|
|
getMessageLinkInfo url:string = MessageLinkInfo;
|
|
|
|
|
|
//@description Sends a message. Returns the sent message
|
|
//@chat_id Target chat
|
|
//@message_thread_id If not 0, a message thread identifier in which the message will be sent
|
|
//@reply_to_message_id Identifier of the message to reply to or 0
|
|
//@options Options to be used to send the message
|
|
//@reply_markup Markup for replying to the message; for bots only @input_message_content The content of the message to be sent
|
|
sendMessage chat_id:int53 message_thread_id:int53 reply_to_message_id:int53 options:messageSendOptions reply_markup:ReplyMarkup input_message_content:InputMessageContent = Message;
|
|
|
|
//@description Sends 2-10 messages grouped together into an album. Currently only audio, document, photo and video messages can be grouped into an album. Documents and audio files can be only grouped in an album with messages of the same type. Returns sent messages
|
|
//@chat_id Target chat
|
|
//@message_thread_id If not 0, a message thread identifier in which the messages will be sent
|
|
//@reply_to_message_id Identifier of a message to reply to or 0
|
|
//@options Options to be used to send the messages
|
|
//@input_message_contents Contents of messages to be sent. At most 10 messages can be added to an album
|
|
sendMessageAlbum chat_id:int53 message_thread_id:int53 reply_to_message_id:int53 options:messageSendOptions input_message_contents:vector<InputMessageContent> = Messages;
|
|
|
|
//@description Invites a bot to a chat (if it is not yet a member) and sends it the /start command. Bots can't be invited to a private chat other than the chat with the bot. Bots can't be invited to channels (although they can be added as admins) and secret chats. Returns the sent message
|
|
//@bot_user_id Identifier of the bot @chat_id Identifier of the target chat @parameter A hidden parameter sent to the bot for deep linking purposes (https://core.telegram.org/bots#deep-linking)
|
|
sendBotStartMessage bot_user_id:int32 chat_id:int53 parameter:string = Message;
|
|
|
|
//@description Sends the result of an inline query as a message. Returns the sent message. Always clears a chat draft message
|
|
//@chat_id Target chat
|
|
//@message_thread_id If not 0, a message thread identifier in which the message will be sent
|
|
//@reply_to_message_id Identifier of a message to reply to or 0
|
|
//@options Options to be used to send the message
|
|
//@query_id Identifier of the inline query @result_id Identifier of the inline result
|
|
//@hide_via_bot If true, there will be no mention of a bot, via which the message is sent. Can be used only for bots GetOption("animation_search_bot_username"), GetOption("photo_search_bot_username") and GetOption("venue_search_bot_username")
|
|
sendInlineQueryResultMessage chat_id:int53 message_thread_id:int53 reply_to_message_id:int53 options:messageSendOptions query_id:int64 result_id:string hide_via_bot:Bool = Message;
|
|
|
|
//@description Forwards previously sent messages. Returns the forwarded messages in the same order as the message identifiers passed in message_ids. If a message can't be forwarded, null will be returned instead of the message
|
|
//@chat_id Identifier of the chat to which to forward messages
|
|
//@from_chat_id Identifier of the chat from which to forward messages
|
|
//@message_ids Identifiers of the messages to forward. Message identifiers must be in a strictly increasing order. At most 100 messages can be forwarded simultaneously
|
|
//@options Options to be used to send the messages
|
|
//@send_copy True, if content of the messages needs to be copied without links to the original messages. Always true if the messages are forwarded to a secret chat
|
|
//@remove_caption True, if media caption of message copies needs to be removed. Ignored if send_copy is false
|
|
forwardMessages chat_id:int53 from_chat_id:int53 message_ids:vector<int53> options:messageSendOptions send_copy:Bool remove_caption:Bool = Messages;
|
|
|
|
//@description Resends messages which failed to send. Can be called only for messages for which messageSendingStateFailed.can_retry is true and after specified in messageSendingStateFailed.retry_after time passed.
|
|
//-If a message is re-sent, the corresponding failed to send message is deleted. Returns the sent messages in the same order as the message identifiers passed in message_ids. If a message can't be re-sent, null will be returned instead of the message
|
|
//@chat_id Identifier of the chat to send messages @message_ids Identifiers of the messages to resend. Message identifiers must be in a strictly increasing order
|
|
resendMessages chat_id:int53 message_ids:vector<int53> = Messages;
|
|
|
|
//@description Sends a notification about a screenshot taken in a chat. Supported only in private and secret chats @chat_id Chat identifier
|
|
sendChatScreenshotTakenNotification chat_id:int53 = Ok;
|
|
|
|
//@description Adds a local message to a chat. The message is persistent across application restarts only if the message database is used. Returns the added message
|
|
//@chat_id Target chat
|
|
//@sender The sender sender of the message
|
|
//@reply_to_message_id Identifier of the message to reply to or 0
|
|
//@disable_notification Pass true to disable notification for the message
|
|
//@input_message_content The content of the message to be added
|
|
addLocalMessage chat_id:int53 sender:MessageSender reply_to_message_id:int53 disable_notification:Bool input_message_content:InputMessageContent = Message;
|
|
|
|
//@description Deletes messages @chat_id Chat identifier @message_ids Identifiers of the messages to be deleted @revoke Pass true to try to delete messages for all chat members. Always true for supergroups, channels and secret chats
|
|
deleteMessages chat_id:int53 message_ids:vector<int53> revoke:Bool = Ok;
|
|
|
|
//@description Deletes all messages sent by the specified user to a chat. Supported only for supergroups; requires can_delete_messages administrator privileges @chat_id Chat identifier @user_id User identifier
|
|
deleteChatMessagesFromUser chat_id:int53 user_id:int32 = Ok;
|
|
|
|
|
|
//@description Edits the text of a message (or a text of a game message). Returns the edited message after the edit is completed on the server side
|
|
//@chat_id The chat the message belongs to @message_id Identifier of the message @reply_markup The new message reply markup; for bots only @input_message_content New text content of the message. Should be of type InputMessageText
|
|
editMessageText chat_id:int53 message_id:int53 reply_markup:ReplyMarkup input_message_content:InputMessageContent = Message;
|
|
|
|
//@description Edits the message content of a live location. Messages can be edited for a limited period of time specified in the live location. Returns the edited message after the edit is completed on the server side
|
|
//@chat_id The chat the message belongs to @message_id Identifier of the message @reply_markup The new message reply markup; for bots only @location New location content of the message; may be null. Pass null to stop sharing the live location
|
|
//@heading The new direction in which the location moves, in degrees; 1-360. Pass 0 if unknown
|
|
//@proximity_alert_radius The new maximum distance for proximity alerts, in meters (0-100000). Pass 0 if the notification is disabled
|
|
editMessageLiveLocation chat_id:int53 message_id:int53 reply_markup:ReplyMarkup location:location heading:int32 proximity_alert_radius:int32 = Message;
|
|
|
|
//@description Edits the content of a message with an animation, an audio, a document, a photo or a video. The media in the message can't be replaced if the message was set to self-destruct. Media can't be replaced by self-destructing media. Media in an album can be edited only to contain a photo or a video. Returns the edited message after the edit is completed on the server side
|
|
//@chat_id The chat the message belongs to @message_id Identifier of the message @reply_markup The new message reply markup; for bots only @input_message_content New content of the message. Must be one of the following types: InputMessageAnimation, InputMessageAudio, InputMessageDocument, InputMessagePhoto or InputMessageVideo
|
|
editMessageMedia chat_id:int53 message_id:int53 reply_markup:ReplyMarkup input_message_content:InputMessageContent = Message;
|
|
|
|
//@description Edits the message content caption. Returns the edited message after the edit is completed on the server side
|
|
//@chat_id The chat the message belongs to @message_id Identifier of the message @reply_markup The new message reply markup; for bots only @caption New message content caption; 0-GetOption("message_caption_length_max") characters
|
|
editMessageCaption chat_id:int53 message_id:int53 reply_markup:ReplyMarkup caption:formattedText = Message;
|
|
|
|
//@description Edits the message reply markup; for bots only. Returns the edited message after the edit is completed on the server side
|
|
//@chat_id The chat the message belongs to @message_id Identifier of the message @reply_markup The new message reply markup
|
|
editMessageReplyMarkup chat_id:int53 message_id:int53 reply_markup:ReplyMarkup = Message;
|
|
|
|
//@description Edits the text of an inline text or game message sent via a bot; for bots only @inline_message_id Inline message identifier @reply_markup The new message reply markup @input_message_content New text content of the message. Should be of type InputMessageText
|
|
editInlineMessageText inline_message_id:string reply_markup:ReplyMarkup input_message_content:InputMessageContent = Ok;
|
|
|
|
//@description Edits the content of a live location in an inline message sent via a bot; for bots only @inline_message_id Inline message identifier @reply_markup The new message reply markup
|
|
//@location New location content of the message; may be null. Pass null to stop sharing the live location
|
|
//@heading The new direction in which the location moves, in degrees; 1-360. Pass 0 if unknown
|
|
//@proximity_alert_radius The new maximum distance for proximity alerts, in meters (0-100000). Pass 0 if the notification is disabled
|
|
editInlineMessageLiveLocation inline_message_id:string reply_markup:ReplyMarkup location:location heading:int32 proximity_alert_radius:int32 = Ok;
|
|
|
|
//@description Edits the content of a message with an animation, an audio, a document, a photo or a video in an inline message sent via a bot; for bots only @inline_message_id Inline message identifier
|
|
//@reply_markup The new message reply markup; for bots only @input_message_content New content of the message. Must be one of the following types: InputMessageAnimation, InputMessageAudio, InputMessageDocument, InputMessagePhoto or InputMessageVideo
|
|
editInlineMessageMedia inline_message_id:string reply_markup:ReplyMarkup input_message_content:InputMessageContent = Ok;
|
|
|
|
//@description Edits the caption of an inline message sent via a bot; for bots only @inline_message_id Inline message identifier @reply_markup The new message reply markup @caption New message content caption; 0-GetOption("message_caption_length_max") characters
|
|
editInlineMessageCaption inline_message_id:string reply_markup:ReplyMarkup caption:formattedText = Ok;
|
|
|
|
//@description Edits the reply markup of an inline message sent via a bot; for bots only @inline_message_id Inline message identifier @reply_markup The new message reply markup
|
|
editInlineMessageReplyMarkup inline_message_id:string reply_markup:ReplyMarkup = Ok;
|
|
|
|
//@description Edits the time when a scheduled message will be sent. Scheduling state of all messages in the same album or forwarded together with the message will be also changed @chat_id The chat the message belongs to @message_id Identifier of the message @scheduling_state The new message scheduling state. Pass null to send the message immediately
|
|
editMessageSchedulingState chat_id:int53 message_id:int53 scheduling_state:MessageSchedulingState = Ok;
|
|
|
|
|
|
//@description Returns all entities (mentions, hashtags, cashtags, bot commands, bank card numbers, URLs, and email addresses) contained in the text. Can be called synchronously @text The text in which to look for entites
|
|
getTextEntities text:string = TextEntities;
|
|
|
|
//@description Parses Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities contained in the text. Can be called synchronously @text The text to parse @parse_mode Text parse mode
|
|
parseTextEntities text:string parse_mode:TextParseMode = FormattedText;
|
|
|
|
//@description Parses Markdown entities in a human-friendly format, ignoring markup errors. Can be called synchronously
|
|
//@text The text to parse. For example, "__italic__ ~~strikethrough~~ **bold** `code` ```pre``` __[italic__ text_url](telegram.org) __italic**bold italic__bold**"
|
|
parseMarkdown text:formattedText = FormattedText;
|
|
|
|
//@description Replaces text entities with Markdown formatting in a human-friendly format. Entities that can't be represented in Markdown unambiguously are kept as is. Can be called synchronously @text The text
|
|
getMarkdownText text:formattedText = FormattedText;
|
|
|
|
//@description Returns the MIME type of a file, guessed by its extension. Returns an empty string on failure. Can be called synchronously @file_name The name of the file or path to the file
|
|
getFileMimeType file_name:string = Text;
|
|
|
|
//@description Returns the extension of a file, guessed by its MIME type. Returns an empty string on failure. Can be called synchronously @mime_type The MIME type of the file
|
|
getFileExtension mime_type:string = Text;
|
|
|
|
//@description Removes potentially dangerous characters from the name of a file. The encoding of the file name is supposed to be UTF-8. Returns an empty string on failure. Can be called synchronously @file_name File name or path to the file
|
|
cleanFileName file_name:string = Text;
|
|
|
|
//@description Returns a string stored in the local database from the specified localization target and language pack by its key. Returns a 404 error if the string is not found. Can be called synchronously
|
|
//@language_pack_database_path Path to the language pack database in which strings are stored @localization_target Localization target to which the language pack belongs @language_pack_id Language pack identifier @key Language pack key of the string to be returned
|
|
getLanguagePackString language_pack_database_path:string localization_target:string language_pack_id:string key:string = LanguagePackStringValue;
|
|
|
|
//@description Converts a JSON-serialized string to corresponding JsonValue object. Can be called synchronously @json The JSON-serialized string
|
|
getJsonValue json:string = JsonValue;
|
|
|
|
//@description Converts a JsonValue object to corresponding JSON-serialized string. Can be called synchronously @json_value The JsonValue object
|
|
getJsonString json_value:JsonValue = Text;
|
|
|
|
|
|
//@description Changes the user answer to a poll. A poll in quiz mode can be answered only once
|
|
//@chat_id Identifier of the chat to which the poll belongs @message_id Identifier of the message containing the poll
|
|
//@option_ids 0-based identifiers of answer options, chosen by the user. User can choose more than 1 answer option only is the poll allows multiple answers
|
|
setPollAnswer chat_id:int53 message_id:int53 option_ids:vector<int32> = Ok;
|
|
|
|
//@description Returns users voted for the specified option in a non-anonymous polls. For the optimal performance the number of returned users is chosen by the library
|
|
//@chat_id Identifier of the chat to which the poll belongs @message_id Identifier of the message containing the poll
|
|
//@option_id 0-based identifier of the answer option
|
|
//@offset Number of users to skip in the result; must be non-negative
|
|
//@limit The maximum number of users to be returned; must be positive and can't be greater than 50. Fewer users may be returned than specified by the limit, even if the end of the voter list has not been reached
|
|
getPollVoters chat_id:int53 message_id:int53 option_id:int32 offset:int32 limit:int32 = Users;
|
|
|
|
//@description Stops a poll. A poll in a message can be stopped when the message has can_be_edited flag set
|
|
//@chat_id Identifier of the chat to which the poll belongs @message_id Identifier of the message containing the poll @reply_markup The new message reply markup; for bots only
|
|
stopPoll chat_id:int53 message_id:int53 reply_markup:ReplyMarkup = Ok;
|
|
|
|
|
|
//@description Hides a suggested action @action Suggested action to hide
|
|
hideSuggestedAction action:SuggestedAction = Ok;
|
|
|
|
|
|
//@description Returns information about a button of type inlineKeyboardButtonTypeLoginUrl. The method needs to be called when the user presses the button
|
|
//@chat_id Chat identifier of the message with the button @message_id Message identifier of the message with the button @button_id Button identifier
|
|
getLoginUrlInfo chat_id:int53 message_id:int53 button_id:int32 = LoginUrlInfo;
|
|
|
|
//@description Returns an HTTP URL which can be used to automatically authorize the user on a website after clicking an inline button of type inlineKeyboardButtonTypeLoginUrl.
|
|
//-Use the method getLoginUrlInfo to find whether a prior user confirmation is needed. If an error is returned, then the button must be handled as an ordinary URL button
|
|
//@chat_id Chat identifier of the message with the button @message_id Message identifier of the message with the button @button_id Button identifier
|
|
//@allow_write_access True, if the user allowed the bot to send them messages
|
|
getLoginUrl chat_id:int53 message_id:int53 button_id:int32 allow_write_access:Bool = HttpUrl;
|
|
|
|
|
|
//@description Sends an inline query to a bot and returns its results. Returns an error with code 502 if the bot fails to answer the query before the query timeout expires @bot_user_id The identifier of the target bot
|
|
//@chat_id Identifier of the chat where the query was sent @user_location Location of the user, only if needed @query Text of the query @offset Offset of the first entry to return
|
|
getInlineQueryResults bot_user_id:int32 chat_id:int53 user_location:location query:string offset:string = InlineQueryResults;
|
|
|
|
//@description Sets the result of an inline query; for bots only @inline_query_id Identifier of the inline query @is_personal True, if the result of the query can be cached for the specified user
|
|
//@results The results of the query @cache_time Allowed time to cache the results of the query, in seconds @next_offset Offset for the next inline query; pass an empty string if there are no more results
|
|
//@switch_pm_text If non-empty, this text should be shown on the button that opens a private chat with the bot and sends a start message to the bot with the parameter switch_pm_parameter @switch_pm_parameter The parameter for the bot start message
|
|
answerInlineQuery inline_query_id:int64 is_personal:Bool results:vector<InputInlineQueryResult> cache_time:int32 next_offset:string switch_pm_text:string switch_pm_parameter:string = Ok;
|
|
|
|
|
|
//@description Sends a callback query to a bot and returns an answer. Returns an error with code 502 if the bot fails to answer the query before the query timeout expires @chat_id Identifier of the chat with the message @message_id Identifier of the message from which the query originated @payload Query payload
|
|
getCallbackQueryAnswer chat_id:int53 message_id:int53 payload:CallbackQueryPayload = CallbackQueryAnswer;
|
|
|
|
//@description Sets the result of a callback query; for bots only @callback_query_id Identifier of the callback query @text Text of the answer @show_alert If true, an alert should be shown to the user instead of a toast notification @url URL to be opened @cache_time Time during which the result of the query can be cached, in seconds
|
|
answerCallbackQuery callback_query_id:int64 text:string show_alert:Bool url:string cache_time:int32 = Ok;
|
|
|
|
|
|
//@description Sets the result of a shipping query; for bots only @shipping_query_id Identifier of the shipping query @shipping_options Available shipping options @error_message An error message, empty on success
|
|
answerShippingQuery shipping_query_id:int64 shipping_options:vector<shippingOption> error_message:string = Ok;
|
|
|
|
//@description Sets the result of a pre-checkout query; for bots only @pre_checkout_query_id Identifier of the pre-checkout query @error_message An error message, empty on success
|
|
answerPreCheckoutQuery pre_checkout_query_id:int64 error_message:string = Ok;
|
|
|
|
|
|
//@description Updates the game score of the specified user in the game; for bots only @chat_id The chat to which the message with the game belongs @message_id Identifier of the message @edit_message True, if the message should be edited @user_id User identifier @score The new score
|
|
//@force Pass true to update the score even if it decreases. If the score is 0, the user will be deleted from the high score table
|
|
setGameScore chat_id:int53 message_id:int53 edit_message:Bool user_id:int32 score:int32 force:Bool = Message;
|
|
|
|
//@description Updates the game score of the specified user in a game; for bots only @inline_message_id Inline message identifier @edit_message True, if the message should be edited @user_id User identifier @score The new score
|
|
//@force Pass true to update the score even if it decreases. If the score is 0, the user will be deleted from the high score table
|
|
setInlineGameScore inline_message_id:string edit_message:Bool user_id:int32 score:int32 force:Bool = Ok;
|
|
|
|
//@description Returns the high scores for a game and some part of the high score table in the range of the specified user; for bots only @chat_id The chat that contains the message with the game @message_id Identifier of the message @user_id User identifier
|
|
getGameHighScores chat_id:int53 message_id:int53 user_id:int32 = GameHighScores;
|
|
|
|
//@description Returns game high scores and some part of the high score table in the range of the specified user; for bots only @inline_message_id Inline message identifier @user_id User identifier
|
|
getInlineGameHighScores inline_message_id:string user_id:int32 = GameHighScores;
|
|
|
|
|
|
//@description Deletes the default reply markup from a chat. Must be called after a one-time keyboard or a ForceReply reply markup has been used. UpdateChatReplyMarkup will be sent if the reply markup will be changed @chat_id Chat identifier
|
|
//@message_id The message identifier of the used keyboard
|
|
deleteChatReplyMarkup chat_id:int53 message_id:int53 = Ok;
|
|
|
|
|
|
//@description Sends a notification about user activity in a chat @chat_id Chat identifier @message_thread_id If not 0, a message thread identifier in which the action was performed @action The action description
|
|
sendChatAction chat_id:int53 message_thread_id:int53 action:ChatAction = Ok;
|
|
|
|
|
|
//@description Informs TDLib that the chat is opened by the user. Many useful activities depend on the chat being opened or closed (e.g., in supergroups and channels all updates are received only for opened chats) @chat_id Chat identifier
|
|
openChat chat_id:int53 = Ok;
|
|
|
|
//@description Informs TDLib that the chat is closed by the user. Many useful activities depend on the chat being opened or closed @chat_id Chat identifier
|
|
closeChat chat_id:int53 = Ok;
|
|
|
|
//@description Informs TDLib that messages are being viewed by the user. Many useful activities depend on whether the messages are currently being viewed or not (e.g., marking messages as read, incrementing a view counter, updating a view counter, removing deleted messages in supergroups and channels)
|
|
//@chat_id Chat identifier
|
|
//@message_thread_id If not 0, a message thread identifier in which the messages are being viewed
|
|
//@message_ids The identifiers of the messages being viewed
|
|
//@force_read True, if messages in closed chats should be marked as read by the request
|
|
viewMessages chat_id:int53 message_thread_id:int53 message_ids:vector<int53> force_read:Bool = Ok;
|
|
|
|
//@description Informs TDLib that the message content has been opened (e.g., the user has opened a photo, video, document, location or venue, or has listened to an audio file or voice note message). An updateMessageContentOpened update will be generated if something has changed @chat_id Chat identifier of the message @message_id Identifier of the message with the opened content
|
|
openMessageContent chat_id:int53 message_id:int53 = Ok;
|
|
|
|
//@description Returns information about an action to be done when the current user clicks an HTTP link. This method can be used to automatically authorize the current user on a website. Don't use this method for links from secret chats if link preview is disabled in secret chats @link The HTTP link
|
|
getExternalLinkInfo link:string = LoginUrlInfo;
|
|
|
|
//@description Returns an HTTP URL which can be used to automatically authorize the current user on a website after clicking an HTTP link. Use the method getExternalLinkInfo to find whether a prior user confirmation is needed
|
|
//@link The HTTP link @allow_write_access True, if the current user allowed the bot, returned in getExternalLinkInfo, to send them messages
|
|
getExternalLink link:string allow_write_access:Bool = HttpUrl;
|
|
|
|
|
|
//@description Marks all mentions in a chat as read @chat_id Chat identifier
|
|
readAllChatMentions chat_id:int53 = Ok;
|
|
|
|
|
|
//@description Returns an existing chat corresponding to a given user @user_id User identifier @force If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect
|
|
createPrivateChat user_id:int32 force:Bool = Chat;
|
|
|
|
//@description Returns an existing chat corresponding to a known basic group @basic_group_id Basic group identifier @force If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect
|
|
createBasicGroupChat basic_group_id:int32 force:Bool = Chat;
|
|
|
|
//@description Returns an existing chat corresponding to a known supergroup or channel @supergroup_id Supergroup or channel identifier @force If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect
|
|
createSupergroupChat supergroup_id:int32 force:Bool = Chat;
|
|
|
|
//@description Returns an existing chat corresponding to a known secret chat @secret_chat_id Secret chat identifier
|
|
createSecretChat secret_chat_id:int32 = Chat;
|
|
|
|
//@description Creates a new basic group and sends a corresponding messageBasicGroupChatCreate. Returns the newly created chat @user_ids Identifiers of users to be added to the basic group @title Title of the new basic group; 1-128 characters
|
|
createNewBasicGroupChat user_ids:vector<int32> title:string = Chat;
|
|
|
|
//@description Creates a new supergroup or channel and sends a corresponding messageSupergroupChatCreate. Returns the newly created chat
|
|
//@title Title of the new chat; 1-128 characters
|
|
//@is_channel True, if a channel chat needs to be created
|
|
//@param_description Chat description; 0-255 characters
|
|
//@location Chat location if a location-based supergroup is being created
|
|
//@for_import True, if the supergroup is created for importing messages using importMessage
|
|
createNewSupergroupChat title:string is_channel:Bool description:string location:chatLocation for_import:Bool = Chat;
|
|
|
|
//@description Creates a new secret chat. Returns the newly created chat @user_id Identifier of the target user
|
|
createNewSecretChat user_id:int32 = Chat;
|
|
|
|
//@description Creates a new supergroup from an existing basic group and sends a corresponding messageChatUpgradeTo and messageChatUpgradeFrom; requires creator privileges. Deactivates the original basic group @chat_id Identifier of the chat to upgrade
|
|
upgradeBasicGroupChatToSupergroupChat chat_id:int53 = Chat;
|
|
|
|
|
|
//@description Returns chat lists to which the chat can be added. This is an offline request @chat_id Chat identifier
|
|
getChatListsToAddChat chat_id:int53 = ChatLists;
|
|
|
|
//@description Adds a chat to a chat list. A chat can't be simultaneously in Main and Archive chat lists, so it is automatically removed from another one if needed
|
|
//@chat_id Chat identifier @chat_list The chat list. Use getChatListsToAddChat to get suitable chat lists
|
|
addChatToList chat_id:int53 chat_list:ChatList = Ok;
|
|
|
|
//@description Returns information about a chat filter by its identifier @chat_filter_id Chat filter identifier
|
|
getChatFilter chat_filter_id:int32 = ChatFilter;
|
|
|
|
//@description Creates new chat filter. Returns information about the created chat filter @filter Chat filter
|
|
createChatFilter filter:chatFilter = ChatFilterInfo;
|
|
|
|
//@description Edits existing chat filter. Returns information about the edited chat filter @chat_filter_id Chat filter identifier @filter The edited chat filter
|
|
editChatFilter chat_filter_id:int32 filter:chatFilter = ChatFilterInfo;
|
|
|
|
//@description Deletes existing chat filter @chat_filter_id Chat filter identifier
|
|
deleteChatFilter chat_filter_id:int32 = Ok;
|
|
|
|
//@description Changes the order of chat filters @chat_filter_ids Identifiers of chat filters in the new correct order
|
|
reorderChatFilters chat_filter_ids:vector<int32> = Ok;
|
|
|
|
//@description Returns recommended chat filters for the current user
|
|
getRecommendedChatFilters = RecommendedChatFilters;
|
|
|
|
//@description Returns default icon name for a filter. Can be called synchronously @filter Chat filter
|
|
getChatFilterDefaultIconName filter:chatFilter = Text;
|
|
|
|
|
|
//@description Changes the chat title. Supported only for basic groups, supergroups and channels. Requires can_change_info administrator right
|
|
//@chat_id Chat identifier @title New title of the chat; 1-128 characters
|
|
setChatTitle chat_id:int53 title:string = Ok;
|
|
|
|
//@description Changes the photo of a chat. Supported only for basic groups, supergroups and channels. Requires can_change_info administrator right
|
|
//@chat_id Chat identifier @photo New chat photo. Pass null to delete the chat photo
|
|
setChatPhoto chat_id:int53 photo:InputChatPhoto = Ok;
|
|
|
|
//@description Changes the message TTL setting (sets a new self-destruct timer) in a chat. Requires can_delete_messages administrator right in basic groups, supergroups and channels
|
|
//-Message TTL setting of a chat with the current user (Saved Messages) and the chat 777000 (Telegram) can't be changed
|
|
//@chat_id Chat identifier @ttl New TTL value, in seconds; must be one of 0, 86400, 604800 unless chat is secret
|
|
setChatMessageTtlSetting chat_id:int53 ttl:int32 = Ok;
|
|
|
|
//@description Changes the chat members permissions. Supported only for basic groups and supergroups. Requires can_restrict_members administrator right
|
|
//@chat_id Chat identifier @permissions New non-administrator members permissions in the chat
|
|
setChatPermissions chat_id:int53 permissions:chatPermissions = Ok;
|
|
|
|
//@description Changes the draft message in a chat @chat_id Chat identifier @message_thread_id If not 0, a message thread identifier in which the draft was changed @draft_message New draft message; may be null
|
|
setChatDraftMessage chat_id:int53 message_thread_id:int53 draft_message:draftMessage = Ok;
|
|
|
|
//@description Changes the notification settings of a chat. Notification settings of a chat with the current user (Saved Messages) can't be changed
|
|
//@chat_id Chat identifier @notification_settings New notification settings for the chat. If the chat is muted for more than 1 week, it is considered to be muted forever
|
|
setChatNotificationSettings chat_id:int53 notification_settings:chatNotificationSettings = Ok;
|
|
|
|
//@description Changes the marked as unread state of a chat @chat_id Chat identifier @is_marked_as_unread New value of is_marked_as_unread
|
|
toggleChatIsMarkedAsUnread chat_id:int53 is_marked_as_unread:Bool = Ok;
|
|
|
|
//@description Changes the value of the default disable_notification parameter, used when a message is sent to a chat @chat_id Chat identifier @default_disable_notification New value of default_disable_notification
|
|
toggleChatDefaultDisableNotification chat_id:int53 default_disable_notification:Bool = Ok;
|
|
|
|
//@description Changes application-specific data associated with a chat @chat_id Chat identifier @client_data New value of client_data
|
|
setChatClientData chat_id:int53 client_data:string = Ok;
|
|
|
|
//@description Changes information about a chat. Available for basic groups, supergroups, and channels. Requires can_change_info administrator right @chat_id Identifier of the chat @param_description New chat description; 0-255 characters
|
|
setChatDescription chat_id:int53 description:string = Ok;
|
|
|
|
//@description Changes the discussion group of a channel chat; requires can_change_info administrator right in the channel if it is specified @chat_id Identifier of the channel chat. Pass 0 to remove a link from the supergroup passed in the second argument to a linked channel chat (requires can_pin_messages rights in the supergroup) @discussion_chat_id Identifier of a new channel's discussion group. Use 0 to remove the discussion group.
|
|
//-Use the method getSuitableDiscussionChats to find all suitable groups. Basic group chats must be first upgraded to supergroup chats. If new chat members don't have access to old messages in the supergroup, then toggleSupergroupIsAllHistoryAvailable must be used first to change that
|
|
setChatDiscussionGroup chat_id:int53 discussion_chat_id:int53 = Ok;
|
|
|
|
//@description Changes the location of a chat. Available only for some location-based supergroups, use supergroupFullInfo.can_set_location to check whether the method is allowed to use @chat_id Chat identifier @location New location for the chat; must be valid and not null
|
|
setChatLocation chat_id:int53 location:chatLocation = Ok;
|
|
|
|
//@description Changes the slow mode delay of a chat. Available only for supergroups; requires can_restrict_members rights @chat_id Chat identifier @slow_mode_delay New slow mode delay for the chat; must be one of 0, 10, 30, 60, 300, 900, 3600
|
|
setChatSlowModeDelay chat_id:int53 slow_mode_delay:int32 = Ok;
|
|
|
|
//@description Pins a message in a chat; requires can_pin_messages rights or can_edit_messages rights in the channel
|
|
//@chat_id Identifier of the chat
|
|
//@message_id Identifier of the new pinned message
|
|
//@disable_notification True, if there should be no notification about the pinned message. Notifications are always disabled in channels and private chats
|
|
//@only_for_self True, if the message needs to be pinned for one side only; private chats only
|
|
pinChatMessage chat_id:int53 message_id:int53 disable_notification:Bool only_for_self:Bool = Ok;
|
|
|
|
//@description Removes a pinned message from a chat; requires can_pin_messages rights in the group or can_edit_messages rights in the channel @chat_id Identifier of the chat @message_id Identifier of the removed pinned message
|
|
unpinChatMessage chat_id:int53 message_id:int53 = Ok;
|
|
|
|
//@description Removes all pinned messages from a chat; requires can_pin_messages rights in the group or can_edit_messages rights in the channel @chat_id Identifier of the chat
|
|
unpinAllChatMessages chat_id:int53 = Ok;
|
|
|
|
|
|
//@description Adds the current user as a new member to a chat. Private and secret chats can't be joined using this method @chat_id Chat identifier
|
|
joinChat chat_id:int53 = Ok;
|
|
|
|
//@description Removes the current user from chat members. Private and secret chats can't be left using this method @chat_id Chat identifier
|
|
leaveChat chat_id:int53 = Ok;
|
|
|
|
//@description Adds a new member to a chat. Members can't be added to private or secret chats
|
|
//@chat_id Chat identifier @user_id Identifier of the user @forward_limit The number of earlier messages from the chat to be forwarded to the new member; up to 100. Ignored for supergroups and channels
|
|
addChatMember chat_id:int53 user_id:int32 forward_limit:int32 = Ok;
|
|
|
|
//@description Adds multiple new members to a chat. Currently this method is only available for supergroups and channels. This method can't be used to join a chat. Members can't be added to a channel if it has more than 200 members
|
|
//@chat_id Chat identifier @user_ids Identifiers of the users to be added to the chat. The maximum number of added users is 20 for supergroups and 100 for channels
|
|
addChatMembers chat_id:int53 user_ids:vector<int32> = Ok;
|
|
|
|
//@description Changes the status of a chat member, needs appropriate privileges. This function is currently not suitable for adding new members to the chat and transferring chat ownership; instead, use addChatMember or transferChatOwnership
|
|
//@chat_id Chat identifier @user_id User identifier @status The new status of the member in the chat
|
|
setChatMemberStatus chat_id:int53 user_id:int32 status:ChatMemberStatus = Ok;
|
|
|
|
//@description Bans a member in a chat. Members can't be banned in private or secret chats. In supergroups and channels, the user will not be able to return to the group on their own using invite links, etc., unless unbanned first
|
|
//@chat_id Chat identifier
|
|
//@user_id Identifier of the user
|
|
//@banned_until_date 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. Ignored in basic groups
|
|
//@revoke_messages Pass true to delete all messages in the chat for the user. Always true for supergroups and channels
|
|
banChatMember chat_id:int53 user_id:int32 banned_until_date:int32 revoke_messages:Bool = Ok;
|
|
|
|
//@description Checks whether the current session can be used to transfer a chat ownership to another user
|
|
canTransferOwnership = CanTransferOwnershipResult;
|
|
|
|
//@description Changes the owner of a chat. The current user must be a current owner of the chat. Use the method canTransferOwnership to check whether the ownership can be transferred from the current session. Available only for supergroups and channel chats
|
|
//@chat_id Chat identifier @user_id Identifier of the user to which transfer the ownership. The ownership can't be transferred to a bot or to a deleted user @password The password of the current user
|
|
transferChatOwnership chat_id:int53 user_id:int32 password:string = Ok;
|
|
|
|
//@description Returns information about a single member of a chat @chat_id Chat identifier @user_id User identifier
|
|
getChatMember chat_id:int53 user_id:int32 = ChatMember;
|
|
|
|
//@description Searches for a specified query in the first name, last name and username of the members of a specified chat. Requires administrator rights in channels @chat_id Chat identifier @query Query to search for @limit The maximum number of users to be returned @filter The type of users to return. By default, chatMembersFilterMembers
|
|
searchChatMembers chat_id:int53 query:string limit:int32 filter:ChatMembersFilter = ChatMembers;
|
|
|
|
//@description Returns a list of administrators of the chat with their custom titles @chat_id Chat identifier
|
|
getChatAdministrators chat_id:int53 = ChatAdministrators;
|
|
|
|
|
|
//@description Clears draft messages in all chats @exclude_secret_chats If true, local draft messages in secret chats will not be cleared
|
|
clearAllDraftMessages exclude_secret_chats:Bool = Ok;
|
|
|
|
|
|
//@description Returns list of chats with non-default notification settings @scope If specified, only chats from the specified scope will be returned @compare_sound If true, also chats with non-default sound will be returned
|
|
getChatNotificationSettingsExceptions scope:NotificationSettingsScope compare_sound:Bool = Chats;
|
|
|
|
//@description Returns the notification settings for chats of a given type @scope Types of chats for which to return the notification settings information
|
|
getScopeNotificationSettings scope:NotificationSettingsScope = ScopeNotificationSettings;
|
|
|
|
//@description Changes notification settings for chats of a given type @scope Types of chats for which to change the notification settings @notification_settings The new notification settings for the given scope
|
|
setScopeNotificationSettings scope:NotificationSettingsScope notification_settings:scopeNotificationSettings = Ok;
|
|
|
|
//@description Resets all notification settings to their default values. By default, all chats are unmuted, the sound is set to "default" and message previews are shown
|
|
resetAllNotificationSettings = Ok;
|
|
|
|
|
|
//@description Changes the pinned state of a chat. There can be up to GetOption("pinned_chat_count_max")/GetOption("pinned_archived_chat_count_max") pinned non-secret chats and the same number of secret chats in the main/arhive chat list
|
|
//@chat_list Chat list in which to change the pinned state of the chat @chat_id Chat identifier @is_pinned True, if the chat is pinned
|
|
toggleChatIsPinned chat_list:ChatList chat_id:int53 is_pinned:Bool = Ok;
|
|
|
|
//@description Changes the order of pinned chats @chat_list Chat list in which to change the order of pinned chats @chat_ids The new list of pinned chats
|
|
setPinnedChats chat_list:ChatList chat_ids:vector<int53> = Ok;
|
|
|
|
|
|
//@description Downloads a file from the cloud. Download progress and completion of the download will be notified through updateFile updates
|
|
//@file_id Identifier of the file to download
|
|
//@priority Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile was called will be downloaded first
|
|
//@offset The starting position from which the file should be downloaded
|
|
//@limit Number of bytes which should be downloaded starting from the "offset" position before the download will be automatically cancelled; use 0 to download without a limit
|
|
//@synchronous If false, this request returns file state just after the download has been started. If true, this request returns file state only after
|
|
//-the download has succeeded, has failed, has been cancelled or a new downloadFile request with different offset/limit parameters was sent
|
|
downloadFile file_id:int32 priority:int32 offset:int32 limit:int32 synchronous:Bool = File;
|
|
|
|
//@description Returns file downloaded prefix size from a given offset @file_id Identifier of the file @offset Offset from which downloaded prefix size should be calculated
|
|
getFileDownloadedPrefixSize file_id:int32 offset:int32 = Count;
|
|
|
|
//@description Stops the downloading of a file. If a file has already been downloaded, does nothing @file_id Identifier of a file to stop downloading @only_if_pending Pass true to stop downloading only if it hasn't been started, i.e. request hasn't been sent to server
|
|
cancelDownloadFile file_id:int32 only_if_pending:Bool = Ok;
|
|
|
|
//@description Asynchronously uploads a file to the cloud without sending it in a message. updateFile will be used to notify about upload progress and successful completion of the upload. The file will not have a persistent remote identifier until it will be sent in a message @file File to upload @file_type File type
|
|
//@priority Priority of the upload (1-32). The higher the priority, the earlier the file will be uploaded. If the priorities of two files are equal, then the first one for which uploadFile was called will be uploaded first
|
|
uploadFile file:InputFile file_type:FileType priority:int32 = File;
|
|
|
|
//@description Stops the uploading of a file. Supported only for files uploaded by using uploadFile. For other files the behavior is undefined @file_id Identifier of the file to stop uploading
|
|
cancelUploadFile file_id:int32 = Ok;
|
|
|
|
//@description Writes a part of a generated file. This method is intended to be used only if the application has no direct access to TDLib's file system, because it is usually slower than a direct write to the destination file
|
|
//@generation_id The identifier of the generation process @offset The offset from which to write the data to the file @data The data to write
|
|
writeGeneratedFilePart generation_id:int64 offset:int32 data:bytes = Ok;
|
|
|
|
//@description Informs TDLib on a file generation progress
|
|
//@generation_id The identifier of the generation process
|
|
//@expected_size Expected size of the generated file, in bytes; 0 if unknown
|
|
//@local_prefix_size The number of bytes already generated
|
|
setFileGenerationProgress generation_id:int64 expected_size:int32 local_prefix_size:int32 = Ok;
|
|
|
|
//@description Finishes the file generation
|
|
//@generation_id The identifier of the generation process
|
|
//@error If set, means that file generation has failed and should be terminated
|
|
finishFileGeneration generation_id:int64 error:error = Ok;
|
|
|
|
//@description Reads a part of a file from the TDLib file cache and returns read bytes. This method is intended to be used only if the application has no direct access to TDLib's file system, because it is usually slower than a direct read from the file
|
|
//@file_id Identifier of the file. The file must be located in the TDLib file cache
|
|
//@offset The offset from which to read the file
|
|
//@count Number of bytes to read. An error will be returned if there are not enough bytes available in the file from the specified position. Pass 0 to read all available data from the specified position
|
|
readFilePart file_id:int32 offset:int32 count:int32 = FilePart;
|
|
|
|
//@description Deletes a file from the TDLib file cache @file_id Identifier of the file to delete
|
|
deleteFile file_id:int32 = Ok;
|
|
|
|
|
|
//@description Returns information about a file with messages exported from another app @message_file_head Beginning of the message file; up to 100 first lines
|
|
getMessageFileType message_file_head:string = MessageFileType;
|
|
|
|
//@description Returns a confirmation text to be shown to the user before starting message import
|
|
//@chat_id Identifier of a chat to which the messages will be imported. It must be an identifier of a private chat with a mutual contact or an identifier of a supergroup chat with can_change_info administrator right
|
|
getMessageImportConfirmationText chat_id:int53 = Text;
|
|
|
|
//@description Imports messages exported from another app
|
|
//@chat_id Identifier of a chat to which the messages will be imported. It must be an identifier of a private chat with a mutual contact or an identifier of a supergroup chat with can_change_info administrator right
|
|
//@message_file File with messages to import. Only inputFileLocal and inputFileGenerated are supported. The file must not be previously uploaded
|
|
//@attached_files Files used in the imported messages. Only inputFileLocal and inputFileGenerated are supported. The files must not be previously uploaded
|
|
importMessages chat_id:int53 message_file:InputFile attached_files:vector<InputFile> = Ok;
|
|
|
|
|
|
//@description Replaces current primary invite link for a chat with a new primary invite link. Available for basic groups, supergroups, and channels. Requires administrator privileges and can_invite_users right @chat_id Chat identifier
|
|
replacePrimaryChatInviteLink chat_id:int53 = ChatInviteLink;
|
|
|
|
//@description Creates a new invite link for a chat. Available for basic groups, supergroups, and channels. Requires administrator privileges and can_invite_users right in the chat
|
|
//@chat_id Chat identifier
|
|
//@expire_date Point in time (Unix timestamp) when the link will expire; pass 0 if never
|
|
//@member_limit Maximum number of chat members that can join the chat by the link simultaneously; 0-99999; pass 0 if not limited
|
|
createChatInviteLink chat_id:int53 expire_date:int32 member_limit:int32 = ChatInviteLink;
|
|
|
|
//@description Edits a non-primary invite link for a chat. Available for basic groups, supergroups, and channels. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links
|
|
//@chat_id Chat identifier
|
|
//@invite_link Invite link to be edited
|
|
//@expire_date Point in time (Unix timestamp) when the link will expire; pass 0 if never
|
|
//@member_limit Maximum number of chat members that can join the chat by the link simultaneously; 0-99999; pass 0 if not limited
|
|
editChatInviteLink chat_id:int53 invite_link:string expire_date:int32 member_limit:int32 = ChatInviteLink;
|
|
|
|
//@description Returns information about an invite link. Requires administrator privileges and can_invite_users right in the chat to get own links and owner privileges to get other links
|
|
//@chat_id Chat identifier
|
|
//@invite_link Invite link to get
|
|
getChatInviteLink chat_id:int53 invite_link:string = ChatInviteLink;
|
|
|
|
//@description Returns list of chat administrators with number of their invite links. Requires owner privileges in the chat @chat_id Chat identifier
|
|
getChatInviteLinkCounts chat_id:int53 = ChatInviteLinkCounts;
|
|
|
|
//@description Returns invite links for a chat created by specified administrator. Requires administrator privileges and can_invite_users right in the chat to get own links and owner privileges to get other links
|
|
//@chat_id Chat identifier
|
|
//@creator_user_id User identifier of a chat administrator. Must be an identifier of the current user for non-owner
|
|
//@is_revoked Pass true if revoked links needs to be returned instead of active or expired
|
|
//@offset_date Creation date of an invite link starting after which to return invite links; use 0 to get results from the beginning
|
|
//@offset_invite_link Invite link starting after which to return invite links; use empty string to get results from the beginning
|
|
//@limit Maximum number of invite links to return
|
|
getChatInviteLinks chat_id:int53 creator_user_id:int32 is_revoked:Bool offset_date:int32 offset_invite_link:string limit:int32 = ChatInviteLinks;
|
|
|
|
//@description Returns chat members joined a chat by an invite link. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links @chat_id Chat identifier @invite_link Invite link for which to return chat members
|
|
//@offset_member A chat member from which to return next chat members; use null to get results from the beginning @limit Maximum number of chat members to return
|
|
getChatInviteLinkMembers chat_id:int53 invite_link:string offset_member:chatInviteLinkMember limit:int32 = ChatInviteLinkMembers;
|
|
|
|
//@description Revokes invite link for a chat. Available for basic groups, supergroups, and channels. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links.
|
|
//-If a primary link is revoked, then additionally to the revoked link returns new primary link
|
|
//@chat_id Chat identifier
|
|
//@invite_link Invite link to be revoked
|
|
revokeChatInviteLink chat_id:int53 invite_link:string = ChatInviteLinks;
|
|
|
|
//@description Deletes revoked chat invite links. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links @chat_id Chat identifier @invite_link Invite link to revoke
|
|
deleteRevokedChatInviteLink chat_id:int53 invite_link:string = Ok;
|
|
|
|
//@description Deletes all revoked chat invite links created by a given chat administrator. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links
|
|
//@chat_id Chat identifier
|
|
//@creator_user_id User identifier of a chat administrator, which links will be deleted. Must be an identifier of the current user for non-owner
|
|
deleteAllRevokedChatInviteLinks chat_id:int53 creator_user_id:int32 = Ok;
|
|
|
|
//@description Checks the validity of an invite link for a chat and returns information about the corresponding chat @invite_link Invite link to be checked; must have URL "t.me", "telegram.me", or "telegram.dog" and query beginning with "/joinchat/" or "/+"
|
|
checkChatInviteLink invite_link:string = ChatInviteLinkInfo;
|
|
|
|
//@description Uses an invite link to add the current user to the chat if possible
|
|
//@invite_link Invite link to import; must have URL "t.me", "telegram.me", or "telegram.dog" and query beginning with "/joinchat/" or "/+"
|
|
joinChatByInviteLink invite_link:string = Chat;
|
|
|
|
|
|
//@description Creates a new call @user_id Identifier of the user to be called @protocol Description of the call protocols supported by the application @is_video True, if a video call needs to be created
|
|
createCall user_id:int32 protocol:callProtocol is_video:Bool = CallId;
|
|
|
|
//@description Accepts an incoming call @call_id Call identifier @protocol Description of the call protocols supported by the application
|
|
acceptCall call_id:int32 protocol:callProtocol = Ok;
|
|
|
|
//@description Sends call signaling data @call_id Call identifier @data The data
|
|
sendCallSignalingData call_id:int32 data:bytes = Ok;
|
|
|
|
//@description Discards a call @call_id Call identifier @is_disconnected True, if the user was disconnected @duration The call duration, in seconds @is_video True, if the call was a video call @connection_id Identifier of the connection used during the call
|
|
discardCall call_id:int32 is_disconnected:Bool duration:int32 is_video:Bool connection_id:int64 = Ok;
|
|
|
|
//@description Sends a call rating @call_id Call identifier @rating Call rating; 1-5 @comment An optional user comment if the rating is less than 5 @problems List of the exact types of problems with the call, specified by the user
|
|
sendCallRating call_id:int32 rating:int32 comment:string problems:vector<CallProblem> = Ok;
|
|
|
|
//@description Sends debug information for a call @call_id Call identifier @debug_information Debug information in application-specific format
|
|
sendCallDebugInformation call_id:int32 debug_information:string = Ok;
|
|
|
|
|
|
//@description Returns list of user and chat, which can be used as aliases to join a voice chat in the chat @chat_id Chat identifier
|
|
getAvailableVoiceChatAliases chat_id:int53 = MessageSenders;
|
|
|
|
//@description Creates a voice chat (a group call bound to a chat). Available only for basic groups, supergroups and channels; requires can_manage_voice_chats rights @chat_id Chat identifier
|
|
createVoiceChat chat_id:int53 = GroupCallId;
|
|
|
|
//@description Returns information about a group call @group_call_id Group call identifier
|
|
getGroupCall group_call_id:int32 = GroupCall;
|
|
|
|
//@description Joins a group call
|
|
//@group_call_id Group call identifier
|
|
//@participant_alias Identifier of the group call participant, which will be used to join the call; voice chats only
|
|
//@payload Group join payload; received from tgcalls
|
|
//@source Caller synchronization source identifier; received from tgcalls
|
|
//@is_muted True, if the user's microphone is muted
|
|
//@invite_hash If non-empty, invite hash to be used to join the group call without being muted by administrators
|
|
joinGroupCall group_call_id:int32 participant_alias:MessageSender payload:groupCallPayload source:int32 is_muted:Bool invite_hash:string = GroupCallJoinResponse;
|
|
|
|
//@description Sets group call title. Requires groupCall.can_be_managed group call flag @group_call_id Group call identifier @title New group call title; 1-64 characters
|
|
setGroupCallTitle group_call_id:int32 title:string = Ok;
|
|
|
|
//@description Toggles whether new participants of a group call can be unmuted only by administrators of the group call. Requires groupCall.can_change_mute_new_participants group call flag
|
|
//@group_call_id Group call identifier @mute_new_participants New value of the mute_new_participants setting
|
|
toggleGroupCallMuteNewParticipants group_call_id:int32 mute_new_participants:Bool = Ok;
|
|
|
|
//@description Revokes invite link for a group call. Requires groupCall.can_be_managed group call flag @group_call_id Group call identifier
|
|
revokeGroupCallInviteLink group_call_id:int32 = Ok;
|
|
|
|
//@description Invites users to a group call. Sends a service message of type messageInviteToGroupCall for voice chats
|
|
//@group_call_id Group call identifier @user_ids User identifiers. At most 10 users can be invited simultaneously
|
|
inviteGroupCallParticipants group_call_id:int32 user_ids:vector<int32> = Ok;
|
|
|
|
//@description Returns invite link to a voice chat in a public chat
|
|
//@group_call_id Group call identifier
|
|
//@can_self_unmute Pass true if the invite_link should contain an invite hash, passing which to joinGroupCall would allow the invited user to unmute themself. Requires groupCall.can_be_managed group call flag
|
|
getGroupCallInviteLink group_call_id:int32 can_self_unmute:Bool = HttpUrl;
|
|
|
|
//@description Starts recording of a group call. Requires groupCall.can_be_managed group call flag @group_call_id Group call identifier @title Group call recording title; 0-64 characters
|
|
startGroupCallRecording group_call_id:int32 title:string = Ok;
|
|
|
|
//@description Ends recording of a group call. Requires groupCall.can_be_managed group call flag @group_call_id Group call identifier
|
|
endGroupCallRecording group_call_id:int32 = Ok;
|
|
|
|
//@description Informs TDLib that a group call participant speaking state has changed @group_call_id Group call identifier
|
|
//@source Group call participant's synchronization source identifier, or 0 for the current user @is_speaking True, if the user is speaking
|
|
setGroupCallParticipantIsSpeaking group_call_id:int32 source:int32 is_speaking:Bool = Ok;
|
|
|
|
//@description Toggles whether a group call participant is muted, unmuted, or allowed to unmute themself
|
|
//@group_call_id Group call identifier @participant Participant identifier @is_muted Pass true if the user must be muted and false otherwise
|
|
toggleGroupCallParticipantIsMuted group_call_id:int32 participant:MessageSender is_muted:Bool = Ok;
|
|
|
|
//@description Changes a group call participant's volume level. If the current user can manage the group call, then the participant's volume level will be changed for all users with default volume level
|
|
//@group_call_id Group call identifier @participant Participant identifier @volume_level New participant's volume level; 1-20000 in hundreds of percents
|
|
setGroupCallParticipantVolumeLevel group_call_id:int32 participant:MessageSender volume_level:int32 = Ok;
|
|
|
|
//@description Toggles whether a group call participant hand is rased
|
|
//@group_call_id Group call identifier @participant Participant identifier
|
|
//@is_hand_raised Pass true if the user's hand should be raised. Only self hand can be raised. Requires groupCall.can_be_managed group call flag to lower other's hand
|
|
toggleGroupCallParticipantIsHandRaised group_call_id:int32 participant:MessageSender is_hand_raised:Bool = Ok;
|
|
|
|
//@description Loads more group call participants. The loaded participants will be received through updates. Use the field groupCall.loaded_all_participants to check whether all participants has already been loaded
|
|
//@group_call_id Group call identifier. The group call must be previously received through getGroupCall and must be joined or being joined
|
|
//@limit Maximum number of participants to load
|
|
loadGroupCallParticipants group_call_id:int32 limit:int32 = Ok;
|
|
|
|
//@description Leaves a group call @group_call_id Group call identifier
|
|
leaveGroupCall group_call_id:int32 = Ok;
|
|
|
|
//@description Discards a group call. Requires groupCall.can_be_managed @group_call_id Group call identifier
|
|
discardGroupCall group_call_id:int32 = Ok;
|
|
|
|
//@description Returns a file with a segment of a group call stream in a modified OGG format
|
|
//@group_call_id Group call identifier
|
|
//@time_offset Point in time when the stream segment begins; Unix timestamp in milliseconds
|
|
//@scale Segment duration scale; 0-1. Segment's duration is 1000/(2**scale) milliseconds
|
|
getGroupCallStreamSegment group_call_id:int32 time_offset:int53 scale:int32 = FilePart;
|
|
|
|
|
|
//@description Changes the block state of a message sender. Currently, only users and supergroup chats can be blocked @sender Message Sender @is_blocked New value of is_blocked
|
|
toggleMessageSenderIsBlocked sender:MessageSender is_blocked:Bool = Ok;
|
|
|
|
//@description Blocks an original sender of a message in the Replies chat
|
|
//@message_id The identifier of an incoming message in the Replies chat
|
|
//@delete_message Pass true if the message must be deleted
|
|
//@delete_all_messages Pass true if all messages from the same sender must be deleted
|
|
//@report_spam Pass true if the sender must be reported to the Telegram moderators
|
|
blockMessageSenderFromReplies message_id:int53 delete_message:Bool delete_all_messages:Bool report_spam:Bool = Ok;
|
|
|
|
//@description Returns users and chats that were blocked by the current user @offset Number of users and chats to skip in the result; must be non-negative @limit The maximum number of users and chats to return; up to 100
|
|
getBlockedMessageSenders offset:int32 limit:int32 = MessageSenders;
|
|
|
|
|
|
//@description Adds a user to the contact list or edits an existing contact by their user identifier @contact The contact to add or edit; phone number can be empty and needs to be specified only if known, vCard is ignored
|
|
//@share_phone_number True, if the new contact needs to be allowed to see current user's phone number. A corresponding rule to userPrivacySettingShowPhoneNumber will be added if needed. Use the field UserFullInfo.need_phone_number_privacy_exception to check whether the current user needs to be asked to share their phone number
|
|
addContact contact:contact share_phone_number:Bool = Ok;
|
|
|
|
//@description Adds new contacts or edits existing contacts by their phone numbers; contacts' user identifiers are ignored @contacts The list of contacts to import or edit; contacts' vCard are ignored and are not imported
|
|
importContacts contacts:vector<contact> = ImportedContacts;
|
|
|
|
//@description Returns all user contacts
|
|
getContacts = Users;
|
|
|
|
//@description Searches for the specified query in the first names, last names and usernames of the known user contacts @query Query to search for; may be empty to return all contacts @limit The maximum number of users to be returned
|
|
searchContacts query:string limit:int32 = Users;
|
|
|
|
//@description Removes users from the contact list @user_ids Identifiers of users to be deleted
|
|
removeContacts user_ids:vector<int32> = Ok;
|
|
|
|
//@description Returns the total number of imported contacts
|
|
getImportedContactCount = Count;
|
|
|
|
//@description Changes imported contacts using the list of contacts saved on the device. Imports newly added contacts and, if at least the file database is enabled, deletes recently deleted contacts.
|
|
//-Query result depends on the result of the previous query, so only one query is possible at the same time @contacts The new list of contacts, contact's vCard are ignored and are not imported
|
|
changeImportedContacts contacts:vector<contact> = ImportedContacts;
|
|
|
|
//@description Clears all imported contacts, contact list remains unchanged
|
|
clearImportedContacts = Ok;
|
|
|
|
|
|
//@description Shares the phone number of the current user with a mutual contact. Supposed to be called when the user clicks on chatActionBarSharePhoneNumber @user_id Identifier of the user with whom to share the phone number. The user must be a mutual contact
|
|
sharePhoneNumber user_id:int32 = Ok;
|
|
|
|
|
|
//@description Returns the profile photos of a user. The result of this query may be outdated: some photos might have been deleted already @user_id User identifier @offset The number of photos to skip; must be non-negative @limit The maximum number of photos to be returned; up to 100
|
|
getUserProfilePhotos user_id:int32 offset:int32 limit:int32 = ChatPhotos;
|
|
|
|
|
|
//@description Returns stickers from the installed sticker sets that correspond to a given emoji. If the emoji is not empty, favorite and recently used stickers may also be returned @emoji String representation of emoji. If empty, returns all known installed stickers @limit The maximum number of stickers to be returned
|
|
getStickers emoji:string limit:int32 = Stickers;
|
|
|
|
//@description Searches for stickers from public sticker sets that correspond to a given emoji @emoji String representation of emoji; must be non-empty @limit The maximum number of stickers to be returned
|
|
searchStickers emoji:string limit:int32 = Stickers;
|
|
|
|
//@description Returns a list of installed sticker sets @is_masks Pass true to return mask sticker sets; pass false to return ordinary sticker sets
|
|
getInstalledStickerSets is_masks:Bool = StickerSets;
|
|
|
|
//@description Returns a list of archived sticker sets @is_masks Pass true to return mask stickers sets; pass false to return ordinary sticker sets @offset_sticker_set_id Identifier of the sticker set from which to return the result @limit The maximum number of sticker sets to return
|
|
getArchivedStickerSets is_masks:Bool offset_sticker_set_id:int64 limit:int32 = StickerSets;
|
|
|
|
//@description Returns a list of trending sticker sets. For the optimal performance the number of returned sticker sets is chosen by the library
|
|
//@offset The offset from which to return the sticker sets; must be non-negative
|
|
//@limit The maximum number of sticker sets to be returned; must be non-negative. Fewer sticker sets may be returned than specified by the limit, even if the end of the list has not been reached
|
|
getTrendingStickerSets offset:int32 limit:int32 = StickerSets;
|
|
|
|
//@description Returns a list of sticker sets attached to a file. Currently only photos and videos can have attached sticker sets @file_id File identifier
|
|
getAttachedStickerSets file_id:int32 = StickerSets;
|
|
|
|
//@description Returns information about a sticker set by its identifier @set_id Identifier of the sticker set
|
|
getStickerSet set_id:int64 = StickerSet;
|
|
|
|
//@description Searches for a sticker set by its name @name Name of the sticker set
|
|
searchStickerSet name:string = StickerSet;
|
|
|
|
//@description Searches for installed sticker sets by looking for specified query in their title and name @is_masks Pass true to return mask sticker sets; pass false to return ordinary sticker sets @query Query to search for @limit The maximum number of sticker sets to return
|
|
searchInstalledStickerSets is_masks:Bool query:string limit:int32 = StickerSets;
|
|
|
|
//@description Searches for ordinary sticker sets by looking for specified query in their title and name. Excludes installed sticker sets from the results @query Query to search for
|
|
searchStickerSets query:string = StickerSets;
|
|
|
|
//@description Installs/uninstalls or activates/archives a sticker set @set_id Identifier of the sticker set @is_installed The new value of is_installed @is_archived The new value of is_archived. A sticker set can't be installed and archived simultaneously
|
|
changeStickerSet set_id:int64 is_installed:Bool is_archived:Bool = Ok;
|
|
|
|
//@description Informs the server that some trending sticker sets have been viewed by the user @sticker_set_ids Identifiers of viewed trending sticker sets
|
|
viewTrendingStickerSets sticker_set_ids:vector<int64> = Ok;
|
|
|
|
//@description Changes the order of installed sticker sets @is_masks Pass true to change the order of mask sticker sets; pass false to change the order of ordinary sticker sets @sticker_set_ids Identifiers of installed sticker sets in the new correct order
|
|
reorderInstalledStickerSets is_masks:Bool sticker_set_ids:vector<int64> = Ok;
|
|
|
|
//@description Returns a list of recently used stickers @is_attached Pass true to return stickers and masks that were recently attached to photos or video files; pass false to return recently sent stickers
|
|
getRecentStickers is_attached:Bool = Stickers;
|
|
|
|
//@description Manually adds a new sticker to the list of recently used stickers. The new sticker is added to the top of the list. If the sticker was already in the list, it is removed from the list first. Only stickers belonging to a sticker set can be added to this list
|
|
//@is_attached Pass true to add the sticker to the list of stickers recently attached to photo or video files; pass false to add the sticker to the list of recently sent stickers @sticker Sticker file to add
|
|
addRecentSticker is_attached:Bool sticker:InputFile = Stickers;
|
|
|
|
//@description Removes a sticker from the list of recently used stickers @is_attached Pass true to remove the sticker from the list of stickers recently attached to photo or video files; pass false to remove the sticker from the list of recently sent stickers @sticker Sticker file to delete
|
|
removeRecentSticker is_attached:Bool sticker:InputFile = Ok;
|
|
|
|
//@description Clears the list of recently used stickers @is_attached Pass true to clear the list of stickers recently attached to photo or video files; pass false to clear the list of recently sent stickers
|
|
clearRecentStickers is_attached:Bool = Ok;
|
|
|
|
//@description Returns favorite stickers
|
|
getFavoriteStickers = Stickers;
|
|
|
|
//@description Adds a new sticker to the list of favorite stickers. The new sticker is added to the top of the list. If the sticker was already in the list, it is removed from the list first. Only stickers belonging to a sticker set can be added to this list
|
|
//@sticker Sticker file to add
|
|
addFavoriteSticker sticker:InputFile = Ok;
|
|
|
|
//@description Removes a sticker from the list of favorite stickers @sticker Sticker file to delete from the list
|
|
removeFavoriteSticker sticker:InputFile = Ok;
|
|
|
|
//@description Returns emoji corresponding to a sticker. The list is only for informational purposes, because a sticker is always sent with a fixed emoji from the corresponding Sticker object @sticker Sticker file identifier
|
|
getStickerEmojis sticker:InputFile = Emojis;
|
|
|
|
//@description Searches for emojis by keywords. Supported only if the file database is enabled @text Text to search for @exact_match True, if only emojis, which exactly match text needs to be returned @input_language_codes List of possible IETF language tags of the user's input language; may be empty if unknown
|
|
searchEmojis text:string exact_match:Bool input_language_codes:vector<string> = Emojis;
|
|
|
|
//@description Returns an HTTP URL which can be used to automatically log in to the translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation @language_code Language code for which the emoji replacements will be suggested
|
|
getEmojiSuggestionsUrl language_code:string = HttpUrl;
|
|
|
|
|
|
//@description Returns saved animations
|
|
getSavedAnimations = Animations;
|
|
|
|
//@description Manually adds a new animation to the list of saved animations. The new animation is added to the beginning of the list. If the animation was already in the list, it is removed first. Only non-secret video animations with MIME type "video/mp4" can be added to the list
|
|
//@animation The animation file to be added. Only animations known to the server (i.e. successfully sent via a message) can be added to the list
|
|
addSavedAnimation animation:InputFile = Ok;
|
|
|
|
//@description Removes an animation from the list of saved animations @animation Animation file to be removed
|
|
removeSavedAnimation animation:InputFile = Ok;
|
|
|
|
|
|
//@description Returns up to 20 recently used inline bots in the order of their last usage
|
|
getRecentInlineBots = Users;
|
|
|
|
|
|
//@description Searches for recently used hashtags by their prefix @prefix Hashtag prefix to search for @limit The maximum number of hashtags to be returned
|
|
searchHashtags prefix:string limit:int32 = Hashtags;
|
|
|
|
//@description Removes a hashtag from the list of recently used hashtags @hashtag Hashtag to delete
|
|
removeRecentHashtag hashtag:string = Ok;
|
|
|
|
|
|
//@description Returns a web page preview by the text of the message. Do not call this function too often. Returns a 404 error if the web page has no preview @text Message text with formatting
|
|
getWebPagePreview text:formattedText = WebPage;
|
|
|
|
//@description Returns an instant view version of a web page if available. Returns a 404 error if the web page has no instant view page @url The web page URL @force_full If true, the full instant view for the web page will be returned
|
|
getWebPageInstantView url:string force_full:Bool = WebPageInstantView;
|
|
|
|
|
|
//@description Changes a profile photo for the current user @photo Profile photo to set
|
|
setProfilePhoto photo:InputChatPhoto = Ok;
|
|
|
|
//@description Deletes a profile photo @profile_photo_id Identifier of the profile photo to delete
|
|
deleteProfilePhoto profile_photo_id:int64 = Ok;
|
|
|
|
//@description Changes the first and last name of the current user @first_name The new value of the first name for the user; 1-64 characters @last_name The new value of the optional last name for the user; 0-64 characters
|
|
setName first_name:string last_name:string = Ok;
|
|
|
|
//@description Changes the bio of the current user @bio The new value of the user bio; 0-70 characters without line feeds
|
|
setBio bio:string = Ok;
|
|
|
|
//@description Changes the username of the current user @username The new value of the username. Use an empty string to remove the username
|
|
setUsername username:string = Ok;
|
|
|
|
//@description Changes the location of the current user. Needs to be called if GetOption("is_location_visible") is true and location changes for more than 1 kilometer @location The new location of the user
|
|
setLocation location:location = Ok;
|
|
|
|
//@description Changes the phone number of the user and sends an authentication code to the user's new phone number. On success, returns information about the sent code
|
|
//@phone_number The new phone number of the user in international format @settings Settings for the authentication of the user's phone number
|
|
changePhoneNumber phone_number:string settings:phoneNumberAuthenticationSettings = AuthenticationCodeInfo;
|
|
|
|
//@description Re-sends the authentication code sent to confirm a new phone number for the user. Works only if the previously received authenticationCodeInfo next_code_type was not null
|
|
resendChangePhoneNumberCode = AuthenticationCodeInfo;
|
|
|
|
//@description Checks the authentication code sent to confirm a new phone number of the user @code Verification code received by SMS, phone call or flash call
|
|
checkChangePhoneNumberCode code:string = Ok;
|
|
|
|
//@description Sets the list of commands supported by the bot; for bots only @commands List of the bot's commands
|
|
setCommands commands:vector<botCommand> = Ok;
|
|
|
|
|
|
//@description Returns all active sessions of the current user
|
|
getActiveSessions = Sessions;
|
|
|
|
//@description Terminates a session of the current user @session_id Session identifier
|
|
terminateSession session_id:int64 = Ok;
|
|
|
|
//@description Terminates all other sessions of the current user
|
|
terminateAllOtherSessions = Ok;
|
|
|
|
|
|
//@description Returns all website where the current user used Telegram to log in
|
|
getConnectedWebsites = ConnectedWebsites;
|
|
|
|
//@description Disconnects website from the current user's Telegram account @website_id Website identifier
|
|
disconnectWebsite website_id:int64 = Ok;
|
|
|
|
//@description Disconnects all websites from the current user's Telegram account
|
|
disconnectAllWebsites = Ok;
|
|
|
|
|
|
//@description Changes the username of a supergroup or channel, requires owner privileges in the supergroup or channel @supergroup_id Identifier of the supergroup or channel @username New value of the username. Use an empty string to remove the username
|
|
setSupergroupUsername supergroup_id:int32 username:string = Ok;
|
|
|
|
//@description Changes the sticker set of a supergroup; requires can_change_info administrator right @supergroup_id Identifier of the supergroup @sticker_set_id New value of the supergroup sticker set identifier. Use 0 to remove the supergroup sticker set
|
|
setSupergroupStickerSet supergroup_id:int32 sticker_set_id:int64 = Ok;
|
|
|
|
//@description Toggles sender signatures messages sent in a channel; requires can_change_info administrator right @supergroup_id Identifier of the channel @sign_messages New value of sign_messages
|
|
toggleSupergroupSignMessages supergroup_id:int32 sign_messages:Bool = Ok;
|
|
|
|
//@description Toggles whether the message history of a supergroup is available to new members; requires can_change_info administrator right @supergroup_id The identifier of the supergroup @is_all_history_available The new value of is_all_history_available
|
|
toggleSupergroupIsAllHistoryAvailable supergroup_id:int32 is_all_history_available:Bool = Ok;
|
|
|
|
//@description Upgrades supergroup to a broadcast group; requires owner privileges in the supergroup @supergroup_id Identifier of the supergroup
|
|
toggleSupergroupIsBroadcastGroup supergroup_id:int32 = Ok;
|
|
|
|
//@description Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup @supergroup_id Supergroup identifier @user_id User identifier @message_ids Identifiers of messages sent in the supergroup by the user. This list must be non-empty
|
|
reportSupergroupSpam supergroup_id:int32 user_id:int32 message_ids:vector<int53> = Ok;
|
|
|
|
//@description Returns information about members or banned users in a supergroup or channel. Can be used only if SupergroupFullInfo.can_get_members == true; additionally, administrator privileges may be required for some filters @supergroup_id Identifier of the supergroup or channel
|
|
//@filter The type of users to return. By default, supergroupMembersFilterRecent @offset Number of users to skip @limit The maximum number of users be returned; up to 200
|
|
getSupergroupMembers supergroup_id:int32 filter:SupergroupMembersFilter offset:int32 limit:int32 = ChatMembers;
|
|
|
|
|
|
//@description Closes a secret chat, effectively transferring its state to secretChatStateClosed @secret_chat_id Secret chat identifier
|
|
closeSecretChat secret_chat_id:int32 = Ok;
|
|
|
|
|
|
//@description Returns a list of service actions taken by chat members and administrators in the last 48 hours. Available only for supergroups and channels. Requires administrator rights. Returns results in reverse chronological order (i. e., in order of decreasing event_id)
|
|
//@chat_id Chat identifier @query Search query by which to filter events @from_event_id Identifier of an event from which to return results. Use 0 to get results from the latest events @limit The maximum number of events to return; up to 100
|
|
//@filters The types of events to return. By default, all types will be returned @user_ids User identifiers by which to filter events. By default, events relating to all users will be returned
|
|
getChatEventLog chat_id:int53 query:string from_event_id:int64 limit:int32 filters:chatEventLogFilters user_ids:vector<int32> = ChatEvents;
|
|
|
|
|
|
//@description Returns an invoice payment form. This method should be called when the user presses inlineKeyboardButtonBuy @chat_id Chat identifier of the Invoice message @message_id Message identifier
|
|
getPaymentForm chat_id:int53 message_id:int53 = PaymentForm;
|
|
|
|
//@description Validates the order information provided by a user and returns the available shipping options for a flexible invoice @chat_id Chat identifier of the Invoice message @message_id Message identifier @order_info The order information, provided by the user @allow_save True, if the order information can be saved
|
|
validateOrderInfo chat_id:int53 message_id:int53 order_info:orderInfo allow_save:Bool = ValidatedOrderInfo;
|
|
|
|
//@description Sends a filled-out payment form to the bot for final verification @chat_id Chat identifier of the Invoice message @message_id Message identifier @order_info_id Identifier returned by ValidateOrderInfo, or an empty string @shipping_option_id Identifier of a chosen shipping option, if applicable
|
|
//@credentials The credentials chosen by user for payment
|
|
sendPaymentForm chat_id:int53 message_id:int53 order_info_id:string shipping_option_id:string credentials:InputCredentials = PaymentResult;
|
|
|
|
//@description Returns information about a successful payment @chat_id Chat identifier of the PaymentSuccessful message @message_id Message identifier
|
|
getPaymentReceipt chat_id:int53 message_id:int53 = PaymentReceipt;
|
|
|
|
//@description Returns saved order info, if any
|
|
getSavedOrderInfo = OrderInfo;
|
|
|
|
//@description Deletes saved order info
|
|
deleteSavedOrderInfo = Ok;
|
|
|
|
//@description Deletes saved credentials for all payment provider bots
|
|
deleteSavedCredentials = Ok;
|
|
|
|
|
|
//@description Returns a user that can be contacted to get support
|
|
getSupportUser = User;
|
|
|
|
|
|
//@description Returns backgrounds installed by the user @for_dark_theme True, if the backgrounds must be ordered for dark theme
|
|
getBackgrounds for_dark_theme:Bool = Backgrounds;
|
|
|
|
//@description Constructs a persistent HTTP URL for a background @name Background name @type Background type
|
|
getBackgroundUrl name:string type:BackgroundType = HttpUrl;
|
|
|
|
//@description Searches for a background by its name @name The name of the background
|
|
searchBackground name:string = Background;
|
|
|
|
//@description Changes the background selected by the user; adds background to the list of installed backgrounds
|
|
//@background The input background to use, null for filled backgrounds
|
|
//@type Background type; null for default background. The method will return error 404 if type is null
|
|
//@for_dark_theme True, if the background is chosen for dark theme
|
|
setBackground background:InputBackground type:BackgroundType for_dark_theme:Bool = Background;
|
|
|
|
//@description Removes background from the list of installed backgrounds @background_id The background identifier
|
|
removeBackground background_id:int64 = Ok;
|
|
|
|
//@description Resets list of installed backgrounds to its default value
|
|
resetBackgrounds = Ok;
|
|
|
|
|
|
//@description Returns information about the current localization target. This is an offline request if only_local is true. Can be called before authorization @only_local If true, returns only locally available information without sending network requests
|
|
getLocalizationTargetInfo only_local:Bool = LocalizationTargetInfo;
|
|
|
|
//@description Returns information about a language pack. Returned language pack identifier may be different from a provided one. Can be called before authorization @language_pack_id Language pack identifier
|
|
getLanguagePackInfo language_pack_id:string = LanguagePackInfo;
|
|
|
|
//@description Returns strings from a language pack in the current localization target by their keys. Can be called before authorization @language_pack_id Language pack identifier of the strings to be returned @keys Language pack keys of the strings to be returned; leave empty to request all available strings
|
|
getLanguagePackStrings language_pack_id:string keys:vector<string> = LanguagePackStrings;
|
|
|
|
//@description Fetches the latest versions of all strings from a language pack in the current localization target from the server. This method shouldn't be called explicitly for the current used/base language packs. Can be called before authorization @language_pack_id Language pack identifier
|
|
synchronizeLanguagePack language_pack_id:string = Ok;
|
|
|
|
//@description Adds a custom server language pack to the list of installed language packs in current localization target. Can be called before authorization @language_pack_id Identifier of a language pack to be added; may be different from a name that is used in an "https://t.me/setlanguage/" link
|
|
addCustomServerLanguagePack language_pack_id:string = Ok;
|
|
|
|
//@description Adds or changes a custom local language pack to the current localization target @info Information about the language pack. Language pack ID must start with 'X', consist only of English letters, digits and hyphens, and must not exceed 64 characters. Can be called before authorization @strings Strings of the new language pack
|
|
setCustomLanguagePack info:languagePackInfo strings:vector<languagePackString> = Ok;
|
|
|
|
//@description Edits information about a custom local language pack in the current localization target. Can be called before authorization @info New information about the custom local language pack
|
|
editCustomLanguagePackInfo info:languagePackInfo = Ok;
|
|
|
|
//@description Adds, edits or deletes a string in a custom local language pack. Can be called before authorization @language_pack_id Identifier of a previously added custom local language pack in the current localization target @new_string New language pack string
|
|
setCustomLanguagePackString language_pack_id:string new_string:languagePackString = Ok;
|
|
|
|
//@description Deletes all information about a language pack in the current localization target. The language pack which is currently in use (including base language pack) or is being synchronized can't be deleted. Can be called before authorization @language_pack_id Identifier of the language pack to delete
|
|
deleteLanguagePack language_pack_id:string = Ok;
|
|
|
|
|
|
//@description Registers the currently used device for receiving push notifications. Returns a globally unique identifier of the push notification subscription @device_token Device token @other_user_ids List of user identifiers of other users currently using the application
|
|
registerDevice device_token:DeviceToken other_user_ids:vector<int32> = PushReceiverId;
|
|
|
|
//@description Handles a push notification. Returns error with code 406 if the push notification is not supported and connection to the server is required to fetch new data. Can be called before authorization
|
|
//@payload JSON-encoded push notification payload with all fields sent by the server, and "google.sent_time" and "google.notification.sound" fields added
|
|
processPushNotification payload:string = Ok;
|
|
|
|
//@description Returns a globally unique push notification subscription identifier for identification of an account, which has received a push notification. Can be called synchronously @payload JSON-encoded push notification payload
|
|
getPushReceiverId payload:string = PushReceiverId;
|
|
|
|
|
|
//@description Returns t.me URLs recently visited by a newly registered user @referrer Google Play referrer to identify the user
|
|
getRecentlyVisitedTMeUrls referrer:string = TMeUrls;
|
|
|
|
|
|
//@description Changes user privacy settings @setting The privacy setting @rules The new privacy rules
|
|
setUserPrivacySettingRules setting:UserPrivacySetting rules:userPrivacySettingRules = Ok;
|
|
|
|
//@description Returns the current privacy settings @setting The privacy setting
|
|
getUserPrivacySettingRules setting:UserPrivacySetting = UserPrivacySettingRules;
|
|
|
|
|
|
//@description Returns the value of an option by its name. (Check the list of available options on https://core.telegram.org/tdlib/options.) Can be called before authorization
|
|
//@name The name of the option
|
|
getOption name:string = OptionValue;
|
|
|
|
//@description Sets the value of an option. (Check the list of available options on https://core.telegram.org/tdlib/options.) Only writable options can be set. Can be called before authorization
|
|
//@name The name of the option @value The new value of the option
|
|
setOption name:string value:OptionValue = Ok;
|
|
|
|
|
|
//@description Changes the period of inactivity after which the account of the current user will automatically be deleted @ttl New account TTL
|
|
setAccountTtl ttl:accountTtl = Ok;
|
|
|
|
//@description Returns the period of inactivity after which the account of the current user will automatically be deleted
|
|
getAccountTtl = AccountTtl;
|
|
|
|
//@description Deletes the account of the current user, deleting all information associated with the user from the server. The phone number of the account can be used to create a new account. Can be called before authorization when the current authorization state is authorizationStateWaitPassword @reason The reason why the account was deleted; optional
|
|
deleteAccount reason:string = Ok;
|
|
|
|
|
|
//@description Removes a chat action bar without any other action @chat_id Chat identifier
|
|
removeChatActionBar chat_id:int53 = Ok;
|
|
|
|
//@description Reports a chat to the Telegram moderators. A chat can be reported only from the chat action bar, or if this is a private chat with a bot, a private chat with a user sharing their location, a supergroup, or a channel, since other chats can't be checked by moderators
|
|
//@chat_id Chat identifier @message_ids Identifiers of reported messages, if any @reason The reason for reporting the chat @text Additional report details; 0-1024 characters
|
|
reportChat chat_id:int53 message_ids:vector<int53> reason:ChatReportReason text:string = Ok;
|
|
|
|
//@description Reports a chat photo to the Telegram moderators. A chat photo can be reported only if this is a private chat with a bot, a private chat with a user sharing their location, a supergroup, or a channel, since other chats can't be checked by moderators
|
|
//@chat_id Chat identifier @file_id Identifier of the photo to report. Only full photos from chatPhoto can be reported @reason The reason for reporting the chat photo @text Additional report details; 0-1024 characters
|
|
reportChatPhoto chat_id:int53 file_id:int32 reason:ChatReportReason text:string = Ok;
|
|
|
|
//@description Returns an HTTP URL with the chat statistics. Currently this method of getting the statistics are disabled and can be deleted in the future @chat_id Chat identifier @parameters Parameters from "tg://statsrefresh?params=******" link @is_dark Pass true if a URL with the dark theme must be returned
|
|
getChatStatisticsUrl chat_id:int53 parameters:string is_dark:Bool = HttpUrl;
|
|
|
|
//@description Returns detailed statistics about a chat. Currently this method can be used only for supergroups and channels. Can be used only if SupergroupFullInfo.can_get_statistics == true @chat_id Chat identifier @is_dark Pass true if a dark theme is used by the application
|
|
getChatStatistics chat_id:int53 is_dark:Bool = ChatStatistics;
|
|
|
|
//@description Returns detailed statistics about a message. Can be used only if Message.can_get_statistics == true @chat_id Chat identifier @message_id Message identifier @is_dark Pass true if a dark theme is used by the application
|
|
getMessageStatistics chat_id:int53 message_id:int53 is_dark:Bool = MessageStatistics;
|
|
|
|
//@description Loads an asynchronous or a zoomed in statistical graph @chat_id Chat identifier @token The token for graph loading @x X-value for zoomed in graph or 0 otherwise
|
|
getStatisticalGraph chat_id:int53 token:string x:int53 = StatisticalGraph;
|
|
|
|
|
|
//@description Returns storage usage statistics. Can be called before authorization @chat_limit The maximum number of chats with the largest storage usage for which separate statistics should be returned. All other chats will be grouped in entries with chat_id == 0. If the chat info database is not used, the chat_limit is ignored and is always set to 0
|
|
getStorageStatistics chat_limit:int32 = StorageStatistics;
|
|
|
|
//@description Quickly returns approximate storage usage statistics. Can be called before authorization
|
|
getStorageStatisticsFast = StorageStatisticsFast;
|
|
|
|
//@description Returns database statistics
|
|
getDatabaseStatistics = DatabaseStatistics;
|
|
|
|
//@description Optimizes storage usage, i.e. deletes some files and returns new storage usage statistics. Secret thumbnails can't be deleted
|
|
//@size Limit on the total size of files after deletion. Pass -1 to use the default limit
|
|
//@ttl Limit on the time that has passed since the last time a file was accessed (or creation time for some filesystems). Pass -1 to use the default limit
|
|
//@count Limit on the total count of files after deletion. Pass -1 to use the default limit
|
|
//@immunity_delay The amount of time after the creation of a file during which it can't be deleted, in seconds. Pass -1 to use the default value
|
|
//@file_types If not empty, only files with the given type(s) are considered. By default, all types except thumbnails, profile photos, stickers and wallpapers are deleted
|
|
//@chat_ids If not empty, only files from the given chats are considered. Use 0 as chat identifier to delete files not belonging to any chat (e.g., profile photos)
|
|
//@exclude_chat_ids If not empty, files from the given chats are excluded. Use 0 as chat identifier to exclude all files not belonging to any chat (e.g., profile photos)
|
|
//@return_deleted_file_statistics Pass true if statistics about the files that were deleted must be returned instead of the whole storage usage statistics. Affects only returned statistics
|
|
//@chat_limit Same as in getStorageStatistics. Affects only returned statistics
|
|
optimizeStorage size:int53 ttl:int32 count:int32 immunity_delay:int32 file_types:vector<FileType> chat_ids:vector<int53> exclude_chat_ids:vector<int53> return_deleted_file_statistics:Bool chat_limit:int32 = StorageStatistics;
|
|
|
|
|
|
//@description Sets the current network type. Can be called before authorization. Calling this method forces all network connections to reopen, mitigating the delay in switching between different networks, so it should be called whenever the network is changed, even if the network type remains the same.
|
|
//-Network type is used to check whether the library can use the network at all and also for collecting detailed network data usage statistics @type The new network type. By default, networkTypeOther
|
|
setNetworkType type:NetworkType = Ok;
|
|
|
|
//@description Returns network data usage statistics. Can be called before authorization @only_current If true, returns only data for the current library launch
|
|
getNetworkStatistics only_current:Bool = NetworkStatistics;
|
|
|
|
//@description Adds the specified data to data usage statistics. Can be called before authorization @entry The network statistics entry with the data to be added to statistics
|
|
addNetworkStatistics entry:NetworkStatisticsEntry = Ok;
|
|
|
|
//@description Resets all network data usage statistics to zero. Can be called before authorization
|
|
resetNetworkStatistics = Ok;
|
|
|
|
//@description Returns auto-download settings presets for the current user
|
|
getAutoDownloadSettingsPresets = AutoDownloadSettingsPresets;
|
|
|
|
//@description Sets auto-download settings @settings New user auto-download settings @type Type of the network for which the new settings are applied
|
|
setAutoDownloadSettings settings:autoDownloadSettings type:NetworkType = Ok;
|
|
|
|
|
|
//@description Returns information about a bank card @bank_card_number The bank card number
|
|
getBankCardInfo bank_card_number:string = BankCardInfo;
|
|
|
|
|
|
//@description Returns one of the available Telegram Passport elements @type Telegram Passport element type @password Password of the current user
|
|
getPassportElement type:PassportElementType password:string = PassportElement;
|
|
|
|
//@description Returns all available Telegram Passport elements @password Password of the current user
|
|
getAllPassportElements password:string = PassportElements;
|
|
|
|
//@description Adds an element to the user's Telegram Passport. May return an error with a message "PHONE_VERIFICATION_NEEDED" or "EMAIL_VERIFICATION_NEEDED" if the chosen phone number or the chosen email address must be verified first @element Input Telegram Passport element @password Password of the current user
|
|
setPassportElement element:InputPassportElement password:string = PassportElement;
|
|
|
|
//@description Deletes a Telegram Passport element @type Element type
|
|
deletePassportElement type:PassportElementType = Ok;
|
|
|
|
//@description Informs the user that some of the elements in their Telegram Passport contain errors; for bots only. The user will not be able to resend the elements, until the errors are fixed @user_id User identifier @errors The errors
|
|
setPassportElementErrors user_id:int32 errors:vector<inputPassportElementError> = Ok;
|
|
|
|
|
|
//@description Returns an IETF language tag of the language preferred in the country, which should be used to fill native fields in Telegram Passport personal details. Returns a 404 error if unknown @country_code A two-letter ISO 3166-1 alpha-2 country code
|
|
getPreferredCountryLanguage country_code:string = Text;
|
|
|
|
|
|
//@description Sends a code to verify a phone number to be added to a user's Telegram Passport
|
|
//@phone_number The phone number of the user, in international format @settings Settings for the authentication of the user's phone number
|
|
sendPhoneNumberVerificationCode phone_number:string settings:phoneNumberAuthenticationSettings = AuthenticationCodeInfo;
|
|
|
|
//@description Re-sends the code to verify a phone number to be added to a user's Telegram Passport
|
|
resendPhoneNumberVerificationCode = AuthenticationCodeInfo;
|
|
|
|
//@description Checks the phone number verification code for Telegram Passport @code Verification code
|
|
checkPhoneNumberVerificationCode code:string = Ok;
|
|
|
|
|
|
//@description Sends a code to verify an email address to be added to a user's Telegram Passport @email_address Email address
|
|
sendEmailAddressVerificationCode email_address:string = EmailAddressAuthenticationCodeInfo;
|
|
|
|
//@description Re-sends the code to verify an email address to be added to a user's Telegram Passport
|
|
resendEmailAddressVerificationCode = EmailAddressAuthenticationCodeInfo;
|
|
|
|
//@description Checks the email address verification code for Telegram Passport @code Verification code
|
|
checkEmailAddressVerificationCode code:string = Ok;
|
|
|
|
|
|
//@description Returns a Telegram Passport authorization form for sharing data with a service @bot_user_id User identifier of the service's bot @scope Telegram Passport element types requested by the service @public_key Service's public_key @nonce Authorization form nonce provided by the service
|
|
getPassportAuthorizationForm bot_user_id:int32 scope:string public_key:string nonce:string = PassportAuthorizationForm;
|
|
|
|
//@description Returns already available Telegram Passport elements suitable for completing a Telegram Passport authorization form. Result can be received only once for each authorization form @autorization_form_id Authorization form identifier @password Password of the current user
|
|
getPassportAuthorizationFormAvailableElements autorization_form_id:int32 password:string = PassportElementsWithErrors;
|
|
|
|
//@description Sends a Telegram Passport authorization form, effectively sharing data with the service. This method must be called after getPassportAuthorizationFormAvailableElements if some previously available elements are going to be reused
|
|
//@autorization_form_id Authorization form identifier @types Types of Telegram Passport elements chosen by user to complete the authorization form
|
|
sendPassportAuthorizationForm autorization_form_id:int32 types:vector<PassportElementType> = Ok;
|
|
|
|
|
|
//@description Sends phone number confirmation code. Should be called when user presses "https://t.me/confirmphone?phone=*******&hash=**********" or "tg://confirmphone?phone=*******&hash=**********" link @hash Value of the "hash" parameter from the link
|
|
//@phone_number Value of the "phone" parameter from the link @settings Settings for the authentication of the user's phone number
|
|
sendPhoneNumberConfirmationCode hash:string phone_number:string settings:phoneNumberAuthenticationSettings = AuthenticationCodeInfo;
|
|
|
|
//@description Resends phone number confirmation code
|
|
resendPhoneNumberConfirmationCode = AuthenticationCodeInfo;
|
|
|
|
//@description Checks phone number confirmation code @code The phone number confirmation code
|
|
checkPhoneNumberConfirmationCode code:string = Ok;
|
|
|
|
|
|
//@description Informs the server about the number of pending bot updates if they haven't been processed for a long time; for bots only @pending_update_count The number of pending updates @error_message The last error message
|
|
setBotUpdatesStatus pending_update_count:int32 error_message:string = Ok;
|
|
|
|
|
|
//@description Uploads a PNG image with a sticker; for bots only; returns the uploaded file
|
|
//@user_id Sticker file owner @png_sticker PNG image with the sticker; must be up to 512 KB in size and fit in 512x512 square
|
|
uploadStickerFile user_id:int32 png_sticker:InputFile = File;
|
|
|
|
//@description Creates a new sticker set; for bots only. Returns the newly created sticker set
|
|
//@user_id Sticker set owner
|
|
//@title Sticker set title; 1-64 characters
|
|
//@name Sticker set name. Can contain only English letters, digits and underscores. Must end with *"_by_<bot username>"* (*<bot_username>* is case insensitive); 1-64 characters
|
|
//@is_masks True, if stickers are masks. Animated stickers can't be masks
|
|
//@stickers List of stickers to be added to the set; must be non-empty. All stickers must be of the same type
|
|
createNewStickerSet user_id:int32 title:string name:string is_masks:Bool stickers:vector<InputSticker> = StickerSet;
|
|
|
|
//@description Adds a new sticker to a set; for bots only. Returns the sticker set
|
|
//@user_id Sticker set owner @name Sticker set name @sticker Sticker to add to the set
|
|
addStickerToSet user_id:int32 name:string sticker:InputSticker = StickerSet;
|
|
|
|
//@description Sets a sticker set thumbnail; for bots only. Returns the sticker set
|
|
//@user_id Sticker set owner @name Sticker set name
|
|
//@thumbnail Thumbnail to set in PNG or TGS format. Animated thumbnail must be set for animated sticker sets and only for them. Pass a zero InputFileId to delete the thumbnail
|
|
setStickerSetThumbnail user_id:int32 name:string thumbnail:InputFile = StickerSet;
|
|
|
|
//@description Changes the position of a sticker in the set to which it belongs; for bots only. The sticker set must have been created by the bot
|
|
//@sticker Sticker @position New position of the sticker in the set, zero-based
|
|
setStickerPositionInSet sticker:InputFile position:int32 = Ok;
|
|
|
|
//@description Removes a sticker from the set to which it belongs; for bots only. The sticker set must have been created by the bot @sticker Sticker
|
|
removeStickerFromSet sticker:InputFile = Ok;
|
|
|
|
|
|
//@description Returns information about a file with a map thumbnail in PNG format. Only map thumbnail files with size less than 1MB can be downloaded @location Location of the map center @zoom Map zoom level; 13-20 @width Map width in pixels before applying scale; 16-1024 @height Map height in pixels before applying scale; 16-1024 @scale Map scale; 1-3 @chat_id Identifier of a chat, in which the thumbnail will be shown. Use 0 if unknown
|
|
getMapThumbnailFile location:location zoom:int32 width:int32 height:int32 scale:int32 chat_id:int53 = File;
|
|
|
|
|
|
//@description Accepts Telegram terms of services @terms_of_service_id Terms of service identifier
|
|
acceptTermsOfService terms_of_service_id:string = Ok;
|
|
|
|
|
|
//@description Sends a custom request; for bots only @method The method name @parameters JSON-serialized method parameters
|
|
sendCustomRequest method:string parameters:string = CustomRequestResult;
|
|
|
|
//@description Answers a custom query; for bots only @custom_query_id Identifier of a custom query @data JSON-serialized answer to the query
|
|
answerCustomQuery custom_query_id:int64 data:string = Ok;
|
|
|
|
|
|
//@description Succeeds after a specified amount of time has passed. Can be called before initialization @seconds Number of seconds before the function returns
|
|
setAlarm seconds:double = Ok;
|
|
|
|
|
|
//@description Returns information about existing countries. Can be called before authorization
|
|
getCountries = Countries;
|
|
|
|
//@description Uses the current IP address to find the current country. Returns two-letter ISO 3166-1 alpha-2 country code. Can be called before authorization
|
|
getCountryCode = Text;
|
|
|
|
//@description Returns information about a phone number by its prefix. Can be called before authorization @phone_number_prefix The phone number prefix
|
|
getPhoneNumberInfo phone_number_prefix:string = PhoneNumberInfo;
|
|
|
|
//@description Returns the default text for invitation messages to be used as a placeholder when the current user invites friends to Telegram
|
|
getInviteText = Text;
|
|
|
|
//@description Returns information about a tg:// deep link. Use "tg://need_update_for_some_feature" or "tg:some_unsupported_feature" for testing. Returns a 404 error for unknown links. Can be called before authorization @link The link
|
|
getDeepLinkInfo link:string = DeepLinkInfo;
|
|
|
|
|
|
//@description Returns application config, provided by the server. Can be called before authorization
|
|
getApplicationConfig = JsonValue;
|
|
|
|
//@description Saves application log event on the server. Can be called before authorization @type Event type @chat_id Optional chat identifier, associated with the event @data The log event data
|
|
saveApplicationLogEvent type:string chat_id:int53 data:JsonValue = Ok;
|
|
|
|
|
|
//@description Adds a proxy server for network requests. Can be called before authorization @server Proxy server IP address @port Proxy server port @enable True, if the proxy should be enabled @type Proxy type
|
|
addProxy server:string port:int32 enable:Bool type:ProxyType = Proxy;
|
|
|
|
//@description Edits an existing proxy server for network requests. Can be called before authorization @proxy_id Proxy identifier @server Proxy server IP address @port Proxy server port @enable True, if the proxy should be enabled @type Proxy type
|
|
editProxy proxy_id:int32 server:string port:int32 enable:Bool type:ProxyType = Proxy;
|
|
|
|
//@description Enables a proxy. Only one proxy can be enabled at a time. Can be called before authorization @proxy_id Proxy identifier
|
|
enableProxy proxy_id:int32 = Ok;
|
|
|
|
//@description Disables the currently enabled proxy. Can be called before authorization
|
|
disableProxy = Ok;
|
|
|
|
//@description Removes a proxy server. Can be called before authorization @proxy_id Proxy identifier
|
|
removeProxy proxy_id:int32 = Ok;
|
|
|
|
//@description Returns list of proxies that are currently set up. Can be called before authorization
|
|
getProxies = Proxies;
|
|
|
|
//@description Returns an HTTPS link, which can be used to add a proxy. Available only for SOCKS5 and MTProto proxies. Can be called before authorization @proxy_id Proxy identifier
|
|
getProxyLink proxy_id:int32 = HttpUrl;
|
|
|
|
//@description Computes time needed to receive a response from a Telegram server through a proxy. Can be called before authorization @proxy_id Proxy identifier. Use 0 to ping a Telegram server without a proxy
|
|
pingProxy proxy_id:int32 = Seconds;
|
|
|
|
|
|
//@description Sets new log stream for internal logging of TDLib. Can be called synchronously @log_stream New log stream
|
|
setLogStream log_stream:LogStream = Ok;
|
|
|
|
//@description Returns information about currently used log stream for internal logging of TDLib. Can be called synchronously
|
|
getLogStream = LogStream;
|
|
|
|
//@description Sets the verbosity level of the internal logging of TDLib. Can be called synchronously
|
|
//@new_verbosity_level New value of the verbosity level for logging. Value 0 corresponds to fatal errors, value 1 corresponds to errors, value 2 corresponds to warnings and debug warnings, value 3 corresponds to informational, value 4 corresponds to debug, value 5 corresponds to verbose debug, value greater than 5 and up to 1023 can be used to enable even more logging
|
|
setLogVerbosityLevel new_verbosity_level:int32 = Ok;
|
|
|
|
//@description Returns current verbosity level of the internal logging of TDLib. Can be called synchronously
|
|
getLogVerbosityLevel = LogVerbosityLevel;
|
|
|
|
//@description Returns list of available TDLib internal log tags, for example, ["actor", "binlog", "connections", "notifications", "proxy"]. Can be called synchronously
|
|
getLogTags = LogTags;
|
|
|
|
//@description Sets the verbosity level for a specified TDLib internal log tag. Can be called synchronously
|
|
//@tag Logging tag to change verbosity level @new_verbosity_level New verbosity level; 1-1024
|
|
setLogTagVerbosityLevel tag:string new_verbosity_level:int32 = Ok;
|
|
|
|
//@description Returns current verbosity level for a specified TDLib internal log tag. Can be called synchronously @tag Logging tag to change verbosity level
|
|
getLogTagVerbosityLevel tag:string = LogVerbosityLevel;
|
|
|
|
//@description Adds a message to TDLib internal log. Can be called synchronously
|
|
//@verbosity_level The minimum verbosity level needed for the message to be logged; 0-1023 @text Text of a message to log
|
|
addLogMessage verbosity_level:int32 text:string = Ok;
|
|
|
|
|
|
//@description Does nothing; for testing only. This is an offline method. Can be called before authorization
|
|
testCallEmpty = Ok;
|
|
//@description Returns the received string; for testing only. This is an offline method. Can be called before authorization @x String to return
|
|
testCallString x:string = TestString;
|
|
//@description Returns the received bytes; for testing only. This is an offline method. Can be called before authorization @x Bytes to return
|
|
testCallBytes x:bytes = TestBytes;
|
|
//@description Returns the received vector of numbers; for testing only. This is an offline method. Can be called before authorization @x Vector of numbers to return
|
|
testCallVectorInt x:vector<int32> = TestVectorInt;
|
|
//@description Returns the received vector of objects containing a number; for testing only. This is an offline method. Can be called before authorization @x Vector of objects to return
|
|
testCallVectorIntObject x:vector<testInt> = TestVectorIntObject;
|
|
//@description Returns the received vector of strings; for testing only. This is an offline method. Can be called before authorization @x Vector of strings to return
|
|
testCallVectorString x:vector<string> = TestVectorString;
|
|
//@description Returns the received vector of objects containing a string; for testing only. This is an offline method. Can be called before authorization @x Vector of objects to return
|
|
testCallVectorStringObject x:vector<testString> = TestVectorStringObject;
|
|
//@description Returns the squared received number; for testing only. This is an offline method. Can be called before authorization @x Number to square
|
|
testSquareInt x:int32 = TestInt;
|
|
//@description Sends a simple network request to the Telegram servers; for testing only. Can be called before authorization
|
|
testNetwork = Ok;
|
|
//@description Sends a simple network request to the Telegram servers via proxy; for testing only. Can be called before authorization @server Proxy server IP address @port Proxy server port @type Proxy type
|
|
//@dc_id Identifier of a datacenter, with which to test connection @timeout The maximum overall timeout for the request
|
|
testProxy server:string port:int32 type:ProxyType dc_id:int32 timeout:double = Ok;
|
|
//@description Forces an updates.getDifference call to the Telegram servers; for testing only
|
|
testGetDifference = Ok;
|
|
//@description Does nothing and ensures that the Update object is used; for testing only. This is an offline method. Can be called before authorization
|
|
testUseUpdate = Update;
|
|
//@description Returns the specified error and ensures that the Error object is used; for testing only. Can be called synchronously @error The error to be returned
|
|
testReturnError error:error = Error;
|