Getting Started with TeleSender

This guide will walk you through installing TeleSender, connecting your Telegram account, and completing your first automation task.

Prerequisites

Before you begin, ensure you have:

• Google Chrome (version 88 or later)
• Active Telegram account with a verified phone number
• TeleSender account — Sign up here

Step 1: Install the Extension

From Chrome Web Store (Recommended)

1. Visit the TeleSender Chrome Web Store page
2. Click "Add to Chrome"
3. Confirm by clicking "Add extension"
4. You'll see the TeleSender icon in your browser toolbar

Sideload Installation (Developer Mode)

For testing or development:

1. Download the latest release from your account dashboard
2. Extract the ZIP file to a folder
3. Open Chrome and navigate to chrome://extensions/
4. Enable "Developer mode" (toggle in top-right)
5. Click "Load unpacked"
6. Select the extracted folder

note

Sideloaded extensions require re-enabling after Chrome updates.

Step 2: Complete Onboarding

After installation, the onboarding page opens automatically:

Welcome Steps

The onboarding wizard guides you through:

1. Overview — Understanding TeleSender's capabilities
2. Account Setup — Logging in to your TeleSender account
3. Telegram Connection — Linking your Telegram account
4. Quick Tour — Feature highlights and tips

Step 3: Log In to TeleSender

Using the Popup

1. Click the TeleSender icon in your Chrome toolbar
2. Enter your email and password
3. Click "Log In"

Using the Options Page

1. Click the TeleSender icon
2. Click "Open Options" or right-click → "Options"
3. Navigate to the Settings tab
4. Enter your credentials and log in

Authentication Flow

Your Credentials → TeleSender Backend → Token Generated → Stored Locally

Upon successful login:

• An authentication token is stored securely in Chrome storage
• Your subscription status is verified
• The interface unlocks based on your plan

Step 4: Connect Your Telegram Account

This is the most important step — TeleSender needs access to your Telegram account to perform automation.

Adding Your First Account

1. Open the TeleSender Options page
2. Navigate to Settings → Accounts
3. Click "Add Account"

Phone Number Verification

1. Enter your phone number (with country code, e.g., +1234567890)
2. Click "Send Code"
3. Telegram sends a verification code via SMS or Telegram message

Entering the Verification Code

Automatic Detection: If you have Telegram Web open in another tab, TeleSender can automatically detect the code.

Manual Entry:

1. Check your SMS or Telegram app
2. Enter the 5-digit code
3. Click "Verify"

Two-Factor Authentication (2FA)

If you have 2FA enabled on your Telegram account:

1. After code verification, a password prompt appears
2. Enter your Telegram 2FA password
3. Click "Submit"

Session Storage

Once verified, TeleSender creates a session:

{
  phoneNumber: "+1234567890",
  sessionString: "encrypted-session-data",
  status: "active",
  createdAt: 1704067200000
}

Session Persistence

Your session is stored securely in Chrome's local storage. You won't need to log in again unless you manually disconnect or the session expires.

Step 5: Dashboard Overview

After setup, explore the main interface:

Popup (Quick Access)

Click the TeleSender icon for:

• Account status
• Quick actions
• Recent activity
• Link to full dashboard

Options Page (Full Dashboard)

Right-click icon → "Options" to access:

Tab	Purpose
Campaigns	Create, manage, and monitor campaigns
Contacts	View scraped contacts and AI scores
Anti-Ban	Configure safety settings
Logs	Review operation history
Settings	Account management, import/export
AI	Access AI-powered tools

Step 6: Your First Scrape

Let's test your setup with a simple member extraction:

1. Go to Options → Campaigns
2. Click "New Campaign"
3. Select "Scrape Only" campaign type
4. Choose a group from the dropdown
5. Set limit to 10 members (for testing)
6. Select "Safe" anti-ban profile
7. Click "Start"

Watch the progress bar as members are extracted. Results are saved to your Contacts tab.

Demo Mode

Not ready to subscribe? Try TeleSender in demo mode:

Demo Limitations

Feature	Demo Limit
Scraping	50 members
Sending	10 messages
Inviting	10 invites
AI Features	10 requests

To use demo mode, contact support for a trial token.

Troubleshooting Common Issues

"Login Failed" Error

Causes:

• Incorrect email or password
• Account not verified
• Network connectivity issues

Solutions:

1. Verify credentials at tele-sender.com
2. Check your email for verification link
3. Try again with stable internet connection

"Session Expired" Error

Causes:

• Telegram session was revoked
• Long period of inactivity
• Account logged out elsewhere

Solutions:

1. Go to Settings → Accounts
2. Click "Remove" on the affected account
3. Add the account again with new verification

"FloodWait" Warning

Causes:

• Too many requests to Telegram
• Aggressive rate settings

Solutions:

1. Wait for the cooldown period (shown in error)
2. Switch to a safer anti-ban profile
3. Reduce operation frequency

Extension Not Working

Causes:

• Chrome version outdated
• Extension permissions blocked
• Conflicting extensions

Solutions:

1. Update Chrome to latest version
2. Check extension permissions in chrome://extensions/
3. Disable other Telegram-related extensions
4. Reinstall TeleSender

"Network Error" Messages

Causes:

• Internet connectivity issues
• Telegram servers unreachable
• VPN/Proxy interference

Solutions:

1. Check internet connection
2. Try disabling VPN temporarily
3. Clear browser cache and retry

Next Steps

Now that you're set up:

1. Learn the Scraper — Master member extraction
2. Configure Anti-Ban — Protect your account
3. Build a Campaign — Create your first workflow
4. Explore AI Tools — Enhance with AI

Getting Help

• Documentation — You're reading it!
• FAQ — Common questions answered
• Support — Contact us at support@tele-sender.com
• Community — Join our Telegram group for tips

---

Pro Tip

Start with the "Safe" anti-ban profile and small operation sizes. Once you're comfortable with the tool and understand Telegram's limits, you can gradually increase speed.