> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maestrobots.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 🔑 Logging In
> When you first open Maestro Scraper, you'll be taken to the login screen. The login process has up to 4 steps:
When you first open Maestro Scraper, you'll be taken to the login screen. The login process has up to 4 steps:
## Step 1: API Credentials
Don't have these yet? See [Getting Your Telegram API Credentials](/scraper/telegram-credentials).
* Enter your **API ID** (the number from my.telegram.org)
* Enter your **API Hash** (the 32-character string)
* Leave **Telegram Server Region** on **Auto** unless connecting is slow or blocked on your network
* Check **"Remember credentials"** if you want the app to save your API credentials for next time
* Click **Continue**
**Telegram Server Region**
**Telegram Server Region** sets which Telegram datacenter the app connects through: **Auto**, **MIA1**, **AMS1**, **MIA2**, **AMS2**, or **SIN**. **Auto** works for almost everyone. If connecting is slow or blocked where you are, try another option. This does not move your account, Telegram always routes you to your account's home region. It appears when there is no saved session yet: your first sign-in, or after you clear your saved login. Signing in saves the session, so afterward the app reconnects to your account's home datacenter automatically and the option is hidden. Once connected, hovering the **Connected** status in the footer shows your datacenter and the current ping (for example **AMS2: 123 ms**), and clicking it copies that.
If you uncheck "Remember credentials" later, the app will clear all saved credentials and your Telegram session. You will need to log in again.
On a system without a secure keychain (some minimal Linux installs, or macOS when Keychain access has been denied), the login page shows a **Secure keychain is not available** prompt. Choose **Accept & enable** to save your credentials with a machine-tied fallback, or **No thanks** to carry on without saving them. See [Security & Privacy](/scraper/security-privacy) for the trade-off and how to switch back later.
## Step 2: Phone Number
* Enter your phone number **with country code** (e.g., `+1 234 567 8900` for US)
* Click **Send Code**
* Telegram decides how to send the code. If you are already signed in to Telegram on another device, it usually delivers the code to that **Telegram app** rather than as an SMS.
## Step 3: Verification Code
* The screen tells you where the code was sent: your **Telegram app**, an **SMS**, or a **call**. Look there.
* If it went to your Telegram app, open Telegram on your phone or desktop and find the login code in the **Telegram** chat.
* Enter the **5-6 digit code** in Maestro Scraper. On rare occasions Telegram sends the code as a **word or short phrase** by SMS instead of digits; the screen will say so, and you type it in exactly as it arrived.
* Click **Verify**
* If you didn't receive it, use the resend button to try the next delivery method. It names the method it will use (for example **Resend via SMS**) and only appears when another method is available. Telegram enforces a short wait between sends, so the button may show a countdown before it becomes available.
If the screen says no code will arrive here, follow the instructions in the message: sign in once on the official Telegram app on your phone (and, if Telegram asks this account to set up a login email, set it up there), then come back and try again.
## Step 4: Two-Factor Authentication (if enabled)
If you have Two-Factor Authentication (2FA) enabled on your Telegram account:
* Enter your **cloud password** (the 2FA password you set up in Telegram)
* Click **Sign In**
After successful login, you'll be redirected to the Channels page.
Your session is saved securely. You won't need to log in again unless you explicitly log out or uncheck "Remember credentials."