Adding Telegram Accounts

​

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

​

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

​

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”

​

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

​

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

​

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:

Managing Accounts

Learn how to manage and monitor your accounts

Creating Campaigns

Start creating campaigns with your connected account