> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reach.raysium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QR Code Authentication

> Authenticate Telegram accounts using QR codes

## QR Code Authentication

QR code authentication is often faster and doesn't require SMS access. Scan a QR code with your Telegram app to authenticate.

## Step-by-Step Process

### Step 1: Generate QR Code

1. Select **"QR Code"** authentication method
2. Click **"Generate QR Code"**
3. QR code appears on screen
4. QR code is valid for 30 seconds

<Note>
  Screenshot placeholder: Add a screenshot showing the QR code generation interface
</Note>

### Step 2: Scan QR Code

1. Open Telegram app on your phone
2. Go to **Settings** → **Devices** → **Link Desktop Device**
3. Scan the QR code displayed in Reach
4. Confirm on your phone

<Info>
  The QR code scanner in Telegram is usually found in Settings → Devices or Privacy → Active Sessions.
</Info>

### Step 3: Wait for Authentication

* QR code polling starts automatically
* System checks for authentication
* Status updates when scanned
* May take a few seconds

<Note>
  Screenshot placeholder: Add a screenshot showing the polling/scanning status
</Note>

### Step 4: Two-Factor Authentication (if enabled)

If your Telegram account has 2FA enabled:

1. Enter your 2FA password
2. Click **"Confirm 2FA Password"**
3. Authentication completes

## Troubleshooting

### QR Code Expired

If QR code expires:

1. Click **"Generate New QR Code"**
2. Scan new code immediately
3. QR codes expire after 30 seconds
4. Generate fresh code if needed

### Cannot Scan

If you cannot scan:

1. Ensure QR code is clearly visible
2. Check camera permissions
3. Try generating new code
4. Use phone authentication instead

### Scanning Doesn't Work

If scanning doesn't authenticate:

1. Verify QR code is fresh (not expired)
2. Check internet connection
3. Ensure Telegram app is updated
4. Try generating new code
5. Use phone authentication as alternative

### 2FA Required

If 2FA password is required:

1. Enter your Telegram 2FA password
2. This is different from account password
3. If forgotten, reset through Telegram
4. Cannot proceed without 2FA password

## Advantages of QR Code

**Benefits:**

* Faster than phone authentication
* No SMS required
* Works without phone number access
* Often more reliable

**When to Use:**

* Quick authentication
* No SMS access
* Multiple account setup
* Faster workflow

## Best Practices

1. **Scan Quickly**: QR codes expire in 30 seconds
2. **Have 2FA Ready**: Keep 2FA password accessible
3. **Good Lighting**: Ensure QR code is clearly visible
4. **Stable Connection**: Use stable internet connection