acceptEncryption
Confirms creation of a secret chat
acceptUrlAuth
Use this to accept a Seamless Telegram Login authorization request, for more info click here »
addChatUser
Adds a user to a chat and sends a service message on it.
addPollAnswer
appendTodoList
Appends one or more items to a todo list ».
checkChatInvite
Check the validity of a chat invite link and get basic info about it
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.
checkHistoryImport
Obtains information about a chat export file, generated by a foreign chat app, click here for more info about imported chats ».
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.
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.
clearAllDrafts
Clear all drafts.
clearRecentReactions
Clear recently used message reactions
clearRecentStickers
Clear recent stickers
clickSponsoredMessage
Informs the server that the user has interacted with a sponsored message in one of the ways listed here ».
composeMessageWithAI
createChat
Creates a new chat.
createForumTopic
Create a forum topic.
declineUrlAuth
Decline an incoming OAuth authorization request », notifying the server that the user refused the login request.
deleteChatUser
Deletes a user from a chat and sends a service message on it.
deleteChat
Delete a chat
deleteExportedChatInvite
Delete a chat invite
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.
deleteHistory
Deletes communication history.
deleteMessages
Deletes messages by their identifiers.
deleteParticipantReaction
deleteParticipantReactions
deletePhoneCallHistory
Delete the entire phone call history.
deletePollAnswer
deleteQuickReplyMessages
Delete one or more messages from a quick reply shortcut. This will also emit an updateDeleteQuickReplyMessages update.
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).
deleteRevokedExportedChatInvites
Delete all revoked chat invites
deleteSavedHistory
Deletes messages from a monoforum topic », or deletes messages forwarded from a specific peer to saved messages ».
deleteScheduledMessages
Delete scheduled messages
deleteTopicHistory
Delete message history of a forum topic
discardEncryption
Cancels a request for creation and/or delete info on secret chat.
editChatAbout
Edit the description of a group/supergroup/channel.
editChatAdmin
Make a user admin in a basic group.
editChatCreator
Transfer the ownership of a basic group, supergroup or channel to another user, see here » for the full flow.
editChatDefaultBannedRights
Edit the default banned rights of a channel/supergroup/group.
editChatParticipantRank
Edit a group participant's tag ».
editChatPhoto
Changes chat photo and sends a service message on it
editChatTitle
Changes chat name and sends a service message on it.
editExportedChatInvite
Edit an exported chat invite
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.
editForumTopic
Edit forum topic.
editInlineBotMessage
Edit an inline bot message
editMessage
Edit message
editQuickReplyShortcut
Rename a quick reply shortcut. This will emit an updateQuickReplies update to other logged-in sessions.
exportChatInvite
Export an invite link for a chat
faveSticker
Mark or unmark a sticker as favorite
forwardMessages
Forwards messages by their IDs.
getAdminsWithInvites
Get info about chat invites generated by admins.
getAllDrafts
Return all message drafts. Returns all the latest updateDraftMessage updates related to all chats with drafts.
getAllStickers
Get all installed stickers
getArchivedStickers
Get all archived stickers
getAttachMenuBot
Returns attachment menu entry for a bot mini app that can be launched from the attachment menu »
getAttachMenuBots
Returns installed attachment menu bot mini apps »
getAttachedStickers
Get stickers attached to a photo or video
getAvailableEffects
Fetch the full list of usable animated message effects ».
getAvailableReactions
Obtain available message reactions »
getBotApp
Obtain information about a direct link Mini App
getBotCallbackAnswer
Press an inline callback button and get a callback answer from the bot
getChatInviteImporters
Get info about the users that joined the chat using a specific chat invite
getChats
Returns chat basic info on their IDs.
getCommonChats
Get chats in common with a user
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.
getDefaultHistoryTTL
Gets the default value of the Time-To-Live setting, applied to all new chats.
getDefaultTagReactions
Fetch a default recommended list of saved message tag reactions.
getDhConfig
Returns configuration parameters for Diffie-Hellman key generation. Can also return a random sequence of bytes of required length.
getDialogFilters
Get folders
getDialogUnreadMarks
Get dialogs manually marked as unread
getDialogs
Returns the current user dialog list.
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
getDocumentByHash
Get a document by its SHA256 hash, mainly used for gifs
getEmojiGameInfo
getEmojiGroups
Represents a list of emoji categories.
getEmojiKeywordsDifference
Get changed emoji keywords ».
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).
getEmojiKeywords
Get localized emoji keywords ».
getEmojiProfilePhotoGroups
Represents a list of emoji categories, to be used when selecting custom emojis to set as profile picture.
getEmojiStatusGroups
Represents a list of emoji categories, to be used when selecting custom emojis to set as custom emoji status.
getEmojiStickerGroups
Represents a list of emoji categories, to be used when choosing a sticker.
getEmojiStickers
Gets the list of currently installed custom emoji stickersets.
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.
getExportedChatInvite
Get info about a chat invite
getExportedChatInvites
Get info about the chat invites of a specific chat
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.
getFactCheck
Fetch one or more factchecks, see here » for the full flow.
getFavedStickers
Get faved stickers
getFeaturedEmojiStickers
Gets featured custom emoji stickersets.
getFeaturedStickers
Get featured stickers
getForumTopicsByID
Get forum topics by their ID
getForumTopics
Get topics of a forum
getFullChat
Get full info about a basic group.
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.
getGameHighScores
Get highscores of a game
getHistory
Returns the message history in a peer. Results are ordered by date (descending).
getInlineBotResults
Query an inline bot
getInlineGameHighScores
Get highscores of a game sent using an inline bot
getMaskStickers
Get installed mask stickers
getMessageEditData
Find out if a media message's caption can be edited
getMessageReactionsList
Get message reaction list, along with the sender of each reaction.
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 ».
getMessagesReactions
Get message reactions »
getMessagesViews
Get and increase the view counter of a message sent or forwarded from a channel
getMessages
Returns the list of messages by their IDs.
getMyStickers
Fetch all stickersets » owned by the current user.
getOldFeaturedStickers
Method for fetching previously featured stickers
getOnlines
Get count of online users in a chat
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.
getPaidReactionPrivacy
Fetches an updatePaidReactionPrivacy update with the current default paid reaction privacy, see here » for more info.
getPeerDialogs
Get dialog info of specified peers
getPeerSettings
Get peer settings
getPersonalChannelHistory
getPinnedDialogs
Get pinned dialogs
getPinnedSavedDialogs
Get pinned saved dialogs, see here » for more info.
getPollResults
Get poll results
getPollVotes
Get poll results for non-anonymous polls
getPreparedInlineMessage
Obtain a prepared inline message generated by a mini app: invoked when handling web_app_send_prepared_message events
getQuickReplies
Fetch basic info about all existing quick reply shortcuts.
getQuickReplyMessages
Fetch (a subset or all) messages in a quick reply shortcut ».
getRecentLocations
Get live location history of a certain user
getRecentReactions
Get recently used message reactions
getRecentStickers
Get recent stickers
getReplies
Get messages in a reply thread
getRichMessage
getSavedDialogsByID
Obtain information about specific saved message dialogs » or monoforum topics ».
getSavedDialogs
Returns the current saved dialog list » or monoforum topic list ».
getSavedGifs
Get saved GIFs.
getSavedHistory
Fetch saved messages » forwarded from a specific peer, or fetch messages from a monoforum topic ».
getSavedReactionTags
Fetch the full list of saved message tags created by the user.
getScheduledHistory
Get scheduled messages
getScheduledMessages
Get scheduled messages
getSearchCounters
Get the number of results that would be found by a messages.search call with the same parameters
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.
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).
getSplitRanges
Get message ranges for saving the user's chat history
getSponsoredMessages
Get a list of sponsored messages for a peer, see here » for more info.
getStickerSet
Get info about a stickerset
getStickers
Get stickers by emoji
getSuggestedDialogFilters
Get suggested folders
getTopReactions
Got popular message reactions
getUnreadMentions
Get unread messages where we were mentioned
getUnreadPollVotes
getUnreadReactions
Get unread reactions to messages you sent
getWebPagePreview
Get preview of webpage
getWebPage
Get instant view page
hideAllChatJoinRequests
Dismiss or approve all join requests related to a specific chat or channel.
hideChatJoinRequest
Dismiss or approve a chat join request related to a specific chat or channel.
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 ».
importChatInvite
Import a chat invite and join a private chat/supergroup/channel
initHistoryImport
Import chat history from a foreign chat app into a specific Telegram chat, click here for more info about imported chats ».
installStickerSet
Install a stickerset
markDialogUnread
Manually mark dialog as unread
migrateChat
Turn a basic group into a supergroup
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.
rateTranscribedAudio
Rate transcribed voice message
readDiscussion
Mark a thread as read
readEncryptedHistory
Marks message history within a secret chat as read.
readFeaturedStickers
Mark new featured stickers as read
readHistory
Marks message history as read.
readMentions
Mark mentions as read
readMessageContents
Notifies the sender about the recipient having listened a voice message or watched a video, emitting an updateReadMessagesContents.
readPollVotes
readReactions
Mark message reactions » as read
readSavedHistory
Mark messages as read in a monoforum topic ».
receivedMessages
Confirms receipt of messages by a client, cancels PUSH-notification sending.
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.
reorderPinnedDialogs
Reorder pinned dialogs
reorderPinnedForumTopics
Reorder pinned forum topics
reorderPinnedSavedDialogs
Reorder pinned saved message dialogs ».
reorderQuickReplies
Reorder quick reply shortcuts. This will emit an updateQuickReplies update to other logged-in sessions.
reorderStickerSets
Reorder installed stickersets
reportEncryptedSpam
Report a secret chat for spam
reportMessagesDelivery
Used for Telegram 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.
reportMusicListen
reportReaction
Report a message reaction
reportReadMetrics
reportSpam
Report a new incoming chat for spam, if the peer settings of the chat allow us to do that
reportSponsoredMessage
Report a sponsored message », see here » for more info on the full flow.
report
Report a message in a chat for violation of telegram's Terms of Service
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.
requestEncryption
Sends a request to start a secret chat to the user.
requestMainWebView
Open a Main Mini App.
requestSimpleWebView
Open a bot mini app.
requestUrlAuth
Get more info about a Seamless Telegram Login authorization request, for more info click here »
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.
saveDefaultSendAs
Change the default peer that should be used when sending messages, reactions, poll votes to a specific group
saveDraft
Save a message draft associated to a chat.
saveGif
Add GIF to saved gifs list
savePreparedInlineMessage
Save a prepared inline message, to be shared by the user of the mini app using a web_app_send_prepared_message event
saveRecentSticker
Add/remove sticker from recent stickers list
searchCustomEmoji
Look for custom emojis associated to a UTF8 emoji
searchEmojiStickerSets
Search for custom emoji stickersets »
searchGlobal
Search for messages and peers globally
searchSentMedia
View and search recently sent media. This method does not support pagination.
searchStickerSets
Search for stickersets
searchStickers
Search for stickers using AI-powered keyword search
search
Search for messages.
sendBotRequestedPeer
Send one or more chosen peers, as requested by a keyboardButtonRequestPeer button.
sendEncryptedFile
Sends a message with a file attachment to a secret chat
sendEncryptedService
Sends a service message to a secret chat.
sendEncrypted
Sends a text message to a secret chat.
sendInlineBotResult
Send a result obtained using messages.getInlineBotResults.
sendMedia
Send a media
sendMessage
Sends a message to a chat
sendMultiMedia
Send an album or grouped media
sendPaidReaction
Sends one or more paid Telegram Star reactions », transferring Telegram Stars » to a channel's balance.
sendQuickReplyMessages
Send a quick reply shortcut ».
sendReaction
React to message. Starting from layer 159, the reaction will be sent from the peer specified using messages.saveDefaultSendAs.
sendScheduledMessages
Send scheduled messages right away
sendScreenshotNotification
Notify the other user in a private chat that a screenshot of the chat was taken
sendVote
Vote in a poll Starting from layer 159, the vote will be sent from the peer specified using messages saveDefaultSendAs.
sendWebViewData
Used by the user to relay data from an opened reply keyboard bot mini app to the bot that owns it.
sendWebViewResultMessage
Terminate webview interaction started with messages.requestWebView, sending the specified message to the chat on behalf of the user.
setBotCallbackAnswer
Set the callback answer to a user button press (bots only)
setBotGuestChatResult
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.
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.
setChatAvailableReactions
Change the set of message reactions » that can be used in a certain group, supergroup or channel
setChatTheme
Change the chat theme of a certain chat, see here » for more info.
setChatWallPaper
Set a custom wallpaper » in a specific private chat with another user.
setDefaultHistoryTTL
Changes the default value of the Time-To-Live setting, applied to all new chats.
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.
setEncryptedTyping
Send typing event by the current user to a secret chat.
setGameScore
Use this method to set the score of the specified user in a game sent as a normal message (bots only).
setHistoryTTL
Set maximum Time-To-Live of all messages in the specified chat
setInlineBotResults
Answer an inline query, for bots only
setInlineGameScore
Use this method to set the score of the specified user in a game sent as an inline message (bots only).
setTyping
Sends a current user typing event (see SendMessageAction for all event types) to a conversation partner or group.
startBot
Start a conversation with a bot using a deep linking parameter
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.
summarizeText
Summarize the contents of a message with AI, see here » for more info.
toggleBotInAttachMenu
Enable or disable web bot attachment menu »
toggleDialogFilterTags
Enable or disable folder tags ».
toggleDialogPin
Pin/unpin a dialog
toggleNoForwards
Enable or disable content protection on a channel, group or private chat.
togglePaidReactionPrivacy
Changes the privacy of already sent paid reactions on a specific message.
togglePeerTranslations
Show or hide the real-time chat translation popup for a certain chat
toggleSavedDialogPin
Pin or unpin a saved message dialog ».
toggleStickerSets
Apply changes to multiple stickersets
toggleSuggestedPostApproval
Approve or reject a suggested post ».
toggleTodoCompleted
Mark one or more items of a todo list » as completed or not completed.
transcribeAudio
Transcribe voice message
translateText
Translate a given text. Styled text entities will only be preserved for Telegram Premium users.
uninstallStickerSet
Uninstall a stickerset
unpinAllMessages
Unpin all pinned messages
updateDialogFilter
Update folder
updateDialogFiltersOrder
Reorder folders
updatePinnedForumTopic
Pin or unpin forum topics
updatePinnedMessage
Pin a message
updateSavedReactionTag
Update the description of a saved message tag ».
uploadEncryptedFile
Upload encrypted file and associate it to a secret chat (without actually sending it to the chat).
uploadImportedMedia
Upload a media file associated with an imported chat, click here for more info ».
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.
viewSponsoredMessage
Mark a specific sponsored message » as read