🏠 Home⚡ Features💰 Pricing 📖 Tutorial🚀 Why TurboSender ⚖️ Legal📞 Contact 🚀 Get Extension Free

TurboSender Complete Guide

Step-by-step instructions for every feature. Available in English and Hindi.

🚀 Getting Started

TurboSender runs entirely in your browser. No account needed. No server. No data upload.
1

System Requirements

Before you start, make sure you have:

  • Google Chrome browser (latest version recommended)
  • A WhatsApp account (personal or Business)
  • Active internet connection
  • The Chrome Extension installed (see Install section below)
2

Prepare Your Contact List

You'll need phone numbers with country code. Best formats:

  • TXT file: One number per line — e.g., 919876543210
  • CSV file: col1=phone, col2=name, col3=custom1, col4=custom2
  • Direct paste: Paste numbers into the textarea in the extension panel

📦 Install the Extension

1

Download the Extension

Go to the Install Extension page and download the latest version of TurboSender.

2

Download WPP.js

Required dependency. Download wpp.min.js from wa-js GitHub releases and place it in the libs/ folder.

3

Load in Chrome

  • Open Chrome → go to chrome://extensions
  • Enable Developer Mode (toggle in top right)
  • Click "Load Unpacked"
  • Select the TS-Chrome-Extension/ folder
  • TurboSender icon will appear in your Chrome toolbar ✅
4

Add Icons (if missing)

Create or copy PNG icons into the icons/ folder: icon16.png (16×16), icon48.png (48×48), icon128.png (128×128).

🔗 Connect to WhatsApp

  1. Click the TurboSender icon in Chrome toolbar → Side Panel opens
  2. Click "Open & Connect" button in the panel
  3. WhatsApp Web opens at web.whatsapp.com
  4. Scan the QR code with your phone (WhatsApp → Settings → Linked Devices)
  5. Wait for WhatsApp Web to load — TurboSender auto-detects connection (polls every 10s)
  6. Status badge turns 🟢 ON when connected
  7. You're ready to send! 🎉
⚠️
Keep the WhatsApp Web tab open while sending. Do not close or refresh it during a campaign.

📤 Bulk Single Send

📤
Send to Many Individuals
  1. Click the Single Send tab in the extension panel
  2. Enter phone numbers (with country code) in the textarea — one per line
    Or click "Import TXT" / "Import CSV"
  3. Live number count updates in real time
  4. Compose your message in the text box. Use variables like {name}, {date}
  5. Optionally attach a media file (image, PDF, video, etc.)
  6. Set Min Delay and Max Delay (in seconds) between messages
  7. Set Batch Size (pause every N messages) and Batch Break duration
  8. Click ▶ START — TurboSender checks WPP connection, then starts sending
  9. Watch the real-time progress bar and per-message log (✅/❌ per contact)
  10. Click ⏹ STOP anytime to abort mid-campaign

👥 Bulk Group Send

👥
Send to Multiple Groups
  1. Click the Group Send tab
  2. Click "Fetch Groups" to load all your WhatsApp groups
  3. Browse the list — use the search box to filter by group name
  4. Check the groups you want to send to (or click Select All)
  5. Click "Use Selected" to populate the group IDs textarea
  6. Compose your message
  7. Optional: check "Tag All Members" to @mention everyone in each group
  8. Optionally attach media
  9. Set delays and batch settings, then click ▶ START

🎯 Variable Substitution

Add personalization to every message using these placeholders:

{name} {number} {date} {time} {index} {custom_var_1} {custom_var_2}

Example message:

Hello {name}, your offer of {custom_var_1} is valid till {date}! 🎉

Result for Priya with offer=30% OFF:

Hello Priya, your offer of 30% OFF is valid till 01 Mar 2026! 🎉

Custom variable names are set in the Settings tab. Their values come from CSV columns 3 & 4.

📋 CSV Import

CSV Column Format:

phone, name, custom_var_1, custom_var_2
919876543210, Priya Sharma, 30% OFF, PRIYA30
919876543211, Rahul Gupta, 25% OFF, RAHUL25
919876543212, Amit Singh, 20% OFF, AMIT20
  • Column 1: Phone number (non-digit characters auto-stripped)
  • Column 2: Name (used in {name} variable)
  • Column 3: Custom Variable 1 value (used in your custom var)
  • Column 4: Custom Variable 2 value
  • Header row optional — TurboSender detects it automatically
  • Works with exports from Excel, Google Sheets, CRM tools

📎 Media Messages

  1. In Single Send or Group Send tab, click the "Attach File" button
  2. Select your file (Image, Video, Audio, PDF, or Document)
  3. File name appears in preview — click ✕ to remove
  4. Write your caption text in the message box (optional)
  5. Click START — media is sent with each message
📋
Supported file types: Images (.jpg, .png, .gif, .webp), Video (.mp4, .avi), Audio (.mp3, .ogg), Documents (.pdf, .doc, .docx, .xlsx)

🗓️ Message Scheduler

  1. Click the Scheduler tab in the extension panel
  2. Enter a campaign name (e.g., "Sunday Offer")
  3. Select type: Single contacts or Groups
  4. Enter phone numbers / group IDs in the target field
  5. Compose your message (variables work here too!)
  6. Pick a future date & time using the datetime picker
  7. Set per-message delay, then click "Schedule Campaign"
  8. Campaign appears in the list with status 🟡 Pending
  9. At the scheduled time, Chrome fires the alarm → campaign starts automatically
  10. Status updates to 🟢 Running, then ✅ Done
  11. Chrome notification appears when complete with sent/failed count
💡
The scheduler uses chrome.alarms API — campaigns fire even if the browser is minimized or in background. Chrome does not need to be at the forefront.

✅ Number Validator

  1. Click the Filter tab
  2. Paste phone numbers in the textarea (or import from TXT)
  3. Set validation delay (seconds between each check)
  4. Click ▶ START FILTERING
  5. Valid numbers appear on the left panel (✅ green)
  6. Invalid numbers appear on the right panel (❌ red)
  7. Live counters update in real time
  8. Click "Export Valid" or "Export Invalid" to download as TXT
🛡️
Run the validator before every campaign to clean your list. This protects your account and improves delivery rates.

🔍 Contact & Group Grabber

🔍
Extract Contacts from WhatsApp

Chat List Grabber:

  1. Go to the Grabber tab
  2. Click "Grab Contacts"
  3. TurboSender scans your chat list and extracts all contact numbers
  4. Numbers auto-download as a TXT file

Group Member Grabber:

  1. Enter the Group ID in the input field (you can get this from Group Send tab → Fetch Groups)
  2. Click "Grab Members"
  3. All member phone numbers extract and auto-download as TXT

⚙️ Settings

Configure global defaults in the Settings tab:

  • Default Min Delay — min seconds between messages (e.g., 3)
  • Default Max Delay — max seconds between messages (e.g., 8). TurboSender picks a random value in this range per message.
  • Batch Size — number of messages before an automatic batch pause
  • Batch Break Duration — seconds to pause between batches
  • Custom Variable 1 Name — e.g., offer → use as {offer}
  • Custom Variable 2 Name — e.g., city → use as {city}

Click Save Settings — all values persist in chrome.storage.local and apply across all tabs. You'll see a toast confirmation.

🛡️ Anti-Ban Best Practices

⏱️
Use Proper Delays
Set min 3s / max 10s between messages. Random human-like timing is harder to detect than fixed intervals.
📦
Batch Your Sends
Never send 1000 msgs in one go. Set batch size to 50 with a 60-second break — mimics natural messaging behavior.
Validate First
Always run the number validator before a campaign. Sending to invalid numbers raises red flags on WhatsApp's server.
👤
Personalize Messages
Unique messages per contact (via variables) are far less likely to be flagged as spam than identical bulk blasts.
📉
Start Small
On a new/fresh account, start with 50–100 messages/day. Gradually increase over weeks as your account ages.
📋
Opt-Out Respected
Remove numbers that reply "STOP" or similar immediately. Keeping opt-out lists clean is both legal compliance and safety.
⚠️
TurboSender is a tool for legitimate business communication. Spam, harassment, or prohibited content violates our Terms of Service and WhatsApp's policies. Read our Anti-Ban Policy.

Ready to Start?

Install TurboSender and start your first campaign in under 2 minutes.

🚀 Install Extension 💰 View Plans ⚡ All Features