Available Methods#

This page is about Pyrogram methods. All the methods listed here are bound to a Client instance, except for idle() and compose(), which are special functions that can be found in the main package directly.

from pyrogram import Client

app = Client("my_account")

with app:
    app.send_message("me", "hi")

Utilities#

`start`	Start the client.
`stop`	Stop the Client.
`run`	Start the client, idle the main script and finally stop the client.
`restart`	Restart the Client.
`add_handler`	Register an update handler.
`remove_handler`	Remove a previously-registered update handler.
`stop_transmission`	Stop downloading or uploading a file.
`export_session_string`	Export the current authorized session as a serialized string.
`set_parse_mode`	Set the parse mode to be used globally by the client.

`idle`	Block the main script execution until a signal is received.
`compose`	Run multiple clients at once.

Messages#

`send_message`	Send text messages.
`forward_messages`	Forward messages of any kind.
`copy_message`	Copy messages of any kind.
`copy_media_group`	Copy a media group by providing one of the message ids.
`send_photo`	Send photos.
`send_audio`	Send audio files.
`send_document`	Send generic files.
`send_sticker`	Send static .webp or animated .tgs stickers.
`send_video`	Send video files.
`send_animation`	Send animation files (animation or H.264/MPEG-4 AVC video without sound).
`send_voice`	Send audio files.
`send_video_note`	Send video messages.
`send_media_group`	Send a group of photos or videos as an album.
`send_location`	Send points on the map.
`send_venue`	Send information about a venue.
`send_contact`	Send phone contacts.
`send_cached_media`	Send any media stored on the Telegram servers using a file_id.
`send_reaction`	Send a reaction to a message.
`edit_message_text`	Edit the text of messages.
`edit_message_caption`	Edit the caption of media messages.
`edit_message_media`	Edit animation, audio, document, photo or video messages.
`edit_message_reply_markup`	Edit only the reply markup of messages sent by the bot.
`edit_inline_text`	Edit the text of inline messages.
`edit_inline_caption`	Edit the caption of inline media messages.
`edit_inline_media`	Edit inline animation, audio, document, photo or video messages.
`edit_inline_reply_markup`	Edit only the reply markup of inline messages sent via the bot (for inline bots).
`send_chat_action`	Tell the other party that something is happening on your side.
`delete_messages`	Delete messages, including service messages.
`get_messages`	Get one or more messages from a chat by using message identifiers.
`get_media_group`	Get the media group a message belongs to.
`get_chat_history`	Get messages from a chat history.
`get_chat_history_count`	Get the total count of messages in a chat.
`read_chat_history`	Mark a chat's message history as read.
`send_poll`	Send a new poll.
`vote_poll`	Vote a poll.
`stop_poll`	Stop a poll which was sent by you.
`retract_vote`	Retract your vote in a poll.
`send_dice`	Send a dice with a random value from 1 to 6.
`search_messages`	Search for text and media messages inside a specific chat.
`search_messages_count`	Get the count of messages resulting from a search inside a chat.
`search_global`	Search messages globally from all of your chats.
`search_global_count`	Get the count of messages resulting from a global search.
`download_media`	Download the media from a message.
`stream_media`	Stream the media from a message chunk by chunk.
`get_discussion_message`	Get the first discussion message of a channel post or a discussion thread in a group.
`get_discussion_replies`	Get the message replies of a discussion thread.
`get_discussion_replies_count`	Get the total count of replies in a discussion thread.
`get_custom_emoji_stickers`	Get information about custom emoji stickers by their identifiers.

Chats#

`join_chat`	Join a group chat or channel.
`leave_chat`	Leave a group chat or channel.
`ban_chat_member`	Ban a user from a group, a supergroup or a channel.
`unban_chat_member`	Unban a previously banned user in a supergroup or channel.
`restrict_chat_member`	Restrict a user in a supergroup.
`promote_chat_member`	Promote or demote a user in a supergroup or a channel.
`set_administrator_title`	Set a custom title (rank) to an administrator of a supergroup.
`set_chat_photo`	Set a new chat photo or video (H.264/MPEG-4 AVC video, max 5 seconds).
`delete_chat_photo`	Delete a chat photo.
`set_chat_title`	Change the title of a chat.
`set_chat_description`	Change the description of a supergroup or a channel.
`set_chat_permissions`	Set default chat permissions for all members.
`pin_chat_message`	Pin a message in a group, channel or your own chat.
`unpin_chat_message`	Unpin a message in a group, channel or your own chat.
`unpin_all_chat_messages`	Use this method to clear the list of pinned messages in a chat.
`get_chat`	Get up to date information about a chat.
`get_chat_member`	Get information about one member of a chat.
`get_chat_members`	Get the members list of a chat.
`get_chat_members_count`	Get the number of members in a chat.
`get_dialogs`	Get a user's dialogs sequentially.
`get_dialogs_count`	Get the total count of your dialogs.
`set_chat_username`	Set a channel or a supergroup username.
`get_nearby_chats`	Get nearby chats.
`archive_chats`	Archive one or more chats.
`unarchive_chats`	Unarchive one or more chats.
`add_chat_members`	Add new chat members to a group, supergroup or channel
`create_channel`	Create a new broadcast channel.
`create_group`	Create a new basic group.
`create_supergroup`	Create a new supergroup.
`delete_channel`	Delete a channel.
`delete_supergroup`	Delete a supergroup.
`delete_user_history`	Delete all messages sent by a certain user in a supergroup.
`set_slow_mode`	Set the slow mode interval for a chat.
`mark_chat_unread`	Mark a chat as unread.
`get_chat_event_log`	Get the actions taken by chat members and administrators in the last 48h.
`get_chat_online_count`	Get the number of members that are currently online in a chat.
`get_send_as_chats`	Get the list of "send_as" chats available.
`set_send_as_chat`	Set the default "send_as" chat for a chat.
`set_chat_protected_content`	Set the chat protected content setting.

Users#

`get_me`	Get your own user identity.
`get_users`	Get information about a user.
`get_chat_photos`	Get a chat or a user profile photos sequentially.
`get_chat_photos_count`	Get the total count of photos for a chat.
`set_profile_photo`	Set a new profile photo or video (H.264/MPEG-4 AVC video, max 5 seconds).
`delete_profile_photos`	Delete your own profile photos.
`set_username`	Set your own username.
`update_profile`	Update your profile details such as first name, last name and bio.
`block_user`	Block a user.
`unblock_user`	Unblock a user.
`get_common_chats`	Get the common chats you have with a user.
`get_default_emoji_statuses`	Get the default emoji statuses.
`set_emoji_status`	Set the emoji status.

Invite Links#

`get_chat_invite_link`	Get detailed information about a chat invite link.
`export_chat_invite_link`	Generate a new primary invite link for a chat; any previously generated primary link is revoked.
`create_chat_invite_link`	Create an additional invite link for a chat.
`edit_chat_invite_link`	Edit a non-primary invite link.
`revoke_chat_invite_link`	Revoke a previously created invite link.
`delete_chat_invite_link`	Delete an already revoked invite link.
`get_chat_invite_link_joiners`	Get the members who joined the chat with the invite link.
`get_chat_invite_link_joiners_count`	Get the count of the members who joined the chat with the invite link.
`get_chat_admin_invite_links`	Get the invite links created by an administrator in a chat.
`get_chat_admin_invite_links_count`	Get the count of the invite links created by an administrator in a chat.
`get_chat_admins_with_invite_links`	Get the list of the administrators that have exported invite links in a chat.
`get_chat_join_requests`	Get the pending join requests of a chat.
`delete_chat_admin_invite_links`	Delete all revoked invite links of an administrator.
`approve_chat_join_request`	Approve a chat join request.
`approve_all_chat_join_requests`	Approve all pending join requests in a chat.
`decline_chat_join_request`	Decline a chat join request.
`decline_all_chat_join_requests`	Decline all pending join requests in a chat.

Contacts#

`add_contact`	Add an existing Telegram user as contact, even without a phone number.
`delete_contacts`	Delete contacts from your Telegram address book.
`import_contacts`	Import contacts to your Telegram address book.
`get_contacts`	Get contacts from your Telegram address book.
`get_contacts_count`	Get the total count of contacts from your Telegram address book.

Password#

`enable_cloud_password`	Enable the Two-Step Verification security feature (Cloud Password) on your account.
`change_cloud_password`	Change your Two-Step Verification password (Cloud Password) with a new one.
`remove_cloud_password`	Turn off the Two-Step Verification security feature (Cloud Password) on your account.

Bots#

`get_inline_bot_results`	Get bot results via inline queries.
`send_inline_bot_result`	Send an inline bot result.
`answer_callback_query`	Send answers to callback queries sent from inline keyboards.
`answer_inline_query`	Send answers to an inline query.
`request_callback_answer`	Request a callback answer from bots.
`send_game`	Send a game.
`set_game_score`	Set the score of the specified user in a game.
`get_game_high_scores`	Get data for high score tables.
`set_bot_commands`	Set the list of the bot's commands.
`get_bot_commands`	Get the current list of the bot's commands for the given scope and user language.
`delete_bot_commands`	Delete the list of the bot's commands for the given scope and user language.
`set_bot_default_privileges`	Change the default privileges requested by the bot when it's added as an administrator to groups or channels.
`get_bot_default_privileges`	Get the current default privileges of the bot.
`set_chat_menu_button`	Change the bot's menu button in a private chat, or the default menu button.
`get_chat_menu_button`	Get the current value of the bot's menu button in a private chat, or the default menu button.
`answer_web_app_query`	Set the result of an interaction with a Web App and send a corresponding message on behalf of the user to the chat from which the query originated.

Authorization#

`connect`	Connect the client to Telegram servers.
`disconnect`	Disconnect the client from Telegram servers.
`initialize`	Initialize the client by starting up workers.
`terminate`	Terminate the client by shutting down workers.
`send_code`	Send the confirmation code to the given phone number.
`resend_code`	Re-send the confirmation code using a different type.
`sign_in`	Authorize a user in Telegram with a valid confirmation code.
`sign_in_bot`	Authorize a bot using its bot token generated by BotFather.
`sign_up`	Register a new user in Telegram.
`get_password_hint`	Get your Two-Step Verification password hint.
`check_password`	Check your Two-Step Verification password and log in.
`send_recovery_code`	Send a code to your email to recover your password.
`recover_password`	Recover your password with a recovery code and log in.
`accept_terms_of_service`	Accept the given terms of service.
`log_out`	Log out from Telegram and delete the *.session file.

Advanced#

Methods used only when dealing with the raw Telegram API. Learn more about how to use the raw API at Advanced Usage.

`invoke`	Invoke raw Telegram functions.
`resolve_peer`	Get the InputPeer of a known peer id.
`save_file`	Upload a file onto Telegram servers, without actually sending the message to anyone.