Name | Description |
---|---|
help.getTermsOfServiceUpdate | Look for updates of telegram's terms of service |
help.acceptTermsOfService | Accept the new terms of service |
Name | Description |
---|---|
account.reportPeer | Report a peer for violation of telegram's Terms of Service |
account.reportProfilePhoto | Report a profile photo of a dialog |
channels.reportSpam | Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup |
messages.report | Report a message in a chat for violation of telegram's Terms of Service |
messages.reportSpam | Report a new incoming chat for spam, if the peer settings of the chat allow us to do that |
messages.reportEncryptedSpam | Report a secret chat for spam |
Name | Description |
---|---|
help.getAppConfig | Get app-specific configuration, see client configuration for more info on the result. |
help.getAppUpdate | Returns information on update availability for the current application. |
help.getConfig | Returns current configuration, including data center configuration. |
help.getInviteText | Returns localized text of a text message with an invitation. |
help.getNearestDc | Returns info on data center nearest to the user. |
help.getSupport | Returns the support user for the "ask a question" feature. |
help.getSupportName | Get localized name of the telegram support user |
help.getCountriesList | Get name, ISO code, localized name and phone codes/patterns of all available countries |
help.dismissSuggestion | Dismiss a suggestion, see here for more info ». |
Name | Description |
---|---|
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. |
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. |
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. |
Name | Description |
---|---|
help.saveAppLog | Saves logs of application on the server. |
initConnection | Initialize connection |
invokeAfterMsg | Invokes a query after successful completion of one of the previous queries. |
invokeAfterMsgs | Invokes a query after a successful completion of previous queries |
invokeWithLayer | Invoke the specified query using the specified API layer |
invokeWithoutUpdates | Invoke a request without subscribing the used connection for updates (this is enabled by default for file queries). |
invokeWithGooglePlayIntegrity | Official clients only, invoke with Google Play Integrity token. |
invokeWithApnsSecret | Official clients only, invoke with Apple push verification. |
Name | Description |
---|---|
auth.bindTempAuthKey | Binds a temporary authorization key temp_auth_key_id to the permanent authorization key perm_auth_key_id . Each permanent key may only be bound to one temporary key at a time, binding a new temporary key overwrites the previous one.For more information, see Perfect Forward Secrecy. |
auth.cancelCode | Cancel the login verification code |
account.sendVerifyEmailCode | Send an email verification code. |
account.verifyEmail | Verify an email address. |
auth.resetLoginEmail | Reset the login email ». |
auth.checkPassword | Try logging to an account protected by a 2FA password. |
account.resetPassword | Initiate a 2FA password reset: can only be used if the user is already logged-in, see here for more info » |
auth.checkRecoveryPassword | Check if the 2FA recovery code sent using auth.requestPasswordRecovery is valid, before passing it to auth.recoverPassword. |
auth.dropTempAuthKeys | Delete all temporary authorization keys except for the ones specified |
auth.exportAuthorization | Returns data for copying authorization to another data-center. |
auth.importAuthorization | Logs in a user using a key transmitted from his native data-center. |
auth.importBotAuthorization | Login as a bot |
account.changeAuthorizationSettings | Change settings related to a session. |
account.setAuthorizationTTL | Set time-to-live of current session |
auth.logOut | Logs out the user. |
auth.recoverPassword | Reset the 2FA password using the recovery code sent using auth.requestPasswordRecovery. |
auth.requestPasswordRecovery | Request recovery code of a 2FA password, only for accounts with a recovery email configured. |
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. |
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 |
auth.sendCode | Send the verification code for login |
auth.reportMissingCode | Official apps only, reports that the SMS authentication code wasn't delivered. |
auth.signIn | Signs in a user with a validated phone number. |
auth.signUp | Registers a validated phone number in the system. |
auth.requestFirebaseSms | Request an SMS code via Firebase. |
auth.importWebTokenAuthorization | Login by importing an authorization token |
account.invalidateSignInCodes | Invalidate the specified login codes, see here » for more info. |
Name | Description |
---|---|
help.hidePromoData | Hide MTProxy/Public Service Announcement information |
help.getPromoData | Get MTProxy/Public Service Announcement information |
Name | Description |
---|---|
smsjobs.isEligibleToJoin | Check if we can process SMS jobs (official clients only). |
smsjobs.join | Enable SMS jobs (official clients only). |
smsjobs.leave | Disable SMS jobs (official clients only). |
smsjobs.updateSettings | Update SMS job settings (official clients only). |
smsjobs.getStatus | Get SMS jobs status (official clients only). |
smsjobs.getSmsJob | Get info about an SMS job (official clients only). |
smsjobs.finishJob | Finish an SMS job (official clients only). |
Name | Description |
---|---|
help.editUserInfo | Internal use |
help.getUserInfo | Can only be used by TSF members to obtain internal information. |
Name | Description |
---|---|
payments.canPurchasePremium | Checks whether Telegram Premium purchase is possible. Must be called before in-store Premium purchase, official apps only. |
help.getPremiumPromo | Get Telegram Premium promotion information |
payments.assignAppStoreTransaction | Informs server about a purchase made through the App Store: for official applications only. |
payments.assignPlayMarketTransaction | Informs server about a purchase made through the Play Store: for official applications only. |
Name | Description |
---|---|
account.confirmPasswordEmail | Verify an email to use as 2FA recovery method. |
account.resendPasswordEmail | Resend the code to verify an email to use as 2FA recovery method. |
account.cancelPasswordEmail | Cancel the code that was sent to verify an email to use as 2FA recovery method. |
account.getPassword | Obtain configuration for two-factor authorization with password |
account.getPasswordSettings | Get private info associated to the password info (recovery email, telegram passport info & so on) |
account.updatePasswordSettings | Set a new 2FA password |
account.declinePasswordReset | Abort a pending 2FA password reset, see here for more info » |
Name | Description |
---|---|
fragment.getCollectibleInfo | Fetch information about a fragment collectible, see here » for more info on the full flow. |
Name | Description |
---|---|
messages.getSavedGifs | Get saved GIFs. |
messages.saveGif | Add GIF to saved gifs list |
Name | Description |
---|---|
bots.getPopularAppBots | Fetch popular Main Mini Apps, to be used in the apps tab of global search ». |
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. |
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. |
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. |
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. |
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 . |
bots.getPreviewMedias | Fetch main mini app previews, see here » for more info. |
messages.requestMainWebView | Open a Main Mini App. |
Name | Description |
---|---|
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. |
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. |
messages.requestSimpleWebView | Open a bot mini app. |
messages.sendWebViewResultMessage | Terminate webview interaction started with messages.requestWebView, sending the specified message to the chat on behalf of the user. |
messages.sendWebViewData | Used by the user to relay data from an opened reply keyboard bot mini app to the bot that owns it. |
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. |
messages.getBotApp | Obtain information about a direct link Mini App |
bots.canSendMessage | Check whether the specified bot can send us messages |
bots.allowSendMessage | Allow the specified bot to send us messages |
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. |
Name | Description |
---|---|
messages.requestUrlAuth | Get more info about a Seamless Telegram Login authorization request, for more info click here » |
messages.acceptUrlAuth | Use this to accept a Seamless Telegram Login authorization request, for more info click here » |
account.getWebAuthorizations | Get web login widget authorizations |
account.resetWebAuthorization | Log out an active web telegram login session |
account.resetWebAuthorizations | Reset all active web telegram login sessions |
Name | Description |
---|---|
account.createBusinessChatLink | Create a business chat deep link ». |
account.editBusinessChatLink | Edit a created business chat deep link ». |
account.deleteBusinessChatLink | Delete a business chat deep link ». |
account.getBusinessChatLinks | List all created business chat deep links ». |
account.resolveBusinessChatLink | Resolve a business chat deep link ». |
Name | Description |
---|---|
account.updateConnectedBot | Connect a business bot » to the current account, or to change the current connection settings. |
account.getConnectedBots | List all currently connected business bots » |
account.toggleConnectedBotPaused | Pause or unpause a specific chat, temporarily disconnecting it from all business bots ». |
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 ». |
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 ». |
invokeWithBusinessConnection | Invoke a method using a Telegram 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. |
Name | Description |
---|---|
account.updateBusinessGreetingMessage | Set a list of Telegram Business greeting messages. |
account.updateBusinessAwayMessage | Set a list of Telegram Business away messages. |
Name | Description |
---|---|
account.updateBusinessWorkHours | Specify a set of Telegram 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 ». |
Name | Description |
---|---|
messages.getQuickReplies | Fetch basic info about all existing quick reply shortcuts. |
messages.reorderQuickReplies | Reorder quick reply shortcuts. This will emit an updateQuickReplies update to other logged-in sessions. |
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. |
messages.editQuickReplyShortcut | Rename a quick reply shortcut. This will emit an updateQuickReplies update to other logged-in sessions. |
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). |
messages.getQuickReplyMessages | Fetch (a subset or all) messages in a quick reply shortcut ». |
messages.sendQuickReplyMessages | Send a quick reply shortcut ». |
messages.deleteQuickReplyMessages | Delete one or more messages from a quick reply shortcut. This will also emit an updateDeleteQuickReplyMessages update. |
Name | Description |
---|---|
payments.getStarsTopupOptions | Obtain a list of Telegram Stars topup options » as starsTopupOption constructors. |
payments.getStarsStatus | Get the current Telegram Stars balance of the current account (with peer=inputPeerSelf), or the stars balance of the bot specified in peer . |
payments.getStarsTransactions | Fetch Telegram Stars transactions. The inbound and outbound flags are mutually exclusive: if none of the two are set, both incoming and outgoing transactions are fetched. |
payments.sendStarsForm | Make a payment using Telegram Stars, see here » for more info. |
payments.refundStarsCharge | Refund a Telegram Stars transaction, see here » for more info. |
payments.getStarsRevenueStats | Get Telegram Star revenue statistics ». |
payments.getStarsRevenueWithdrawalUrl | Withdraw funds from a channel or bot's star balance ». |
payments.getStarsRevenueAdsAccountUrl | Returns a URL for a Telegram Ad platform account that can be used to set up advertisements for channel/bot in peer , paid using the Telegram Stars owned by the specified peer , see here » for more info. |
payments.getStarsTransactionsByID | Obtain info about Telegram Star transactions » using specific transaction IDs. |
payments.getStarsGiftOptions | Obtain a list of Telegram Stars gift options » as starsGiftOption constructors. |
Name | Description |
---|---|
phone.acceptCall | Accept incoming call |
phone.confirmCall | Complete phone call E2E encryption key exchange » |
phone.discardCall | Refuse or end running call |
phone.getCallConfig | Get phone call configuration to be passed to libtgvoip's shared config |
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. |
phone.requestCall | Start a telegram phone call |
phone.saveCallDebug | Send phone call debug data to server |
phone.sendSignalingData | Send VoIP signaling data |
phone.setCallRating | Rate a call, returns info about the rating message sent to the official VoIP bot. |
phone.saveCallLog | Save phone call debug information |
messages.deletePhoneCallHistory | Delete the entire phone call history. |
Name | Description |
---|---|
help.getPeerColors | Get the set of accent color palettes » that can be used for message accents. |
help.getPeerProfileColors | Get the set of accent color palettes » that can be used in profile page backgrounds. |
account.updateColor | Update the accent color and background custom emoji » of the current account. |
channels.updateColor | Update the accent color and background custom emoji » of a channel. |
account.getDefaultBackgroundEmojis | Get a set of suggested custom emoji stickers that can be used in an accent color pattern. |
Name | Description |
---|---|
premium.getBoostsList | Obtains info about the boosts that were applied to a certain channel or supergroup (admins only) |
premium.getMyBoosts | Obtain which peers are we currently boosting, and how many boost slots we have left. |
premium.applyBoost | Apply one or more boosts » to a peer. |
premium.getBoostsStatus | Gets the current number of boosts of a channel/supergroup. |
premium.getUserBoosts | Returns the lists of boost that were applied to a channel/supergroup by a specific user (admins only) |
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. |
Name | Description |
---|---|
channels.getChannelRecommendations | Obtain a list of similarly themed public channels, selected based on similarities in their subscriber bases. |
Name | Description |
---|---|
channels.createChannel | Create a supergroup/channel. |
channels.getInactiveChannels | Get inactive channels and supergroups |
channels.deleteChannel | Delete a channel/supergroup |
channels.deleteHistory | Delete the history of a supergroup |
channels.deleteMessages | Delete messages in a channel/supergroup |
channels.deleteParticipantHistory | Delete all messages sent by a specific participant of a given supergroup |
channels.editAdmin | Modify the admin rights of a user in a supergroup/channel. |
channels.editBanned | Ban/unban/kick a user in a supergroup/channel. |
channels.editCreator | Transfer channel ownership |
channels.editLocation | Edit location of geogroup, see here » for more info on geogroups. |
channels.editPhoto | Change the photo of a channel/supergroup |
channels.editTitle | Edit the name of a channel/supergroup |
channels.exportMessageLink | Get link and embed info of a message in a channel/supergroup |
channels.getAdminLog | Get the admin log of a channel/supergroup |
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. |
channels.getChannels | Get info about channels/supergroups |
channels.getFullChannel | Get full info about a supergroup, gigagroup or channel |
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. |
channels.getMessages | Get channel/supergroup messages |
channels.getParticipant | Get info about a channel/supergroup participant |
channels.getParticipants | Get the participants of a supergroup/channel |
channels.inviteToChannel | Invite users to a channel/supergroup |
channels.joinChannel | Join a channel/supergroup |
channels.leaveChannel | Leave a channel/supergroup |
channels.readHistory | Mark channel/supergroup history as read |
channels.readMessageContents | Mark channel/supergroup message contents as read |
channels.setDiscussionGroup | Associate a group to a channel as discussion group for that channel |
channels.setStickers | Associate a stickerset to the supergroup |
channels.togglePreHistoryHidden | Hide/unhide message history for new channel/supergroup users |
channels.toggleSignatures | Enable/disable message signatures in channels |
channels.toggleSlowMode | Toggle supergroup slow mode: if enabled, users will only be able to send one message every seconds seconds |
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 ». |
Name | Description |
---|---|
messages.exportChatInvite | Export an invite link for a chat |
messages.getExportedChatInvite | Get info about a chat invite |
messages.getExportedChatInvites | Get info about the chat invites of a specific chat |
messages.editExportedChatInvite | Edit an exported chat invite |
messages.deleteRevokedExportedChatInvites | Delete all revoked chat invites |
messages.deleteExportedChatInvite | Delete a chat invite |
messages.getAdminsWithInvites | Get info about chat invites generated by admins. |
messages.getChatInviteImporters | Get info about the users that joined the chat using a specific chat invite |
messages.checkChatInvite | Check the validity of a chat invite link and get basic info about it |
messages.importChatInvite | Import a chat invite and join a private chat/supergroup/channel |
messages.hideChatJoinRequest | Dismiss or approve a chat join request related to a specific chat or channel. |
messages.hideAllChatJoinRequests | Dismiss or approve all join requests related to a specific chat or channel. |
channels.toggleJoinToSend | Set whether all users should join a discussion group in order to comment on a post » |
channels.toggleJoinRequest | Set whether all users should request admin approval to join the group ». |
Name | Description |
---|---|
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 ». |
messages.addChatUser | Adds a user to a chat and sends a service message on it. |
messages.createChat | Creates a new chat. |
messages.deleteChatUser | Deletes a user from a chat and sends a service message on it. |
messages.editChatAbout | Edit the description of a group/supergroup/channel. |
messages.editChatAdmin | Make a user admin in a basic group. |
messages.editChatDefaultBannedRights | Edit the default banned rights of a channel/supergroup/group. |
messages.editChatPhoto | Changes chat photo and sends a service message on it |
messages.editChatTitle | Changes chat name and sends a service message on it. |
messages.getChats | Returns chat basic info on their IDs. |
messages.deleteChat | Delete a chat |
messages.getCommonChats | Get chats in common with a user |
messages.getFullChat | Get full info about a basic group. |
messages.migrateChat | Turn a basic group into a supergroup |
channels.convertToGigagroup | Convert a supergroup to a gigagroup, when requested by channel suggestions. |
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. |
Name | Description |
---|---|
account.updateTheme | Update theme |
account.uploadTheme | Upload theme |
account.getThemes | Get installed themes |
account.createTheme | Create a theme |
account.installTheme | Install a theme |
account.saveTheme | Save a theme |
account.getTheme | Get theme information |
account.getChatThemes | Get all available chat themes ». |
messages.setChatTheme | Change the chat theme of a certain chat |
Name | Description |
---|---|
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. |
messages.getEmojiStickers | Gets the list of currently installed custom emoji stickersets. |
messages.getFeaturedEmojiStickers | Gets featured custom emoji stickersets. |
messages.searchCustomEmoji | Look for custom emojis associated to a UTF8 emoji |
account.getDefaultProfilePhotoEmojis | Get a set of suggested custom emoji stickers that can be used as profile picture |
account.getDefaultGroupPhotoEmojis | Get a set of suggested custom emoji stickers that can be used as group picture |
Name | Description |
---|---|
messages.startBot | Start a conversation with a bot using a deep linking parameter |
help.getDeepLinkInfo | Get info about an unsupported deep link, see here for more info ». |
help.getRecentMeUrls | Get recently used t.me links.When installing official applications from "Download Telegram" 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 Telegram. |
Name | Description |
---|---|
messages.clearAllDrafts | Clear all drafts. |
messages.getAllDrafts | Return all message drafts. Returns all the latest updateDraftMessage updates related to all chats with drafts. |
messages.saveDraft | Save a message draft associated to a chat. |
Name | Description |
---|---|
messages.getEmojiStickerGroups | Represents a list of emoji categories, to be used when choosing a sticker. |
messages.getEmojiGroups | Represents a list of emoji categories. |
messages.getEmojiStatusGroups | Represents a list of emoji categories, to be used when selecting custom emojis to set as custom emoji status. |
messages.getEmojiProfilePhotoGroups | Represents a list of emoji categories, to be used when selecting custom emojis to set as profile picture. |
Name | Description |
---|---|
messages.getEmojiKeywords | Get localized emoji keywords ». |
messages.getEmojiKeywordsDifference | Get changed emoji keywords ». |
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). |
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. |
Name | Description |
---|---|
account.updateEmojiStatus | Set an emoji status |
channels.updateEmojiStatus | Set an emoji status for a channel or supergroup. |
account.getDefaultEmojiStatuses | Get a list of default suggested emoji statuses |
account.getChannelDefaultEmojiStatuses | Get a list of default suggested channel emoji statuses. |
account.getChannelRestrictedStatusEmojis | Returns fetch the full list of custom emoji IDs » that cannot be used in channel emoji statuses ». |
account.getRecentEmojiStatuses | Get recently used emoji statuses |
account.clearRecentEmojiStatuses | Clears list of recently used emoji statuses |
Name | Description |
---|---|
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. |
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. |
messages.getFactCheck | Fetch one or more factchecks, see here » for the full flow. |
Name | Description |
---|---|
help.getCdnConfig | Get configuration for CDN file downloads. |
upload.getCdnFile | Download a CDN file. |
upload.getCdnFileHashes | Get SHA256 hashes for verifying downloaded CDN files |
upload.reuploadCdnFile | Request a reupload of a certain file to a CDN DC. |
upload.getFile | Returns content of a whole file or its part. |
upload.getFileHashes | Get SHA256 hashes for verifying downloaded files |
upload.getWebFile | Returns content of a web file, by proxying the request through telegram, see the webfile docs for more info. Note: the query must be sent to the DC specified in the webfile_dc_id MTProto configuration field. |
upload.saveBigFilePart | Saves a part of a large file (over 10 MB in size) to be later passed to one of the methods. |
upload.saveFilePart | Saves a part of file for further sending to one of the methods. |
messages.uploadEncryptedFile | Upload encrypted file and associate it to a secret chat |
messages.uploadMedia | Upload a file and associate it to a chat (without actually sending it to the chat) |
messages.getDocumentByHash | Get a document by its SHA256 hash, mainly used for gifs |
Name | Description |
---|---|
messages.toggleDialogFilterTags | Enable or disable folder tags ». |
Name | Description |
---|---|
channels.toggleForum | Enable or disable forum functionality in a supergroup. |
channels.createForumTopic | Create a forum topic; requires manage_topics rights. |
channels.getForumTopics | Get topics of a forum |
channels.getForumTopicsByID | Get forum topics by their ID |
channels.editForumTopic | Edit forum topic; requires manage_topics rights. |
channels.updatePinnedForumTopic | Pin or unpin forum topics |
channels.reorderPinnedForumTopics | Reorder pinned forum topics |
channels.deleteTopicHistory | Delete message history of a forum topic |
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. |
Name | Description |
---|---|
account.reorderUsernames | Reorder usernames associated with the currently logged-in user. |
account.toggleUsername | Activate or deactivate a purchased fragment.com username associated to the currently logged-in user. |
bots.reorderUsernames | Reorder usernames associated to a bot we own. |
bots.toggleUsername | Activate or deactivate a purchased fragment.com username associated to a bot we own. |
channels.reorderUsernames | Reorder active usernames |
channels.toggleUsername | Activate or deactivate a purchased fragment.com username associated to a supergroup or channel we own. |
channels.deactivateAllUsernames | Disable all purchased usernames of a supergroup or channel |
Name | Description |
---|---|
messages.getGameHighScores | Get highscores of a game |
messages.getInlineGameHighScores | Get highscores of a game sent using an inline bot |
messages.setGameScore | Use this method to set the score of the specified user in a game sent as a normal message (bots only). |
messages.setInlineGameScore | Use this method to set the score of the specified user in a game sent as an inline message (bots only). |
Name | Description |
---|---|
payments.checkGiftCode | Obtain information about a Telegram Premium giftcode » |
payments.applyGiftCode | Apply a Telegram Premium giftcode » |
Name | Description |
---|---|
payments.getPremiumGiftCodeOptions | Obtain a list of Telegram Premium giveaway/gift code » options. |
payments.getGiveawayInfo | Obtain information about a Telegram Premium giveaway ». |
payments.launchPrepaidGiveaway | Launch a prepaid giveaway ». |
Name | Description |
---|---|
messages.getWebPage | Get instant view page |
messages.getWebPagePreview | Get preview of webpage |
Name | Description |
---|---|
messages.getAvailableEffects | Fetch the full list of usable animated message effects ». |
Name | Description |
---|---|
messages.translateText | Translate a given text. Styled text entities will only be preserved for Telegram Premium users. |
messages.togglePeerTranslations | Show or hide the real-time chat translation popup for a certain chat |
Name | Description |
---|---|
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. |
Name | Description |
---|---|
account.getReactionsNotifySettings | Get the current reaction notification settings ». |
account.setReactionsNotifySettings | Change the reaction notification settings ». |
Name | Description |
---|---|
messages.getSavedDialogs | Returns the current saved dialog list, see here » for more info. |
messages.getSavedHistory | Returns saved messages » forwarded from a specific peer |
messages.deleteSavedHistory | Deletes messages forwarded from a specific peer to saved messages ». |
messages.getPinnedSavedDialogs | Get pinned saved dialogs, see here » for more info. |
messages.toggleSavedDialogPin | Pin or unpin a saved message dialog ». |
messages.reorderPinnedSavedDialogs | Reorder pinned saved message dialogs ». |
Name | Description |
---|---|
messages.getSavedReactionTags | Fetch the full list of saved message tags created by the user. |
messages.updateSavedReactionTag | Update the description of a saved message tag ». |
messages.getDefaultTagReactions | Fetch a default recommended list of saved message tag reactions. |
Name | Description |
---|---|
messages.setEncryptedTyping | Send typing event by the current user to a secret chat. |
messages.readEncryptedHistory | Marks message history within a secret chat as read. |
messages.acceptEncryption | Confirms creation of a secret chat |
messages.discardEncryption | Cancels a request for creation and/or delete info on secret chat. |
messages.requestEncryption | Sends a request to start a secret chat to the user. |
messages.sendEncrypted | Sends a text message to a secret chat. |
messages.sendEncryptedFile | Sends a message with a file attachment to a secret chat |
messages.sendEncryptedService | Sends a service message to a secret chat. |
messages.getDhConfig | Returns configuration parameters for Diffie-Hellman key generation. Can also return a random sequence of bytes of required length. |
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. |
Name | Description |
---|---|
stats.loadAsyncGraph | Load channel statistics graph asynchronously |
stats.getBroadcastStats | Get channel statistics |
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. |
stats.getMegagroupStats | Get supergroup statistics |
stats.getMessageStats | Get message statistics |
stats.getStoryStats | Get statistics for a certain story. |
stats.getStoryPublicForwards | Obtain forwards of a story as a message to public chats and reposts by public channels. |
Name | Description |
---|---|
messages.getOldFeaturedStickers | Method for fetching previously featured stickers |
messages.toggleStickerSets | Apply changes to multiple stickersets |
stickers.suggestShortName | Suggests a short name for a given stickerpack name |
stickers.replaceSticker | Replace a sticker in a stickerset ». |
stickers.checkShortName | Check whether the given short name is available |
stickers.setStickerSetThumb | Set stickerset thumbnail |
stickers.addStickerToSet | Add a sticker to a stickerset. The sticker set must have been created by the current user/bot. |
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. |
stickers.createStickerSet | Create a stickerset. |
stickers.changeSticker | Update the keywords, emojis or mask coordinates of a sticker. |
stickers.renameStickerSet | Renames a stickerset. |
stickers.deleteStickerSet | Deletes a stickerset we created. |
messages.getMyStickers | Fetch all stickersets » owned by the current user. |
stickers.removeStickerFromSet | Remove a sticker from the set where it belongs. The sticker set must have been created by the current user/bot. |
messages.clearRecentStickers | Clear recent stickers |
messages.faveSticker | Mark or unmark a sticker as favorite |
messages.getAllStickers | Get all installed stickers |
messages.getArchivedStickers | Get all archived stickers |
messages.getAttachedStickers | Get stickers attached to a photo or video |
messages.getFavedStickers | Get faved stickers |
messages.getFeaturedStickers | Get featured stickers |
messages.getMaskStickers | Get installed mask stickers |
messages.getRecentStickers | Get recent stickers |
messages.getStickerSet | Get info about a stickerset |
messages.getStickers | Get stickers by emoji |
messages.saveRecentSticker | Add/remove sticker from recent stickers list |
messages.installStickerSet | Install a stickerset |
messages.readFeaturedStickers | Mark new featured stickers as read |
messages.reorderStickerSets | Reorder installed stickersets |
messages.searchStickerSets | Search for stickersets |
messages.searchEmojiStickerSets | Search for custom emoji stickersets » |
messages.uninstallStickerSet | Uninstall a stickerset |
Name | Description |
---|---|
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. |
stories.canSendStory | Check whether we can post stories as the specified peer. |
stories.sendStory | Uploads a Telegram Story. |
stories.editStory | Edit an uploaded story |
stories.deleteStories | Deletes some posted stories. |
stories.togglePinnedToTop | Pin some stories to the top of the profile, see here » for more info. |
stories.togglePinned | Pin or unpin one or more stories |
stories.getAllStories | Fetch the List of active (or active and hidden) stories, see here » for more info on watching stories. |
stories.getPinnedStories | Fetch the stories pinned on a peer's profile. |
stories.getStoriesArchive | Fetch the story archive » of a peer we control. |
stories.getStoriesByID | Obtain full info about a set of stories by their IDs. |
stories.toggleAllStoriesHidden | Hide the active stories of a specific peer, preventing them from being displayed on the action bar on the homescreen. |
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. |
stories.incrementStoryViews | Increment the view counter of one or more stories. |
stories.getStoryViewsList | Obtain the list of users that have viewed a specific story we posted |
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. |
stories.getStoriesViews | Obtain info about the view count, forward count, reactions and recent viewers of one or more stories. |
stories.exportStoryLink | Generate a story deep link for a specific story |
stories.report | Report a story. |
stories.activateStealthMode | Activates stories stealth mode, see here » for more info. Will return an updateStoriesStealthMode. |
stories.getPeerStories | Fetch the full active story list of a specific peer. |
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. |
stories.getPeerMaxIDs | Get the IDs of the maximum read stories for a set of peers. |
stories.getChatsToSend | Obtain a list of channels where the user can post stories |
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. |
stories.sendReaction | React to a story. |
Name | Description |
---|---|
account.sendVerifyPhoneCode | Send the verification phone code for telegram passport. |
account.verifyPhone | Verify a phone number for telegram passport. |
account.acceptAuthorization | Sends a Telegram Passport authorization form, effectively sharing data with the service |
account.getAuthorizationForm | Returns a Telegram Passport authorization form for sharing data with a service |
account.getAuthorizations | Get logged-in sessions |
account.deleteSecureValue | Delete stored Telegram Passport documents, for more info see the passport docs » |
account.getAllSecureValues | Get all saved Telegram Passport documents, for more info see the passport docs » |
account.getSecureValue | Get saved Telegram Passport document, for more info see the passport docs » |
account.saveSecureValue | Securely save Telegram Passport document, for more info see the passport docs » |
help.getPassportConfig | Get passport configuration |
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. |
Name | Description |
---|---|
contacts.exportContactToken | Generates a temporary profile link for the currently logged-in user. |
contacts.importContactToken | Obtain user info from a temporary profile link. |
Name | Description |
---|---|
updates.getChannelDifference | Returns the difference between the current state of updates of a certain channel and transmitted. |
updates.getDifference | Get new updates. |
updates.getState | Returns a current state of updates. |
Name | Description |
---|---|
messages.transcribeAudio | Transcribe voice message |
messages.rateTranscribedAudio | Rate transcribed voice message |
Name | Description |
---|---|
account.getMultiWallPapers | Get info about multiple wallpapers |
account.getWallPaper | Get info about a certain wallpaper |
account.getWallPapers | Returns a list of available wallpapers. |
account.installWallPaper | Install wallpaper |
account.resetWallPapers | Delete all installed wallpapers, reverting to the default wallpaper set. |
account.saveWallPaper | Install/uninstall wallpaper |
account.uploadWallPaper | Create and upload a new wallpaper |
messages.setChatWallPaper | Set a custom wallpaper » in a specific private chat with another user. |
Name | Description |
---|---|
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 ». |
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 ». |
Name | Description |
---|---|
messages.getInlineBotResults | Query an inline bot |
messages.setInlineBotResults | Answer an inline query, for bots only |
messages.sendInlineBotResult | Send a result obtained using messages.getInlineBotResults. |
messages.getBotCallbackAnswer | Press an inline callback button and get a callback answer from the bot |
messages.setBotCallbackAnswer | Set the callback answer to a user button press (bots only) |
messages.editInlineBotMessage | Edit an inline bot message |
messages.sendBotRequestedPeer | Send one or more chosen peers, as requested by a keyboardButtonRequestPeer button. |
Name | Description |
---|---|
bots.resetBotCommands | Clear bot commands for the specified bot scope and language code |
bots.getBotCommands | Obtain a list of bot commands for the specified bot scope and language code |
bots.setBotCommands | Set bot command list |
bots.setBotInfo | Set localized name, about text and description of a bot (or of the current account, if called by a bot). |
bots.getBotInfo | Get localized name, about text and description of a bot (or of the current account, if called by a bot). |
Name | Description |
---|---|
bots.answerWebhookJSONQuery | Answers a custom query; for bots only |
bots.sendCustomRequest | Sends a custom request; for bots only |
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 |
Name | Description |
---|---|
account.getContactSignUpNotification | Whether the user will receive notifications when contacts sign up |
account.setContactSignUpNotification | Toggle contact sign up notifications |
contacts.acceptContact | If the add contact action bar is active, add that user as contact |
contacts.addContact | Add an existing telegram user as contact. Use contacts.importContacts to add contacts by phone number, without knowing their Telegram ID. |
contacts.block | Adds a peer to a blocklist, see here » for more info. |
contacts.deleteByPhones | Delete contacts by phone number |
contacts.deleteContacts | Deletes several contacts from the list. |
contacts.getBlocked | Returns the list of blocked users. |
contacts.getContactIDs | Get the telegram IDs of all contacts. Returns an array of Telegram user IDs for all contacts (0 if a contact does not have an associated Telegram account or have hidden their account using privacy settings). |
contacts.getContacts | Returns the current user's contact list. |
contacts.getLocated | Get users and geochats near you, see here » for more info. |
contacts.getSaved | Get all contacts, requires a takeout session, see here » for more info. |
contacts.getStatuses | Use this method to obtain the online statuses of all contacts with an accessible Telegram account. |
contacts.getTopPeers | Get most used peers |
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 Telegram contacts without actually using their phone number. |
contacts.resetSaved | Removes all contacts without an associated Telegram account. |
contacts.resetTopPeerRating | Reset rating of top peer |
contacts.search | Returns users found by username substring. |
contacts.toggleTopPeers | Enable/disable top peers |
contacts.unblock | Deletes a peer from a blocklist, see here » for more info. |
contacts.setBlocked | Replace the contents of an entire blocklist, see here for more info ». |
contacts.editCloseFriends | Edit the close friends list, see here » for more info. |
Name | Description |
---|---|
messages.getDialogs | Returns the current user dialog list. |
messages.getPeerDialogs | Get dialog info of specified peers |
messages.getPinnedDialogs | Get pinned dialogs |
messages.toggleDialogPin | Pin/unpin a dialog |
messages.reorderPinnedDialogs | Reorder pinned dialogs |
messages.getDialogUnreadMarks | Get dialogs manually marked as unread |
messages.markDialogUnread | Manually mark dialog as unread |
messages.getPeerSettings | Get peer settings |
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 ». |
messages.getOnlines | Get count of online users in a chat |
messages.sendScreenshotNotification | Notify the other user in a private chat that a screenshot of the chat was taken |
messages.setTyping | Sends a current user typing event (see SendMessageAction for all event types) to a conversation partner or group. |
messages.setHistoryTTL | Set maximum Time-To-Live of all messages in the specified chat |
Name | Description |
---|---|
phone.exportGroupCallInvite | Get an invite link for a group call or livestream |
phone.getGroupCallJoinAs | Get a list of peers that can be used to join a group call, presenting yourself as a specific user/channel. |
phone.editGroupCallParticipant | Edit information about a given group call participant 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 . |
phone.toggleGroupCallRecord | Start or stop recording a group call: the recorded audio and video streams will be automatically sent to Saved messages (the chat with ourselves). |
phone.editGroupCallTitle | Edit the title of a group call or livestream |
phone.getGroupParticipants | Get group call participants |
phone.checkGroupCall | Check whether the group call Server Forwarding Unit is currently receiving the streams with the specified WebRTC source IDs. Returns an intersection of the source IDs specified in sources , and the source IDs currently being forwarded by the SFU. |
phone.createGroupCall | Create a group call or livestream |
phone.toggleGroupCallStartSubscription | Subscribe or unsubscribe to a scheduled group call |
phone.leaveGroupCall | Leave a group call |
phone.toggleGroupCallSettings | Change group call settings |
phone.inviteToGroupCall | Invite a set of users to a group call. |
phone.getGroupCall | Get info about a group call |
phone.joinGroupCall | Join a group call |
phone.leaveGroupCallPresentation | Stop screen sharing in a group call |
phone.discardGroupCall | Terminate a group call |
phone.joinGroupCallPresentation | Start screen sharing in a call |
phone.startScheduledGroupCall | Start a scheduled group call. |
phone.saveDefaultGroupCallJoinAs | Set the default peer that will be used to join a group call in a specific dialog. |
phone.getGroupCallStreamChannels | Get info about RTMP streams in a group call or livestream. This method should be invoked to the same group/channel-related DC used for downloading livestream chunks. As usual, the media DC is preferred, if available. |
phone.getGroupCallStreamRtmpUrl | Get RTMP URL and stream key for RTMP livestreams. Can be used even before creating the actual RTMP livestream with phone.createGroupCall (the rtmp_stream flag must be set). |
Name | Description |
---|---|
messages.uploadImportedMedia | Upload a media file associated with an imported chat, click here for more info ». |
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. |
messages.checkHistoryImportPeer | Check whether chat history exported from another chat app can be imported into a specific Telegram 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. |
messages.checkHistoryImport | Obtains information about a chat export file, generated by a foreign chat app, click here for more info about imported chats ». |
messages.initHistoryImport | Import chat history from a foreign chat app into a specific Telegram chat, click here for more info about imported chats ». |
Name | Description |
---|---|
langpack.getDifference | Get new strings in language pack |
langpack.getLangPack | Get localization pack strings |
langpack.getLanguage | Get information about a language in a localization pack |
langpack.getLanguages | Get information about all languages in a localization pack |
langpack.getStrings | Get strings from a language pack |
Name | Description |
---|---|
account.getAutoDownloadSettings | Get media autodownload settings |
account.saveAutoDownloadSettings | Change media autodownload settings |
Name | Description |
---|---|
account.getAutoSaveSettings | Get autosave settings |
account.saveAutoSaveSettings | Modify autosave settings |
account.deleteAutoSaveExceptions | Clear all peer-specific autosave settings. |
Name | Description |
---|---|
messages.getReplies | Get messages in a reply thread |
contacts.blockFromReplies | Stop getting notifications about discussion replies of a certain user in @replies |
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 |
messages.readDiscussion | Mark a thread as read |
Name | Description |
---|---|
messages.deleteHistory | Deletes communication history. |
messages.deleteMessages | Deletes messages by their identifiers. |
messages.editMessage | Edit message |
messages.forwardMessages | Forwards messages by their IDs. |
messages.getHistory | Returns the conversation history with one interlocutor / within a chat |
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). |
messages.getMessageEditData | Find out if a media message's caption can be edited |
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. |
messages.getMessages | Returns the list of messages by their IDs. |
messages.getMessagesViews | Get and increase the view counter of a message sent or forwarded from a channel |
messages.getRecentLocations | Get live location history of a certain user |
messages.getSearchCounters | Get the number of results that would be found by a messages.search call with the same parameters |
messages.getUnreadMentions | Get unread messages where we were mentioned |
messages.readHistory | Marks message history as read. |
messages.readMentions | Mark mentions as read |
messages.readMessageContents | Notifies the sender about the recipient having listened a voice message or watched a video. |
messages.receivedMessages | Confirms receipt of messages by a client, cancels PUSH-notification sending. |
messages.search | Search for messages. |
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. |
messages.searchGlobal | Search for messages and peers globally |
messages.searchSentMedia | View and search recently sent media. This method does not support pagination. |
channels.searchPosts | Globally search for posts from public channels » (including those we aren't a member of) containing a specific hashtag. |
messages.sendMedia | Send a media |
messages.sendMessage | Sends a message to a chat |
messages.sendMultiMedia | Send an album or grouped media |
messages.updatePinnedMessage | Pin a message |
messages.unpinAllMessages | Unpin all pinned messages |
messages.toggleNoForwards | Enable or disable content protection on a channel or chat |
messages.saveDefaultSendAs | Change the default peer that should be used when sending messages, reactions, poll votes to a specific group |
channels.getSendAs | Obtains a list of peers that can be used to send messages in a specific group |
Name | Description |
---|---|
account.registerDevice | Register device to receive PUSH notifications |
account.unregisterDevice | Deletes a device by its token, stops sending PUSH-notifications to it. |
account.updateDeviceLocked | When client-side passcode lock feature is enabled, will not show message texts in incoming PUSH notifications. |
account.getNotifyExceptions | Returns list of chats with non-default notification settings |
account.getNotifySettings | Gets current notification settings for a given user/group, from all users/all groups. |
account.updateNotifySettings | Edits notification settings from a given user/group, from all users/all groups. |
account.resetNotifySettings | Resets all notification settings from users and groups. |
Name | Description |
---|---|
account.getSavedRingtones | Fetch saved notification sounds |
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). |
account.uploadRingtone | Upload notification sound, use account.saveRingtone to convert it and add it to the list of saved notification sounds. |
Name | Description |
---|---|
users.getFullUser | Returns extended user info by ID. |
users.getUsers | Returns basic user info according to their identifiers. |
contacts.resolvePhone | Resolve a phone number to get user info, if their privacy settings allow it. |
Name | Description |
---|---|
payments.getSavedInfo | Get saved payment information |
payments.clearSavedInfo | Clear saved payment information |
payments.getPaymentForm | Get a payment form |
payments.validateRequestedInfo | Submit requested order information for validation |
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. |
account.getTmpPassword | Get temporary payment password |
payments.sendPaymentForm | Send compiled payment form |
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: Telegram must receive an answer within 10 seconds after the pre-checkout query was sent. |
payments.getPaymentReceipt | Get payment receipt |
payments.exportInvoice | Generate an invoice deep link |
payments.getBankCardData | Get info about a credit card |
Name | Description |
---|---|
messages.getPollResults | Get poll results |
messages.getPollVotes | Get poll results for non-anonymous polls |
messages.sendVote | Vote in a poll Starting from layer 159, the vote will be sent from the peer specified using messages.saveDefaultSendAs. |
Name | Description |
---|---|
messages.sendScheduledMessages | Send scheduled messages right away |
messages.getScheduledHistory | Get scheduled messages |
messages.deleteScheduledMessages | Delete scheduled messages |
messages.getScheduledMessages | Get scheduled messages |
Name | Description |
---|---|
account.getContentSettings | Get sensitive content settings |
account.setContentSettings | Set sensitive content settings (for viewing or hiding NSFW content) |
Name | Description |
---|---|
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. |
account.toggleSponsoredMessages | Disable or re-enable Telegram ads for the current Premium account. Useful for business owners that may want to launch and view their own Telegram ads via the Telegram ad platform ». |
Name | Description |
---|---|
account.updateBusinessIntro | Set or remove the Telegram Business introduction ». |
Name | Description |
---|---|
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. |
Name | Description |
---|---|
messages.getAttachMenuBots | Returns installed attachment menu bot mini apps » |
messages.getAttachMenuBot | Returns attachment menu entry for a bot mini app that can be launched from the attachment menu » |
messages.toggleBotInAttachMenu | Enable or disable web bot attachment menu » |
Name | Description |
---|---|
stats.getBroadcastRevenueStats | Get channel ad revenue statistics ». |
stats.getBroadcastRevenueWithdrawalUrl | Withdraw funds from a channel's ad revenue balance ». |
stats.getBroadcastRevenueTransactions | Fetch channel ad revenue transaction history ». |
Name | Description |
---|---|
channels.toggleAntiSpam | Enable or disable the native antispam system. |
channels.reportAntiSpamFalsePositive | Report a native antispam false positive |
Name | Description |
---|---|
account.getPrivacy | Get privacy settings of current account |
account.setPrivacy | Change privacy settings of current account |
account.setGlobalPrivacySettings | Set global privacy settings |
account.getGlobalPrivacySettings | Get global privacy settings |
users.getIsPremiumRequiredToContact | Check whether we can write to the specified user (this method can only be called by non-Premium users), see here » for more info on the full flow. |
messages.setDefaultHistoryTTL | Changes the default value of the Time-To-Live setting, applied to all new chats. |
messages.getDefaultHistoryTTL | Gets the default value of the Time-To-Live setting, applied to all new chats. |
Name | Description |
---|---|
account.initTakeoutSession | Initialize a takeout session, see here » for more info. |
account.finishTakeoutSession | Terminate a takeout session, see here » for more info. |
messages.getSplitRanges | Get message ranges for saving the user's chat history |
channels.getLeftChannels | Get a list of channels/supergroups we left, requires a takeout session, see here » for more info. |
invokeWithMessagesRange | Invoke with the given message range |
invokeWithTakeout | Invoke a method within a takeout session, see here » for more info. |
Name | Description |
---|---|
photos.deletePhotos | Deletes profile photos. The method returns a list of successfully deleted photo IDs. |
photos.getUserPhotos | Returns the list of user photos. |
photos.updateProfilePhoto | Installs a previously uploaded photo as a profile photo. |
photos.uploadProfilePhoto | Updates current user profile photo. The file , video and video_emoji_markup flags are mutually exclusive. |
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. |
account.updateProfile | Updates user profile. |
account.updateBirthday | Update our birthday, see here » for more info. |
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. |
account.updatePersonalChannel | Associate (or remove) a personal channel », that will be listed on our personal profile page ». Changing it will emit an updateUser update. |
account.updateStatus | Updates online user status. |
Name | Description |
---|---|
bots.setBotMenuButton | Sets the menu button action » for a given user or for all users |
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. |
Name | Description |
---|---|
account.changePhone | Change the phone number of the current account |
account.confirmPhone | Confirm a phone number to cancel account deletion, for more info click here » |
account.deleteAccount | Delete the user's account from the telegram 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. |
account.getAccountTTL | Get days to live of account |
account.resetAuthorization | Log out an active authorized session by its hash |
account.sendChangePhoneCode | Verify a new phone number to associate to the current account |
account.sendConfirmPhoneCode | Send confirmation code to cancel account deletion, for more info click here » |
account.setAccountTTL | Set account self-destruction period |
Name | Description |
---|---|
help.getTimezonesList | Returns timezone information that may be used elsewhere in the API, such as to set Telegram Business opening hours ». |
Name | Description |
---|---|
channels.checkUsername | Check if a username is free and can be assigned to a channel/supergroup |
channels.updateUsername | Change or remove the username of a supergroup/channel |
account.updateUsername | Changes username for the current user. |
account.checkUsername | Validates a username and checks availability. |
contacts.resolveUsername | Resolve a @username to get peer info |
Name | Description |
---|---|
payments.getStarsSubscriptions | Obtain a list of active, expired or cancelled Telegram Star subscriptions ». |
payments.changeStarsSubscription | Activate or deactivate a Telegram Star subscription ». |
payments.fulfillStarsSubscription | Re-join a private channel associated to an active Telegram Star subscription ». |
messages.sendPaidReaction | Sends one or more paid Telegram Star reactions », transferring Telegram Stars » to a channel's balance. |
messages.togglePaidReactionPrivacy | Changes the privacy of already sent paid reactions on a specific message. |
payments.getStarsGiveawayOptions | Fetch a list of star giveaway options ». |
messages.getPaidReactionPrivacy | Fetches an updatePaidReactionPrivacy update with the current default paid reaction privacy, see here » for more info. |
payments.getStarGifts | Get a list of available gifts, see here » for more info. |
payments.getUserStarGifts | Get the gifts » pinned on a specific user's profile. May also be used to fetch all gifts received by the current user. |
payments.saveStarGift | Display or remove a received gift » from our profile. |
payments.convertStarGift | Convert a received gift » into Telegram Stars: this will permanently destroy the gift, converting it into starGift.convert_stars Telegram 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 Telegram Stars bought a long time ago. |
messages.viewSponsoredMessage | Mark a specific sponsored message » as read |
messages.clickSponsoredMessage | Informs the server that the user has interacted with a sponsored message in one of the ways listed here ». |
messages.reportSponsoredMessage | Report a sponsored message », see here » for more info on the full flow. |
messages.getSponsoredMessages | Get a list of sponsored messages for a peer, see here » for more info. |