Authorization¶
Once a project is set up, you will still have to follow a few steps before you can actually use Hydrogram to make API calls. This section provides all the information you need in order to authorize yourself as user or bot.
User Authorization¶
In order to use the API, Telegram requires that users be authorized via their phone numbers.
Hydrogram automatically manages this process, all you need to do is create an instance of the
Client
class by passing to it a name
of your choice (e.g.: “my_account”) and call
the run()
method:
from hydrogram import Client
api_id = 12345
api_hash = "0123456789abcdef0123456789abcdef"
app = Client("my_account", api_id=api_id, api_hash=api_hash)
app.run()
This starts an interactive shell asking you to input your phone number, including your Country Code (the plus
+
and minus -
symbols can be omitted) and the phone code you will receive in your devices that are already
authorized or via SMS:
Enter phone number: +1-123-456-7890
Is "+1-123-456-7890" correct? (y/n): y
Enter phone code: 12345
Logged in successfully
After successfully authorizing yourself, a new file called my_account.session
will be created allowing Hydrogram to
execute API calls with your identity. This file is personal and will be loaded again when you restart your app.
You can now remove the api_id and api_hash values from the code as they are not needed anymore.
Note
The code above does nothing except asking for credentials and keeping the client online, hit CTRL+C now to stop your application and keep reading.
Bot Authorization¶
Bots are a special kind of users that are authorized via their tokens (instead of phone numbers), which are created by the Bot Father. Bot tokens replace the users’ phone numbers only — you still need to configure a Telegram API key with Hydrogram, even when using bots.
The authorization process is automatically managed. All you need to do is choose a name
(can be anything,
usually your bot username) and pass your bot token using the bot_token
parameter. The session file will be named
after the session name, which will be my_bot.session
for the example below.
from hydrogram import Client
api_id = 12345
api_hash = "0123456789abcdef0123456789abcdef"
bot_token = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
app = Client(
"my_bot",
api_id=api_id, api_hash=api_hash,
bot_token=bot_token
)
app.run()
Note
The API key (api_id and api_hash) and the bot_token are not required anymore after a successful authorization. This means you can now simply use the following:
from hydrogram import Client
app = Client("my_account")
app.run()