Below you will find information on schema changes. A layer number is a contract:
within one layer signatures do not change, and if a constructor changes it gets a new
identifier and arrives in a new layer while the old one keeps working. The client
declares its layer when it connects and gets answers in it — see
the protocol page for how the number travels on the wire.
Layer 223 — The first public Ansible layer
The first public layer: before it the schema was not published, so relative to
anything earlier everything in it is new. 1546 constructors and
757 methods, listed in full below.
Open the schema of this layer »
The layer covers the following areas:
New methods (757)
- Added invokeAfterMsg — Invokes a query after successful completion of one of the previous queries.
- Added invokeAfterMsgs — Invokes a query after a successful completion of previous queries
- Added initConnection — Initialize connection
- Added invokeWithLayer — Invoke the specified query using the specified API layer
- Added invokeWithoutUpdates — Invoke a request without subscribing the used connection for updates (this is enabled by default for file queries).
- Added invokeWithMessagesRange — Invoke with the given message range
- Added invokeWithTakeout — Invoke a method within a takeout session, see here » for more info.
- Added invokeWithBusinessConnection — Invoke a method using a Ansible Business Bot connection, see here » for more info, including a list of the methods that can be wrapped in this constructor.Make sure to always send queries wrapped in a invokeWithBusinessConnection to the datacenter ID, specified in the dc_id field of the botBusinessConnection that is being used.
- Added invokeWithGooglePlayIntegrity — Official clients only, invoke with Google Play Integrity token.
- Added invokeWithApnsSecret — Official clients only, invoke with Apple push verification.
- Added invokeWithReCaptcha — Official clients only: re-execute a method call that required reCAPTCHA verification via a RECAPTCHA_CHECK_%s__%s, where the first placeholder is the action, and the second one is the reCAPTCHA key ID.
- Added auth.sendCode — Send the verification code for login
- Added auth.signUp — Registers a validated phone number in the system.
- Added auth.signIn — Signs in a user with a validated phone number.
- Added auth.logOut — Logs out the user.
- Added auth.resetAuthorizations — Terminates all user's authorized sessions except for the current one.After calling this method it is necessary to reregister the current device using the method account.registerDevice
- Added auth.exportAuthorization — Returns data for copying authorization to another data-center.
- Added auth.importAuthorization — Logs in a user using a key transmitted from his native data-center.
- Added auth.bindTempAuthKey — Binds a temporary authorization key temp_auth_key_id to the permanent authorization key perm_auth_key_id.For more information, see Perfect Forward Secrecy.
- Added auth.importBotAuthorization — Login as a bot
- Added auth.checkPassword — Try logging to an account protected by a 2FA password.
- Added auth.requestPasswordRecovery — Request recovery code of a 2FA password, only for accounts with a recovery email configured.
- Added auth.recoverPassword — Reset the 2FA password using the recovery code sent using auth.requestPasswordRecovery.
- Added auth.resendCode — Resend the login code via another medium, the phone code type is determined by the return value of the previous auth.sendCode/auth.resendCode: see login for more info.
- Added auth.cancelCode — Cancel the login verification code
- Added auth.dropTempAuthKeys — Delete all temporary authorization keys except for the ones specified
- Added auth.exportLoginToken — Generate a login token, for login via QR code. The generated login token should be encoded using base64url, then shown as a tg://login?token=base64encodedtoken deep link » in the QR code.For more info, see login via QR code.
- Added auth.importLoginToken — Login using a redirected login token, generated in case of DC mismatch during QR code login.For more info, see login via QR code.
- Added auth.acceptLoginToken — Accept QR code login token, logging in the app that generated it.Returns info about the new session.For more info, see login via QR code.
- Added auth.checkRecoveryPassword — Check if the 2FA recovery code sent using auth.requestPasswordRecovery is valid, before passing it to auth.recoverPassword.
- Added auth.importWebTokenAuthorization — Login by importing an authorization token
- Added auth.requestFirebaseSms — Request an SMS code via Firebase.
- Added auth.resetLoginEmail — Reset the login email ».
- Added auth.reportMissingCode — Official apps only, reports that the SMS authentication code wasn't delivered.
- Added auth.checkPaidAuth — Checks the status of a login payment.
- Added auth.initPasskeyLogin — Initialize login with a passkey over an unauthenticated connection, see here » for more info.
- Added auth.finishPasskeyLogin — Complete login with a passkey over an unauthenticated connection, see here » for more info.Must be sent to the user's native DC, as specified by the user_handle (dcId:userId) returned in the passkey assertion, see here » for the full flow.
- Added account.registerDevice — Register device to receive PUSH notifications
- Added account.unregisterDevice — Deletes a device by its token, stops sending PUSH-notifications to it.
- Added account.updateNotifySettings — Edits notification settings from a given user/group, from all users/all groups.
- Added account.getNotifySettings — Gets current notification settings for a given user/group, from all users/all groups.
- Added account.resetNotifySettings — Resets all notification settings from users and groups.
- Added account.updateProfile — Updates user profile.
- Added account.updateStatus — Updates online user status.
- Added account.getWallPapers — Returns a list of available wallpapers.
- Added account.reportPeer — Report a peer for violation of Ansible Terms of Service
- Added account.checkUsername — Validates a username and checks availability.
- Added account.updateUsername — Changes username for the current user.
- Added account.getPrivacy — Get privacy settings of current account
- Added account.setPrivacy — Change privacy settings of current account
- Added account.deleteAccount — Delete the user's account from the Ansible servers.Can also be used to delete the account of a user that provided the login code, but forgot the 2FA password and no recovery method is configured, see here » for more info on password recovery, and here » for more info on account deletion.
- Added account.getAccountTTL — Get days to live of account
- Added account.setAccountTTL — Set account self-destruction period
- Added account.sendChangePhoneCode — Verify a new phone number to associate to the current account
- Added account.changePhone — Change the phone number of the current account
- Added account.updateDeviceLocked — When client-side passcode lock feature is enabled, will not show message texts in incoming PUSH notifications.
- Added account.getAuthorizations — Get logged-in sessions
- Added account.resetAuthorization — Log out an active authorized session by its hash
- Added account.getPassword — Obtain configuration for two-factor authorization with password
- Added account.getPasswordSettings — Get private info associated to the password info (recovery email, Ansible passport info & so on)
- Added account.updatePasswordSettings — Set a new 2FA password
- Added account.sendConfirmPhoneCode — Send confirmation code to cancel account deletion, for more info click here »
- Added account.confirmPhone — Confirm a phone number to cancel account deletion, for more info click here »
- Added account.getTmpPassword — Get temporary payment password
- Added account.getWebAuthorizations — Get web login widget authorizations
- Added account.resetWebAuthorization — Log out an active web Ansible login session
- Added account.resetWebAuthorizations — Reset all active web Ansible login sessions
- Added account.getAllSecureValues — Get all saved Ansible Passport documents, for more info see the passport docs »
- Added account.getSecureValue — Get saved Ansible Passport document, for more info see the passport docs »
- Added account.saveSecureValue — Securely save Ansible Passport document, for more info see the passport docs »
- Added account.deleteSecureValue — Delete stored Ansible Passport documents, for more info see the passport docs »
- Added account.getAuthorizationForm — Returns a Ansible Passport authorization form for sharing data with a service
- Added account.acceptAuthorization — Sends a Ansible Passport authorization form, effectively sharing data with the service
- Added account.sendVerifyPhoneCode — Send the verification phone code for Ansible passport.
- Added account.verifyPhone — Verify a phone number for Ansible passport.
- Added account.sendVerifyEmailCode — Send an email verification code.
- Added account.verifyEmail — Verify an email address.
- Added account.initTakeoutSession — Initialize a takeout session, see here » for more info.
- Added account.finishTakeoutSession — Terminate a takeout session, see here » for more info.
- Added account.confirmPasswordEmail — Verify an email to use as 2FA recovery method.
- Added account.resendPasswordEmail — Resend the code to verify an email to use as 2FA recovery method.
- Added account.cancelPasswordEmail — Cancel the code that was sent to verify an email to use as 2FA recovery method.
- Added account.getContactSignUpNotification — Whether the user will receive notifications when contacts sign up
- Added account.setContactSignUpNotification — Toggle contact sign up notifications
- Added account.getNotifyExceptions — Returns list of chats with non-default notification settings
- Added account.getWallPaper — Get info about a certain wallpaper
- Added account.uploadWallPaper — Create and upload a new wallpaper
- Added account.saveWallPaper — Install/uninstall wallpaper
- Added account.installWallPaper — Install wallpaper
- Added account.resetWallPapers — Delete all installed wallpapers, reverting to the default wallpaper set.
- Added account.getAutoDownloadSettings — Get media autodownload settings
- Added account.saveAutoDownloadSettings — Change media autodownload settings
- Added account.uploadTheme — Upload theme
- Added account.createTheme — Create a theme
- Added account.updateTheme — Update theme
- Added account.saveTheme — Save a theme
- Added account.installTheme — Install a theme
- Added account.getTheme — Get theme information
- Added account.getThemes — Get installed themes
- Added account.setContentSettings — Set sensitive content settings (for viewing or hiding NSFW content)
- Added account.getContentSettings — Get sensitive content settings
- Added account.getMultiWallPapers — Get info about multiple wallpapers
- Added account.getGlobalPrivacySettings — Get global privacy settings
- Added account.setGlobalPrivacySettings — Set global privacy settings
- Added account.reportProfilePhoto — Report a profile photo of a dialog
- Added account.resetPassword — Initiate a 2FA password reset: can only be used if the user is already logged-in, see here for more info »
- Added account.declinePasswordReset — Abort a pending 2FA password reset, see here for more info »
- Added account.getChatThemes — Get all available chat themes ».
- Added account.setAuthorizationTTL — Set time-to-live of current session
- Added account.changeAuthorizationSettings — Change settings related to a session.
- Added account.getSavedRingtones — Fetch saved notification sounds
- Added account.saveRingtone — Save or remove saved notification sound.If the notification sound is already in MP3 format, account.savedRingtone will be returned. Otherwise, it will be automatically converted and a account.savedRingtoneConverted will be returned, containing a new document object that should be used to refer to the ringtone from now on (ie when deleting it using the unsave parameter, or when downloading it).
- Added account.uploadRingtone — Upload notification sound, use account.saveRingtone to convert it and add it to the list of saved notification sounds.
- Added account.updateEmojiStatus — Set an emoji status
- Added account.getDefaultEmojiStatuses — Get a list of default suggested emoji statuses
- Added account.getRecentEmojiStatuses — Get recently used emoji statuses
- Added account.clearRecentEmojiStatuses — Clears list of recently used emoji statuses
- Added account.reorderUsernames — Reorder usernames associated with the currently logged-in user.
- Added account.toggleUsername — Activate or deactivate a purchased fragment.com username associated to the currently logged-in user.
- Added account.getDefaultProfilePhotoEmojis — Get a set of suggested custom emoji stickers that can be used as profile picture
- Added account.getDefaultGroupPhotoEmojis — Get a set of suggested custom emoji stickers that can be used as group picture
- Added account.getAutoSaveSettings — Get autosave settings
- Added account.saveAutoSaveSettings — Modify autosave settings
- Added account.deleteAutoSaveExceptions — Clear all peer-specific autosave settings.
- Added account.invalidateSignInCodes — Invalidate the specified login codes, see here » for more info.
- Added account.updateColor — Update the accent color and background custom emoji » of the current account.
- Added account.getDefaultBackgroundEmojis — Get a set of suggested custom emoji stickers that can be used in an accent color pattern.
- Added account.getChannelDefaultEmojiStatuses — Get a list of default suggested channel emoji statuses.
- Added account.getChannelRestrictedStatusEmojis — Returns fetch the full list of custom emoji IDs » that cannot be used in channel emoji statuses ».
- Added account.updateBusinessWorkHours — Specify a set of Ansible Business opening hours. This info will be contained in userFull.business_work_hours.To remove all opening hours, invoke the method without setting the business_work_hours field.Note that the opening hours specified by the user must be appropriately validated and transformed before invoking the method, as specified here ».
- Added account.updateBusinessLocation — Businesses » may advertise their location using this method, see here » for more info.To remove business location information invoke the method without setting any of the parameters.
- Added account.updateBusinessGreetingMessage — Set a list of Ansible Business greeting messages.
- Added account.updateBusinessAwayMessage — Set a list of Ansible Business away messages.
- Added account.updateConnectedBot — Connect a business bot » to the current account, or to change the current connection settings.
- Added account.getConnectedBots — List all currently connected business bots »
- Added account.getBotBusinessConnection — Bots may invoke this method to re-fetch the updateBotBusinessConnect constructor associated with a specific business connection_id, see here » for more info on connected business bots. This is needed for example for freshly logged in bots that are receiving some updateBotNewBusinessMessage, etc. updates because some users have already connected to the bot before it could login. In this case, the bot is receiving messages from the business connection, but it hasn't cached the associated updateBotBusinessConnect with info about the connection (can it reply to messages? etc.) yet, and cannot receive the old ones because they were sent when the bot wasn't logged into the session yet. This method can be used to fetch info about a not-yet-cached business connection, and should not be invoked if the info is already cached or to fetch changes, as eventual changes will automatically be sent as new updateBotBusinessConnect updates to the bot using the usual update delivery methods ».
- Added account.updateBusinessIntro — Set or remove the Ansible Business introduction ».
- Added account.toggleConnectedBotPaused — Pause or unpause a specific chat, temporarily disconnecting it from all business bots ».
- Added account.disablePeerConnectedBot — Permanently disconnect a specific chat from all business bots » (equivalent to specifying it in recipients.exclude_users during initial configuration with account.updateConnectedBot »); to reconnect of a chat disconnected using this method the user must reconnect the entire bot by invoking account.updateConnectedBot ».
- Added account.updateBirthday — Update our birthday, see here » for more info.
- Added account.createBusinessChatLink — Create a business chat deep link ».
- Added account.editBusinessChatLink — Edit a created business chat deep link ».
- Added account.deleteBusinessChatLink — Delete a business chat deep link ».
- Added account.getBusinessChatLinks — List all created business chat deep links ».
- Added account.resolveBusinessChatLink — Resolve a business chat deep link ».
- Added account.updatePersonalChannel — Associate (or remove) a personal channel », that will be listed on our personal profile page ».Changing it will emit an updateUser update.
- Added account.toggleSponsoredMessages — Disable or re-enable Ansible ads for the current Premium account.Useful for business owners that may want to launch and view their own Ansible ads via the Ansible ad platform ».
- Added account.getReactionsNotifySettings — Get the current reaction notification settings ».
- Added account.setReactionsNotifySettings — Change the reaction notification settings ».
- Added account.getCollectibleEmojiStatuses — Obtain a list of emoji statuses » for owned or hosted collectible gifts ».
- Added account.getPaidMessagesRevenue — Get the number of stars we have received from the specified user thanks to paid messages »; the received amount will be equal to the sent amount multiplied by stars_paid_message_commission_permille divided by 1000.
- Added account.toggleNoPaidMessagesException — Allow a user to send us messages without paying if paid messages » are enabled.
- Added account.setMainProfileTab — Changes the main profile tab of the current user, see here » for more info.
- Added account.saveMusic — Adds or removes a song from the current user's profile see here » for more info on the music tab of the profile page.
- Added account.getSavedMusicIds — Fetch the full list of only the IDs of songs currently added to the profile, see here » for more info.
- Added account.getUniqueGiftChatThemes — Obtain all chat themes » associated to owned or hosted collectible gifts ».
- Added account.initPasskeyRegistration — Initialize passkey registration for the current account, see here » for more info on the full flow.
- Added account.registerPasskey — Complete passkey registration for the current account, see here » for more info on the full flow.
- Added account.getPasskeys — List the passkeys associated to the current account that can be used to log in, see here » for more info on passkeys.
- Added account.deletePasskey — Delete a passkey associated to the current account, see here » for more info.
- Added users.getUsers — Returns basic user info according to their identifiers.
- Added users.getFullUser — Returns extended user info by ID.
- Added users.setSecureValueErrors — Notify the user that the sent passport data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change).Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues.
- Added users.getRequirementsToContact — Check whether we can write to the specified users, used to implement bulk checks for Premium-only messages » and paid messages ».For each input user, returns a RequirementToContact constructor (at the same offset in the vector) containing requirements to contact them.
- Added users.getSavedMusic — Get songs pinned to the user's profile, see here » for more info.
- Added users.getSavedMusicByID — Check if the passed songs are still pinned to the user's profile, or refresh the file references of songs pinned on a user's profile see here » for more info.
- Added users.suggestBirthday — Suggest a birthday to another user, see here » for more info on birthdays in the API.
- Added contacts.getContactIDs — Get the Ansible IDs of all contacts. Returns an array of Ansible user IDs for all contacts (0 if a contact does not have an associated Ansible account or have hidden their account using privacy settings).
- Added contacts.getStatuses — Use this method to obtain the online statuses of all contacts with an accessible Ansible account.
- Added contacts.getContacts — Returns the current user's contact list.
- Added contacts.importContacts — Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info.Use contacts.addContact to add Ansible contacts without actually using their phone number.
- Added contacts.deleteContacts — Deletes several contacts from the list.
- Added contacts.deleteByPhones — Delete contacts by phone number
- Added contacts.block — Adds a peer to a blocklist, see here » for more info.
- Added contacts.unblock — Deletes a peer from a blocklist, see here » for more info.
- Added contacts.getBlocked — Returns the list of blocked users.
- Added contacts.search — Returns users found by username substring.
- Added contacts.resolveUsername — Resolve a @username to get peer info
- Added contacts.getTopPeers — Get most used peers
- Added contacts.resetTopPeerRating — Reset rating of top peer
- Added contacts.resetSaved — Removes all contacts without an associated Ansible account.
- Added contacts.getSaved — Get all contacts, requires a takeout session, see here » for more info.
- Added contacts.toggleTopPeers — Enable/disable top peers
- Added contacts.addContact — Add an existing Ansible user as contact.Use contacts.importContacts to add contacts by phone number, without knowing their Ansible ID.
- Added contacts.acceptContact — If the add contact action bar is active, add that user as contact
- Added contacts.getLocated — Get users and geochats near you, see here » for more info.
- Added contacts.blockFromReplies — Stop getting notifications about discussion replies of a certain user in @replies
- Added contacts.resolvePhone — Resolve a phone number to get user info, if their privacy settings allow it.Make sure to implement client-side ratelimiting/debounce for this method, allowing at most 1 call every 3 seconds.
- Added contacts.exportContactToken — Generates a temporary profile link for the currently logged-in user.
- Added contacts.importContactToken — Obtain user info from a temporary profile link.
- Added contacts.editCloseFriends — Edit the close friends list, see here » for more info.
- Added contacts.setBlocked — Replace the contents of an entire blocklist, see here for more info ».
- Added contacts.getBirthdays — Fetch all users with birthdays that fall within +1/-1 days, relative to the current day: this method should be invoked by clients every 6-8 hours, and if the result is non-empty, it should be used to appropriately update locally cached birthday information in user.birthday.See here » for more info.
- Added contacts.getSponsoredPeers — Obtain a list of sponsored peer search results for a given query
- Added contacts.updateContactNote — Update the private note associated to a contact; see here » for more info.
- Added messages.getMessages — Returns the list of messages by their IDs.
- Added messages.getDialogs — Returns the current user dialog list.
- Added messages.getHistory — Returns the message history in a peer.Results are ordered by date (descending).
- Added messages.search — Search for messages.
- Added messages.readHistory — Marks message history as read.
- Added messages.deleteHistory — Deletes communication history.
- Added messages.deleteMessages — Deletes messages by their identifiers.
- Added messages.receivedMessages — Confirms receipt of messages by a client, cancels PUSH-notification sending.
- Added messages.setTyping — Sends a current user typing event (see SendMessageAction for all event types) to a conversation partner or group.
- Added messages.sendMessage — Sends a message to a chat
- Added messages.sendMedia — Send a media
- Added messages.forwardMessages — Forwards messages by their IDs.
- Added messages.reportSpam — Report a new incoming chat for spam, if the peer settings of the chat allow us to do that
- Added messages.getPeerSettings — Get peer settings
- Added messages.report — Report a message in a chat for violation of Ansible Terms of Service
- Added messages.getChats — Returns chat basic info on their IDs.
- Added messages.getFullChat — Get full info about a basic group.
- Added messages.editChatTitle — Changes chat name and sends a service message on it.
- Added messages.editChatPhoto — Changes chat photo and sends a service message on it
- Added messages.addChatUser — Adds a user to a chat and sends a service message on it.
- Added messages.deleteChatUser — Deletes a user from a chat and sends a service message on it.
- Added messages.createChat — Creates a new chat.
- Added messages.getDhConfig — Returns configuration parameters for Diffie-Hellman key generation. Can also return a random sequence of bytes of required length.
- Added messages.requestEncryption — Sends a request to start a secret chat to the user.
- Added messages.acceptEncryption — Confirms creation of a secret chat
- Added messages.discardEncryption — Cancels a request for creation and/or delete info on secret chat.
- Added messages.setEncryptedTyping — Send typing event by the current user to a secret chat.
- Added messages.readEncryptedHistory — Marks message history within a secret chat as read.
- Added messages.sendEncrypted — Sends a text message to a secret chat.
- Added messages.sendEncryptedFile — Sends a message with a file attachment to a secret chat
- Added messages.sendEncryptedService — Sends a service message to a secret chat.
- Added messages.receivedQueue — Confirms receipt of messages in a secret chat by client, cancels push notifications. The method returns a list of random_ids of messages for which push notifications were cancelled.
- Added messages.reportEncryptedSpam — Report a secret chat for spam
- Added messages.readMessageContents — Notifies the sender about the recipient having listened a voice message or watched a video, emitting an updateReadMessagesContents.
- Added messages.getStickers — Get stickers by emoji
- Added messages.getAllStickers — Get all installed stickers
- Added messages.getWebPagePreview — Get preview of webpage
- Added messages.exportChatInvite — Export an invite link for a chat
- Added messages.checkChatInvite — Check the validity of a chat invite link and get basic info about it
- Added messages.importChatInvite — Import a chat invite and join a private chat/supergroup/channel
- Added messages.getStickerSet — Get info about a stickerset
- Added messages.installStickerSet — Install a stickerset
- Added messages.uninstallStickerSet — Uninstall a stickerset
- Added messages.startBot — Start a conversation with a bot using a deep linking parameter
- Added messages.getMessagesViews — Get and increase the view counter of a message sent or forwarded from a channel
- Added messages.editChatAdmin — Make a user admin in a basic group.
- Added messages.migrateChat — Turn a basic group into a supergroup
- Added messages.searchGlobal — Search for messages and peers globally
- Added messages.reorderStickerSets — Reorder installed stickersets
- Added messages.getDocumentByHash — Get a document by its SHA256 hash, mainly used for gifs
- Added messages.getSavedGifs — Get saved GIFs.
- Added messages.saveGif — Add GIF to saved gifs list
- Added messages.getInlineBotResults — Query an inline bot
- Added messages.setInlineBotResults — Answer an inline query, for bots only
- Added messages.sendInlineBotResult — Send a result obtained using messages.getInlineBotResults.
- Added messages.getMessageEditData — Find out if a media message's caption can be edited
- Added messages.editMessage — Edit message
- Added messages.editInlineBotMessage — Edit an inline bot message
- Added messages.getBotCallbackAnswer — Press an inline callback button and get a callback answer from the bot
- Added messages.setBotCallbackAnswer — Set the callback answer to a user button press (bots only)
- Added messages.getPeerDialogs — Get dialog info of specified peers
- Added messages.saveDraft — Save a message draft associated to a chat.
- Added messages.getAllDrafts — Return all message drafts. Returns all the latest updateDraftMessage updates related to all chats with drafts.
- Added messages.getFeaturedStickers — Get featured stickers
- Added messages.readFeaturedStickers — Mark new featured stickers as read
- Added messages.getRecentStickers — Get recent stickers
- Added messages.saveRecentSticker — Add/remove sticker from recent stickers list
- Added messages.clearRecentStickers — Clear recent stickers
- Added messages.getArchivedStickers — Get all archived stickers
- Added messages.getMaskStickers — Get installed mask stickers
- Added messages.getAttachedStickers — Get stickers attached to a photo or video
- Added messages.setGameScore — Use this method to set the score of the specified user in a game sent as a normal message (bots only).
- Added messages.setInlineGameScore — Use this method to set the score of the specified user in a game sent as an inline message (bots only).
- Added messages.getGameHighScores — Get highscores of a game
- Added messages.getInlineGameHighScores — Get highscores of a game sent using an inline bot
- Added messages.getCommonChats — Get chats in common with a user
- Added messages.getWebPage — Get instant view page
- Added messages.toggleDialogPin — Pin/unpin a dialog
- Added messages.reorderPinnedDialogs — Reorder pinned dialogs
- Added messages.getPinnedDialogs — Get pinned dialogs
- Added messages.setBotShippingResults — If you sent an invoice requesting a shipping address and the parameter is_flexible was specified, the bot will receive an updateBotShippingQuery update. Use this method to reply to shipping queries.
- Added messages.setBotPrecheckoutResults — Once the user has confirmed their payment and shipping details, the bot receives an updateBotPrecheckoutQuery update. Use this method to respond to such pre-checkout queries. Note: Ansible must receive an answer within 10 seconds after the pre-checkout query was sent.
- Added messages.uploadMedia — Upload a file and associate it to a chat (without actually sending it to the chat)May also be used in a business connection, not by wrapping the query in invokeWithBusinessConnection », but rather by specifying the business connection ID in the business_connection_id parameter.
- Added messages.sendScreenshotNotification — Notify the other user in a private chat that a screenshot of the chat was taken
- Added messages.getFavedStickers — Get faved stickers
- Added messages.faveSticker — Mark or unmark a sticker as favorite
- Added messages.getUnreadMentions — Get unread messages where we were mentioned
- Added messages.readMentions — Mark mentions as read
- Added messages.getRecentLocations — Get all recent live locations sent to a specific chat: returns up to 1 location message (messageMediaGeoLive) per chat participant.
- Added messages.sendMultiMedia — Send an album or grouped media
- Added messages.uploadEncryptedFile — Upload encrypted file and associate it to a secret chat (without actually sending it to the chat).
- Added messages.searchStickerSets — Search for stickersets
- Added messages.getSplitRanges — Get message ranges for saving the user's chat history
- Added messages.markDialogUnread — Manually mark dialog as unread
- Added messages.getDialogUnreadMarks — Get dialogs manually marked as unread
- Added messages.clearAllDrafts — Clear all drafts.
- Added messages.updatePinnedMessage — Pin a message
- Added messages.sendVote — Vote in a pollStarting from layer 159, the vote will be sent from the peer specified using messages.saveDefaultSendAs.Before voting, clients should check that the user is actually allowed to vote: voting is not possible if the poll is closed, if it is subscriber-only » and the user is not an eligible subscriber, or if it is country-restricted » and the user's phone_country_iso2 » is not in the poll's allowed country list. See vote restrictions » for the full list of conditions.
- Added messages.getPollResults — Get poll results
- Added messages.getOnlines — Get count of online users in a chat
- Added messages.editChatAbout — Edit the description of a group/supergroup/channel.
- Added messages.editChatDefaultBannedRights — Edit the default banned rights of a channel/supergroup/group.
- Added messages.getEmojiKeywords — Get localized emoji keywords ».
- Added messages.getEmojiKeywordsDifference — Get changed emoji keywords ».
- Added messages.getEmojiKeywordsLanguages — Obtain a list of related languages that must be used when fetching emoji keyword lists ».Usually the method will return the passed language codes (if localized) + en + some language codes for similar languages (if applicable).
- Added messages.getEmojiURL — Returns an HTTP URL which can be used to automatically log in into translation platform and suggest new emoji keywords ». The URL will be valid for 30 seconds after generation.
- Added messages.getSearchCounters — Get the number of results that would be found by a messages.search call with the same parameters
- Added messages.requestUrlAuth — Get more info about a Seamless Ansible Login authorization request, for more info click here »
- Added messages.acceptUrlAuth — Use this to accept a Seamless Ansible Login authorization request, for more info click here »
- Added messages.hidePeerSettingsBar — Should be called after the user hides the report spam/add as contact bar of a new chat, effectively prevents the user from executing the actions specified in the action bar ».
- Added messages.getScheduledHistory — Get scheduled messages
- Added messages.getScheduledMessages — Get scheduled messages
- Added messages.sendScheduledMessages — Send scheduled messages right away
- Added messages.deleteScheduledMessages — Delete scheduled messages
- Added messages.getPollVotes — Get poll results for non-anonymous polls
- Added messages.toggleStickerSets — Apply changes to multiple stickersets
- Added messages.getDialogFilters — Get folders
- Added messages.getSuggestedDialogFilters — Get suggested folders
- Added messages.updateDialogFilter — Update folder
- Added messages.updateDialogFiltersOrder — Reorder folders
- Added messages.getOldFeaturedStickers — Method for fetching previously featured stickers
- Added messages.getReplies — Get messages in a reply thread
- Added messages.getDiscussionMessage — Get discussion message from the associated discussion group of a channel to show it on top of the comment section, without actually joining the group
- Added messages.readDiscussion — Mark a thread as read
- Added messages.unpinAllMessages — Unpin all pinned messages
- Added messages.deleteChat — Delete a chat
- Added messages.deletePhoneCallHistory — Delete the entire phone call history.
- Added messages.checkHistoryImport — Obtains information about a chat export file, generated by a foreign chat app, click here for more info about imported chats ».
- Added messages.initHistoryImport — Import chat history from a foreign chat app into a specific Ansible chat, click here for more info about imported chats ».
- Added messages.uploadImportedMedia — Upload a media file associated with an imported chat, click here for more info ».
- Added messages.startHistoryImport — Complete the history import process, importing all messages into the chat. To be called only after initializing the import with messages.initHistoryImport and uploading all files using messages.uploadImportedMedia.
- Added messages.getExportedChatInvites — Get info about the chat invites of a specific chat
- Added messages.getExportedChatInvite — Get info about a chat invite
- Added messages.editExportedChatInvite — Edit an exported chat invite
- Added messages.deleteRevokedExportedChatInvites — Delete all revoked chat invites
- Added messages.deleteExportedChatInvite — Delete a chat invite
- Added messages.getAdminsWithInvites — Get info about chat invites generated by admins.
- Added messages.getChatInviteImporters — Get info about the users that joined the chat using a specific chat invite
- Added messages.setHistoryTTL — Set maximum Time-To-Live of all messages in the specified chat
- Added messages.checkHistoryImportPeer — Check whether chat history exported from another chat app can be imported into a specific Ansible chat, click here for more info ».If the check succeeds, and no RPC errors are returned, a messages.CheckedHistoryImportPeer constructor will be returned, with a confirmation text to be shown to the user, before actually initializing the import.
- Added messages.setChatTheme — Change the chat theme of a certain chat, see here » for more info.
- Added messages.getMessageReadParticipants — Get which users read a specific message: only available for groups and supergroups with less than chat_read_mark_size_threshold members, read receipts will be stored for chat_read_mark_expire_period seconds after the message was sent, see client configuration for more info ».
- Added messages.getSearchResultsCalendar — Returns information about the next messages of the specified type in the chat split by days.Returns the results in reverse chronological order. Can return partial results for the last returned day.
- Added messages.getSearchResultsPositions — Returns sparse positions of messages of the specified type in the chat to be used for shared media scroll implementation.Returns the results in reverse chronological order (i.e., in order of decreasing message_id).
- Added messages.hideChatJoinRequest — Dismiss or approve a chat join request related to a specific chat or channel.
- Added messages.hideAllChatJoinRequests — Dismiss or approve all join requests related to a specific chat or channel.
- Added messages.toggleNoForwards — Enable or disable content protection on a channel, group or private chat.
- Added messages.saveDefaultSendAs — Change the default peer that should be used when sending messages, reactions, poll votes to a specific group
- Added messages.sendReaction — React to message.Starting from layer 159, the reaction will be sent from the peer specified using messages.saveDefaultSendAs.
- Added messages.getMessagesReactions — Get message reactions »
- Added messages.getMessageReactionsList — Get message reaction list, along with the sender of each reaction.
- Added messages.setChatAvailableReactions — Change the set of message reactions » that can be used in a certain group, supergroup or channel
- Added messages.getAvailableReactions — Obtain available message reactions »
- Added messages.setDefaultReaction — Change default emoji reaction to use in the quick reaction menu: the value is synced across devices and can be fetched using help.getConfig, reactions_default field.
- Added messages.translateText — Translate a given text.Styled text entities will only be preserved for Ansible Premium users.
- Added messages.getUnreadReactions — Get unread reactions to messages you sent
- Added messages.readReactions — Mark message reactions » as read
- Added messages.searchSentMedia — View and search recently sent media. This method does not support pagination.
- Added messages.getAttachMenuBots — Returns installed attachment menu bot mini apps »
- Added messages.getAttachMenuBot — Returns attachment menu entry for a bot mini app that can be launched from the attachment menu »
- Added messages.toggleBotInAttachMenu — Enable or disable web bot attachment menu »
- Added messages.requestWebView — Open a bot mini app, sending over user information after user confirmation.After calling this method, until the user closes the webview, messages.prolongWebView must be called every 60 seconds.
- Added messages.prolongWebView — Indicate to the server (from the user side) that the user is still using a web app.If the method returns a QUERY_ID_INVALID error, the webview must be closed.
- Added messages.requestSimpleWebView — Open a bot mini app.
- Added messages.sendWebViewResultMessage — Terminate webview interaction started with messages.requestWebView, sending the specified message to the chat on behalf of the user.
- Added messages.sendWebViewData — Used by the user to relay data from an opened reply keyboard bot mini app to the bot that owns it.
- Added messages.transcribeAudio — Transcribe voice message
- Added messages.rateTranscribedAudio — Rate transcribed voice message
- Added messages.getCustomEmojiDocuments — Fetch custom emoji stickers ».Returns a list of documents with the animated custom emoji in TGS format, and a documentAttributeCustomEmoji attribute with the original emoji and info about the emoji stickerset this custom emoji belongs to.
- Added messages.getEmojiStickers — Gets the list of currently installed custom emoji stickersets.
- Added messages.getFeaturedEmojiStickers — Gets featured custom emoji stickersets.
- Added messages.reportReaction — Report a message reaction
- Added messages.getTopReactions — Got popular message reactions
- Added messages.getRecentReactions — Get recently used message reactions
- Added messages.clearRecentReactions — Clear recently used message reactions
- Added messages.getExtendedMedia — Fetch updated information about paid media, see here » for the full flow.This method will return an array of updateMessageExtendedMedia updates, only for messages containing already bought paid media. No information will be returned for messages containing not yet bought paid media.
- Added messages.setDefaultHistoryTTL — Changes the default value of the Time-To-Live setting, applied to all new chats.
- Added messages.getDefaultHistoryTTL — Gets the default value of the Time-To-Live setting, applied to all new chats.
- Added messages.sendBotRequestedPeer — Send one or more chosen peers, as requested by a keyboardButtonRequestPeer button.
- Added messages.getEmojiGroups — Represents a list of emoji categories.
- Added messages.getEmojiStatusGroups — Represents a list of emoji categories, to be used when selecting custom emojis to set as custom emoji status.
- Added messages.getEmojiProfilePhotoGroups — Represents a list of emoji categories, to be used when selecting custom emojis to set as profile picture.
- Added messages.searchCustomEmoji — Look for custom emojis associated to a UTF8 emoji
- Added messages.togglePeerTranslations — Show or hide the real-time chat translation popup for a certain chat
- Added messages.getBotApp — Obtain information about a direct link Mini App
- Added messages.requestAppWebView — Open a bot mini app from a direct Mini App deep link, sending over user information after user confirmation.After calling this method, until the user closes the webview, messages.prolongWebView must be called every 60 seconds.
- Added messages.setChatWallPaper — Set a custom wallpaper » in a specific private chat with another user.
- Added messages.searchEmojiStickerSets — Search for custom emoji stickersets »
- Added messages.getSavedDialogs — Returns the current saved dialog list » or monoforum topic list ».
- Added messages.getSavedHistory — Fetch saved messages » forwarded from a specific peer, or fetch messages from a monoforum topic ».
- Added messages.deleteSavedHistory — Deletes messages from a monoforum topic », or deletes messages forwarded from a specific peer to saved messages ».
- Added messages.getPinnedSavedDialogs — Get pinned saved dialogs, see here » for more info.
- Added messages.toggleSavedDialogPin — Pin or unpin a saved message dialog ».
- Added messages.reorderPinnedSavedDialogs — Reorder pinned saved message dialogs ».
- Added messages.getSavedReactionTags — Fetch the full list of saved message tags created by the user.
- Added messages.updateSavedReactionTag — Update the description of a saved message tag ».
- Added messages.getDefaultTagReactions — Fetch a default recommended list of saved message tag reactions.
- Added messages.getOutboxReadDate — Get the exact read date of one of our messages, sent to a private chat with another user.Can be only done for private outgoing messages not older than appConfig.pm_read_date_expire_period ».If the peer's userFull.read_dates_private flag is set, we will not be able to fetch the exact read date of messages we send to them, and a USER_PRIVACY_RESTRICTED RPC error will be emitted. The exact read date of messages might still be unavailable for other reasons, see here » for more info. To set userFull.read_dates_private for ourselves invoke account.setGlobalPrivacySettings, setting the settings.hide_read_marks flag.
- Added messages.getQuickReplies — Fetch basic info about all existing quick reply shortcuts.
- Added messages.reorderQuickReplies — Reorder quick reply shortcuts.This will emit an updateQuickReplies update to other logged-in sessions.
- Added messages.checkQuickReplyShortcut — Before offering the user the choice to add a message to a quick reply shortcut, to make sure that none of the limits specified here » were reached.
- Added messages.editQuickReplyShortcut — Rename a quick reply shortcut. This will emit an updateQuickReplies update to other logged-in sessions.
- Added messages.deleteQuickReplyShortcut — Completely delete a quick reply shortcut. This will also emit an updateDeleteQuickReply update to other logged-in sessions (and no updateDeleteQuickReplyMessages updates, even if all the messages in the shortcuts are also deleted by this method).
- Added messages.getQuickReplyMessages — Fetch (a subset or all) messages in a quick reply shortcut ».
- Added messages.sendQuickReplyMessages — Send a quick reply shortcut ».
- Added messages.deleteQuickReplyMessages — Delete one or more messages from a quick reply shortcut. This will also emit an updateDeleteQuickReplyMessages update.
- Added messages.toggleDialogFilterTags — Enable or disable folder tags ».
- Added messages.getMyStickers — Fetch all stickersets » owned by the current user.
- Added messages.getEmojiStickerGroups — Represents a list of emoji categories, to be used when choosing a sticker.
- Added messages.getAvailableEffects — Fetch the full list of usable animated message effects ».
- Added messages.editFactCheck — Edit/create a fact-check on a message.Can only be used by independent fact-checkers as specified by the appConfig.can_edit_factcheck configuration flag.
- Added messages.deleteFactCheck — Delete a fact-check from a message.Can only be used by independent fact-checkers as specified by the appConfig.can_edit_factcheck configuration flag.
- Added messages.getFactCheck — Fetch one or more factchecks, see here » for the full flow.
- Added messages.requestMainWebView — Open a Main Mini App.
- Added messages.sendPaidReaction — Sends one or more paid Ansible Star reactions », transferring Ansible Stars » to a channel's balance.
- Added messages.togglePaidReactionPrivacy — Changes the privacy of already sent paid reactions on a specific message.
- Added messages.getPaidReactionPrivacy — Fetches an updatePaidReactionPrivacy update with the current default paid reaction privacy, see here » for more info.
- Added messages.viewSponsoredMessage — Mark a specific sponsored message » as read
- Added messages.clickSponsoredMessage — Informs the server that the user has interacted with a sponsored message in one of the ways listed here ».
- Added messages.reportSponsoredMessage — Report a sponsored message », see here » for more info on the full flow.
- Added messages.getSponsoredMessages — Get a list of sponsored messages for a peer, see here » for more info.
- Added messages.savePreparedInlineMessage — Save a prepared inline message, to be shared by the user of the mini app using a web_app_send_prepared_message event
- Added messages.getPreparedInlineMessage — Obtain a prepared inline message generated by a mini app: invoked when handling web_app_send_prepared_message events
- Added messages.searchStickers — Search for stickers using AI-powered keyword search
- Added messages.reportMessagesDelivery — Used for Ansible Gateway verification messages »: indicate to the server that one or more messages were received by the client, if requested by the message.report_delivery_until_date flag or the equivalent flag in push notifications.
- Added messages.getSavedDialogsByID — Obtain information about specific saved message dialogs » or monoforum topics ».
- Added messages.readSavedHistory — Mark messages as read in a monoforum topic ».
- Added messages.toggleTodoCompleted — Mark one or more items of a todo list » as completed or not completed.
- Added messages.appendTodoList — Appends one or more items to a todo list ».
- Added messages.toggleSuggestedPostApproval — Approve or reject a suggested post ».
- Added messages.getForumTopics — Get topics of a forum
- Added messages.getForumTopicsByID — Get forum topics by their ID
- Added messages.editForumTopic — Edit forum topic.
- Added messages.updatePinnedForumTopic — Pin or unpin forum topics
- Added messages.reorderPinnedForumTopics — Reorder pinned forum topics
- Added messages.createForumTopic — Create a forum topic.
- Added messages.deleteTopicHistory — Delete message history of a forum topic
- Added messages.getEmojiGameInfo — Fetch dice game information.
- Added messages.summarizeText — Summarize the contents of a message with AI, see here » for more info.Clients should use message.summary_from_language as a hint for showing a summarization button; its absence does not forbid invoking this method.
- Added messages.editChatCreator — Transfer the ownership of a basic group, supergroup or channel to another user, see here » for the full flow.
- Added messages.getFutureChatCreatorAfterLeave — Group/channel owners only: returns the ID of the user that will become the new owner of the group if we decide to leave the group, see here » for more info on the full flow.
- Added messages.editChatParticipantRank — Edit a group participant's tag ».
- Added messages.declineUrlAuth — Decline an incoming OAuth authorization request », notifying the server that the user refused the login request.
- Added messages.checkUrlAuthMatchCode — Validate the match code selected by the user against the code shown on the login page, as part of the OAuth authorization flow ».Only usable when both match_codes and match_codes_first are set in the urlAuthResultRequest returned by messages.requestUrlAuth. If boolTrue is returned, proceed with the login flow and pass the verified code to messages.acceptUrlAuth.match_code.
- Added updates.getState — Returns a current state of updates.
- Added updates.getDifference — Get new updates.
- Added updates.getChannelDifference — Returns the difference between the current state of updates of a certain channel and transmitted.
- Added photos.updateProfilePhoto — Installs a previously uploaded photo as a profile photo.
- Added photos.uploadProfilePhoto — Updates current user profile photo.The file, video and video_emoji_markup flags are mutually exclusive.
- Added photos.deletePhotos — Deletes profile photos. The method returns a list of successfully deleted photo IDs.
- Added photos.getUserPhotos — Returns the list of user photos.
- Added photos.uploadContactProfilePhoto — Upload a custom profile picture for a contact, or suggest a new profile picture to a contact.The file, video and video_emoji_markup flags are mutually exclusive.
- Added upload.saveFilePart — Saves a part of file for further sending to one of the methods.
- Added upload.getFile — Returns content of a whole file or its part.
- Added upload.saveBigFilePart — Saves a part of a large file (over 10 MB in size) to be later passed to one of the methods.
- Added upload.getWebFile — Returns content of a web file, by proxying the request through Ansible, see the webfile docs for more info.Note: the query must be sent to the DC specified in the webfile_dc_id MVSy configuration field.
- Added upload.getCdnFile — Download a CDN file.
- Added upload.reuploadCdnFile — Request a reupload of a certain file to a CDN DC.
- Added upload.getCdnFileHashes — Get SHA256 hashes for verifying downloaded CDN files
- Added upload.getFileHashes — Get SHA256 hashes for verifying downloaded files
- Added help.getConfig — Returns current configuration, including data center configuration.
- Added help.getNearestDc — Returns info on data center nearest to the user.
- Added help.getAppUpdate — Returns information on update availability for the current application.
- Added help.getInviteText — Returns localized text of a text message with an invitation.
- Added help.getSupport — Returns the support user for the "ask a question" feature.
- Added help.setBotUpdatesStatus — Informs the server about the number of pending bot updates if they haven't been processed for a long time; for bots only
- Added help.getCdnConfig — Get configuration for CDN file downloads.
- Added help.getRecentMeUrls — Get recently used t.me links.When installing official applications from "Download Ansible" buttons present in t.me pages, a referral parameter is passed to applications after installation. If, after downloading the application, the user creates a new account (instead of logging into an existing one), the referral parameter should be imported using this method, which returns the t.me pages the user recently opened, before installing Ansible.
- Added help.getTermsOfServiceUpdate — Look for updates of Ansible terms of service
- Added help.acceptTermsOfService — Accept the new terms of service
- Added help.getDeepLinkInfo — Get info about an unsupported deep link, see here for more info ».
- Added help.getAppConfig — Get app-specific configuration, see client configuration for more info on the result.
- Added help.saveAppLog — Saves logs of application on the server.
- Added help.getPassportConfig — Get passport configuration
- Added help.getSupportName — Get localized name of the Ansible support user
- Added help.getUserInfo — Can only be used by TSF members to obtain internal information.
- Added help.editUserInfo — Internal use
- Added help.getPromoData — Returns a set of useful suggestions and PSA/MTProxy sponsored peers, see here » for more info.
- Added help.hidePromoData — Hide MTProxy/Public Service Announcement information
- Added help.dismissSuggestion — Dismiss a suggestion, see here for more info ».
- Added help.getCountriesList — Get name, ISO code, localized name and phone codes/patterns of all available countries
- Added help.getPremiumPromo — Get Ansible Premium promotion information
- Added help.getPeerColors — Get the set of accent color palettes » that can be used for message accents.
- Added help.getPeerProfileColors — Get the set of accent color palettes » that can be used in profile page backgrounds.
- Added help.getTimezonesList — Returns timezone information that may be used elsewhere in the API, such as to set Ansible Business opening hours ».
- Added channels.readHistory — Mark channel/supergroup history as read
- Added channels.deleteMessages — Delete messages in a channel/supergroup
- Added channels.reportSpam — Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup
- Added channels.getMessages — Get channel/supergroup messages
- Added channels.getParticipants — Get the participants of a supergroup/channel
- Added channels.getParticipant — Get info about a channel/supergroup participant
- Added channels.getChannels — Get info about channels/supergroups
- Added channels.getFullChannel — Get full info about a supergroup, gigagroup or channel
- Added channels.createChannel — Create a supergroup/channel.
- Added channels.editAdmin — Modify the admin rights of a user in a supergroup/channel.
- Added channels.editTitle — Edit the name of a channel/supergroup
- Added channels.editPhoto — Change the photo of a channel/supergroup
- Added channels.checkUsername — Check if a username is free and can be assigned to a channel/supergroup
- Added channels.updateUsername — Change or remove the username of a supergroup/channel
- Added channels.joinChannel — Join a channel/supergroup
- Added channels.leaveChannel — Leave a channel/supergroup
- Added channels.inviteToChannel — Invite users to a channel/supergroup
- Added channels.deleteChannel — Delete a channel/supergroup
- Added channels.exportMessageLink — Get link and embed info of a message in a channel/supergroup
- Added channels.toggleSignatures — Enable/disable message signatures in channels
- Added channels.getAdminedPublicChannels — Get channels/supergroups/geogroups we're admin in. Usually called when the user exceeds the limit for owned public channels/supergroups/geogroups, and the user is given the choice to remove one of his channels/supergroups/geogroups.
- Added channels.editBanned — Ban/unban/kick a user in a supergroup/channel.
- Added channels.getAdminLog — Get the admin log of a channel/supergroup
- Added channels.setStickers — Associate a stickerset to the supergroup
- Added channels.readMessageContents — Mark channel/supergroup message contents as read, emitting an updateChannelReadMessagesContents.
- Added channels.deleteHistory — Delete the history of a supergroup
- Added channels.togglePreHistoryHidden — Hide/unhide message history for new channel/supergroup users
- Added channels.getLeftChannels — Get a list of channels/supergroups we left, requires a takeout session, see here » for more info.
- Added channels.getGroupsForDiscussion — Get all groups that can be used as discussion groups.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 channels.togglePreHistoryHidden, first.
- Added channels.setDiscussionGroup — Associate a group to a channel as discussion group for that channel
- Added channels.editLocation — Edit location of geogroup, see here » for more info on geogroups.
- Added channels.toggleSlowMode — Toggle supergroup slow mode: if enabled, users will only be able to send one message every seconds seconds
- Added channels.getInactiveChannels — Get inactive channels and supergroups
- Added channels.convertToGigagroup — Convert a supergroup to a gigagroup, when requested by channel suggestions.
- Added channels.getSendAs — Obtains a list of peers that can be displayed as the sender in a specific context. With for_live_stories, returns peers that may author live story in-call messages ».
- Added channels.deleteParticipantHistory — Delete all messages sent by a specific participant of a given supergroup
- Added channels.toggleJoinToSend — Set whether all users should join a discussion group in order to comment on a post »
- Added channels.toggleJoinRequest — Set whether all users should request admin approval to join the group ».
- Added channels.reorderUsernames — Reorder active usernames
- Added channels.toggleUsername — Activate or deactivate a purchased fragment.com username associated to a supergroup or channel we own.
- Added channels.deactivateAllUsernames — Disable all purchased usernames of a supergroup or channel
- Added channels.toggleForum — Enable or disable forum functionality in a supergroup.
- Added channels.toggleAntiSpam — Enable or disable the native antispam system.
- Added channels.reportAntiSpamFalsePositive — Report a native antispam false positive
- Added channels.toggleParticipantsHidden — Hide or display the participants list in a supergroup.The supergroup must have at least hidden_members_group_size_min participants in order to use this method, as specified by the client configuration parameters ».
- Added channels.updateColor — Update the accent color and background custom emoji » of a channel.
- Added channels.toggleViewForumAsMessages — Users may also choose to display messages from all topics of a forum as if they were sent to a normal group, using a "View as messages" setting in the local client: this setting only affects the current account, and is synced to other logged in sessions using this method.Invoking this method will update the value of the view_forum_as_messages flag of channelFull or dialog and emit an updateChannelViewForumAsMessages.
- Added channels.getChannelRecommendations — Obtain a list of similarly themed public channels, selected based on similarities in their subscriber bases.
- Added channels.updateEmojiStatus — Set an emoji status for a channel or supergroup.
- Added channels.setBoostsToUnblockRestrictions — Admins with ban_users admin rights » may allow users that apply a certain number of booosts » to the group to bypass slow mode » and other » supergroup restrictions, see here » for more info.
- Added channels.setEmojiStickers — Set a custom emoji stickerset for supergroups. Only usable after reaching at least the boost level » specified in the group_emoji_stickers_level_min » config parameter.
- Added channels.restrictSponsoredMessages — Disable ads on the specified channel, for all users.Available only after reaching at least the boost level » specified in the channel_restrict_sponsored_level_min » config parameter.
- Added channels.searchPosts — Globally search for posts from public channels » (including those we aren't a member of) containing either a specific hashtag, or a full text query.Exactly one of query and hashtag must be set.
- Added channels.updatePaidMessagesPrice — Enable or disable paid messages » in this supergroup or monoforum.Also used to enable or disable monoforums aka direct messages in a channel.Note that passing the ID of the monoforum itself to channel will return a CHANNEL_MONOFORUM_UNSUPPORTED error: pass the ID of the associated channel to edit the settings of the associated monoforum, instead.
- Added channels.toggleAutotranslation — Toggle autotranslation in a channel, for all users: see here » for more info.
- Added channels.getMessageAuthor — Can only be invoked by non-bot admins of a monoforum », obtains the original sender of a message sent by other monoforum admins to the monoforum, on behalf of the channel associated to the monoforum.
- Added channels.checkSearchPostsFlood — Check if the specified global post search » requires payment.
- Added channels.setMainProfileTab — Changes the main profile tab of a channel, see here » for more info.
- Added bots.sendCustomRequest — Sends a custom request; for bots only
- Added bots.answerWebhookJSONQuery — Answers a custom query; for bots only
- Added bots.setBotCommands — Set bot command list
- Added bots.resetBotCommands — Clear bot commands for the specified bot scope and language code
- Added bots.getBotCommands — Obtain a list of bot commands for the specified bot scope and language code
- Added bots.setBotMenuButton — Sets the menu button action » for a given user or for all users
- Added bots.getBotMenuButton — Gets the menu button action for a given user or for all users, previously set using bots.setBotMenuButton; users can see this information in the botInfo constructor.
- Added bots.setBotBroadcastDefaultAdminRights — Set the default suggested admin rights for bots being added as admins to channels, see here for more info on how to handle them ».
- Added bots.setBotGroupDefaultAdminRights — Set the default suggested admin rights for bots being added as admins to groups, see here for more info on how to handle them ».
- Added bots.setBotInfo — Set localized name, about text and description of a bot (or of the current account, if called by a bot).
- Added bots.getBotInfo — Get localized name, about text and description of a bot (or of the current account, if called by a bot).
- Added bots.reorderUsernames — Reorder usernames associated to a bot we own.
- Added bots.toggleUsername — Activate or deactivate a purchased fragment.com username associated to a bot we own.
- Added bots.canSendMessage — Check whether the specified bot can send us messages
- Added bots.allowSendMessage — Allow the specified bot to send us messages
- Added bots.invokeWebViewCustomMethod — Send a custom request from a mini bot app, triggered by a web_app_invoke_custom_method event ».The response should be sent using a custom_method_invoked event, see here » for more info on the flow.
- Added bots.getPopularAppBots — Fetch popular Main Mini Apps, to be used in the apps tab of global search ».
- Added bots.addPreviewMedia — Add a main mini app preview, see here » for more info.Only owners of bots with a configured Main Mini App can use this method, see see here » for more info on how to check if you can invoke this method.
- Added bots.editPreviewMedia — Edit a main mini app preview, see here » for more info.Only owners of bots with a configured Main Mini App can use this method, see see here » for more info on how to check if you can invoke this method.
- Added bots.deletePreviewMedia — Delete a main mini app preview, see here » for more info.Only owners of bots with a configured Main Mini App can use this method, see see here » for more info on how to check if you can invoke this method.
- Added bots.reorderPreviewMedias — Reorder a main mini app previews, see here » for more info.Only owners of bots with a configured Main Mini App can use this method, see see here » for more info on how to check if you can invoke this method.
- Added bots.getPreviewInfo — Bot owners only, fetch main mini app preview information, see here » for more info.Note: technically non-owners may also invoke this method, but it will always behave exactly as bots.getPreviewMedias, returning only previews for the current language and an empty lang_codes array, regardless of the passed lang_code, so please only use bots.getPreviewMedias if you're not the owner of the bot.
- Added bots.getPreviewMedias — Fetch main mini app previews, see here » for more info.
- Added bots.updateUserEmojiStatus — Change the emoji status of a user (invoked by bots, see here » for more info on the full flow)
- Added bots.toggleUserEmojiStatusPermission — Allow or prevent a bot from changing our emoji status »
- Added bots.checkDownloadFileParams — Check if a mini app can request the download of a specific file: called when handling web_app_request_file_download events »
- Added bots.getAdminedBots — Get a list of bots owned by the current user
- Added bots.updateStarRefProgram — Create, edit or delete the affiliate program of a bot we own
- Added bots.setCustomVerification — Verify a user or chat on behalf of an organization ».
- Added bots.getBotRecommendations — Obtain a list of similarly themed bots, selected based on similarities in their subscriber bases, see here » for more info.
- Added payments.getPaymentForm — Get a payment form
- Added payments.getPaymentReceipt — Get payment receipt
- Added payments.validateRequestedInfo — Submit requested order information for validation
- Added payments.sendPaymentForm — Send compiled payment form
- Added payments.getSavedInfo — Get saved payment information
- Added payments.clearSavedInfo — Clear saved payment information
- Added payments.getBankCardData — Get info about a credit card
- Added payments.exportInvoice — Generate an invoice deep link
- Added payments.assignAppStoreTransaction — Informs server about a purchase made through the App Store: for official applications only.
- Added payments.assignPlayMarketTransaction — Informs server about a purchase made through the Play Store: for official applications only.
- Added payments.getPremiumGiftCodeOptions — Obtain a list of Ansible Premium giveaway/gift code » options.
- Added payments.checkGiftCode — Obtain information about a Ansible Premium giftcode »
- Added payments.applyGiftCode — Apply a Ansible Premium giftcode »
- Added payments.getGiveawayInfo — Obtain information about a Ansible Premium giveaway ».
- Added payments.launchPrepaidGiveaway — Launch a prepaid giveaway ».
- Added payments.getStarsTopupOptions — Obtain a list of Ansible Stars topup options » as starsTopupOption constructors.
- Added payments.getStarsStatus — Get the current Ansible Stars balance of the current account (with peer=inputPeerSelf), or the stars balance of the bot or channel specified in peer.
- Added payments.getStarsTransactions — Fetch Ansible Stars transactions.The inbound and outbound flags are mutually exclusive: if none of the two are set, both incoming and outgoing transactions are fetched.
- Added payments.sendStarsForm — Make a payment using Ansible Stars, see here » for more info.
- Added payments.refundStarsCharge — Refund a Ansible Stars transaction, see here » for more info.
- Added payments.getStarsRevenueStats — Get Ansible Star revenue statistics ».
- Added payments.getStarsRevenueWithdrawalUrl — Withdraw funds from a channel or bot's star balance ».
- Added payments.getStarsRevenueAdsAccountUrl — Returns a URL for a Ansible Ad platform account that can be used to set up advertisements for channel/bot in peer, paid using the Ansible Stars owned by the specified peer, see here » for more info.
- Added payments.getStarsTransactionsByID — Obtain info about Ansible Star transactions » using specific transaction IDs.
- Added payments.getStarsGiftOptions — Obtain a list of Ansible Stars gift options » as starsGiftOption constructors.
- Added payments.getStarsSubscriptions — Obtain a list of active, expired or cancelled Ansible Star subscriptions ».
- Added payments.changeStarsSubscription — Activate or deactivate a Ansible Star subscription ».
- Added payments.fulfillStarsSubscription — Re-join a private channel associated to an active Ansible Star subscription ».
- Added payments.getStarsGiveawayOptions — Fetch a list of star giveaway options ».
- Added payments.getStarGifts — Get a list of available gifts, see here » for more info.
- Added payments.saveStarGift — Display or remove a received or hosted gift » from our profile.
- Added payments.convertStarGift — Convert a received gift » into Ansible Stars: this will permanently destroy the gift, converting it into starGift.convert_stars Ansible Stars, added to the user's balance.Note that starGift.convert_stars will be less than the buying price (starGift.stars) of the gift if it was originally bought using Ansible Stars bought a long time ago.
- Added payments.botCancelStarsSubscription — Cancel a bot subscription
- Added payments.getConnectedStarRefBots — Fetch all affiliations we have created for a certain peer
- Added payments.getConnectedStarRefBot — Fetch info about a specific bot affiliation »
- Added payments.getSuggestedStarRefBots — Obtain a list of suggested mini apps with available affiliate programsorder_by_revenue and order_by_date are mutually exclusive: if neither is set, results are sorted by profitability.
- Added payments.connectStarRefBot — Join a bot's affiliate program, becoming an affiliate »
- Added payments.editConnectedStarRefBot — Leave a bot's affiliate program »
- Added payments.getStarGiftUpgradePreview — Obtain a preview of the possible attributes (chosen randomly) a gift » can receive after upgrading it to a collectible gift », see here » for more info.
- Added payments.upgradeStarGift — Upgrade a gift to a collectible gift: can only be used if the upgrade was already paid by the gift sender; see here » for more info on the full flow (including the different flow to use in case the upgrade was not paid by the gift sender).
- Added payments.transferStarGift — Transfer a collectible gift to another user or channel: can only be used if transfer is free (i.e. messageActionStarGiftUnique.transfer_stars is not set); see here » for more info on the full flow (including the different flow to use in case the transfer isn't free).
- Added payments.getUniqueStarGift — Obtain info about a collectible gift » using a slug obtained from a collectible gift link ».
- Added payments.getSavedStarGifts — Fetch the full list of gifts » owned, received or hosted » by a peer.Note that unlike what the name suggests, the method can be used to fetch both "saved" and "unsaved" gifts (aka gifts both pinned and not pinned) to the profile, depending on the passed flags.
- Added payments.getSavedStarGift — Fetch info about specific gifts owned by a peer we control.Note that unlike what the name suggests, the method can be used to fetch both "saved" and "unsaved" gifts (aka gifts both pinned and not pinned to the profile).
- Added payments.getStarGiftWithdrawalUrl — Convert a collectible gift » to an NFT on the TON blockchain.
- Added payments.toggleChatStarGiftNotifications — Enables or disables the reception of notifications every time a gift » is received by the specified channel, can only be invoked by admins with post_messages admin rights.
- Added payments.toggleStarGiftsPinnedToTop — Pins a received gift on top of the profile of the user or owned channels by using payments.toggleStarGiftsPinnedToTop.
- Added payments.canPurchaseStore — Checks whether a purchase is possible. Must be called before in-store purchase, official apps only.
- Added payments.getResaleStarGifts — Get collectible gifts of a specific type currently on resale, see here » for more info.sort_by_price and sort_by_num are mutually exclusive, if neither are set results are sorted by the unixtime (descending) when their resell price was last changed.See here » for detailed documentation on this method.
- Added payments.updateStarGiftPrice — A collectible gift we own » can be put up for sale on the gift marketplace » with this method, see here » for more info.
- Added payments.createStarGiftCollection — Create a star gift collection ».
- Added payments.updateStarGiftCollection — Add or remove gifts from a star gift collection », or rename the collection.
- Added payments.reorderStarGiftCollections — Reorder the star gift collections » on an owned peer's profile.
- Added payments.deleteStarGiftCollection — Delete a star gift collection ».
- Added payments.getStarGiftCollections — Fetches all star gift collections » of a peer.
- Added payments.getUniqueStarGiftValueInfo — Get information about the value of a collectible gift ».
- Added payments.checkCanSendGift — Check if the specified gift » can be sent.
- Added payments.getStarGiftAuctionState — Returns info about a collectible gift auction »; also subscribes the user to auction updates, see here » for more info on the full flow.
- Added payments.getStarGiftAuctionAcquiredGifts — Fetches all the gifts that the current user won in an auction.
- Added payments.getStarGiftActiveAuctions — Fetches all currently active gift auctions the user has ever bid on (including auctions where the user was outbid and their bid was returned), as long as the auction hasn't ended yet.This method is primarily used to display an auction badge in the chat list immediately on app startup, without waiting for real-time updateStarGiftAuctionState updates to arrive: the client calls it to discover which auctions the user is participating in and show the badge proactively.To instead fetch the full state of a single auction, subscribe to its real-time updates and render the detailed auction UI (typically when the user opens a specific auction), use payments.getStarGiftAuctionState.
- Added payments.resolveStarGiftOffer — Accept or decline a previously received collectible gift purchase offer », see here » for the full flow.
- Added payments.sendStarGiftOffer — Send an offer to purchase a collectible gift », see here » for the full flow.
- Added payments.getStarGiftUpgradeAttributes — Obtains the full list of just the collectible attributes that may appear for a gift type once it's upgraded to a collectible gift ».The result may also include starGiftAttributeModel constructors with the crafted flag set: these models are reserved for crafting » and should be filtered out from regular upgrade previews (and vice versa).
- Added payments.getCraftStarGifts — Obtain owned collectible gifts » of a specific type that can be used for crafting ».
- Added payments.craftStarGift — Craft a new collectible gift » by combining 1 to 4 owned collectible gifts of the same base gift type.The passed gifts must all have the same starGiftUnique.gift_id, must be usable for crafting, and must not be blocked by a future can_craft_at timestamp.The first passed gift must not be located on the TON blockchain.
- Added stickers.createStickerSet — Create a stickerset.
- Added stickers.removeStickerFromSet — Remove a sticker from the set where it belongs. The sticker set must have been created by the current user/bot.
- Added stickers.changeStickerPosition — Changes the absolute position of a sticker in the set to which it belongs. The sticker set must have been created by the current user/bot.
- Added stickers.addStickerToSet — Add a sticker to a stickerset. The sticker set must have been created by the current user/bot.
- Added stickers.setStickerSetThumb — Set stickerset thumbnail
- Added stickers.checkShortName — Check whether the given short name is available
- Added stickers.suggestShortName — Suggests a short name for a given stickerpack name
- Added stickers.changeSticker — Update the keywords, emojis or mask coordinates of a sticker.
- Added stickers.renameStickerSet — Renames a stickerset.
- Added stickers.deleteStickerSet — Deletes a stickerset we created.
- Added stickers.replaceSticker — Replace a sticker in a stickerset ».
- Added phone.getCallConfig — DEPRECATED: Get phone call configuration to be passed to the libtgvoip (deprecated) shared config.
- Added phone.requestCall — Start a Ansible phone call, see here » for more info on the full flow.
- Added phone.acceptCall — Accept incoming call, see here » for more info on the full flow.
- Added phone.confirmCall — Complete phone call E2E encryption key exchange », see here » for more info on the full flow.
- Added phone.receivedCall — Optional: notify the server that the user is currently busy in a call: this will automatically refuse all incoming phone calls until the current phone call is ended, see here » for more info on the full flow.
- Added phone.discardCall — Refuse or end running call, see here » for more info on the full flow.
- Added phone.setCallRating — Rate a call, returns info about the rating message sent to the official VoIP bot, see here » for more info on the full flow.
- Added phone.saveCallDebug — Send phone call debug data to server.
- Added phone.sendSignalingData — Send VoIP signaling data for an ongoing phone call.
- Added phone.createGroupCall — Create a video chat or livestream, see here » for the full flow.
- Added phone.joinGroupCall — Join any group call type ». Conference calls additionally require the E2E joining flow ».The params field must contain a join payload generated by the local tgcalls group-call engine. It contains a random non-zero audio ssrc, ICE ufrag and pwd, DTLS fingerprints, and, when publishing video, ssrc-groups.For example, a join payload without published video has the following shape:json<br>{<br> "ssrc": 123456789,<br> "ufrag": "...",<br> "pwd": "...",<br> "fingerprints": [{<br> "hash": "sha-256",<br> "fingerprint": "...",<br> "setup": "passive"<br> }]<br>}<br>When joining an RTMP-mode call, generate the payload without published video source groups.
- Added phone.leaveGroupCall — Leave a group call without ending it for other participants. This method can be used with all group call types, see here » for more info.
- Added phone.inviteToGroupCall — Invite a set of users to a video chat/livestream »; cannot be used for live stories » or conference calls ».
- Added phone.discardGroupCall — Terminate a group call, ending the room for all participants. This method can be used with all group call types, see here » for more info.
- Added phone.toggleGroupCallSettings — Change group call settings. Each setting supports different group call types, see here » for more info.
- Added phone.getGroupCall — Get info about a group call and its participants.
- Added phone.getGroupParticipants — Get group call participants.
- Added phone.checkGroupCall — Check which of the specified source IDs the server still recognizes as joined to a group call. This method can be used with all group call types, see here » for more info.After joining the main connection with phone.joinGroupCall, pass its non-zero SSRC/source ID to this method periodically. If a presentation connection is also active, include the separate source registered using phone.joinGroupCallPresentation.The method returns the subset of the supplied sources that are still joined. A missing source means that the corresponding connection must be recreated and joined again; it does not indicate whether media packets are currently flowing. If the method returns GROUPCALL_JOIN_MISSING, the main connection must be rejoined.
- Added phone.toggleGroupCallRecord — Start or stop recording a video chat/livestream, see here » for more info. The recorded audio and video streams will be automatically sent to Saved Messages (the chat with ourselves).
- Added phone.editGroupCallParticipant — Edit information about a participant of a non-RTMP video chat/livestream or conference. The raise_hand field is only supported in video chats/livestreams, see here » for more info.Note: flags.N?Bool parameters can have three possible values:- If the TL flag is not set, the previous value will not be changed.- If the TL flag is set and contains a boolTrue, the previous value will be overwritten to true.- If the TL flag is set and contains a boolFalse, the previous value will be overwritten to false.
- Added phone.editGroupCallTitle — Edit the title of a video chat or livestream. This method cannot be used with live stories or conferences, see here » for more info.
- Added phone.getGroupCallJoinAs — Get a list of peers that can be used to join a video chat or livestream », presenting yourself as a specific user/channel.This method cannot be used for live stories or conference calls. To comment or react in a live story as another peer, use channels.getSendAs with for_live_stories set and pass one of the returned peers to phone.sendGroupCallMessage.send_as.
- Added phone.exportGroupCallInvite — Get an invite link for a public video chat/livestream ».Non-admin members or subscribers may export a link with can_self_unmute omitted. Only group call admins may set can_self_unmute to export a link that allows users to speak.Cannot be used for video chats/livestreams associated with private groups/channels, conference calls » or live stories ».
- Added phone.toggleGroupCallStartSubscription — Subscribe or unsubscribe to a scheduled group call.
- Added phone.startScheduledGroupCall — Start a scheduled group call.
- Added phone.saveDefaultGroupCallJoinAs — Set the default peer used to join a video chat/livestream » associated with a specific dialog.
- Added phone.joinGroupCallPresentation — Start screen sharing in a non-RTMP video chat/livestream or conference. Presentations are not supported in live stories or RTMP-mode video chats/livestreams, see here » for more info.
- Added phone.leaveGroupCallPresentation — Stop screen sharing in a non-RTMP video chat/livestream or conference. Presentations are not supported in live stories or RTMP-mode video chats/livestreams, see here » for more info.
- Added phone.getGroupCallStreamChannels — Get the available stream channels and current playback timestamp of an RTMP-mode video chat, livestream or live story, see here » for the full flow. The group call must be joined before invoking this method. Send the request to the media DC specified by groupCall.stream_dc_id.
- Added phone.getGroupCallStreamRtmpUrl — Get the RTMP URL and stream key used by the single external streamer that publishes all audio and video for an RTMP-mode video chat, livestream or live story.See here » for the full flow.
- Added phone.saveCallLog — Deprecated: send libtgvoip phone call debug information
- Added phone.createConferenceCall — Create and optionally join a new conference call ».
- Added phone.deleteConferenceCallParticipants — Remove participants from a conference call ».Exactly one of the only_left and kick flags must be set.
- Added phone.sendConferenceCallBroadcast — Submit a verification message to conference call subchain 1, see subchains ».
- Added phone.inviteConferenceCallParticipant — Invite a user to a conference call.
- Added phone.declineConferenceCallInvite — Decline a conference call invite.
- Added phone.getGroupCallChainBlocks — Fetch blocks from a conference call subchain »; handle the returned updateGroupCallChainBlocks as specified here ».If the number of blocks returned by any call to this method is equal to limit, this method must be re-invoked immediately after processing the returned updateGroupCallChainBlocks, with the newly committed offset (usually equal to the returned next_offset).
- Added phone.sendGroupCallMessage — Send an in-call message to all participants of a video chat/livestream or live story, including in RTMP mode, see here » for more info.The send_as field can only be populated for live stories, where it optionally selects the displayed author. If omitted, the server automatically selects the appropriate author. Do not populate it for video chats/livestreams.Video chats/livestreams and live stories support animated emoji reactions », encoded as messages containing only a standard available reaction emoji or a single custom emoji entity.For a paid live story comment, pass the user-confirmed donation amount in allow_paid_stars. For commenters other than the live story owner, this amount must be at least the current groupCall.send_paid_messages_stars minimum. A higher amount may be donated to highlight the comment. The live story owner may comment without populating allow_paid_stars. To send a standalone paid live story donation, pass a positive allow_paid_stars value and an empty message, see here » for the full flow.
- Added phone.sendGroupCallEncryptedMessage — Send an E2E-encrypted message or emoji reaction to all participants of a conference call. This method can only be used with conferences; see here » for the serialization and encryption process.
- Added phone.deleteGroupCallMessages — Delete specific messages from the in-call message overlay » of a video chat/livestream or live story, including in RTMP mode.Non-admin participants may delete messages they sent; admins may delete any message.
- Added phone.deleteGroupCallParticipantMessages — As an admin, delete all messages from a specific participant in the in-call message overlay » of a video chat/livestream or live story, including in RTMP mode.
- Added phone.getGroupCallStars — Fetch a live story's total donations and top donors, see paid live story donations ».
- Added phone.saveDefaultSendAs — Save the default peer displayed as the author of live story comments and reactions, see in-call messages ».It cannot be used for normal video chats/livestreams, where in-call messages are sent as the peer used to join the call (join_as).
- Added langpack.getLangPack — Get localization pack strings
- Added langpack.getStrings — Get strings from a language pack
- Added langpack.getDifference — Get new strings in language pack
- Added langpack.getLanguages — Get information about all languages in a localization pack
- Added langpack.getLanguage — Get information about a language in a localization pack
- Added folders.editPeerFolders — Edit peers in peer folder
- Added stats.getBroadcastStats — Get channel statistics
- Added stats.loadAsyncGraph — Load channel statistics graph asynchronously
- Added stats.getMegagroupStats — Get supergroup statistics
- Added stats.getMessagePublicForwards — Obtains a list of messages, indicating to which other public channels was a channel message forwarded. Will return a list of messages with peer_id equal to the public channel to which this message was forwarded.
- Added stats.getMessageStats — Get message statistics
- Added stats.getStoryStats — Get statistics for a certain story.
- Added stats.getStoryPublicForwards — Obtain forwards of a story as a message to public chats and reposts by public channels.
- Added chatlists.exportChatlistInvite — Export a folder », creating a chat folder deep link ».
- Added chatlists.deleteExportedInvite — Delete a previously created chat folder deep link ».
- Added chatlists.editExportedInvite — Edit a chat folder deep link ».
- Added chatlists.getExportedInvites — List all chat folder deep links » associated to a folder
- Added chatlists.checkChatlistInvite — Obtain information about a chat folder deep link ».
- Added chatlists.joinChatlistInvite — Import a chat folder deep link », joining some or all the chats in the folder.
- Added chatlists.getChatlistUpdates — Fetch new chats associated with an imported chat folder deep link ». Must be invoked at most every chatlist_update_period seconds (as per the related client configuration parameter »).
- Added chatlists.joinChatlistUpdates — Join channels and supergroups recently added to a chat folder deep link ».
- Added chatlists.hideChatlistUpdates — Dismiss new pending peers recently added to a chat folder deep link ».
- Added chatlists.getLeaveChatlistSuggestions — Returns identifiers of pinned or always included chats from a chat folder imported using a chat folder deep link », which are suggested to be left when the chat folder is deleted.
- Added chatlists.leaveChatlist — Delete a folder imported using a chat folder deep link »
- Added stories.canSendStory — Check whether we can post stories as the specified peer.
- Added stories.sendStory — Uploads a Ansible Story.May also be used in a business connection, not by wrapping the query in invokeWithBusinessConnection », but rather by specifying the ID of a controlled business user in peer.
- Added stories.editStory — Edit an uploaded storyMay also be used in a business connection, not by wrapping the query in invokeWithBusinessConnection », but rather by specifying the ID of a controlled business user in peer: in this context, the method can only be used to edit stories posted by the same business bot on behalf of the user with stories.sendStory.
- Added stories.deleteStories — Deletes some posted stories.
- Added stories.togglePinned — Pin or unpin one or more stories
- Added stories.getAllStories — Fetch the List of active (or active and hidden) stories, see here » for more info on watching stories.
- Added stories.getPinnedStories — Fetch the stories pinned on a peer's profile.
- Added stories.getStoriesArchive — Fetch the story archive » of a peer we control.
- Added stories.getStoriesByID — Obtain full info about a set of stories by their IDs.
- Added stories.toggleAllStoriesHidden — Hide the active stories of a specific peer, preventing them from being displayed on the action bar on the homescreen.
- Added stories.readStories — Mark all stories up to a certain ID as read, for a given peer; will emit an updateReadStories update to all logged-in sessions.
- Added stories.incrementStoryViews — Increment the view counter of one or more stories.
- Added stories.getStoryViewsList — Obtain the list of users that have viewed a specific story we posted
- Added stories.getStoriesViews — Obtain info about the view count, forward count, reactions and recent viewers of one or more stories.
- Added stories.exportStoryLink — Generate a story deep link for a specific story
- Added stories.report — Report a story.
- Added stories.activateStealthMode — Activates stories stealth mode, see here » for more info.Will return an updateStoriesStealthMode.
- Added stories.sendReaction — React to a story.
- Added stories.getPeerStories — Fetch the full active story list of a specific peer.
- Added stories.getAllReadPeerStories — Obtain the latest read story ID for all peers when first logging in, returned as a list of updateReadStories updates, see here » for more info.
- Added stories.getPeerMaxIDs — Get compact active story summaries » for a set of peers.
- Added stories.getChatsToSend — Obtain a list of channels where the user can post stories
- Added stories.togglePeerStoriesHidden — Hide the active stories of a user, preventing them from being displayed on the action bar on the homescreen, see here » for more info.
- Added stories.getStoryReactionsList — Get the reaction and interaction list of a story posted to a channel, along with the sender of each reaction.Can only be used by channel admins.
- Added stories.togglePinnedToTop — Pin some stories to the top of the profile, see here » for more info.
- Added stories.searchPosts — Globally search for stories using a hashtag or a location media area, see here » for more info on the full flow.Either hashtag or area must be set when invoking the method.
- Added stories.createAlbum — Creates a story album.
- Added stories.updateAlbum — Rename a story albums », or add, delete or reorder stories in it.
- Added stories.reorderAlbums — Reorder story albums on a profile ».
- Added stories.deleteAlbum — Delete a story album.
- Added stories.getAlbums — Get story albums created by a peer.
- Added stories.getAlbumStories — Get stories in a story album ».
- Added stories.startLive — Start a live story, optionally using RTMP livestream mode, see here » for the full flow.
- Added premium.getBoostsList — Obtains info about the boosts that were applied to a certain channel or supergroup (admins only)
- Added premium.getMyBoosts — Obtain which peers are we currently boosting, and how many boost slots we have left.
- Added premium.applyBoost — Apply one or more boosts » to a peer.
- Added premium.getBoostsStatus — Gets the current number of boosts of a channel/supergroup.
- Added premium.getUserBoosts — Returns the lists of boost that were applied to a channel/supergroup by a specific user (admins only)
- Added smsjobs.isEligibleToJoin — Check if we can process SMS jobs (official clients only).
- Added smsjobs.join — Enable SMS jobs (official clients only).
- Added smsjobs.leave — Disable SMS jobs (official clients only).
- Added smsjobs.updateSettings — Update SMS job settings (official clients only).
- Added smsjobs.getStatus — Get SMS jobs status (official clients only).
- Added smsjobs.getSmsJob — Get info about an SMS job (official clients only).
- Added smsjobs.finishJob — Finish an SMS job (official clients only).
- Added fragment.getCollectibleInfo — Fetch information about a fragment collectible, see here » for more info on the full flow.
New constructors (1546)