> ## 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.

# Adding Telegram Accounts

> Step-by-step guide to connecting Telegram accounts to Reach

## Adding Your First Account

Before you can send messages through campaigns, you need to connect at least one Telegram account to Reach.

## Prerequisites

Before adding an account, make sure you have:

* A Telegram account (phone number or access to Telegram app)
* Access to receive SMS or Telegram verification codes
* Your 2FA password (if two-factor authentication is enabled)

## Adding an Account

### Step 1: Open Add Account Form

1. Navigate to **Accounts** page
2. Click **"Add Account"** button
3. Add account form appears

<Note>
  Screenshot placeholder: Add a screenshot showing the "Add Account" button and form
</Note>

### Step 2: Choose Authentication Method

Select how you want to authenticate:

**Phone Number:**

* Enter your phone number
* Receive verification code via SMS/Telegram
* Enter code to verify

**QR Code:**

* Generate QR code
* Scan with Telegram app
* Automatic authentication

<Info>
  QR code authentication is often faster and doesn't require SMS access.
</Info>

### Step 3: Complete Authentication

Follow the steps for your chosen method (see detailed guides below).

### Step 4: Account Added

Once authenticated:

* Account appears in your accounts list
* Status shows as "Connected"
* Account is ready for campaigns
* Health check runs automatically

## Phone Number Authentication

### Step 1: Enter Phone Number

1. Select "Phone Number" authentication method
2. Enter your phone number with country code
3. Format: +1234567890 (include + and country code)
4. Click "Send Code"

<Info>
  Use the same phone number format you use in Telegram. Include the country code.
</Info>

### Step 2: Receive Verification Code

* Code is sent via Telegram (not SMS)
* Check your Telegram app for the code
* Code is typically 5 digits
* Code expires after a few minutes

### Step 3: Enter Verification Code

1. Enter the code you received
2. Click "Verify Code"
3. If 2FA is enabled, you'll be prompted for password
4. Account authenticates

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

If your Telegram account has 2FA:

1. Enter your 2FA password
2. Click "Verify Password"
3. Account completes authentication

<Warning>
  If you don't have your 2FA password, you'll need to reset it through Telegram before adding the account.
</Warning>

## QR Code Authentication

### 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

### Step 3: Wait for Authentication

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

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

If your Telegram account has 2FA:

1. Enter your 2FA password
2. Click "Confirm 2FA Password"
3. Account completes authentication

## Account Status

### After Adding

Once added, your account:

* Appears in accounts list
* Shows connection status
* Health check runs automatically
* Ready for campaigns

### Connection Status

**Connected:**

* Account is healthy
* Can send messages
* Ready to use

**Disconnected:**

* Account needs reconnection
* Cannot send messages
* Check account health

## Troubleshooting

### Verification Code Not Received

If you don't receive the code:

1. Check Telegram app is working
2. Verify phone number is correct
3. Check internet connection
4. Wait a few minutes and try again
5. Try QR code method instead

### Code Expired

If code expires:

1. Click "Back" or "Resend Code"
2. Request a new code
3. Enter new code promptly
4. Codes expire quickly for security

### 2FA Password Required

If 2FA is required:

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

### 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

### Authentication Fails

If authentication fails:

1. Verify phone number format
2. Check Telegram account is active
3. Ensure internet connection is stable
4. Try alternative authentication method
5. Contact support if issues persist

## Best Practices

1. **Use QR Code**: Often faster and more reliable
2. **Keep 2FA Password**: Store 2FA password securely
3. **Verify Status**: Check account status after adding
4. **Test Connection**: Use "Test Connection" to verify
5. **Multiple Accounts**: Consider adding backup accounts

## Security Considerations

### Account Security

* Accounts are encrypted and stored securely
* Session data is protected
* Only you can access your accounts
* Accounts are isolated per user

### Best Practices

1. **Secure Password**: Use strong 2FA password
2. **Don't Share**: Never share account credentials
3. **Monitor Access**: Check account activity regularly
4. **Remove Unused**: Delete accounts you no longer use

## Next Steps

After adding your account:

<Card title="Managing Accounts" icon="settings" href="/accounts/managing-accounts">
  Learn how to manage and monitor your accounts
</Card>

<Card title="Creating Campaigns" icon="plus" href="/campaigns/creating-campaigns">
  Start creating campaigns with your connected account
</Card>