sign_in()

Client.sign_in()

Authorize a user in Telegram with a valid confirmation code.

Usable by Users Bots
Parameters:

  • phone_number (``str``) – Phone number in international format (includes the country prefix).

  • phone_code_hash (``str``) – Code identifier taken from the result of send_code().

  • phone_code (``str``) – The valid confirmation code you received (either as Telegram message or as SMS in your phone number).

Returns:

  • :obj:`~pyrogram.types.User` | :obj:`~pyrogram.types.TermsOfService` | bool (On success, in case the)

  • authorization completed, the user is returned. In case the phone number needs to be registered first AND the

  • terms of services accepted (with accept_terms_of_service()), an object containing

  • them is returned. In case the phone number needs to be registered, but the terms of services don’t need to

  • be accepted, False is returned instead.

Raises:

  • BadRequest – In case the arguments are invalid.:

  • SessionPasswordNeeded – In case a password is needed to sign in.:

  • RPCError –