MadelineProtoDocs/docs/docs/LOGIN.md

title	description	image
Logging in	There are many ways you can login with MadelineProto.	https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png

Logging in

There are many ways you can login with MadelineProto.

• Getting permission to use the telegram API
• Automatic
• Manual (user)
  • API ID
• Manual (bot)
• Logout
• Changing 2FA password

Getting permission to use the telegram API

Automatic (now fully async!)

yield $MadelineProto->start();

This will start an interactive login prompt via console (if running via CLI), or a login web UI (if running in the browser).
You will get to choose if login as user, or as bot.

Manual (user)

API ID

Before logging in, you must obtain an API ID (if you're using the automatic mode you don't have to do this).
You can do that either by logging in to my.telegram.org and getting your API ID/hash, or automatically, by using MadelineProto's MyTelegramOrgWrapper API:

use danog\MadelineProto\MyTelegramOrgWrapper;

$wrapper = new MyTelegramOrgWrapper($settings);
$wrapper->async(true);

yield $wrapper->login(yield $wrapper->readline('Enter your phone number (this number must already be signed up to telegram)'));

yield $wrapper->complete_login(yield $wrapper->readline('Enter the code'));

if (yield $wrapper->logged_in()) {
    if (yield $wrapper->has_app()) {
        $app = yield $wrapper->get_app();
    } else {
        $app_title = yield $wrapper->readLine('Enter the app\'s name, can be anything: ');
        $short_name = yield $wrapper->readLine('Enter the app\'s short name, can be anything: ');
        $url = yield $wrapper->readLine('Enter the app/website\'s URL, or t.me/yourusername: ');
        $description = yield $wrapper->readLine('Describe your app: ');
        
        $app = yield $wrapper->my_telegram_org_wrapper->create_app_async(['app_title' => $app_title, 'app_shortname' => $short_name, 'app_url' => $url, 'app_platform' => 'web', 'app_desc' => $description]);
    }
    
    \danog\MadelineProto\Logger::log($app);

}

This wrapper allows you to automatically login to my.telegram.org and create an app associated to the specified user (the specified phone number must be already signed up to telegram).

Async is handled exactly like in MadelineProto, with an async method that can be used to enable or disable async functionality.
The readline wrapper (see Async) can also be used with the the MyTelegramOrgWrapper API.

The constructor of the API is optional, and can be an array of MadelineProto settings: it can be used to set proxy info (only HTTP and SOCKS is supported for this).

After you provide an API ID, you can then login (if you're using the automatic mode you don't have to do this).

yield $MadelineProto->phone_login(yield $MadelineProto->readline('Enter your phone number: '));
$authorization = yield $MadelineProto->complete_phone_login(yield $MadelineProto->readline('Enter the phone code: '));
if ($authorization['_'] === 'account.password') {
    $authorization = yield $MadelineProto->complete_2fa_login(yield $MadelineProto->readline('Please enter your password (hint '.$authorization['hint'].'): '));
}
if ($authorization['_'] === 'account.needSignup') {
    $authorization = yield $MadelineProto->complete_signup(yield $MadelineProto->readline('Please enter your first name: '), readline('Please enter your last name (can be empty): '));
}

First, you must call phone_login to send the verification code, see here for the parameters and the result.
Then, use complete_phone_login to complete the login, see here for the parameters and the result.

Use complete_2FA_login to complete the login to an account with 2FA enabled, see here for the parameters and the result.

If the account does not have an account, use complete_signup to signup, see here for the parameters and the result.

Manual (bot)

yield $MadelineProto->bot_login('34298141894:aflknsaflknLKNFS');

Use bot_login to login as a bot, see here for the parameters and the result.

Note that when you login as a bot, MadelineProto also logins using the PWRTelegram API, to allow persistant storage of peers, even after a logout and another login.

Logout

yield $MadelineProto->logout();

If you want to logout, you can use the logout function, see here for the parameters and the result.

Changing 2FA password

$result = yield $MadelineProto->update_2fa(['password' => 'current password', 'new_password' => 'New password', 'email' => 'daniil@daniil.it', 'hint' => 'ponies']);

If you want to logout, you can use the update_2fa function, see here for the parameters and the result.

Next section