Skip to main content
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.
  • 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 RegionTelegram 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 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.”