Async PHP client API for the telegram MTProto protocol
3,512
stars
5,557
commits
PHP
primary language
Sep 6, 2026
updated
amphp
async
bot
calls
easy
hacktoberfest
inline-bots
madelineproto
mtproto
mtproto-api
php
proxy
secret-chats
stickers
tdlib
tdlib-php
telegram
telegram-api
voip
README
MadelineProto, a PHP MTProto telegram client
Created by Daniil Gentili
#StandWithUkraine 🇺🇦
Do join the official channel, @MadelineProto and the support groups!
What's this?
This library can be used to easily interact with Telegram without the bot API, just like the official apps.
It can login with a phone number (MTProto API), or with a bot token (MTProto API, no bot API involved!).
Getting started (now fully async!)
<?php
// PHP 8.2+ is required.
if (!file_exists('madeline.php')) {
copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';
$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();
$me = $MadelineProto->getSelf();
$MadelineProto->logger($me);
if (!$me['bot']) {
$MadelineProto->messages->sendMessage(peer: '@stickeroptimizerbot', message: "/start");
$MadelineProto->channels->joinChannel(channel: '@MadelineProto');
try {
$MadelineProto->messages->importChatInvite(hash: 'https://t.me/+Por5orOjwgccnt2w');
} catch (\danog\MadelineProto\RPCErrorException $e) {
$MadelineProto->logger($e);
}
}
$MadelineProto->echo('OK, done!');
Try running this code in a browser or in a console!
Tip: if you receive an error (or nothing), send us the error message and the MadelineProto.log file that was created in the same directory (if running from a browser).
Made with MadelineProto
The following open source projects were created using MadelineProto: you can directly install them, or explore the source code as direct examples on how to use MadelineProto's many features!
- magnaluna webradio - Multifeatured Telegram VoIP webradio
simpleBot.php- Extremely basic exampletgstories_dl_bot.php- Source code of @tgstories_dl_bot - Bot to download any Telegram Story!downloadRenameBot.php- Download files by URL and rename Telegram files using this async parallelized bot!secret_bot.php- Secret chat bot!pipesbot.php- Creating inline bots and using other inline bots via a userbot!bot.php- Examples for how to use filters, updates, get download links for any file, Telegram Stories and much more!
Want to add your own open-source project to this list? Click here!
Some of MadelineProto's core components are also available as separate, standalone libraries:
- danog/async-orm - Async ORM based on AMPHP v3 and fibers.
- danog/telegram-entities - A library to work with Telegram UTF-16 styled text entities.
- danog/tg-file-decoder - A library to work with Telegram bot API file IDs.
- danog/tg-dialog-id - A library to work with Telegram bot API dialog IDs.
- danog/loop - Loop/actor model abstraction for AMPHP.
- danog/better-prometheus - A better Prometheus library for PHP applications.
- danog/ipc - Async IPC component for AMPHP.
- danog/dns-over-https - Async DNS-over-HTTPS resolution for AMPHP.
Documentation
- Creating a client - This page explains how to create a MadelineProto instance.
- Login - There are many ways you can login with MadelineProto.
- Features - MadelineProto can do everything official clients can do, and more!
- Requirements - MadelineProto requires the mbstring, xml, json, fileinfo, gmp, openssl, iconv, gd extensions to function properly.
- MadelineProto on Docker - MadelineProto offers an official MadelineProto docker image for the linux/amd64, linux/arm64 and linux/riscv64 platforms @ hub.madelineproto.xyz/danog/madelineproto.
- Metrics - MadelineProto can expose many useful metrics, that can be visualized using the official MadelineProto Grafana dashboard.
- Installation - There are various ways to install MadelineProto:
- Broadcasting messages to all users - MadelineProto can be used to broadcast messages to all users, chats and channels of a bot or userbot.
- Handling updates (new messages & other events) - Update handling can be done in different ways:
- Async Event driven
- Webhook (for HTTP APIs)
- getUpdates (only for Javascript APIs)
- Noop (default)
- danog\MadelineProto\Broadcast\Progress » - Broadcast progress.
- danog\MadelineProto\EventHandler\AbstractMessage » - Represents an incoming or outgoing message.
- danog\MadelineProto\EventHandler\AbstractPrivateMessage » - Represents a private or secret chat message.
- danog\MadelineProto\EventHandler\AbstractStory » - Represents a Telegram Story.
- danog\MadelineProto\EventHandler\BotCommands » - The command set of a certain bot in a certain chat has changed.
- danog\MadelineProto\EventHandler\CallbackQuery » - Represents a query sent by the user by clicking on a button.
- danog\MadelineProto\EventHandler\Channel\ChannelParticipant » - A participant has left, joined, was banned or admin'd in a channel or supergroup.
- danog\MadelineProto\EventHandler\Channel\MessageForwards » - Indicates that the forward counter of a message in a channel has changed.
- danog\MadelineProto\EventHandler\Channel\MessageViewsChanged » - Indicates that the view counter of a message in a channel has changed.
- danog\MadelineProto\EventHandler\Channel\UpdateChannel » - A new channel is available, or info about an existing channel was changed.
- danog\MadelineProto\EventHandler\ChatInviteRequester » - Indicates someone has requested to join a chat or channel.
- danog\MadelineProto\EventHandler\ChatInviteRequester\BotChatInviteRequest » - Indicates someone has requested to join a chat or channel (bots only).
- danog\MadelineProto\EventHandler\ChatInviteRequester\PendingJoinRequests » - Someone has requested to join a chat or channel.
- danog\MadelineProto\EventHandler\Delete » - Indicates that some messages were deleted.
- danog\MadelineProto\EventHandler\Delete\DeleteChannelMessages » - Some messages in a supergroup/channel were deleted.
- danog\MadelineProto\EventHandler\Delete\DeleteMessages » - Some messages were deleted in a private chat or simple group.
- danog\MadelineProto\EventHandler\Delete\DeleteScheduledMessages » - Some scheduled messages were deleted from the schedule queue of a chat.
- danog\MadelineProto\EventHandler\InlineQuery » - An incoming inline query.
- danog\MadelineProto\EventHandler\Message » - Represents an incoming or outgoing message.
- danog\MadelineProto\EventHandler\Message\ChannelMessage » - Represents an incoming or outgoing channel message.
- danog\MadelineProto\EventHandler\Message\CommentReply » - Represents a reply to one of our messages in a channel comment group that we're not a member of (i.e. received via
@replies). - danog\MadelineProto\EventHandler\Message\GroupMessage » - Represents an incoming or outgoing group message.
- danog\MadelineProto\EventHandler\Message\PrivateMessage » - Represents an incoming or outgoing private message.
- danog\MadelineProto\EventHandler\Message\SecretMessage » - Represents New encrypted message.
- danog\MadelineProto\EventHandler\Message\ServiceMessage » - Represents info about a service message.
- danog\MadelineProto\EventHandler\Message\ServiceMessage » - Represents info about a service message.
- danog\MadelineProto\EventHandler\Message\Service\DialogBotAllowed » - We have given the bot permission to send us direct messages.
- danog\MadelineProto\EventHandler\Message\Service\DialogChannelCreated » - The channel was created.
- danog\MadelineProto\EventHandler\Message\Service\DialogChannelMigrateFrom » - Indicates the channel was migrated from the specified chat.
- danog\MadelineProto\EventHandler\Message\Service\DialogChatJoinedByLink » - A user joined the chat via an invite link.
- danog\MadelineProto\EventHandler\Message\Service\DialogChatMigrateTo » - Indicates the chat was migrated to the specified supergroup.
- danog\MadelineProto\EventHandler\Message\Service\DialogContactSignUp » - A contact just signed up to telegram.
- danog\MadelineProto\EventHandler\Message\Service\DialogCreated » - A chat or channel was created.
- danog\MadelineProto\EventHandler\Message\Service\DialogDeleteMessages » - Deleted messages.
- danog\MadelineProto\EventHandler\Message\Service\DialogGameScore » - Someone scored in a game.
- danog\MadelineProto\EventHandler\Message\Service\DialogGeoProximityReached » - A user of the chat is now in proximity of another user.
- danog\MadelineProto\EventHandler\Message\Service\DialogGiftPremium » - Info about a gifted Telegram Premium subscription.
- danog\MadelineProto\EventHandler\Message\Service\DialogGiftStars » - Info about a gifted Telegram Stars.
- danog\MadelineProto\EventHandler\Message\Service\DialogGroupCall » - Represents a service message about a group call.
- danog\MadelineProto\EventHandler\Message\Service\DialogGroupCall\GroupCall » - The group call has started or ended.
- danog\MadelineProto\EventHandler\Message\Service\DialogGroupCall\GroupCallInvited » - A set of users was invited to the group call.
- danog\MadelineProto\EventHandler\Message\Service\DialogGroupCall\GroupCallScheduled » - A group call was scheduled.
- danog\MadelineProto\EventHandler\Message\Service\DialogHistoryCleared » - Chat history was cleared.
- danog\MadelineProto\EventHandler\Message\Service\DialogMemberJoinedByRequest » - A user was accepted into the group by an admin.
- danog\MadelineProto\EventHandler\Message\Service\DialogMemberLeft » - A member left the chat or channel.
- danog\MadelineProto\EventHandler\Message\Service\DialogMembersJoined » - Some members joined the chat or channel.
- danog\MadelineProto\EventHandler\Message\Service\DialogMessagePinned » - A message was pinned in a chat.
- danog\MadelineProto\EventHandler\Message\Service\DialogNoForwardRequest » - Emitted only in private chats if the other side requested to disable content protection ».
- danog\MadelineProto\EventHandler\Message\Service\DialogNoForwardToggle » - Emitted only in private chats when enabling or disabling content protection ».
- danog\MadelineProto\EventHandler\Message\Service\DialogPaymentSent » - A payment was sent.
- danog\MadelineProto\EventHandler\Message\Service\DialogPaymentSentMe » - A user just sent a payment to me (a bot).
- danog\MadelineProto\EventHandler\Message\Service\DialogPeerRequested » - Contains info about a peer that the user shared with the bot after clicking on a keyboardButtonRequestPeer button.
- danog\MadelineProto\EventHandler\Message\Service\DialogPhoneCall » - A phone call.
- danog\MadelineProto\EventHandler\Message\Service\DialogPhotoChanged » - The photo of the dialog was changed or deleted.
- danog\MadelineProto\EventHandler\Message\Service\DialogReadMessages » - Messages marked as read.
- danog\MadelineProto\EventHandler\Message\Service\DialogScreenshotTaken » - A screenshot of the chat was taken.
- danog\MadelineProto\EventHandler\Message\Service\DialogSetChatTheme » - The chat theme was changed.
- danog\MadelineProto\EventHandler\Message\Service\DialogSetChatWallPaper » - The wallpaper of the current chat was changed.
- danog\MadelineProto\EventHandler\Message\Service\DialogSetTTL » - The Time-To-Live of messages in this chat was changed.
- danog\MadelineProto\EventHandler\Message\Service\DialogStarGift » - Info about a Star gifted.
- danog\MadelineProto\EventHandler\Message\Service\DialogSuggestProfilePhoto » - A new profile picture was suggested using photos.uploadContactProfilePhoto.
- danog\MadelineProto\EventHandler\Message\Service\DialogTitleChanged » - The title of a channel or group has changed.
- danog\MadelineProto\EventHandler\Message\Service\DialogTopicCreated » - A forum topic was created.
- danog\MadelineProto\EventHandler\Message\Service\DialogTopicEdited » - Forum topic information was edited.
- danog\MadelineProto\EventHandler\Message\Service\DialogWebView » - Data from an opened reply keyboard bot web app was relayed to the bot that owns it (user & bot side service message).
- danog\MadelineProto\EventHandler\Payments\Payment » - This object contains information about an incoming pre-checkout query.
- danog\MadelineProto\EventHandler\Pinned » - Indicates that some messages were pinned/unpinned.
- danog\MadelineProto\EventHandler\Pinned\PinnedChannelMessages » - Represents messages that were pinned/unpinned in a channel.
- danog\MadelineProto\EventHandler\Pinned\PinnedGroupMessages » - Represents messages that were pinned/unpinned in a chat/supergroup.
- danog\MadelineProto\EventHandler\Pinned\PinnedPrivateMessages » - Some messages were pinned in a private chat.
- danog\MadelineProto\EventHandler\Privacy » - Indicates some privacy rules for a user or set of users.
- danog\MadelineProto\EventHandler\Query\ButtonQuery » - Represents a query sent by the user by clicking on a button.
- danog\MadelineProto\EventHandler\Query\ChatButtonQuery » - Represents a query sent by the user by clicking on a button in a chat.
- danog\MadelineProto\EventHandler\Query\ChatGameQuery » - Represents a query sent by the user by clicking on a "Play game" button in a chat.
- danog\MadelineProto\EventHandler\Query\GameQuery » - Represents a query sent by the user by clicking on a "Play game" button.
- danog\MadelineProto\EventHandler\Query\InlineButtonQuery » - Represents a query sent by the user by clicking on a button in an inline message.
- danog\MadelineProto\EventHandler\Query\InlineGameQuery » - Represents a query sent by the user by clicking on a "Play game" button in an inline message.
- danog\MadelineProto\EventHandler\Story\Story » - Represents a Telegram story.
- danog\MadelineProto\EventHandler\Story\StoryDeleted » - Represents a deleted story.
- danog\MadelineProto\EventHandler\Story\StoryReaction » - Represents a reaction to a story.
- danog\MadelineProto\EventHandler\Typing » - A user is typing.
- danog\MadelineProto\EventHandler\Typing\ChatUserTyping » - The user is preparing a message in a group; typing, recording, uploading, etc. This update is valid for 6 seconds. If no further updates of this kind are received after 6 seconds, it should be considered that the user stopped doing whatever they were doing.
- danog\MadelineProto\EventHandler\Typing\SecretUserTyping » - The user is preparing a message in a secret chat; typing, recording, uploading, etc. This update is valid for 6 seconds. If no further updates of this kind are received after 6 seconds, it should be considered that the user stopped doing whatever they were doing.
- danog\MadelineProto\EventHandler\Typing\SupergroupUserTyping » - A user is typing in a supergroup.
- danog\MadelineProto\EventHandler\Typing\UserTyping » - The user is preparing a message; typing, recording, uploading, etc. This update is valid for 6 seconds. If no further updates of this kind are received after 6 seconds, it should be considered that the user stopped doing whatever they were doing.
- danog\MadelineProto\EventHandler\User\Blocked » - A peer was blocked.
- danog\MadelineProto\EventHandler\User\BotStopped » - A bot was stopped or re-started.
- danog\MadelineProto\EventHandler\User\Phone » - A user’s phone number was changed.
- danog\MadelineProto\EventHandler\User\Status » - Contains a status update.
- danog\MadelineProto\EventHandler\User\Status\Emoji » - The emoji status of a certain user has changed or was removed.
- danog\MadelineProto\EventHandler\User\Status\EmptyStatus » - User status has not been set yet.
- danog\MadelineProto\EventHandler\User\Status\LastMonth » - Online status: last seen last month.
- danog\MadelineProto\EventHandler\User\Status\LastWeek » - Online status: last seen last week.
- danog\MadelineProto\EventHandler\User\Status\Offline » - The user’s offline status.
- danog\MadelineProto\EventHandler\User\Status\Online » - Online status of the user.
- danog\MadelineProto\EventHandler\User\Status\Recently » - Online status: last seen recently.
- danog\MadelineProto\EventHandler\User\Username » - Changes were made to the user’s first name, last name or username.
- danog\MadelineProto\VoIP » - This update represents a VoIP Telegram call.
- Filters - MadelineProto offers a very simple and intuitive message filtering system, based on PHP's type system and attributes.
- Plugins - MadelineProto offers a native plugin system, based on event handlers!
- Database - MadelineProto optionally can keep some of its internal data in a database, such as mysql, mariadb, postgres or redis (you can also add your own!), reducing RAM usage.
- Settings - MadelineProto has lots of settings that can be used to modify the behaviour of the library.
- AppInfo: App information.
- Auth: Cryptography settings.
- Connection: Connection settings.
- Files: File management settings.
- Logger: Logger settings.
- Peer: Peer database settings.
- Pwr: PWRTelegram settings.
- RPC: RPC settings.
- SecretChats: Secret chat settings.
- Serialization: Serialization settings.
- TLSchema: TL schema settings.
- Templates: Web and CLI template settings for login.
- VoIP: VoIP settings.
- Database\Memory: Memory backend settings.
- Database\Mysql: MySQL backend settings.
- Database\Postgres: Postgres backend settings.
- Database\Redis: Redis backend settings.
- Getting info about the current user - Here's how you can fetch info about the currently logged in user
- Exceptions - MadelineProto can throw lots of different exceptions.
- Avoiding FLOOD_WAITs - If you make too many requests to telegram, you might get FLOOD_WAITed for a while. To avoid these flood waits, you must calculate the flood wait rate.
- Logging - MadelineProto provides a unified class for logging messages to the logging destination defined in settings.
- Telegram VoIP phone calls - MadelineProto provides an easy wrapper to work with phone calls.
- Uploading and downloading files - MadelineProto provides fully parallelized wrapper methods to upload and download files that support bot API file ids, direct upload by URL and file renaming.
- Getting info about chats - There are various methods that can be used to fetch info about chats, based on bot API id, Peer, User, Chat objects.
- Getting all chats (dialogs) - There are two ways to get a list of all chats, depending if you logged in as a user, or as a bot.
- Inline buttons - You can easily click inline buttons using MadelineProto, just access the correct button:
- Secret chats - MadelineProto provides wrappers to work with secret chats.
- Using a proxy - You can use a proxy with MadelineProto.
- Async - MadelineProto now features async, for incredible speed improvements, and parallel processing, all powered by amphp.
- FAQ - Here's a list of common MadelineProto questions and answers.
- Upgrading from MadelineProto v7 to v8 - MadelineProto v8 is a major MadelineProto update, that removes a large number of long-deprecated APIs: I've created this upgrade checklist, to simplify the upgrade process.
- Using methods - There are simplifications for many, if not all of, these methods.
- Named arguments
- Peers
- Files
- Secret chats
- Entities (Markdown & HTML)
- reply_markup (keyboards & inline keyboards)
- bot API objects
- No result
- Multiple method calls
- Cancellation
- FULL API Documentation with descriptions
- Login
- Change 2FA password: update2FA
- Get all chats, broadcast a message to all chats: getDialogIds, getDialogs, getFullDialogs
- Get the full participant list of a channel/group/supergroup: getPwrChat
- Get full info about a user/chat/supergroup/channel: getFullInfo
- Get info about a user/chat/supergroup/channel: getInfo
- Get the ID of a user/chat/supergroup/channel/update: getID
- Get info about the currently logged-in user: getSelf
- Upload or download files up to 4 GB: uploadFrom*, downloadTo*
- Make a phone call and play a song
- Create a secret chat bot
- A collectible gift we own » can be put up for sale on the gift marketplace » with this method, see here » for more info: payments.updateStarGiftPrice
- Abort a pending 2FA password reset, see here for more info »: account.declinePasswordReset
- Accept QR code login token, logging in the app that generated it: auth.acceptLoginToken
- Accept call: acceptCall
- Accept secret chat: acceptSecretChat
- Accept the new terms of service: help.acceptTermsOfService
- Activate or deactivate a Telegram Star subscription »: payments.changeStarsSubscription
- Activate or deactivate a purchased fragment.com username associated to a bot we own: bots.toggleUsername
- Activate or deactivate a purchased fragment.com username associated to a supergroup or channel we own: channels.toggleUsername
- Activate or deactivate a purchased fragment.com username associated to the currently logged-in user: account.toggleUsername
- Activates stories stealth mode, see here » for more info: stories.activateStealthMode
- Add GIF to saved gifs list: messages.saveGif
- Add a main mini app preview, see here » for more info: bots.addPreviewMedia
- Add a sticker to a stickerset. The sticker set must have been created by the current user/bot: stickers.addStickerToSet
- Add an existing telegram user as contact: contacts.addContact
- Add or remove gifts from a star gift collection », or rename the collection: payments.updateStarGiftCollection
- Add/remove sticker from recent stickers list: messages.saveRecentSticker
- Adds a peer to a blocklist, see here » for more info: contacts.block
- Adds a user to a chat and sends a service message on it: messages.addChatUser
- Adds or removes a song from the current user's profile see here » for more info on the music tab of the profile page: account.saveMusic
- 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: channels.setBoostsToUnblockRestrictions
- Allow a user to send us messages without paying if paid messages » are enabled: account.toggleNoPaidMessagesException
- Allow or prevent a bot from changing our emoji status »: bots.toggleUserEmojiStatusPermission
- Allow the specified bot to send us messages: bots.allowSendMessage
- Answer an inline query, for bots only: messages.setInlineBotResults
- Answers a custom query; for bots only: bots.answerWebhookJSONQuery
- Appends one or more items to a todo list »: messages.appendTodoList
- Apply a Telegram Premium giftcode »: payments.applyGiftCode
- Apply changes to multiple stickersets: messages.toggleStickerSets
- Apply one or more boosts » to a peer: premium.applyBoost
- Approve or reject a suggested post »: messages.toggleSuggestedPostApproval
- Associate (or remove) a personal channel », that will be listed on our personal profile page »: account.updatePersonalChannel
- Associate a group to a channel as discussion group for that channel: channels.setDiscussionGroup
- Associate a stickerset to the supergroup: channels.setStickers
- Asynchronously lock a file: flock
- Asynchronously read line: readLine
- Asynchronously sleep: sleep
- Asynchronously write to stdout/browser: echo
- Ban/unban/kick a user in a supergroup/channel: channels.editBanned
- Base64URL encode: base64urlEncode
- 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.checkQuickReplyShortcut
- Bot owners only, fetch main mini app preview information, see here » for more info: bots.getPreviewInfo
- 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.: account.getBotBusinessConnection
- Broadcast a blockchain block to all members of a conference call, see here » for more info: phone.sendConferenceCallBroadcast
- Businesses » may advertise their location using this method, see here » for more info: account.updateBusinessLocation
- Can only be invoked by non-bot admins of a monoforum », obtains the original sender of a message sent by other monoforum admins to the monoforum, on behalf of the channel associated to the monoforum: channels.getMessageAuthor
- Can only be used by TSF members to obtain internal information: help.getUserInfo
- Cancel a bot subscription: payments.botCancelStarsSubscription
- Cancel a running broadcast: cancelBroadcast
- Cancel the code that was sent to verify an email to use as 2FA recovery method: account.cancelPasswordEmail
- Cancel the login verification code: auth.cancelCode
- 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: messages.setDefaultReaction
- Change group call settings: phone.toggleGroupCallSettings
- Change media autodownload settings: account.saveAutoDownloadSettings
- Change or remove the username of a supergroup/channel: channels.updateUsername
- Change privacy settings of current account: account.setPrivacy
- Change settings related to a session: account.changeAuthorizationSettings
- Change the chat theme of a certain chat, see here » for more info: messages.setChatTheme
- Change the default peer that should be used when sending messages, reactions, poll votes to a specific group: messages.saveDefaultSendAs
- Change the emoji status of a user (invoked by bots, see here » for more info on the full flow): bots.updateUserEmojiStatus
- Change the phone number of the current account: account.changePhone
- Change the photo of a channel/supergroup: channels.editPhoto
- Change the reaction notification settings »: account.setReactionsNotifySettings
- Change the set of message reactions » that can be used in a certain group, supergroup or channel: messages.setChatAvailableReactions
- Changes chat name and sends a service message on it: messages.editChatTitle
- Changes chat photo and sends a service message on it: messages.editChatPhoto
- 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.changeStickerPosition
- Changes the default value of the Time-To-Live setting, applied to all new chats: messages.setDefaultHistoryTTL
- Changes the main profile tab of a channel, see here » for more info: channels.setMainProfileTab
- Changes the main profile tab of the current user, see here » for more info: account.setMainProfileTab
- Changes the privacy of already sent paid reactions on a specific message: messages.togglePaidReactionPrivacy
- Changes username for the current user: account.updateUsername
- Check if a certain event handler plugin is installed: hasPlugin
- Check if a mini app can request the download of a specific file: called when handling web_app_request_file_download events »: bots.checkDownloadFileParams
- Check if a username is free and can be assigned to a channel/supergroup: channels.checkUsername
- Check if an event handler instance is present: hasEventHandler
- Check if has admins: hasAdmins
- Check if has report peers: hasReportPeers
- Check if is array or similar (traversable && countable && arrayAccess): isArrayOrAlike
- Check if peer is present in internal peer database: peerIsset
- Check if the 2FA recovery code sent using auth.requestPasswordRecovery is valid, before passing it to auth.recoverPassword: auth.checkRecoveryPassword
- Check if the passed songs are still pinned to the user's profile, or refresh the file references of songs pinned on a user's profile see here » for more info: users.getSavedMusicByID
- Check if the specified gift » can be sent: payments.checkCanSendGift
- Check if the specified global post search » requires payment: channels.checkSearchPostsFlood
- Check if the specified peer is a bot: isBot
- Check if the specified peer is a forum: isForum
- Check if we can process SMS jobs (official clients only): smsjobs.isEligibleToJoin
- Check the validity of a chat invite link and get basic info about it: messages.checkChatInvite
- Check whether chat history exported from another chat app can be imported into a specific Telegram chat, click here for more info »: messages.checkHistoryImportPeer
- Check whether secret chat exists: hasSecretChat
- Check whether the given short name is available: stickers.checkShortName
- Check whether the group call Server Forwarding Unit is currently receiving the streams with the specified WebRTC source IDs.: phone.checkGroupCall
- Check whether the specified bot can send us messages: bots.canSendMessage
- Check whether we can post stories as the specified peer: stories.canSendStory
- Check whether we can write to the specified users, used to implement bulk checks for Premium-only messages » and paid messages »: users.getRequirementsToContact
- Checks whether a purchase is possible. Must be called before in-store purchase, official apps only: payments.canPurchaseStore
- Clear all drafts: messages.clearAllDrafts
- Clear all peer-specific autosave settings: account.deleteAutoSaveExceptions
- Clear bot commands for the specified bot scope and language code: bots.resetBotCommands
- Clear recent stickers: messages.clearRecentStickers
- Clear recently used message reactions: messages.clearRecentReactions
- Clear saved payment information: payments.clearSavedInfo
- Clears list of recently used emoji statuses: account.clearRecentEmojiStatuses
- Close connection with client, connected via web: closeConnection
- Complet user login using login code: completePhoneLogin
- Complete 2FA login: complete2faLogin
- Complete signup to Telegram: completeSignup
- Complete the history import process, importing all messages into the chat.: messages.startHistoryImport
- Completely delete a quick reply shortcut.: messages.deleteQuickReplyShortcut
- Confirm a phone number to cancel account deletion, for more info click here »: account.confirmPhone
- Confirms receipt of messages by a client, cancels PUSH-notification sending: messages.receivedMessages
- Connect a business bot » to the current account, or to change the current connection settings: account.updateConnectedBot
- Convert MTProto parameters to bot API parameters: MTProtoToBotAPI
- Convert TD parameters to tdcli: tdToTdcli
- Convert TD to MTProto parameters: tdToMTProto
- Convert a collectible gift » to an NFT on the TON blockchain: payments.getStarGiftWithdrawalUrl
- Convert a message and a set of entities to HTML: entitiesToHtml
- 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: payments.convertStarGift
- Convert a supergroup to a gigagroup, when requested by channel suggestions: channels.convertToGigagroup
- Convert bot API parameters to MTProto parameters: botAPIToMTProto
- Convert double to binary version: packDouble
- Convert integer to base256 long: packSignedLong
- Convert integer to base256 signed int: packSignedInt
- Convert tdcli parameters to tdcli: tdcliToTd
- Convert to camelCase: toCamelCase
- Convert to snake_case: toSnakeCase
- Convert value to unsigned base256 int: packUnsignedInt
- Converts a string into an async amphp stream: stringToStream
- Create a business chat deep link »: account.createBusinessChatLink
- Create a group call or livestream: phone.createGroupCall
- Create a star gift collection »: payments.createStarGiftCollection
- Create a stickerset: stickers.createStickerSet
- Create a supergroup/channel: channels.createChannel
- Create a theme: account.createTheme
- Create and optionally join a new conference call: phone.createConferenceCall
- Create and upload a new wallpaper: account.uploadWallPaper
- Create array: arr
- Create, edit or delete the affiliate program of a bot we own: bots.updateStarRefProgram
- Creates a new chat: messages.createChat
- Creates a story album: stories.createAlbum
- Creates and returns a prometheus counter: getPromCounter
- Creates and returns a prometheus gauge: getPromGauge
- Creates and returns a prometheus histogram: getPromHistogram
- Creates and returns a prometheus summary: getPromSummary
- Declines a conference call invite: phone.declineConferenceCallInvite
- Delete a business chat deep link »: account.deleteBusinessChatLink
- Delete a channel/supergroup: channels.deleteChannel
- Delete a chat invite: messages.deleteExportedChatInvite
- Delete a chat: messages.deleteChat
- Delete a fact-check from a message: messages.deleteFactCheck
- Delete a folder imported using a chat folder deep link »: chatlists.leaveChatlist
- Delete a main mini app preview, see here » for more info: bots.deletePreviewMedia
- Delete a previously created chat folder deep link »: chatlists.deleteExportedInvite
- Delete a star gift collection »: payments.deleteStarGiftCollection
- Delete a story album: stories.deleteAlbum
- Delete all installed wallpapers, reverting to the default wallpaper set: account.resetWallPapers
- Delete all messages sent by a specific participant of a given supergroup: channels.deleteParticipantHistory
- Delete all revoked chat invites: messages.deleteRevokedExportedChatInvites
- Delete all temporary authorization keys except for the ones specified: auth.dropTempAuthKeys
- Delete contacts by phone number: contacts.deleteByPhones
- Delete messages in a channel/supergroup: channels.deleteMessages
- Delete one or more messages from a quick reply shortcut. This will also emit an updateDeleteQuickReplyMessages update: messages.deleteQuickReplyMessages
- Delete scheduled messages: messages.deleteScheduledMessages
- Delete stored Telegram Passport documents, for more info see the passport docs »: account.deleteSecureValue
- Delete the entire phone call history: messages.deletePhoneCallHistory
- Delete the history of a supergroup: channels.deleteHistory
- Delete the user's account from the telegram servers: account.deleteAccount
- Deletes a device by its token, stops sending PUSH-notifications to it: account.unregisterDevice
- Deletes a peer from a blocklist, see here » for more info: contacts.unblock
- Deletes a stickerset we created: stickers.deleteStickerSet
- Deletes a user from a chat and sends a service message on it: messages.deleteChatUser
- Deletes communication history: messages.deleteHistory
- Deletes messages by their identifiers: messages.deleteMessages
- Deletes messages from a monoforum topic », or deletes messages forwarded from a specific peer to saved messages »: messages.deleteSavedHistory
- Deletes profile photos. The method returns a list of successfully deleted photo IDs: photos.deletePhotos
- Deletes several contacts from the list: contacts.deleteContacts
- Deletes some posted stories: stories.deleteStories
- Disable SMS jobs (official clients only): smsjobs.leave
- Disable ads on the specified channel, for all users: channels.restrictSponsoredMessages
- Disable all purchased usernames of a supergroup or channel: channels.deactivateAllUsernames
- Disable or re-enable Telegram ads for the current Premium account: account.toggleSponsoredMessages
- Discard call: discardCall
- Discard secret chat: discardSecretChat
- Dismiss a suggestion, see here for more info »: help.dismissSuggestion
- Dismiss new pending peers recently added to a chat folder deep link »: chatlists.hideChatlistUpdates
- Dismiss or approve a chat join request related to a specific chat or channel: messages.hideChatJoinRequest
- Dismiss or approve all join requests related to a specific chat or channel: messages.hideAllChatJoinRequests
- Display or remove a received gift » from our profile: payments.saveStarGift
- Download file to amphp/http-server response: downloadToResponse
- Download file to an amphp stream, returning it: downloadToReturnedStream
- Download file to browser: downloadToBrowser
- Download file to callable: downloadToCallable
- Download file to directory: downloadToDir
- Download file to stream: downloadToStream
- Download file: downloadToFile
- Downloads a file to the browser using the specified session file: downloadServer
- Edit a chat folder deep link »: chatlists.editExportedInvite
- Edit a created business chat deep link »: account.editBusinessChatLink
- Edit a main mini app preview, see here » for more info: bots.editPreviewMedia
- Edit an exported chat invite: messages.editExportedChatInvite
- Edit an inline bot message: messages.editInlineBotMessage
- Edit an uploaded story: stories.editStory
- Edit information about a given group call participant: phone.editGroupCallParticipant
- Edit location of geogroup, see here » for more info on geogroups: channels.editLocation
- Edit message: messages.editMessage
- Edit peers in peer folder: folders.editPeerFolders
- Edit the close friends list, see here » for more info: contacts.editCloseFriends
- Edit the default banned rights of a channel/supergroup/group: messages.editChatDefaultBannedRights
- Edit the description of a group/supergroup/channel: messages.editChatAbout
- Edit the name of a channel/supergroup: channels.editTitle
- Edit the title of a group call or livestream: phone.editGroupCallTitle
- Edit/create a fact-check on a message: messages.editFactCheck
- Edits notification settings from a given user/group, from all users/all groups: account.updateNotifySettings
- Enable SMS jobs (official clients only): smsjobs.join
- Enable or disable content protection on a channel or chat: messages.toggleNoForwards
- Enable or disable folder tags »: messages.toggleDialogFilterTags
- Enable or disable forum functionality in a supergroup: channels.toggleForum
- Enable or disable paid messages » in this supergroup or monoforum: channels.updatePaidMessagesPrice
- Enable or disable the native antispam system: channels.toggleAntiSpam
- Enable or disable web bot attachment menu »: messages.toggleBotInAttachMenu
- Enable/disable message signatures in channels: channels.toggleSignatures
- Enable/disable top peers: contacts.toggleTopPeers
- Enables or disables the reception of notifications every time a gift » is received by the specified channel, can only be invoked by admins with post_messages admin rights: payments.toggleChatStarGiftNotifications
- Escape string for MadelineProto's HTML entity converter: htmlEscape
- Escape string for URL: markdownUrlEscape
- Escape string for markdown code section: markdownCodeEscape
- Escape string for markdown codeblock: markdownCodeblockEscape
- Escape string for markdown: markdownEscape
- Executes a custom broadcast action with all peers (users, chats, channels) of the bot: broadcastCustom
- Export a folder », creating a chat folder deep link »: chatlists.exportChatlistInvite
- Export an invite link for a chat: messages.exportChatInvite
- Export authorization: exportAuthorization
- Extract Update constructors from an Updates constructor: extractUpdates
- Extract a message ID from an Updates constructor: extractMessageId
- Extract a message constructor from an Updates constructor: extractMessage
- Extract an update message constructor from an Updates constructor: extractMessageUpdate
- Extract file info from bot API message: extractBotAPIFile
- Fetch (a subset or all) messages in a quick reply shortcut »: messages.getQuickReplyMessages
- Fetch Telegram Stars transactions: payments.getStarsTransactions
- Fetch a default recommended list of saved message tag reactions: messages.getDefaultTagReactions
- Fetch a list of star giveaway options »: payments.getStarsGiveawayOptions
- Fetch all affiliations we have created for a certain peer: payments.getConnectedStarRefBots
- Fetch all stickersets » owned by the current user: messages.getMyStickers
- 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: contacts.getBirthdays
- Fetch basic info about all existing quick reply shortcuts: messages.getQuickReplies
- Fetch custom emoji stickers »: messages.getCustomEmojiDocuments
- Fetch info about a specific bot affiliation »: payments.getConnectedStarRefBot
- Fetch info about specific gifts owned by a peer we control: payments.getSavedStarGift
- Fetch information about a fragment collectible, see here » for more info on the full flow: fragment.getCollectibleInfo
- Fetch main mini app previews, see here » for more info: bots.getPreviewMedias
- Fetch new chats associated with an imported chat folder deep link ». Must be invoked at most every chatlist_update_period seconds (as per the related client configuration parameter »): chatlists.getChatlistUpdates
- Fetch one or more factchecks, see here » for the full flow: messages.getFactCheck
- Fetch popular Main Mini Apps, to be used in the apps tab of global search »: bots.getPopularAppBots
- Fetch saved messages » forwarded from a specific peer, or fetch messages from a monoforum topic »: messages.getSavedHistory
- Fetch saved notification sounds: account.getSavedRingtones
- Fetch the List of active (or active and hidden) stories, see here » for more info on watching stories: stories.getAllStories
- Fetch the blocks of a conference blockchain »: phone.getGroupCallChainBlocks
- Fetch the full active story list of a specific peer: stories.getPeerStories
- Fetch the full list of gifts owned by a peer: payments.getSavedStarGifts
- Fetch the full list of only the IDs of songs currently added to the profile, see here » for more info: account.getSavedMusicIds
- Fetch the full list of saved message tags created by the user: messages.getSavedReactionTags
- Fetch the full list of usable animated message effects »: messages.getAvailableEffects
- Fetch the stories pinned on a peer's profile: stories.getPinnedStories
- Fetch the story archive » of a peer we control: stories.getStoriesArchive
- Fetch updated information about paid media, see here » for the full flow: messages.getExtendedMedia
- Fetches all star gift collections » of a peer: payments.getStarGiftCollections
- Fetches an updatePaidReactionPrivacy update with the current default paid reaction privacy, see here » for more info: messages.getPaidReactionPrivacy
- Find out if a media message's caption can be edited: messages.getMessageEditData
- Finish an SMS job (official clients only): smsjobs.finishJob
- Fork a new green thread and execute the passed function in the background: callFork
- Forwards a list of messages to all peers (users, chats, channels) of the bot: broadcastForwardMessages
- Forwards messages by their IDs: messages.forwardMessages
- Generate MTProto vector hash: genVectorHash
- Generate a login token, for login via QR code.: auth.exportLoginToken
- Generate a story deep link for a specific story: stories.exportStoryLink
- Generate an invoice deep link: payments.exportInvoice
- Generates a temporary profile link for the currently logged-in user: contacts.exportContactToken
- Get PSR logger: getPsrLogger
- 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): phone.getGroupCallStreamRtmpUrl
- Get SMS jobs status (official clients only): smsjobs.getStatus
- Get TL namespaces: getMethodNamespaces
- Get TL serializer: getTL
- Get Telegram Premium promotion information: help.getPremiumPromo
- Get Telegram Star revenue statistics »: payments.getStarsRevenueStats
- Get Telegram UTF-8 length of string: mbStrlen
- Get a document by its SHA256 hash, mainly used for gifs: messages.getDocumentByHash
- Get a list of available gifts, see here » for more info: payments.getStarGifts
- Get a list of bots owned by the current user: bots.getAdminedBots
- Get a list of channels/supergroups we left, requires a takeout session, see here » for more info: channels.getLeftChannels
- Get a list of default suggested channel emoji statuses: account.getChannelDefaultEmojiStatuses
- Get a list of default suggested emoji statuses: account.getDefaultEmojiStatuses
- Get a list of peers that can be used to join a group call, presenting yourself as a specific user/channel: phone.getGroupCallJoinAs
- Get a list of sponsored messages for a peer, see here » for more info: messages.getSponsoredMessages
- Get a message to show to the user when starting the bot: getWebMessage
- Get a payment form: payments.getPaymentForm
- Get a set of suggested custom emoji stickers that can be used as group picture: account.getDefaultGroupPhotoEmojis
- Get a set of suggested custom emoji stickers that can be used as profile picture: account.getDefaultProfilePhotoEmojis
- Get a set of suggested custom emoji stickers that can be used in an accent color pattern: account.getDefaultBackgroundEmojis
- Get admin IDs (equal to all user report peers): getAdminIds
- Get all archived stickers: messages.getArchivedStickers
- Get all available chat themes »: account.getChatThemes
- Get all contacts, requires a takeout session, see here » for more info: contacts.getSaved
- Get all groups that can be used as discussion groups: channels.getGroupsForDiscussion
- Get all installed stickers: messages.getAllStickers
- Get all pending and running calls, indexed by user ID: getAllCalls
- Get all saved Telegram Passport documents, for more info see the passport docs »: account.getAllSecureValues
- Get an invite link for a group call or livestream: phone.exportGroupCallInvite
- Get and increase the view counter of a message sent or forwarded from a channel: messages.getMessagesViews
- Get app-specific configuration, see client configuration for more info on the result: help.getAppConfig
- Get async DNS client: getDNSClient
- Get async HTTP client: getHTTPClient
- Get authorization info: getAuthorization
- Get autosave settings: account.getAutoSaveSettings
- Get cached (or eventually re-fetch) server-side config: getConfig
- Get cached server-side config: getCachedConfig
- Get call state: getCallState
- Get changed emoji keywords »: messages.getEmojiKeywordsDifference
- Get channel statistics: stats.getBroadcastStats
- Get channel/supergroup messages: channels.getMessages
- 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.getAdminedPublicChannels
- Get chats in common with a user: messages.getCommonChats
- Get collectible gifts of a specific type currently on resale, see here » for more info: payments.getResaleStarGifts
- Get configuration for CDN file downloads: help.getCdnConfig
- Get contents of remote file asynchronously: fileGetContents
- Get count of online users in a chat: messages.getOnlines
- Get current number of memory-mapped regions, UNIX only: getMaps
- Get current password hint: getHint
- Get days to live of account: account.getAccountTTL
- Get dialog info of specified peers: messages.getPeerDialogs
- Get dialogs manually marked as unread: messages.getDialogUnreadMarks
- Get diffie-hellman configuration: getDhConfig
- 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.getDiscussionMessage
- Get download info of file: getDownloadInfo
- Get download link of media file: getDownloadLink
- Get event handler (or plugin instance): getEventHandler
- Get extension from file location: getExtensionFromLocation
- Get extension from mime type: getExtensionFromMime
- Get faved stickers: messages.getFavedStickers
- Get featured stickers: messages.getFeaturedStickers
- Get final element of array: end
- Get folders: messages.getDialogFilters
- Get full list of MTProto and API methods: getAllMethods
- Get global privacy settings: account.getGlobalPrivacySettings
- Get group call participants: phone.getGroupParticipants
- Get highscores of a game sent using an inline bot: messages.getInlineGameHighScores
- Get highscores of a game: messages.getGameHighScores
- Get inactive channels and supergroups: channels.getInactiveChannels
- Get info about RTMP streams in a group call or livestream.: phone.getGroupCallStreamChannels
- Get info about a certain wallpaper: account.getWallPaper
- Get info about a channel/supergroup participant: channels.getParticipant
- Get info about a chat invite: messages.getExportedChatInvite
- Get info about a credit card: payments.getBankCardData
- Get info about a group call: phone.getGroupCall
- Get info about a stickerset: messages.getStickerSet
- Get info about an SMS job (official clients only): smsjobs.getSmsJob
- Get info about an unsupported deep link, see here for more info »: help.getDeepLinkInfo
- Get info about chat invites generated by admins: messages.getAdminsWithInvites
- Get info about file: getFileInfo
- Get info about multiple wallpapers: account.getMultiWallPapers
- Get info about the chat invites of a specific chat: messages.getExportedChatInvites
- Get info about the logged-in user, not cached: fullGetSelf
- Get info about the users that joined the chat using a specific chat invite: messages.getChatInviteImporters
- Get information about a language in a localization pack: langpack.getLanguage
- Get information about all languages in a localization pack: langpack.getLanguages
- Get information about the value of a collectible gift »: payments.getUniqueStarGiftValueInfo
- Get installed mask stickers: messages.getMaskStickers
- Get installed themes: account.getThemes
- Get instant view page: messages.getWebPage
- Get link and embed info of a message in a channel/supergroup: channels.exportMessageLink
- Get live location history of a certain user: messages.getRecentLocations
- Get localization pack strings: langpack.getLangPack
- Get localized emoji keywords »: messages.getEmojiKeywords
- Get localized name of the telegram support user: help.getSupportName
- Get localized name, about text and description of a bot (or of the current account, if called by a bot): bots.getBotInfo
- Get logged-in sessions: account.getAuthorizations
- Get logger: getLogger
- Get maximum number of memory-mapped regions, UNIX only: getMaxMaps
- Get media autodownload settings: account.getAutoDownloadSettings
- Get memory profile with memprof: getMemoryProfile
- Get message ranges for saving the user's chat history: messages.getSplitRanges
- Get message reaction list, along with the sender of each reaction: messages.getMessageReactionsList
- Get message reactions »: messages.getMessagesReactions
- Get message statistics: stats.getMessageStats
- Get messages in a reply thread: messages.getReplies
- Get mime type from buffer: getMimeFromBuffer
- Get mime type from file extension: getMimeFromExtension
- Get mime type of file: getMimeFromFile
- Get more info about a Seamless Telegram Login authorization request, for more info click here »: messages.requestUrlAuth
- Get most used peers: contacts.getTopPeers
- Get name, ISO code, localized name and phone codes/patterns of all available countries: help.getCountriesList
- Get namespaced methods (method => namespace): getMethodsNamespaced
- Get new strings in language pack: langpack.getDifference
- Get passport configuration: help.getPassportConfig
- Get payment receipt: payments.getPaymentReceipt
- Get peer settings: messages.getPeerSettings
- Get phone call configuration to be passed to libtgvoip's shared config: phone.getCallConfig
- Get phone call information: getCall
- Get pinned dialogs: messages.getPinnedDialogs
- Get pinned saved dialogs, see here » for more info: messages.getPinnedSavedDialogs
- Get poll results for non-anonymous polls: messages.getPollVotes
- Get poll results: messages.getPollResults
- Get preview of webpage: messages.getWebPagePreview
- Get privacy settings of current account: account.getPrivacy
- Get random integer: randomInt
- Get recent stickers: messages.getRecentStickers
- Get recently used emoji statuses: account.getRecentEmojiStatuses
- Get recently used message reactions: messages.getRecentReactions
- Get recently used t.me links: help.getRecentMeUrls
- Get saved GIFs: messages.getSavedGifs
- Get saved Telegram Passport document, for more info see the passport docs »: account.getSecureValue
- Get saved payment information: payments.getSavedInfo
- Get scheduled messages: messages.getScheduledHistory
- Get scheduled messages: messages.getScheduledMessages
- Get secret chat: getSecretChat
- Get secure random string of specified length: random
- Get sensitive content settings: account.getContentSettings
- Get songs pinned to the user's profile, see here » for more info: users.getSavedMusic
- Get sponsored messages for channel: getSponsoredMessages
- Get statistics for a certain story: stats.getStoryStats
- Get stickers attached to a photo or video: messages.getAttachedStickers
- Get stickers by emoji: messages.getStickers
- Get stories in a story album »: stories.getAlbumStories
- Get story albums created by a peer: stories.getAlbums
- Get strings from a language pack: langpack.getStrings
- Get suggested folders: messages.getSuggestedDialogFilters
- Get supergroup statistics: stats.getMegagroupStats
- Get temporary payment password: account.getTmpPassword
- Get the IDs of the maximum read stories for a set of peers: stories.getPeerMaxIDs
- Get the admin log of a channel/supergroup: channels.getAdminLog
- Get the current Telegram Stars balance of the current account (with peer=inputPeerSelf), or the stars balance of the bot specified in peer: payments.getStarsStatus
- Get the current reaction notification settings »: account.getReactionsNotifySettings
- Get the exact read date of one of our messages, sent to a private chat with another user: messages.getOutboxReadDate
- Get the file that is currently being played: callGetCurrent
- Get the number of results that would be found by a messages.search call with the same parameters: messages.getSearchCounters
- Get the number of stars we have received from the specified user thanks to paid messages »; the received amount will be equal to the sent amount multiplied by stars_paid_message_commission_permille divided by 1000: account.getPaidMessagesRevenue
- Get the participants of a supergroup/channel: channels.getParticipants
- Get the phone call with the specified user ID: getCallByPeer
- Get the progress of a currently running broadcast: getBroadcastProgress
- Get the reaction and interaction list of a story posted to a channel, along with the sender of each reaction: stories.getStoryReactionsList
- Get the set of accent color palettes » that can be used for message accents: help.getPeerColors
- Get the set of accent color palettes » that can be used in profile page backgrounds: help.getPeerProfileColors
- Get the telegram IDs of all contacts.: contacts.getContactIDs
- Get theme information: account.getTheme
- Get type of peer: getType
- Get unread messages where we were mentioned: messages.getUnreadMentions
- Get unread reactions to messages you sent: messages.getUnreadReactions
- Get users and geochats near you, see here » for more info: contacts.getLocated
- Get various warnings to show to the user in the web UI: getWebWarnings
- Get web login widget authorizations: account.getWebAuthorizations
- 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.getMessageReadParticipants
- Gets a secret chat message: getSecretMessage
- Gets current notification settings for a given user/group, from all users/all groups: account.getNotifySettings
- Gets featured custom emoji stickersets: messages.getFeaturedEmojiStickers
- Gets info of the propic of a user: getPropicInfo
- Gets the current number of boosts of a channel/supergroup: premium.getBoostsStatus
- Gets the default value of the Time-To-Live setting, applied to all new chats: messages.getDefaultHistoryTTL
- Gets the list of currently installed custom emoji stickersets: messages.getEmojiStickers
- 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: bots.getBotMenuButton
- Globally search for posts from public channels » (including those we aren't a member of) containing either a specific hashtag, or a full text query: channels.searchPosts
- Globally search for stories using a hashtag or a location media area, see here » for more info on the full flow: stories.searchPosts
- Got popular message reactions: messages.getTopReactions
- Hide MTProxy/Public Service Announcement information: help.hidePromoData
- Hide or display the participants list in a supergroup: channels.toggleParticipantsHidden
- Hide the active stories of a specific peer, preventing them from being displayed on the action bar on the homescreen: stories.toggleAllStoriesHidden
- 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.togglePeerStoriesHidden
- Hide/unhide message history for new channel/supergroup users: channels.togglePreHistoryHidden
- If the add contact action bar is active, add that user as contact: contacts.acceptContact
- 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: messages.setBotShippingResults
- Import a chat folder deep link », joining some or all the chats in the folder: chatlists.joinChatlistInvite
- Import a chat invite and join a private chat/supergroup/channel: messages.importChatInvite
- Import authorization: importAuthorization
- Import chat history from a foreign chat app into a specific Telegram chat, click here for more info about imported chats »: messages.initHistoryImport
- Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info: contacts.importContacts
- Increment the view counter of one or more stories: stories.incrementStoryViews
- Indicate to the server (from the user side) that the user is still using a web app: messages.prolongWebView
- Inflate stripped photosize to full JPG payload: inflateStripped
- Informs server about a purchase made through the App Store: for official applications only: payments.assignAppStoreTransaction
- Informs server about a purchase made through the Play Store: for official applications only: payments.assignPlayMarketTransaction
- Informs the server about the number of pending bot updates if they haven't been processed for a long time; for bots only: help.setBotUpdatesStatus
- Informs the server that the user has interacted with a sponsored message in one of the ways listed here »: messages.clickSponsoredMessage
- Initialize a takeout session, see here » for more info: account.initTakeoutSession
- Initialize connection: initConnection
- Initialize self-restart hack: initSelfRestart
- Initiate a 2FA password reset: can only be used if the user is already logged-in, see here for more info »: account.resetPassword
- Initiates QR code login: qrLogin
- Install a stickerset: messages.installStickerSet
- Install a theme: account.installTheme
- Install wallpaper: account.installWallPaper
- Install/uninstall wallpaper: account.saveWallPaper
- Installs a previously uploaded photo as a profile photo: photos.updateProfilePhoto
- Internal endpoint used by the download server: processDownloadServerPing
- Internal use: help.editUserInfo
- Invalidate the specified login codes, see here » for more info: account.invalidateSignInCodes
- Invite a set of users to a group call: phone.inviteToGroupCall
- Invite a user to a conference call: phone.inviteConferenceCallParticipant
- Invite users to a channel/supergroup: channels.inviteToChannel
- 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: invokeWithBusinessConnection
- Invoke a method within a takeout session, see here » for more info: invokeWithTakeout
- Invoke a request without subscribing the used connection for updates (this is enabled by default for file queries): invokeWithoutUpdates
- Invoke the specified query using the specified API layer: invokeWithLayer
- Invoke with the given message range: invokeWithMessagesRange
- Invokes a query after a successful completion of previous queries: invokeAfterMsgs
- Invokes a query after successful completion of one of the previous queries: invokeAfterMsg
- Join a bot's affiliate program, becoming an affiliate »: payments.connectStarRefBot
- Join a channel/supergroup: channels.joinChannel
- Join a group call: phone.joinGroupCall
- Join channels and supergroups recently added to a chat folder deep link »: chatlists.joinChatlistUpdates
- Launch a prepaid giveaway »: payments.launchPrepaidGiveaway
- Leave a bot's affiliate program »: payments.editConnectedStarRefBot
- Leave a channel/supergroup: channels.leaveChannel
- Leave a group call: phone.leaveGroupCall
- List all chat folder deep links » associated to a folder: chatlists.getExportedInvites
- List all created business chat deep links »: account.getBusinessChatLinks
- List all currently connected business bots »: account.getConnectedBots
- Load channel statistics graph asynchronously: stats.loadAsyncGraph
- Log in to telegram (via CLI or web): start
- Log out an active authorized session by its hash: account.resetAuthorization
- Log out an active web telegram login session: account.resetWebAuthorization
- Logger: logger
- Login as bot: botLogin
- Login as user: phoneLogin
- Login by importing an authorization token: auth.importWebTokenAuthorization
- Login using a redirected login token, generated in case of DC mismatch during QR code login: auth.importLoginToken
- Logout the session: logout
- Look for custom emojis associated to a UTF8 emoji: messages.searchCustomEmoji
- Look for updates of telegram's terms of service: help.getTermsOfServiceUpdate
- MTProto to TD params: MTProtoToTd
- MTProto to TDCLI params: MTProtoToTdcli
- Make a payment using Telegram Stars, see here » for more info: payments.sendStarsForm
- Make a user admin in a basic group: messages.editChatAdmin
- Manually convert HTML to a message and a set of entities: htmlToMessageEntities
- Manually convert markdown to a message and a set of entities: markdownToMessageEntities
- Manually mark dialog as unread: messages.markDialogUnread
- Mark a specific sponsored message » as read: messages.viewSponsoredMessage
- Mark a thread as read: messages.readDiscussion
- 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.readStories
- Mark channel/supergroup history as read: channels.readHistory
- Mark channel/supergroup message contents as read, emitting an updateChannelReadMessagesContents: channels.readMessageContents
- Mark mentions as read: messages.readMentions
- Mark message reactions » as read: messages.readReactions
- Mark messages as read in a monoforum topic »: messages.readSavedHistory
- Mark new featured stickers as read: messages.readFeaturedStickers
- Mark one or more items of a todo list » as completed or not completed: messages.toggleTodoCompleted
- Mark or unmark a sticker as favorite: messages.faveSticker
- Mark sponsored message as read: viewSponsoredMessage
- Marks message history as read: messages.readHistory
- Marks message history within a secret chat as read: messages.readEncryptedHistory
- Method for fetching previously featured stickers: messages.getOldFeaturedStickers
- Modify autosave settings: account.saveAutoSaveSettings
- Modify the admin rights of a user in a supergroup/channel: channels.editAdmin
- Notifies the sender about the recipient having listened a voice message or watched a video, emitting an updateReadMessagesContents: messages.readMessageContents
- Notify the other user in a private chat that a screenshot of the chat was taken: messages.sendScreenshotNotification
- 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): users.setSecureValueErrors
- Obtain a certain event handler plugin instance: getPlugin
- Obtain a list of Telegram Premium giveaway/gift code » options: payments.getPremiumGiftCodeOptions
- Obtain a list of Telegram Stars gift options » as starsGiftOption constructors: payments.getStarsGiftOptions
- Obtain a list of Telegram Stars topup options » as starsTopupOption constructors: payments.getStarsTopupOptions
- Obtain a list of active, expired or cancelled Telegram Star subscriptions »: payments.getStarsSubscriptions
- Obtain a list of bot commands for the specified bot scope and language code: bots.getBotCommands
- Obtain a list of channels where the user can post stories: stories.getChatsToSend
- Obtain a list of emoji statuses » for owned collectible gifts: account.getCollectibleEmojiStatuses
- Obtain a list of related languages that must be used when fetching emoji keyword lists »: messages.getEmojiKeywordsLanguages
- Obtain a list of similarly themed bots, selected based on similarities in their subscriber bases, see here » for more info: bots.getBotRecommendations
- Obtain a list of similarly themed public channels, selected based on similarities in their subscriber bases: channels.getChannelRecommendations
- Obtain a list of sponsored peer search results for a given query: contacts.getSponsoredPeers
- Obtain a list of suggested mini apps with available affiliate programs: payments.getSuggestedStarRefBots
- Obtain a prepared inline message generated by a mini app: invoked when handling web_app_send_prepared_message events: messages.getPreparedInlineMessage
- Obtain a preview of the possible attributes (chosen randomly) a gift » can receive after upgrading it to a collectible gift », see here » for more info: payments.getStarGiftUpgradePreview
- Obtain all chat themes » associated to owned collectible gifts »: account.getUniqueGiftChatThemes
- Obtain available message reactions »: messages.getAvailableReactions
- Obtain configuration for two-factor authorization with password: account.getPassword
- Obtain forwards of a story as a message to public chats and reposts by public channels: stats.getStoryPublicForwards
- Obtain full info about a set of stories by their IDs: stories.getStoriesByID
- Obtain info about Telegram Star transactions » using specific transaction IDs: payments.getStarsTransactionsByID
- Obtain info about a collectible gift » using a slug obtained from a collectible gift link »: payments.getUniqueStarGift
- Obtain info about the view count, forward count, reactions and recent viewers of one or more stories: stories.getStoriesViews
- Obtain information about a Telegram Premium giftcode »: payments.checkGiftCode
- Obtain information about a Telegram Premium giveaway »: payments.getGiveawayInfo
- Obtain information about a chat folder deep link »: chatlists.checkChatlistInvite
- Obtain information about a direct link Mini App: messages.getBotApp
- Obtain information about specific saved message dialogs » or monoforum topics »: messages.getSavedDialogsByID
- Obtain the API ID UI template: getWebAPITemplate
- 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.getAllReadPeerStories
- Obtain the list of users that have viewed a specific story we posted: stories.getStoryViewsList
- Obtain user info from a temporary profile link: contacts.importContactToken
- Obtain which peers are we currently boosting, and how many boost slots we have left: premium.getMyBoosts
- Obtains a list of messages, indicating to which other public channels was a channel message forwarded.: stats.getMessagePublicForwards
- Obtains a list of peers that can be used to send messages in a specific group: channels.getSendAs
- Obtains a pipe that can be used to upload a file from a stream: getStreamPipe
- Obtains info about the boosts that were applied to a certain channel or supergroup (admins only): premium.getBoostsList
- Obtains information about a chat export file, generated by a foreign chat app, click here for more info about imported chats »: messages.checkHistoryImport
- Official apps only, reports that the SMS authentication code wasn't delivered: auth.reportMissingCode
- Official clients only, invoke with Apple push verification: invokeWithApnsSecret
- Official clients only, invoke with Google Play Integrity token: invokeWithGooglePlayIntegrity
- Official clients only: re-execute a method call that required reCAPTCHA verification via a RECAPTCHA_CHECK_%s__%s, where the first placeholder is the action, and the second one is the reCAPTCHA key ID: invokeWithReCaptcha
- Once the user has confirmed their payment and shipping details, the bot receives an updateBotPrecheckoutQuery update.: messages.setBotPrecheckoutResults
- Only useful when consuming MadelineProto updates through an API in another language (like Javascript), absolutely not recommended when directly writing MadelineProto bots: getUpdates
- Open a Main Mini App: messages.requestMainWebView
- Open a bot mini app from a direct Mini App deep link, sending over user information after user confirmation: messages.requestAppWebView
- Open a bot mini app, sending over user information after user confirmation: messages.requestWebView
- Open a bot mini app: messages.requestSimpleWebView
- Opens a file in append-only mode: openFileAppendOnly
- 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.receivedCall
- Parse, update and store settings: updateSettings
- Pause or unpause a specific chat, temporarily disconnecting it from all business bots »: account.toggleConnectedBotPaused
- Pauses playback of the current audio file in the call: pausePlay
- Perform static analysis on a certain event handler class, to make sure it satisfies some performance requirements: validateEventHandlerClass
- 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.disablePeerConnectedBot
- Pin a message: messages.updatePinnedMessage
- Pin or unpin a saved message dialog »: messages.toggleSavedDialogPin
- Pin or unpin one or more stories: stories.togglePinned
- Pin some stories to the top of the profile, see here » for more info: stories.togglePinnedToTop
- Pin/unpin a dialog: messages.toggleDialogPin
- Pins a received gift on top of the profile of the user or owned channels by using payments.toggleStarGiftsPinnedToTop: payments.toggleStarGiftsPinnedToTop
- Play file in call: callPlay
- Play files on hold in call: callPlayOnHold
- Positive modulo: posmod
- Press an inline callback button and get a callback answer from the bot: messages.getBotCallbackAnswer
- Provide a buffered reader for a file, URL or amp stream: openBuffered
- Provide a stream for a file, URL or amp stream: getStream
- Query an inline bot: messages.getInlineBotResults
- Rate a call, returns info about the rating message sent to the official VoIP bot: phone.setCallRating
- Rate transcribed voice message: messages.rateTranscribedAudio
- Re-join a private channel associated to an active Telegram Star subscription »: payments.fulfillStarsSubscription
- React to a story: stories.sendReaction
- React to message: messages.sendReaction
- Refresh full peer cache for a certain peer: refreshFullPeerCache
- Refresh peer cache for a certain peer: refreshPeerCache
- Refund a Telegram Stars transaction, see here » for more info: payments.refundStarsCharge
- Register device to receive PUSH notifications: account.registerDevice
- Remove a sticker from the set where it belongs. The sticker set must have been created by the current user/bot: stickers.removeStickerFromSet
- Remove participants from a conference call: phone.deleteConferenceCallParticipants
- Removes all contacts without an associated Telegram account: contacts.resetSaved
- Rename a quick reply shortcut.: messages.editQuickReplyShortcut
- Rename a story albums », or add, delete or reorder stories in it: stories.updateAlbum
- Renames a stickerset: stickers.renameStickerSet
- Renders prometheus stats using the specified renderer: renderPromStats
- Reorder a main mini app previews, see here » for more info: bots.reorderPreviewMedias
- Reorder active usernames: channels.reorderUsernames
- Reorder folders: messages.updateDialogFiltersOrder
- Reorder installed stickersets: messages.reorderStickerSets
- Reorder pinned dialogs: messages.reorderPinnedDialogs
- Reorder pinned saved message dialogs »: messages.reorderPinnedSavedDialogs
- Reorder quick reply shortcuts: messages.reorderQuickReplies
- Reorder story albums on a profile »: stories.reorderAlbums
- Reorder the star gift collections » on an owned peer's profile: payments.reorderStarGiftCollections
- Reorder usernames associated to a bot we own: bots.reorderUsernames
- Reorder usernames associated with the currently logged-in user: account.reorderUsernames
- Replace a sticker in a stickerset »: stickers.replaceSticker
- Replace the contents of an entire blocklist, see here for more info »: contacts.setBlocked
- Report a message in a chat for violation of telegram's Terms of Service: messages.report
- Report a message reaction: messages.reportReaction
- Report a native antispam false positive: channels.reportAntiSpamFalsePositive
- Report a new incoming chat for spam, if the peer settings of the chat allow us to do that: messages.reportSpam
- Report a peer for violation of telegram's Terms of Service: account.reportPeer
- Report a profile photo of a dialog: account.reportProfilePhoto
- Report a secret chat for spam: messages.reportEncryptedSpam
- Report a sponsored message », see here » for more info on the full flow: messages.reportSponsoredMessage
- Report a story: stories.report
- Report an error to the previously set peer: report
- Report memory profile with memprof: reportMemoryProfile
- Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup: channels.reportSpam
- Represents a list of emoji categories, to be used when choosing a sticker: messages.getEmojiStickerGroups
- Represents a list of emoji categories, to be used when selecting custom emojis to set as custom emoji status: messages.getEmojiStatusGroups
- Represents a list of emoji categories, to be used when selecting custom emojis to set as profile picture: messages.getEmojiProfilePhotoGroups
- Represents a list of emoji categories: messages.getEmojiGroups
- Request VoIP call: requestCall
- Request an SMS code via Firebase: auth.requestFirebaseSms
- Request recovery code of a 2FA password, only for accounts with a recovery email configured: auth.requestPasswordRecovery
- Request secret chat: requestSecretChat
- Resend the code to verify an email to use as 2FA recovery method: account.resendPasswordEmail
- 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.resendCode
- Reset all active web telegram login sessions: account.resetWebAuthorizations
- Reset rating of top peer: contacts.resetTopPeerRating
- Reset the 2FA password using the recovery code sent using auth.requestPasswordRecovery: auth.recoverPassword
- Reset the login email »: auth.resetLoginEmail
- Reset the update state and fetch all updates from the beginning: resetUpdateState
- Resets all notification settings from users and groups: account.resetNotifySettings
- Resolve a business chat deep link »: account.resolveBusinessChatLink
- Resolve a phone number to get user info, if their privacy settings allow it: contacts.resolvePhone
- Restart update loop: restart
- Resumes playback of the current audio file in the call: resumePlay
- Rethrow exception into event loop: rethrow
- Return all message drafts.: messages.getAllDrafts
- Return current settings: getSettings
- Returns a Telegram Passport authorization form for sharing data with a service: account.getAuthorizationForm
- 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.getStarsRevenueAdsAccountUrl
- Returns a list of available wallpapers: account.getWallPapers
- Returns a set of useful suggestions and PSA/MTProxy sponsored peers, see here » for more info: help.getPromoData
- 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: messages.getEmojiURL
- Returns attachment menu entry for a bot mini app that can be launched from the attachment menu »: messages.getAttachMenuBot
- Returns chat basic info on their IDs: messages.getChats
- Returns content of a web file, by proxying the request through telegram, see the webfile docs for more info: upload.getWebFile
- Returns current configuration, including data center configuration: help.getConfig
- Returns fetch the full list of custom emoji IDs » that cannot be used in channel emoji statuses »: account.getChannelRestrictedStatusEmojis
- Returns identifiers of pinned or always included chats from a chat folder imported using a chat folder deep link », which are suggested to be left when the chat folder is deleted: chatlists.getLeaveChatlistSuggestions
- Returns info on data center nearest to the user: help.getNearestDc
- Returns information about the next messages of the specified type in the chat split by days: messages.getSearchResultsCalendar
- Returns information on update availability for the current application: help.getAppUpdate
- Returns installed attachment menu bot mini apps »: messages.getAttachMenuBots
- Returns list of chats with non-default notification settings: account.getNotifyExceptions
- Returns localized text of a text message with an invitation: help.getInviteText
- Returns sparse positions of messages of the specified type in the chat to be used for shared media scroll implementation: messages.getSearchResultsPositions
- Returns the conversation history with one interlocutor / within a chat: messages.getHistory
- Returns the current saved dialog list » or monoforum topic list »: messages.getSavedDialogs
- Returns the current user dialog list: messages.getDialogs
- Returns the current user's contact list: contacts.getContacts
- Returns the list of blocked users: contacts.getBlocked
- Returns the list of messages by their IDs: messages.getMessages
- Returns the list of user photos: photos.getUserPhotos
- Returns the lists of boost that were applied to a channel/supergroup by a specific user (admins only): premium.getUserBoosts
- Returns the session name: getSessionName
- Returns the support user for the "ask a question" feature: help.getSupport
- Returns timezone information that may be used elsewhere in the API, such as to set Telegram Business opening hours »: help.getTimezonesList
- Returns users found by username substring: contacts.search
- Returns whether the current user is a bot: isSelfBot
- Returns whether the current user is a premium user, cached: isPremium
- Returns whether the current user is a user: isSelfUser
- Reupload telegram file: uploadFromTgfile
- Save a message draft associated to a chat: messages.saveDraft
- Save a prepared inline message, to be
Truncated — view the full README on GitHub.
Similar repos
Languages
PHP
99.7%
Async PHP client API for the telegram MTProto protocol
3,512
stars
5,557
commits
PHP
primary language
Sep 6, 2026
updated
amphp
async
bot
calls
easy
hacktoberfest
inline-bots
madelineproto
mtproto
mtproto-api
php
proxy
secret-chats
stickers
tdlib
tdlib-php
telegram
telegram-api
voip
README
MadelineProto, a PHP MTProto telegram client
Created by Daniil Gentili
#StandWithUkraine 🇺🇦
Do join the official channel, @MadelineProto and the support groups!
What's this?
This library can be used to easily interact with Telegram without the bot API, just like the official apps.
It can login with a phone number (MTProto API), or with a bot token (MTProto API, no bot API involved!).
Getting started (now fully async!)
<?php
// PHP 8.2+ is required.
if (!file_exists('madeline.php')) {
copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';
$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();
$me = $MadelineProto->getSelf();
$MadelineProto->logger($me);
if (!$me['bot']) {
$MadelineProto->messages->sendMessage(peer: '@stickeroptimizerbot', message: "/start");
$MadelineProto->channels->joinChannel(channel: '@MadelineProto');
try {
$MadelineProto->messages->importChatInvite(hash: 'https://t.me/+Por5orOjwgccnt2w');
} catch (\danog\MadelineProto\RPCErrorException $e) {
$MadelineProto->logger($e);
}
}
$MadelineProto->echo('OK, done!');
Try running this code in a browser or in a console!
Tip: if you receive an error (or nothing), send us the error message and the MadelineProto.log file that was created in the same directory (if running from a browser).
Made with MadelineProto
The following open source projects were created using MadelineProto: you can directly install them, or explore the source code as direct examples on how to use MadelineProto's many features!
- magnaluna webradio - Multifeatured Telegram VoIP webradio
simpleBot.php- Extremely basic exampletgstories_dl_bot.php- Source code of @tgstories_dl_bot - Bot to download any Telegram Story!downloadRenameBot.php- Download files by URL and rename Telegram files using this async parallelized bot!secret_bot.php- Secret chat bot!pipesbot.php- Creating inline bots and using other inline bots via a userbot!bot.php- Examples for how to use filters, updates, get download links for any file, Telegram Stories and much more!
Want to add your own open-source project to this list? Click here!
Some of MadelineProto's core components are also available as separate, standalone libraries:
- danog/async-orm - Async ORM based on AMPHP v3 and fibers.
- danog/telegram-entities - A library to work with Telegram UTF-16 styled text entities.
- danog/tg-file-decoder - A library to work with Telegram bot API file IDs.
- danog/tg-dialog-id - A library to work with Telegram bot API dialog IDs.
- danog/loop - Loop/actor model abstraction for AMPHP.
- danog/better-prometheus - A better Prometheus library for PHP applications.
- danog/ipc - Async IPC component for AMPHP.
- danog/dns-over-https - Async DNS-over-HTTPS resolution for AMPHP.
Documentation
- Creating a client - This page explains how to create a MadelineProto instance.
- Login - There are many ways you can login with MadelineProto.
- Features - MadelineProto can do everything official clients can do, and more!
- Requirements - MadelineProto requires the mbstring, xml, json, fileinfo, gmp, openssl, iconv, gd extensions to function properly.
- MadelineProto on Docker - MadelineProto offers an official MadelineProto docker image for the linux/amd64, linux/arm64 and linux/riscv64 platforms @ hub.madelineproto.xyz/danog/madelineproto.
- Metrics - MadelineProto can expose many useful metrics, that can be visualized using the official MadelineProto Grafana dashboard.
- Installation - There are various ways to install MadelineProto:
- Broadcasting messages to all users - MadelineProto can be used to broadcast messages to all users, chats and channels of a bot or userbot.
- Handling updates (new messages & other events) - Update handling can be done in different ways:
- Async Event driven
- Webhook (for HTTP APIs)
- getUpdates (only for Javascript APIs)
- Noop (default)
- danog\MadelineProto\Broadcast\Progress » - Broadcast progress.
- danog\MadelineProto\EventHandler\AbstractMessage » - Represents an incoming or outgoing message.
- danog\MadelineProto\EventHandler\AbstractPrivateMessage » - Represents a private or secret chat message.
- danog\MadelineProto\EventHandler\AbstractStory » - Represents a Telegram Story.
- danog\MadelineProto\EventHandler\BotCommands » - The command set of a certain bot in a certain chat has changed.
- danog\MadelineProto\EventHandler\CallbackQuery » - Represents a query sent by the user by clicking on a button.
- danog\MadelineProto\EventHandler\Channel\ChannelParticipant » - A participant has left, joined, was banned or admin'd in a channel or supergroup.
- danog\MadelineProto\EventHandler\Channel\MessageForwards » - Indicates that the forward counter of a message in a channel has changed.
- danog\MadelineProto\EventHandler\Channel\MessageViewsChanged » - Indicates that the view counter of a message in a channel has changed.
- danog\MadelineProto\EventHandler\Channel\UpdateChannel » - A new channel is available, or info about an existing channel was changed.
- danog\MadelineProto\EventHandler\ChatInviteRequester » - Indicates someone has requested to join a chat or channel.
- danog\MadelineProto\EventHandler\ChatInviteRequester\BotChatInviteRequest » - Indicates someone has requested to join a chat or channel (bots only).
- danog\MadelineProto\EventHandler\ChatInviteRequester\PendingJoinRequests » - Someone has requested to join a chat or channel.
- danog\MadelineProto\EventHandler\Delete » - Indicates that some messages were deleted.
- danog\MadelineProto\EventHandler\Delete\DeleteChannelMessages » - Some messages in a supergroup/channel were deleted.
- danog\MadelineProto\EventHandler\Delete\DeleteMessages » - Some messages were deleted in a private chat or simple group.
- danog\MadelineProto\EventHandler\Delete\DeleteScheduledMessages » - Some scheduled messages were deleted from the schedule queue of a chat.
- danog\MadelineProto\EventHandler\InlineQuery » - An incoming inline query.
- danog\MadelineProto\EventHandler\Message » - Represents an incoming or outgoing message.
- danog\MadelineProto\EventHandler\Message\ChannelMessage » - Represents an incoming or outgoing channel message.
- danog\MadelineProto\EventHandler\Message\CommentReply » - Represents a reply to one of our messages in a channel comment group that we're not a member of (i.e. received via
@replies). - danog\MadelineProto\EventHandler\Message\GroupMessage » - Represents an incoming or outgoing group message.
- danog\MadelineProto\EventHandler\Message\PrivateMessage » - Represents an incoming or outgoing private message.
- danog\MadelineProto\EventHandler\Message\SecretMessage » - Represents New encrypted message.
- danog\MadelineProto\EventHandler\Message\ServiceMessage » - Represents info about a service message.
- danog\MadelineProto\EventHandler\Message\ServiceMessage » - Represents info about a service message.
- danog\MadelineProto\EventHandler\Message\Service\DialogBotAllowed » - We have given the bot permission to send us direct messages.
- danog\MadelineProto\EventHandler\Message\Service\DialogChannelCreated » - The channel was created.
- danog\MadelineProto\EventHandler\Message\Service\DialogChannelMigrateFrom » - Indicates the channel was migrated from the specified chat.
- danog\MadelineProto\EventHandler\Message\Service\DialogChatJoinedByLink » - A user joined the chat via an invite link.
- danog\MadelineProto\EventHandler\Message\Service\DialogChatMigrateTo » - Indicates the chat was migrated to the specified supergroup.
- danog\MadelineProto\EventHandler\Message\Service\DialogContactSignUp » - A contact just signed up to telegram.
- danog\MadelineProto\EventHandler\Message\Service\DialogCreated » - A chat or channel was created.
- danog\MadelineProto\EventHandler\Message\Service\DialogDeleteMessages » - Deleted messages.
- danog\MadelineProto\EventHandler\Message\Service\DialogGameScore » - Someone scored in a game.
- danog\MadelineProto\EventHandler\Message\Service\DialogGeoProximityReached » - A user of the chat is now in proximity of another user.
- danog\MadelineProto\EventHandler\Message\Service\DialogGiftPremium » - Info about a gifted Telegram Premium subscription.
- danog\MadelineProto\EventHandler\Message\Service\DialogGiftStars » - Info about a gifted Telegram Stars.
- danog\MadelineProto\EventHandler\Message\Service\DialogGroupCall » - Represents a service message about a group call.
- danog\MadelineProto\EventHandler\Message\Service\DialogGroupCall\GroupCall » - The group call has started or ended.
- danog\MadelineProto\EventHandler\Message\Service\DialogGroupCall\GroupCallInvited » - A set of users was invited to the group call.
- danog\MadelineProto\EventHandler\Message\Service\DialogGroupCall\GroupCallScheduled » - A group call was scheduled.
- danog\MadelineProto\EventHandler\Message\Service\DialogHistoryCleared » - Chat history was cleared.
- danog\MadelineProto\EventHandler\Message\Service\DialogMemberJoinedByRequest » - A user was accepted into the group by an admin.
- danog\MadelineProto\EventHandler\Message\Service\DialogMemberLeft » - A member left the chat or channel.
- danog\MadelineProto\EventHandler\Message\Service\DialogMembersJoined » - Some members joined the chat or channel.
- danog\MadelineProto\EventHandler\Message\Service\DialogMessagePinned » - A message was pinned in a chat.
- danog\MadelineProto\EventHandler\Message\Service\DialogNoForwardRequest » - Emitted only in private chats if the other side requested to disable content protection ».
- danog\MadelineProto\EventHandler\Message\Service\DialogNoForwardToggle » - Emitted only in private chats when enabling or disabling content protection ».
- danog\MadelineProto\EventHandler\Message\Service\DialogPaymentSent » - A payment was sent.
- danog\MadelineProto\EventHandler\Message\Service\DialogPaymentSentMe » - A user just sent a payment to me (a bot).
- danog\MadelineProto\EventHandler\Message\Service\DialogPeerRequested » - Contains info about a peer that the user shared with the bot after clicking on a keyboardButtonRequestPeer button.
- danog\MadelineProto\EventHandler\Message\Service\DialogPhoneCall » - A phone call.
- danog\MadelineProto\EventHandler\Message\Service\DialogPhotoChanged » - The photo of the dialog was changed or deleted.
- danog\MadelineProto\EventHandler\Message\Service\DialogReadMessages » - Messages marked as read.
- danog\MadelineProto\EventHandler\Message\Service\DialogScreenshotTaken » - A screenshot of the chat was taken.
- danog\MadelineProto\EventHandler\Message\Service\DialogSetChatTheme » - The chat theme was changed.
- danog\MadelineProto\EventHandler\Message\Service\DialogSetChatWallPaper » - The wallpaper of the current chat was changed.
- danog\MadelineProto\EventHandler\Message\Service\DialogSetTTL » - The Time-To-Live of messages in this chat was changed.
- danog\MadelineProto\EventHandler\Message\Service\DialogStarGift » - Info about a Star gifted.
- danog\MadelineProto\EventHandler\Message\Service\DialogSuggestProfilePhoto » - A new profile picture was suggested using photos.uploadContactProfilePhoto.
- danog\MadelineProto\EventHandler\Message\Service\DialogTitleChanged » - The title of a channel or group has changed.
- danog\MadelineProto\EventHandler\Message\Service\DialogTopicCreated » - A forum topic was created.
- danog\MadelineProto\EventHandler\Message\Service\DialogTopicEdited » - Forum topic information was edited.
- danog\MadelineProto\EventHandler\Message\Service\DialogWebView » - Data from an opened reply keyboard bot web app was relayed to the bot that owns it (user & bot side service message).
- danog\MadelineProto\EventHandler\Payments\Payment » - This object contains information about an incoming pre-checkout query.
- danog\MadelineProto\EventHandler\Pinned » - Indicates that some messages were pinned/unpinned.
- danog\MadelineProto\EventHandler\Pinned\PinnedChannelMessages » - Represents messages that were pinned/unpinned in a channel.
- danog\MadelineProto\EventHandler\Pinned\PinnedGroupMessages » - Represents messages that were pinned/unpinned in a chat/supergroup.
- danog\MadelineProto\EventHandler\Pinned\PinnedPrivateMessages » - Some messages were pinned in a private chat.
- danog\MadelineProto\EventHandler\Privacy » - Indicates some privacy rules for a user or set of users.
- danog\MadelineProto\EventHandler\Query\ButtonQuery » - Represents a query sent by the user by clicking on a button.
- danog\MadelineProto\EventHandler\Query\ChatButtonQuery » - Represents a query sent by the user by clicking on a button in a chat.
- danog\MadelineProto\EventHandler\Query\ChatGameQuery » - Represents a query sent by the user by clicking on a "Play game" button in a chat.
- danog\MadelineProto\EventHandler\Query\GameQuery » - Represents a query sent by the user by clicking on a "Play game" button.
- danog\MadelineProto\EventHandler\Query\InlineButtonQuery » - Represents a query sent by the user by clicking on a button in an inline message.
- danog\MadelineProto\EventHandler\Query\InlineGameQuery » - Represents a query sent by the user by clicking on a "Play game" button in an inline message.
- danog\MadelineProto\EventHandler\Story\Story » - Represents a Telegram story.
- danog\MadelineProto\EventHandler\Story\StoryDeleted » - Represents a deleted story.
- danog\MadelineProto\EventHandler\Story\StoryReaction » - Represents a reaction to a story.
- danog\MadelineProto\EventHandler\Typing » - A user is typing.
- danog\MadelineProto\EventHandler\Typing\ChatUserTyping » - The user is preparing a message in a group; typing, recording, uploading, etc. This update is valid for 6 seconds. If no further updates of this kind are received after 6 seconds, it should be considered that the user stopped doing whatever they were doing.
- danog\MadelineProto\EventHandler\Typing\SecretUserTyping » - The user is preparing a message in a secret chat; typing, recording, uploading, etc. This update is valid for 6 seconds. If no further updates of this kind are received after 6 seconds, it should be considered that the user stopped doing whatever they were doing.
- danog\MadelineProto\EventHandler\Typing\SupergroupUserTyping » - A user is typing in a supergroup.
- danog\MadelineProto\EventHandler\Typing\UserTyping » - The user is preparing a message; typing, recording, uploading, etc. This update is valid for 6 seconds. If no further updates of this kind are received after 6 seconds, it should be considered that the user stopped doing whatever they were doing.
- danog\MadelineProto\EventHandler\User\Blocked » - A peer was blocked.
- danog\MadelineProto\EventHandler\User\BotStopped » - A bot was stopped or re-started.
- danog\MadelineProto\EventHandler\User\Phone » - A user’s phone number was changed.
- danog\MadelineProto\EventHandler\User\Status » - Contains a status update.
- danog\MadelineProto\EventHandler\User\Status\Emoji » - The emoji status of a certain user has changed or was removed.
- danog\MadelineProto\EventHandler\User\Status\EmptyStatus » - User status has not been set yet.
- danog\MadelineProto\EventHandler\User\Status\LastMonth » - Online status: last seen last month.
- danog\MadelineProto\EventHandler\User\Status\LastWeek » - Online status: last seen last week.
- danog\MadelineProto\EventHandler\User\Status\Offline » - The user’s offline status.
- danog\MadelineProto\EventHandler\User\Status\Online » - Online status of the user.
- danog\MadelineProto\EventHandler\User\Status\Recently » - Online status: last seen recently.
- danog\MadelineProto\EventHandler\User\Username » - Changes were made to the user’s first name, last name or username.
- danog\MadelineProto\VoIP » - This update represents a VoIP Telegram call.
- Filters - MadelineProto offers a very simple and intuitive message filtering system, based on PHP's type system and attributes.
- Plugins - MadelineProto offers a native plugin system, based on event handlers!
- Database - MadelineProto optionally can keep some of its internal data in a database, such as mysql, mariadb, postgres or redis (you can also add your own!), reducing RAM usage.
- Settings - MadelineProto has lots of settings that can be used to modify the behaviour of the library.
- AppInfo: App information.
- Auth: Cryptography settings.
- Connection: Connection settings.
- Files: File management settings.
- Logger: Logger settings.
- Peer: Peer database settings.
- Pwr: PWRTelegram settings.
- RPC: RPC settings.
- SecretChats: Secret chat settings.
- Serialization: Serialization settings.
- TLSchema: TL schema settings.
- Templates: Web and CLI template settings for login.
- VoIP: VoIP settings.
- Database\Memory: Memory backend settings.
- Database\Mysql: MySQL backend settings.
- Database\Postgres: Postgres backend settings.
- Database\Redis: Redis backend settings.
- Getting info about the current user - Here's how you can fetch info about the currently logged in user
- Exceptions - MadelineProto can throw lots of different exceptions.
- Avoiding FLOOD_WAITs - If you make too many requests to telegram, you might get FLOOD_WAITed for a while. To avoid these flood waits, you must calculate the flood wait rate.
- Logging - MadelineProto provides a unified class for logging messages to the logging destination defined in settings.
- Telegram VoIP phone calls - MadelineProto provides an easy wrapper to work with phone calls.
- Uploading and downloading files - MadelineProto provides fully parallelized wrapper methods to upload and download files that support bot API file ids, direct upload by URL and file renaming.
- Getting info about chats - There are various methods that can be used to fetch info about chats, based on bot API id, Peer, User, Chat objects.
- Getting all chats (dialogs) - There are two ways to get a list of all chats, depending if you logged in as a user, or as a bot.
- Inline buttons - You can easily click inline buttons using MadelineProto, just access the correct button:
- Secret chats - MadelineProto provides wrappers to work with secret chats.
- Using a proxy - You can use a proxy with MadelineProto.
- Async - MadelineProto now features async, for incredible speed improvements, and parallel processing, all powered by amphp.
- FAQ - Here's a list of common MadelineProto questions and answers.
- Upgrading from MadelineProto v7 to v8 - MadelineProto v8 is a major MadelineProto update, that removes a large number of long-deprecated APIs: I've created this upgrade checklist, to simplify the upgrade process.
- Using methods - There are simplifications for many, if not all of, these methods.
- Named arguments
- Peers
- Files
- Secret chats
- Entities (Markdown & HTML)
- reply_markup (keyboards & inline keyboards)
- bot API objects
- No result
- Multiple method calls
- Cancellation
- FULL API Documentation with descriptions
- Login
- Change 2FA password: update2FA
- Get all chats, broadcast a message to all chats: getDialogIds, getDialogs, getFullDialogs
- Get the full participant list of a channel/group/supergroup: getPwrChat
- Get full info about a user/chat/supergroup/channel: getFullInfo
- Get info about a user/chat/supergroup/channel: getInfo
- Get the ID of a user/chat/supergroup/channel/update: getID
- Get info about the currently logged-in user: getSelf
- Upload or download files up to 4 GB: uploadFrom*, downloadTo*
- Make a phone call and play a song
- Create a secret chat bot
- A collectible gift we own » can be put up for sale on the gift marketplace » with this method, see here » for more info: payments.updateStarGiftPrice
- Abort a pending 2FA password reset, see here for more info »: account.declinePasswordReset
- Accept QR code login token, logging in the app that generated it: auth.acceptLoginToken
- Accept call: acceptCall
- Accept secret chat: acceptSecretChat
- Accept the new terms of service: help.acceptTermsOfService
- Activate or deactivate a Telegram Star subscription »: payments.changeStarsSubscription
- Activate or deactivate a purchased fragment.com username associated to a bot we own: bots.toggleUsername
- Activate or deactivate a purchased fragment.com username associated to a supergroup or channel we own: channels.toggleUsername
- Activate or deactivate a purchased fragment.com username associated to the currently logged-in user: account.toggleUsername
- Activates stories stealth mode, see here » for more info: stories.activateStealthMode
- Add GIF to saved gifs list: messages.saveGif
- Add a main mini app preview, see here » for more info: bots.addPreviewMedia
- Add a sticker to a stickerset. The sticker set must have been created by the current user/bot: stickers.addStickerToSet
- Add an existing telegram user as contact: contacts.addContact
- Add or remove gifts from a star gift collection », or rename the collection: payments.updateStarGiftCollection
- Add/remove sticker from recent stickers list: messages.saveRecentSticker
- Adds a peer to a blocklist, see here » for more info: contacts.block
- Adds a user to a chat and sends a service message on it: messages.addChatUser
- Adds or removes a song from the current user's profile see here » for more info on the music tab of the profile page: account.saveMusic
- 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: channels.setBoostsToUnblockRestrictions
- Allow a user to send us messages without paying if paid messages » are enabled: account.toggleNoPaidMessagesException
- Allow or prevent a bot from changing our emoji status »: bots.toggleUserEmojiStatusPermission
- Allow the specified bot to send us messages: bots.allowSendMessage
- Answer an inline query, for bots only: messages.setInlineBotResults
- Answers a custom query; for bots only: bots.answerWebhookJSONQuery
- Appends one or more items to a todo list »: messages.appendTodoList
- Apply a Telegram Premium giftcode »: payments.applyGiftCode
- Apply changes to multiple stickersets: messages.toggleStickerSets
- Apply one or more boosts » to a peer: premium.applyBoost
- Approve or reject a suggested post »: messages.toggleSuggestedPostApproval
- Associate (or remove) a personal channel », that will be listed on our personal profile page »: account.updatePersonalChannel
- Associate a group to a channel as discussion group for that channel: channels.setDiscussionGroup
- Associate a stickerset to the supergroup: channels.setStickers
- Asynchronously lock a file: flock
- Asynchronously read line: readLine
- Asynchronously sleep: sleep
- Asynchronously write to stdout/browser: echo
- Ban/unban/kick a user in a supergroup/channel: channels.editBanned
- Base64URL encode: base64urlEncode
- 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.checkQuickReplyShortcut
- Bot owners only, fetch main mini app preview information, see here » for more info: bots.getPreviewInfo
- 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.: account.getBotBusinessConnection
- Broadcast a blockchain block to all members of a conference call, see here » for more info: phone.sendConferenceCallBroadcast
- Businesses » may advertise their location using this method, see here » for more info: account.updateBusinessLocation
- Can only be invoked by non-bot admins of a monoforum », obtains the original sender of a message sent by other monoforum admins to the monoforum, on behalf of the channel associated to the monoforum: channels.getMessageAuthor
- Can only be used by TSF members to obtain internal information: help.getUserInfo
- Cancel a bot subscription: payments.botCancelStarsSubscription
- Cancel a running broadcast: cancelBroadcast
- Cancel the code that was sent to verify an email to use as 2FA recovery method: account.cancelPasswordEmail
- Cancel the login verification code: auth.cancelCode
- 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: messages.setDefaultReaction
- Change group call settings: phone.toggleGroupCallSettings
- Change media autodownload settings: account.saveAutoDownloadSettings
- Change or remove the username of a supergroup/channel: channels.updateUsername
- Change privacy settings of current account: account.setPrivacy
- Change settings related to a session: account.changeAuthorizationSettings
- Change the chat theme of a certain chat, see here » for more info: messages.setChatTheme
- Change the default peer that should be used when sending messages, reactions, poll votes to a specific group: messages.saveDefaultSendAs
- Change the emoji status of a user (invoked by bots, see here » for more info on the full flow): bots.updateUserEmojiStatus
- Change the phone number of the current account: account.changePhone
- Change the photo of a channel/supergroup: channels.editPhoto
- Change the reaction notification settings »: account.setReactionsNotifySettings
- Change the set of message reactions » that can be used in a certain group, supergroup or channel: messages.setChatAvailableReactions
- Changes chat name and sends a service message on it: messages.editChatTitle
- Changes chat photo and sends a service message on it: messages.editChatPhoto
- 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.changeStickerPosition
- Changes the default value of the Time-To-Live setting, applied to all new chats: messages.setDefaultHistoryTTL
- Changes the main profile tab of a channel, see here » for more info: channels.setMainProfileTab
- Changes the main profile tab of the current user, see here » for more info: account.setMainProfileTab
- Changes the privacy of already sent paid reactions on a specific message: messages.togglePaidReactionPrivacy
- Changes username for the current user: account.updateUsername
- Check if a certain event handler plugin is installed: hasPlugin
- Check if a mini app can request the download of a specific file: called when handling web_app_request_file_download events »: bots.checkDownloadFileParams
- Check if a username is free and can be assigned to a channel/supergroup: channels.checkUsername
- Check if an event handler instance is present: hasEventHandler
- Check if has admins: hasAdmins
- Check if has report peers: hasReportPeers
- Check if is array or similar (traversable && countable && arrayAccess): isArrayOrAlike
- Check if peer is present in internal peer database: peerIsset
- Check if the 2FA recovery code sent using auth.requestPasswordRecovery is valid, before passing it to auth.recoverPassword: auth.checkRecoveryPassword
- Check if the passed songs are still pinned to the user's profile, or refresh the file references of songs pinned on a user's profile see here » for more info: users.getSavedMusicByID
- Check if the specified gift » can be sent: payments.checkCanSendGift
- Check if the specified global post search » requires payment: channels.checkSearchPostsFlood
- Check if the specified peer is a bot: isBot
- Check if the specified peer is a forum: isForum
- Check if we can process SMS jobs (official clients only): smsjobs.isEligibleToJoin
- Check the validity of a chat invite link and get basic info about it: messages.checkChatInvite
- Check whether chat history exported from another chat app can be imported into a specific Telegram chat, click here for more info »: messages.checkHistoryImportPeer
- Check whether secret chat exists: hasSecretChat
- Check whether the given short name is available: stickers.checkShortName
- Check whether the group call Server Forwarding Unit is currently receiving the streams with the specified WebRTC source IDs.: phone.checkGroupCall
- Check whether the specified bot can send us messages: bots.canSendMessage
- Check whether we can post stories as the specified peer: stories.canSendStory
- Check whether we can write to the specified users, used to implement bulk checks for Premium-only messages » and paid messages »: users.getRequirementsToContact
- Checks whether a purchase is possible. Must be called before in-store purchase, official apps only: payments.canPurchaseStore
- Clear all drafts: messages.clearAllDrafts
- Clear all peer-specific autosave settings: account.deleteAutoSaveExceptions
- Clear bot commands for the specified bot scope and language code: bots.resetBotCommands
- Clear recent stickers: messages.clearRecentStickers
- Clear recently used message reactions: messages.clearRecentReactions
- Clear saved payment information: payments.clearSavedInfo
- Clears list of recently used emoji statuses: account.clearRecentEmojiStatuses
- Close connection with client, connected via web: closeConnection
- Complet user login using login code: completePhoneLogin
- Complete 2FA login: complete2faLogin
- Complete signup to Telegram: completeSignup
- Complete the history import process, importing all messages into the chat.: messages.startHistoryImport
- Completely delete a quick reply shortcut.: messages.deleteQuickReplyShortcut
- Confirm a phone number to cancel account deletion, for more info click here »: account.confirmPhone
- Confirms receipt of messages by a client, cancels PUSH-notification sending: messages.receivedMessages
- Connect a business bot » to the current account, or to change the current connection settings: account.updateConnectedBot
- Convert MTProto parameters to bot API parameters: MTProtoToBotAPI
- Convert TD parameters to tdcli: tdToTdcli
- Convert TD to MTProto parameters: tdToMTProto
- Convert a collectible gift » to an NFT on the TON blockchain: payments.getStarGiftWithdrawalUrl
- Convert a message and a set of entities to HTML: entitiesToHtml
- 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: payments.convertStarGift
- Convert a supergroup to a gigagroup, when requested by channel suggestions: channels.convertToGigagroup
- Convert bot API parameters to MTProto parameters: botAPIToMTProto
- Convert double to binary version: packDouble
- Convert integer to base256 long: packSignedLong
- Convert integer to base256 signed int: packSignedInt
- Convert tdcli parameters to tdcli: tdcliToTd
- Convert to camelCase: toCamelCase
- Convert to snake_case: toSnakeCase
- Convert value to unsigned base256 int: packUnsignedInt
- Converts a string into an async amphp stream: stringToStream
- Create a business chat deep link »: account.createBusinessChatLink
- Create a group call or livestream: phone.createGroupCall
- Create a star gift collection »: payments.createStarGiftCollection
- Create a stickerset: stickers.createStickerSet
- Create a supergroup/channel: channels.createChannel
- Create a theme: account.createTheme
- Create and optionally join a new conference call: phone.createConferenceCall
- Create and upload a new wallpaper: account.uploadWallPaper
- Create array: arr
- Create, edit or delete the affiliate program of a bot we own: bots.updateStarRefProgram
- Creates a new chat: messages.createChat
- Creates a story album: stories.createAlbum
- Creates and returns a prometheus counter: getPromCounter
- Creates and returns a prometheus gauge: getPromGauge
- Creates and returns a prometheus histogram: getPromHistogram
- Creates and returns a prometheus summary: getPromSummary
- Declines a conference call invite: phone.declineConferenceCallInvite
- Delete a business chat deep link »: account.deleteBusinessChatLink
- Delete a channel/supergroup: channels.deleteChannel
- Delete a chat invite: messages.deleteExportedChatInvite
- Delete a chat: messages.deleteChat
- Delete a fact-check from a message: messages.deleteFactCheck
- Delete a folder imported using a chat folder deep link »: chatlists.leaveChatlist
- Delete a main mini app preview, see here » for more info: bots.deletePreviewMedia
- Delete a previously created chat folder deep link »: chatlists.deleteExportedInvite
- Delete a star gift collection »: payments.deleteStarGiftCollection
- Delete a story album: stories.deleteAlbum
- Delete all installed wallpapers, reverting to the default wallpaper set: account.resetWallPapers
- Delete all messages sent by a specific participant of a given supergroup: channels.deleteParticipantHistory
- Delete all revoked chat invites: messages.deleteRevokedExportedChatInvites
- Delete all temporary authorization keys except for the ones specified: auth.dropTempAuthKeys
- Delete contacts by phone number: contacts.deleteByPhones
- Delete messages in a channel/supergroup: channels.deleteMessages
- Delete one or more messages from a quick reply shortcut. This will also emit an updateDeleteQuickReplyMessages update: messages.deleteQuickReplyMessages
- Delete scheduled messages: messages.deleteScheduledMessages
- Delete stored Telegram Passport documents, for more info see the passport docs »: account.deleteSecureValue
- Delete the entire phone call history: messages.deletePhoneCallHistory
- Delete the history of a supergroup: channels.deleteHistory
- Delete the user's account from the telegram servers: account.deleteAccount
- Deletes a device by its token, stops sending PUSH-notifications to it: account.unregisterDevice
- Deletes a peer from a blocklist, see here » for more info: contacts.unblock
- Deletes a stickerset we created: stickers.deleteStickerSet
- Deletes a user from a chat and sends a service message on it: messages.deleteChatUser
- Deletes communication history: messages.deleteHistory
- Deletes messages by their identifiers: messages.deleteMessages
- Deletes messages from a monoforum topic », or deletes messages forwarded from a specific peer to saved messages »: messages.deleteSavedHistory
- Deletes profile photos. The method returns a list of successfully deleted photo IDs: photos.deletePhotos
- Deletes several contacts from the list: contacts.deleteContacts
- Deletes some posted stories: stories.deleteStories
- Disable SMS jobs (official clients only): smsjobs.leave
- Disable ads on the specified channel, for all users: channels.restrictSponsoredMessages
- Disable all purchased usernames of a supergroup or channel: channels.deactivateAllUsernames
- Disable or re-enable Telegram ads for the current Premium account: account.toggleSponsoredMessages
- Discard call: discardCall
- Discard secret chat: discardSecretChat
- Dismiss a suggestion, see here for more info »: help.dismissSuggestion
- Dismiss new pending peers recently added to a chat folder deep link »: chatlists.hideChatlistUpdates
- Dismiss or approve a chat join request related to a specific chat or channel: messages.hideChatJoinRequest
- Dismiss or approve all join requests related to a specific chat or channel: messages.hideAllChatJoinRequests
- Display or remove a received gift » from our profile: payments.saveStarGift
- Download file to amphp/http-server response: downloadToResponse
- Download file to an amphp stream, returning it: downloadToReturnedStream
- Download file to browser: downloadToBrowser
- Download file to callable: downloadToCallable
- Download file to directory: downloadToDir
- Download file to stream: downloadToStream
- Download file: downloadToFile
- Downloads a file to the browser using the specified session file: downloadServer
- Edit a chat folder deep link »: chatlists.editExportedInvite
- Edit a created business chat deep link »: account.editBusinessChatLink
- Edit a main mini app preview, see here » for more info: bots.editPreviewMedia
- Edit an exported chat invite: messages.editExportedChatInvite
- Edit an inline bot message: messages.editInlineBotMessage
- Edit an uploaded story: stories.editStory
- Edit information about a given group call participant: phone.editGroupCallParticipant
- Edit location of geogroup, see here » for more info on geogroups: channels.editLocation
- Edit message: messages.editMessage
- Edit peers in peer folder: folders.editPeerFolders
- Edit the close friends list, see here » for more info: contacts.editCloseFriends
- Edit the default banned rights of a channel/supergroup/group: messages.editChatDefaultBannedRights
- Edit the description of a group/supergroup/channel: messages.editChatAbout
- Edit the name of a channel/supergroup: channels.editTitle
- Edit the title of a group call or livestream: phone.editGroupCallTitle
- Edit/create a fact-check on a message: messages.editFactCheck
- Edits notification settings from a given user/group, from all users/all groups: account.updateNotifySettings
- Enable SMS jobs (official clients only): smsjobs.join
- Enable or disable content protection on a channel or chat: messages.toggleNoForwards
- Enable or disable folder tags »: messages.toggleDialogFilterTags
- Enable or disable forum functionality in a supergroup: channels.toggleForum
- Enable or disable paid messages » in this supergroup or monoforum: channels.updatePaidMessagesPrice
- Enable or disable the native antispam system: channels.toggleAntiSpam
- Enable or disable web bot attachment menu »: messages.toggleBotInAttachMenu
- Enable/disable message signatures in channels: channels.toggleSignatures
- Enable/disable top peers: contacts.toggleTopPeers
- Enables or disables the reception of notifications every time a gift » is received by the specified channel, can only be invoked by admins with post_messages admin rights: payments.toggleChatStarGiftNotifications
- Escape string for MadelineProto's HTML entity converter: htmlEscape
- Escape string for URL: markdownUrlEscape
- Escape string for markdown code section: markdownCodeEscape
- Escape string for markdown codeblock: markdownCodeblockEscape
- Escape string for markdown: markdownEscape
- Executes a custom broadcast action with all peers (users, chats, channels) of the bot: broadcastCustom
- Export a folder », creating a chat folder deep link »: chatlists.exportChatlistInvite
- Export an invite link for a chat: messages.exportChatInvite
- Export authorization: exportAuthorization
- Extract Update constructors from an Updates constructor: extractUpdates
- Extract a message ID from an Updates constructor: extractMessageId
- Extract a message constructor from an Updates constructor: extractMessage
- Extract an update message constructor from an Updates constructor: extractMessageUpdate
- Extract file info from bot API message: extractBotAPIFile
- Fetch (a subset or all) messages in a quick reply shortcut »: messages.getQuickReplyMessages
- Fetch Telegram Stars transactions: payments.getStarsTransactions
- Fetch a default recommended list of saved message tag reactions: messages.getDefaultTagReactions
- Fetch a list of star giveaway options »: payments.getStarsGiveawayOptions
- Fetch all affiliations we have created for a certain peer: payments.getConnectedStarRefBots
- Fetch all stickersets » owned by the current user: messages.getMyStickers
- 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: contacts.getBirthdays
- Fetch basic info about all existing quick reply shortcuts: messages.getQuickReplies
- Fetch custom emoji stickers »: messages.getCustomEmojiDocuments
- Fetch info about a specific bot affiliation »: payments.getConnectedStarRefBot
- Fetch info about specific gifts owned by a peer we control: payments.getSavedStarGift
- Fetch information about a fragment collectible, see here » for more info on the full flow: fragment.getCollectibleInfo
- Fetch main mini app previews, see here » for more info: bots.getPreviewMedias
- Fetch new chats associated with an imported chat folder deep link ». Must be invoked at most every chatlist_update_period seconds (as per the related client configuration parameter »): chatlists.getChatlistUpdates
- Fetch one or more factchecks, see here » for the full flow: messages.getFactCheck
- Fetch popular Main Mini Apps, to be used in the apps tab of global search »: bots.getPopularAppBots
- Fetch saved messages » forwarded from a specific peer, or fetch messages from a monoforum topic »: messages.getSavedHistory
- Fetch saved notification sounds: account.getSavedRingtones
- Fetch the List of active (or active and hidden) stories, see here » for more info on watching stories: stories.getAllStories
- Fetch the blocks of a conference blockchain »: phone.getGroupCallChainBlocks
- Fetch the full active story list of a specific peer: stories.getPeerStories
- Fetch the full list of gifts owned by a peer: payments.getSavedStarGifts
- Fetch the full list of only the IDs of songs currently added to the profile, see here » for more info: account.getSavedMusicIds
- Fetch the full list of saved message tags created by the user: messages.getSavedReactionTags
- Fetch the full list of usable animated message effects »: messages.getAvailableEffects
- Fetch the stories pinned on a peer's profile: stories.getPinnedStories
- Fetch the story archive » of a peer we control: stories.getStoriesArchive
- Fetch updated information about paid media, see here » for the full flow: messages.getExtendedMedia
- Fetches all star gift collections » of a peer: payments.getStarGiftCollections
- Fetches an updatePaidReactionPrivacy update with the current default paid reaction privacy, see here » for more info: messages.getPaidReactionPrivacy
- Find out if a media message's caption can be edited: messages.getMessageEditData
- Finish an SMS job (official clients only): smsjobs.finishJob
- Fork a new green thread and execute the passed function in the background: callFork
- Forwards a list of messages to all peers (users, chats, channels) of the bot: broadcastForwardMessages
- Forwards messages by their IDs: messages.forwardMessages
- Generate MTProto vector hash: genVectorHash
- Generate a login token, for login via QR code.: auth.exportLoginToken
- Generate a story deep link for a specific story: stories.exportStoryLink
- Generate an invoice deep link: payments.exportInvoice
- Generates a temporary profile link for the currently logged-in user: contacts.exportContactToken
- Get PSR logger: getPsrLogger
- 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): phone.getGroupCallStreamRtmpUrl
- Get SMS jobs status (official clients only): smsjobs.getStatus
- Get TL namespaces: getMethodNamespaces
- Get TL serializer: getTL
- Get Telegram Premium promotion information: help.getPremiumPromo
- Get Telegram Star revenue statistics »: payments.getStarsRevenueStats
- Get Telegram UTF-8 length of string: mbStrlen
- Get a document by its SHA256 hash, mainly used for gifs: messages.getDocumentByHash
- Get a list of available gifts, see here » for more info: payments.getStarGifts
- Get a list of bots owned by the current user: bots.getAdminedBots
- Get a list of channels/supergroups we left, requires a takeout session, see here » for more info: channels.getLeftChannels
- Get a list of default suggested channel emoji statuses: account.getChannelDefaultEmojiStatuses
- Get a list of default suggested emoji statuses: account.getDefaultEmojiStatuses
- Get a list of peers that can be used to join a group call, presenting yourself as a specific user/channel: phone.getGroupCallJoinAs
- Get a list of sponsored messages for a peer, see here » for more info: messages.getSponsoredMessages
- Get a message to show to the user when starting the bot: getWebMessage
- Get a payment form: payments.getPaymentForm
- Get a set of suggested custom emoji stickers that can be used as group picture: account.getDefaultGroupPhotoEmojis
- Get a set of suggested custom emoji stickers that can be used as profile picture: account.getDefaultProfilePhotoEmojis
- Get a set of suggested custom emoji stickers that can be used in an accent color pattern: account.getDefaultBackgroundEmojis
- Get admin IDs (equal to all user report peers): getAdminIds
- Get all archived stickers: messages.getArchivedStickers
- Get all available chat themes »: account.getChatThemes
- Get all contacts, requires a takeout session, see here » for more info: contacts.getSaved
- Get all groups that can be used as discussion groups: channels.getGroupsForDiscussion
- Get all installed stickers: messages.getAllStickers
- Get all pending and running calls, indexed by user ID: getAllCalls
- Get all saved Telegram Passport documents, for more info see the passport docs »: account.getAllSecureValues
- Get an invite link for a group call or livestream: phone.exportGroupCallInvite
- Get and increase the view counter of a message sent or forwarded from a channel: messages.getMessagesViews
- Get app-specific configuration, see client configuration for more info on the result: help.getAppConfig
- Get async DNS client: getDNSClient
- Get async HTTP client: getHTTPClient
- Get authorization info: getAuthorization
- Get autosave settings: account.getAutoSaveSettings
- Get cached (or eventually re-fetch) server-side config: getConfig
- Get cached server-side config: getCachedConfig
- Get call state: getCallState
- Get changed emoji keywords »: messages.getEmojiKeywordsDifference
- Get channel statistics: stats.getBroadcastStats
- Get channel/supergroup messages: channels.getMessages
- 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.getAdminedPublicChannels
- Get chats in common with a user: messages.getCommonChats
- Get collectible gifts of a specific type currently on resale, see here » for more info: payments.getResaleStarGifts
- Get configuration for CDN file downloads: help.getCdnConfig
- Get contents of remote file asynchronously: fileGetContents
- Get count of online users in a chat: messages.getOnlines
- Get current number of memory-mapped regions, UNIX only: getMaps
- Get current password hint: getHint
- Get days to live of account: account.getAccountTTL
- Get dialog info of specified peers: messages.getPeerDialogs
- Get dialogs manually marked as unread: messages.getDialogUnreadMarks
- Get diffie-hellman configuration: getDhConfig
- 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.getDiscussionMessage
- Get download info of file: getDownloadInfo
- Get download link of media file: getDownloadLink
- Get event handler (or plugin instance): getEventHandler
- Get extension from file location: getExtensionFromLocation
- Get extension from mime type: getExtensionFromMime
- Get faved stickers: messages.getFavedStickers
- Get featured stickers: messages.getFeaturedStickers
- Get final element of array: end
- Get folders: messages.getDialogFilters
- Get full list of MTProto and API methods: getAllMethods
- Get global privacy settings: account.getGlobalPrivacySettings
- Get group call participants: phone.getGroupParticipants
- Get highscores of a game sent using an inline bot: messages.getInlineGameHighScores
- Get highscores of a game: messages.getGameHighScores
- Get inactive channels and supergroups: channels.getInactiveChannels
- Get info about RTMP streams in a group call or livestream.: phone.getGroupCallStreamChannels
- Get info about a certain wallpaper: account.getWallPaper
- Get info about a channel/supergroup participant: channels.getParticipant
- Get info about a chat invite: messages.getExportedChatInvite
- Get info about a credit card: payments.getBankCardData
- Get info about a group call: phone.getGroupCall
- Get info about a stickerset: messages.getStickerSet
- Get info about an SMS job (official clients only): smsjobs.getSmsJob
- Get info about an unsupported deep link, see here for more info »: help.getDeepLinkInfo
- Get info about chat invites generated by admins: messages.getAdminsWithInvites
- Get info about file: getFileInfo
- Get info about multiple wallpapers: account.getMultiWallPapers
- Get info about the chat invites of a specific chat: messages.getExportedChatInvites
- Get info about the logged-in user, not cached: fullGetSelf
- Get info about the users that joined the chat using a specific chat invite: messages.getChatInviteImporters
- Get information about a language in a localization pack: langpack.getLanguage
- Get information about all languages in a localization pack: langpack.getLanguages
- Get information about the value of a collectible gift »: payments.getUniqueStarGiftValueInfo
- Get installed mask stickers: messages.getMaskStickers
- Get installed themes: account.getThemes
- Get instant view page: messages.getWebPage
- Get link and embed info of a message in a channel/supergroup: channels.exportMessageLink
- Get live location history of a certain user: messages.getRecentLocations
- Get localization pack strings: langpack.getLangPack
- Get localized emoji keywords »: messages.getEmojiKeywords
- Get localized name of the telegram support user: help.getSupportName
- Get localized name, about text and description of a bot (or of the current account, if called by a bot): bots.getBotInfo
- Get logged-in sessions: account.getAuthorizations
- Get logger: getLogger
- Get maximum number of memory-mapped regions, UNIX only: getMaxMaps
- Get media autodownload settings: account.getAutoDownloadSettings
- Get memory profile with memprof: getMemoryProfile
- Get message ranges for saving the user's chat history: messages.getSplitRanges
- Get message reaction list, along with the sender of each reaction: messages.getMessageReactionsList
- Get message reactions »: messages.getMessagesReactions
- Get message statistics: stats.getMessageStats
- Get messages in a reply thread: messages.getReplies
- Get mime type from buffer: getMimeFromBuffer
- Get mime type from file extension: getMimeFromExtension
- Get mime type of file: getMimeFromFile
- Get more info about a Seamless Telegram Login authorization request, for more info click here »: messages.requestUrlAuth
- Get most used peers: contacts.getTopPeers
- Get name, ISO code, localized name and phone codes/patterns of all available countries: help.getCountriesList
- Get namespaced methods (method => namespace): getMethodsNamespaced
- Get new strings in language pack: langpack.getDifference
- Get passport configuration: help.getPassportConfig
- Get payment receipt: payments.getPaymentReceipt
- Get peer settings: messages.getPeerSettings
- Get phone call configuration to be passed to libtgvoip's shared config: phone.getCallConfig
- Get phone call information: getCall
- Get pinned dialogs: messages.getPinnedDialogs
- Get pinned saved dialogs, see here » for more info: messages.getPinnedSavedDialogs
- Get poll results for non-anonymous polls: messages.getPollVotes
- Get poll results: messages.getPollResults
- Get preview of webpage: messages.getWebPagePreview
- Get privacy settings of current account: account.getPrivacy
- Get random integer: randomInt
- Get recent stickers: messages.getRecentStickers
- Get recently used emoji statuses: account.getRecentEmojiStatuses
- Get recently used message reactions: messages.getRecentReactions
- Get recently used t.me links: help.getRecentMeUrls
- Get saved GIFs: messages.getSavedGifs
- Get saved Telegram Passport document, for more info see the passport docs »: account.getSecureValue
- Get saved payment information: payments.getSavedInfo
- Get scheduled messages: messages.getScheduledHistory
- Get scheduled messages: messages.getScheduledMessages
- Get secret chat: getSecretChat
- Get secure random string of specified length: random
- Get sensitive content settings: account.getContentSettings
- Get songs pinned to the user's profile, see here » for more info: users.getSavedMusic
- Get sponsored messages for channel: getSponsoredMessages
- Get statistics for a certain story: stats.getStoryStats
- Get stickers attached to a photo or video: messages.getAttachedStickers
- Get stickers by emoji: messages.getStickers
- Get stories in a story album »: stories.getAlbumStories
- Get story albums created by a peer: stories.getAlbums
- Get strings from a language pack: langpack.getStrings
- Get suggested folders: messages.getSuggestedDialogFilters
- Get supergroup statistics: stats.getMegagroupStats
- Get temporary payment password: account.getTmpPassword
- Get the IDs of the maximum read stories for a set of peers: stories.getPeerMaxIDs
- Get the admin log of a channel/supergroup: channels.getAdminLog
- Get the current Telegram Stars balance of the current account (with peer=inputPeerSelf), or the stars balance of the bot specified in peer: payments.getStarsStatus
- Get the current reaction notification settings »: account.getReactionsNotifySettings
- Get the exact read date of one of our messages, sent to a private chat with another user: messages.getOutboxReadDate
- Get the file that is currently being played: callGetCurrent
- Get the number of results that would be found by a messages.search call with the same parameters: messages.getSearchCounters
- Get the number of stars we have received from the specified user thanks to paid messages »; the received amount will be equal to the sent amount multiplied by stars_paid_message_commission_permille divided by 1000: account.getPaidMessagesRevenue
- Get the participants of a supergroup/channel: channels.getParticipants
- Get the phone call with the specified user ID: getCallByPeer
- Get the progress of a currently running broadcast: getBroadcastProgress
- Get the reaction and interaction list of a story posted to a channel, along with the sender of each reaction: stories.getStoryReactionsList
- Get the set of accent color palettes » that can be used for message accents: help.getPeerColors
- Get the set of accent color palettes » that can be used in profile page backgrounds: help.getPeerProfileColors
- Get the telegram IDs of all contacts.: contacts.getContactIDs
- Get theme information: account.getTheme
- Get type of peer: getType
- Get unread messages where we were mentioned: messages.getUnreadMentions
- Get unread reactions to messages you sent: messages.getUnreadReactions
- Get users and geochats near you, see here » for more info: contacts.getLocated
- Get various warnings to show to the user in the web UI: getWebWarnings
- Get web login widget authorizations: account.getWebAuthorizations
- 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.getMessageReadParticipants
- Gets a secret chat message: getSecretMessage
- Gets current notification settings for a given user/group, from all users/all groups: account.getNotifySettings
- Gets featured custom emoji stickersets: messages.getFeaturedEmojiStickers
- Gets info of the propic of a user: getPropicInfo
- Gets the current number of boosts of a channel/supergroup: premium.getBoostsStatus
- Gets the default value of the Time-To-Live setting, applied to all new chats: messages.getDefaultHistoryTTL
- Gets the list of currently installed custom emoji stickersets: messages.getEmojiStickers
- 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: bots.getBotMenuButton
- Globally search for posts from public channels » (including those we aren't a member of) containing either a specific hashtag, or a full text query: channels.searchPosts
- Globally search for stories using a hashtag or a location media area, see here » for more info on the full flow: stories.searchPosts
- Got popular message reactions: messages.getTopReactions
- Hide MTProxy/Public Service Announcement information: help.hidePromoData
- Hide or display the participants list in a supergroup: channels.toggleParticipantsHidden
- Hide the active stories of a specific peer, preventing them from being displayed on the action bar on the homescreen: stories.toggleAllStoriesHidden
- 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.togglePeerStoriesHidden
- Hide/unhide message history for new channel/supergroup users: channels.togglePreHistoryHidden
- If the add contact action bar is active, add that user as contact: contacts.acceptContact
- 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: messages.setBotShippingResults
- Import a chat folder deep link », joining some or all the chats in the folder: chatlists.joinChatlistInvite
- Import a chat invite and join a private chat/supergroup/channel: messages.importChatInvite
- Import authorization: importAuthorization
- Import chat history from a foreign chat app into a specific Telegram chat, click here for more info about imported chats »: messages.initHistoryImport
- Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info: contacts.importContacts
- Increment the view counter of one or more stories: stories.incrementStoryViews
- Indicate to the server (from the user side) that the user is still using a web app: messages.prolongWebView
- Inflate stripped photosize to full JPG payload: inflateStripped
- Informs server about a purchase made through the App Store: for official applications only: payments.assignAppStoreTransaction
- Informs server about a purchase made through the Play Store: for official applications only: payments.assignPlayMarketTransaction
- Informs the server about the number of pending bot updates if they haven't been processed for a long time; for bots only: help.setBotUpdatesStatus
- Informs the server that the user has interacted with a sponsored message in one of the ways listed here »: messages.clickSponsoredMessage
- Initialize a takeout session, see here » for more info: account.initTakeoutSession
- Initialize connection: initConnection
- Initialize self-restart hack: initSelfRestart
- Initiate a 2FA password reset: can only be used if the user is already logged-in, see here for more info »: account.resetPassword
- Initiates QR code login: qrLogin
- Install a stickerset: messages.installStickerSet
- Install a theme: account.installTheme
- Install wallpaper: account.installWallPaper
- Install/uninstall wallpaper: account.saveWallPaper
- Installs a previously uploaded photo as a profile photo: photos.updateProfilePhoto
- Internal endpoint used by the download server: processDownloadServerPing
- Internal use: help.editUserInfo
- Invalidate the specified login codes, see here » for more info: account.invalidateSignInCodes
- Invite a set of users to a group call: phone.inviteToGroupCall
- Invite a user to a conference call: phone.inviteConferenceCallParticipant
- Invite users to a channel/supergroup: channels.inviteToChannel
- 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: invokeWithBusinessConnection
- Invoke a method within a takeout session, see here » for more info: invokeWithTakeout
- Invoke a request without subscribing the used connection for updates (this is enabled by default for file queries): invokeWithoutUpdates
- Invoke the specified query using the specified API layer: invokeWithLayer
- Invoke with the given message range: invokeWithMessagesRange
- Invokes a query after a successful completion of previous queries: invokeAfterMsgs
- Invokes a query after successful completion of one of the previous queries: invokeAfterMsg
- Join a bot's affiliate program, becoming an affiliate »: payments.connectStarRefBot
- Join a channel/supergroup: channels.joinChannel
- Join a group call: phone.joinGroupCall
- Join channels and supergroups recently added to a chat folder deep link »: chatlists.joinChatlistUpdates
- Launch a prepaid giveaway »: payments.launchPrepaidGiveaway
- Leave a bot's affiliate program »: payments.editConnectedStarRefBot
- Leave a channel/supergroup: channels.leaveChannel
- Leave a group call: phone.leaveGroupCall
- List all chat folder deep links » associated to a folder: chatlists.getExportedInvites
- List all created business chat deep links »: account.getBusinessChatLinks
- List all currently connected business bots »: account.getConnectedBots
- Load channel statistics graph asynchronously: stats.loadAsyncGraph
- Log in to telegram (via CLI or web): start
- Log out an active authorized session by its hash: account.resetAuthorization
- Log out an active web telegram login session: account.resetWebAuthorization
- Logger: logger
- Login as bot: botLogin
- Login as user: phoneLogin
- Login by importing an authorization token: auth.importWebTokenAuthorization
- Login using a redirected login token, generated in case of DC mismatch during QR code login: auth.importLoginToken
- Logout the session: logout
- Look for custom emojis associated to a UTF8 emoji: messages.searchCustomEmoji
- Look for updates of telegram's terms of service: help.getTermsOfServiceUpdate
- MTProto to TD params: MTProtoToTd
- MTProto to TDCLI params: MTProtoToTdcli
- Make a payment using Telegram Stars, see here » for more info: payments.sendStarsForm
- Make a user admin in a basic group: messages.editChatAdmin
- Manually convert HTML to a message and a set of entities: htmlToMessageEntities
- Manually convert markdown to a message and a set of entities: markdownToMessageEntities
- Manually mark dialog as unread: messages.markDialogUnread
- Mark a specific sponsored message » as read: messages.viewSponsoredMessage
- Mark a thread as read: messages.readDiscussion
- 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.readStories
- Mark channel/supergroup history as read: channels.readHistory
- Mark channel/supergroup message contents as read, emitting an updateChannelReadMessagesContents: channels.readMessageContents
- Mark mentions as read: messages.readMentions
- Mark message reactions » as read: messages.readReactions
- Mark messages as read in a monoforum topic »: messages.readSavedHistory
- Mark new featured stickers as read: messages.readFeaturedStickers
- Mark one or more items of a todo list » as completed or not completed: messages.toggleTodoCompleted
- Mark or unmark a sticker as favorite: messages.faveSticker
- Mark sponsored message as read: viewSponsoredMessage
- Marks message history as read: messages.readHistory
- Marks message history within a secret chat as read: messages.readEncryptedHistory
- Method for fetching previously featured stickers: messages.getOldFeaturedStickers
- Modify autosave settings: account.saveAutoSaveSettings
- Modify the admin rights of a user in a supergroup/channel: channels.editAdmin
- Notifies the sender about the recipient having listened a voice message or watched a video, emitting an updateReadMessagesContents: messages.readMessageContents
- Notify the other user in a private chat that a screenshot of the chat was taken: messages.sendScreenshotNotification
- 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): users.setSecureValueErrors
- Obtain a certain event handler plugin instance: getPlugin
- Obtain a list of Telegram Premium giveaway/gift code » options: payments.getPremiumGiftCodeOptions
- Obtain a list of Telegram Stars gift options » as starsGiftOption constructors: payments.getStarsGiftOptions
- Obtain a list of Telegram Stars topup options » as starsTopupOption constructors: payments.getStarsTopupOptions
- Obtain a list of active, expired or cancelled Telegram Star subscriptions »: payments.getStarsSubscriptions
- Obtain a list of bot commands for the specified bot scope and language code: bots.getBotCommands
- Obtain a list of channels where the user can post stories: stories.getChatsToSend
- Obtain a list of emoji statuses » for owned collectible gifts: account.getCollectibleEmojiStatuses
- Obtain a list of related languages that must be used when fetching emoji keyword lists »: messages.getEmojiKeywordsLanguages
- Obtain a list of similarly themed bots, selected based on similarities in their subscriber bases, see here » for more info: bots.getBotRecommendations
- Obtain a list of similarly themed public channels, selected based on similarities in their subscriber bases: channels.getChannelRecommendations
- Obtain a list of sponsored peer search results for a given query: contacts.getSponsoredPeers
- Obtain a list of suggested mini apps with available affiliate programs: payments.getSuggestedStarRefBots
- Obtain a prepared inline message generated by a mini app: invoked when handling web_app_send_prepared_message events: messages.getPreparedInlineMessage
- Obtain a preview of the possible attributes (chosen randomly) a gift » can receive after upgrading it to a collectible gift », see here » for more info: payments.getStarGiftUpgradePreview
- Obtain all chat themes » associated to owned collectible gifts »: account.getUniqueGiftChatThemes
- Obtain available message reactions »: messages.getAvailableReactions
- Obtain configuration for two-factor authorization with password: account.getPassword
- Obtain forwards of a story as a message to public chats and reposts by public channels: stats.getStoryPublicForwards
- Obtain full info about a set of stories by their IDs: stories.getStoriesByID
- Obtain info about Telegram Star transactions » using specific transaction IDs: payments.getStarsTransactionsByID
- Obtain info about a collectible gift » using a slug obtained from a collectible gift link »: payments.getUniqueStarGift
- Obtain info about the view count, forward count, reactions and recent viewers of one or more stories: stories.getStoriesViews
- Obtain information about a Telegram Premium giftcode »: payments.checkGiftCode
- Obtain information about a Telegram Premium giveaway »: payments.getGiveawayInfo
- Obtain information about a chat folder deep link »: chatlists.checkChatlistInvite
- Obtain information about a direct link Mini App: messages.getBotApp
- Obtain information about specific saved message dialogs » or monoforum topics »: messages.getSavedDialogsByID
- Obtain the API ID UI template: getWebAPITemplate
- 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.getAllReadPeerStories
- Obtain the list of users that have viewed a specific story we posted: stories.getStoryViewsList
- Obtain user info from a temporary profile link: contacts.importContactToken
- Obtain which peers are we currently boosting, and how many boost slots we have left: premium.getMyBoosts
- Obtains a list of messages, indicating to which other public channels was a channel message forwarded.: stats.getMessagePublicForwards
- Obtains a list of peers that can be used to send messages in a specific group: channels.getSendAs
- Obtains a pipe that can be used to upload a file from a stream: getStreamPipe
- Obtains info about the boosts that were applied to a certain channel or supergroup (admins only): premium.getBoostsList
- Obtains information about a chat export file, generated by a foreign chat app, click here for more info about imported chats »: messages.checkHistoryImport
- Official apps only, reports that the SMS authentication code wasn't delivered: auth.reportMissingCode
- Official clients only, invoke with Apple push verification: invokeWithApnsSecret
- Official clients only, invoke with Google Play Integrity token: invokeWithGooglePlayIntegrity
- Official clients only: re-execute a method call that required reCAPTCHA verification via a RECAPTCHA_CHECK_%s__%s, where the first placeholder is the action, and the second one is the reCAPTCHA key ID: invokeWithReCaptcha
- Once the user has confirmed their payment and shipping details, the bot receives an updateBotPrecheckoutQuery update.: messages.setBotPrecheckoutResults
- Only useful when consuming MadelineProto updates through an API in another language (like Javascript), absolutely not recommended when directly writing MadelineProto bots: getUpdates
- Open a Main Mini App: messages.requestMainWebView
- Open a bot mini app from a direct Mini App deep link, sending over user information after user confirmation: messages.requestAppWebView
- Open a bot mini app, sending over user information after user confirmation: messages.requestWebView
- Open a bot mini app: messages.requestSimpleWebView
- Opens a file in append-only mode: openFileAppendOnly
- 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.receivedCall
- Parse, update and store settings: updateSettings
- Pause or unpause a specific chat, temporarily disconnecting it from all business bots »: account.toggleConnectedBotPaused
- Pauses playback of the current audio file in the call: pausePlay
- Perform static analysis on a certain event handler class, to make sure it satisfies some performance requirements: validateEventHandlerClass
- 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.disablePeerConnectedBot
- Pin a message: messages.updatePinnedMessage
- Pin or unpin a saved message dialog »: messages.toggleSavedDialogPin
- Pin or unpin one or more stories: stories.togglePinned
- Pin some stories to the top of the profile, see here » for more info: stories.togglePinnedToTop
- Pin/unpin a dialog: messages.toggleDialogPin
- Pins a received gift on top of the profile of the user or owned channels by using payments.toggleStarGiftsPinnedToTop: payments.toggleStarGiftsPinnedToTop
- Play file in call: callPlay
- Play files on hold in call: callPlayOnHold
- Positive modulo: posmod
- Press an inline callback button and get a callback answer from the bot: messages.getBotCallbackAnswer
- Provide a buffered reader for a file, URL or amp stream: openBuffered
- Provide a stream for a file, URL or amp stream: getStream
- Query an inline bot: messages.getInlineBotResults
- Rate a call, returns info about the rating message sent to the official VoIP bot: phone.setCallRating
- Rate transcribed voice message: messages.rateTranscribedAudio
- Re-join a private channel associated to an active Telegram Star subscription »: payments.fulfillStarsSubscription
- React to a story: stories.sendReaction
- React to message: messages.sendReaction
- Refresh full peer cache for a certain peer: refreshFullPeerCache
- Refresh peer cache for a certain peer: refreshPeerCache
- Refund a Telegram Stars transaction, see here » for more info: payments.refundStarsCharge
- Register device to receive PUSH notifications: account.registerDevice
- Remove a sticker from the set where it belongs. The sticker set must have been created by the current user/bot: stickers.removeStickerFromSet
- Remove participants from a conference call: phone.deleteConferenceCallParticipants
- Removes all contacts without an associated Telegram account: contacts.resetSaved
- Rename a quick reply shortcut.: messages.editQuickReplyShortcut
- Rename a story albums », or add, delete or reorder stories in it: stories.updateAlbum
- Renames a stickerset: stickers.renameStickerSet
- Renders prometheus stats using the specified renderer: renderPromStats
- Reorder a main mini app previews, see here » for more info: bots.reorderPreviewMedias
- Reorder active usernames: channels.reorderUsernames
- Reorder folders: messages.updateDialogFiltersOrder
- Reorder installed stickersets: messages.reorderStickerSets
- Reorder pinned dialogs: messages.reorderPinnedDialogs
- Reorder pinned saved message dialogs »: messages.reorderPinnedSavedDialogs
- Reorder quick reply shortcuts: messages.reorderQuickReplies
- Reorder story albums on a profile »: stories.reorderAlbums
- Reorder the star gift collections » on an owned peer's profile: payments.reorderStarGiftCollections
- Reorder usernames associated to a bot we own: bots.reorderUsernames
- Reorder usernames associated with the currently logged-in user: account.reorderUsernames
- Replace a sticker in a stickerset »: stickers.replaceSticker
- Replace the contents of an entire blocklist, see here for more info »: contacts.setBlocked
- Report a message in a chat for violation of telegram's Terms of Service: messages.report
- Report a message reaction: messages.reportReaction
- Report a native antispam false positive: channels.reportAntiSpamFalsePositive
- Report a new incoming chat for spam, if the peer settings of the chat allow us to do that: messages.reportSpam
- Report a peer for violation of telegram's Terms of Service: account.reportPeer
- Report a profile photo of a dialog: account.reportProfilePhoto
- Report a secret chat for spam: messages.reportEncryptedSpam
- Report a sponsored message », see here » for more info on the full flow: messages.reportSponsoredMessage
- Report a story: stories.report
- Report an error to the previously set peer: report
- Report memory profile with memprof: reportMemoryProfile
- Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup: channels.reportSpam
- Represents a list of emoji categories, to be used when choosing a sticker: messages.getEmojiStickerGroups
- Represents a list of emoji categories, to be used when selecting custom emojis to set as custom emoji status: messages.getEmojiStatusGroups
- Represents a list of emoji categories, to be used when selecting custom emojis to set as profile picture: messages.getEmojiProfilePhotoGroups
- Represents a list of emoji categories: messages.getEmojiGroups
- Request VoIP call: requestCall
- Request an SMS code via Firebase: auth.requestFirebaseSms
- Request recovery code of a 2FA password, only for accounts with a recovery email configured: auth.requestPasswordRecovery
- Request secret chat: requestSecretChat
- Resend the code to verify an email to use as 2FA recovery method: account.resendPasswordEmail
- 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.resendCode
- Reset all active web telegram login sessions: account.resetWebAuthorizations
- Reset rating of top peer: contacts.resetTopPeerRating
- Reset the 2FA password using the recovery code sent using auth.requestPasswordRecovery: auth.recoverPassword
- Reset the login email »: auth.resetLoginEmail
- Reset the update state and fetch all updates from the beginning: resetUpdateState
- Resets all notification settings from users and groups: account.resetNotifySettings
- Resolve a business chat deep link »: account.resolveBusinessChatLink
- Resolve a phone number to get user info, if their privacy settings allow it: contacts.resolvePhone
- Restart update loop: restart
- Resumes playback of the current audio file in the call: resumePlay
- Rethrow exception into event loop: rethrow
- Return all message drafts.: messages.getAllDrafts
- Return current settings: getSettings
- Returns a Telegram Passport authorization form for sharing data with a service: account.getAuthorizationForm
- 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.getStarsRevenueAdsAccountUrl
- Returns a list of available wallpapers: account.getWallPapers
- Returns a set of useful suggestions and PSA/MTProxy sponsored peers, see here » for more info: help.getPromoData
- 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: messages.getEmojiURL
- Returns attachment menu entry for a bot mini app that can be launched from the attachment menu »: messages.getAttachMenuBot
- Returns chat basic info on their IDs: messages.getChats
- Returns content of a web file, by proxying the request through telegram, see the webfile docs for more info: upload.getWebFile
- Returns current configuration, including data center configuration: help.getConfig
- Returns fetch the full list of custom emoji IDs » that cannot be used in channel emoji statuses »: account.getChannelRestrictedStatusEmojis
- Returns identifiers of pinned or always included chats from a chat folder imported using a chat folder deep link », which are suggested to be left when the chat folder is deleted: chatlists.getLeaveChatlistSuggestions
- Returns info on data center nearest to the user: help.getNearestDc
- Returns information about the next messages of the specified type in the chat split by days: messages.getSearchResultsCalendar
- Returns information on update availability for the current application: help.getAppUpdate
- Returns installed attachment menu bot mini apps »: messages.getAttachMenuBots
- Returns list of chats with non-default notification settings: account.getNotifyExceptions
- Returns localized text of a text message with an invitation: help.getInviteText
- Returns sparse positions of messages of the specified type in the chat to be used for shared media scroll implementation: messages.getSearchResultsPositions
- Returns the conversation history with one interlocutor / within a chat: messages.getHistory
- Returns the current saved dialog list » or monoforum topic list »: messages.getSavedDialogs
- Returns the current user dialog list: messages.getDialogs
- Returns the current user's contact list: contacts.getContacts
- Returns the list of blocked users: contacts.getBlocked
- Returns the list of messages by their IDs: messages.getMessages
- Returns the list of user photos: photos.getUserPhotos
- Returns the lists of boost that were applied to a channel/supergroup by a specific user (admins only): premium.getUserBoosts
- Returns the session name: getSessionName
- Returns the support user for the "ask a question" feature: help.getSupport
- Returns timezone information that may be used elsewhere in the API, such as to set Telegram Business opening hours »: help.getTimezonesList
- Returns users found by username substring: contacts.search
- Returns whether the current user is a bot: isSelfBot
- Returns whether the current user is a premium user, cached: isPremium
- Returns whether the current user is a user: isSelfUser
- Reupload telegram file: uploadFromTgfile
- Save a message draft associated to a chat: messages.saveDraft
- Save a prepared inline message, to be
Truncated — view the full README on GitHub.
Similar repos
Languages
PHP
99.7%