MadelineProtoDocs/docs/docs/LOGIN.md

3.0 KiB

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.

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)

yield $MadelineProto->phone_login(readline('Enter your phone number: '));
$authorization = yield $MadelineProto->complete_phone_login(readline('Enter the phone code: '));
if ($authorization['_'] === 'account.password') {
    $authorization = yield $MadelineProto->complete_2fa_login(readline('Please enter your password (hint '.$authorization['hint'].'): '));
}
if ($authorization['_'] === 'account.needSignup') {
    $authorization = yield $MadelineProto->complete_signup(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