TurboSender Complete Guide
Step-by-step instructions for every feature. Available in English and Hindi.
🚀 Getting Started
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)
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
Download the Extension
Go to the Install Extension page and download the latest version of TurboSender.
Download WPP.js
Required dependency. Download wpp.min.js from wa-js GitHub releases and place it in the libs/ folder.
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 ✅
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
- Click the TurboSender icon in Chrome toolbar → Side Panel opens
- Click "Open & Connect" button in the panel
- WhatsApp Web opens at
web.whatsapp.com - Scan the QR code with your phone (WhatsApp → Settings → Linked Devices)
- Wait for WhatsApp Web to load — TurboSender auto-detects connection (polls every 10s)
- Status badge turns 🟢 ON when connected
- You're ready to send! 🎉
📤 Bulk Single Send
- Click the Single Send tab in the extension panel
- Enter phone numbers (with country code) in the textarea — one per line
Or click "Import TXT" / "Import CSV" - Live number count updates in real time
- Compose your message in the text box. Use variables like
{name},{date} - Optionally attach a media file (image, PDF, video, etc.)
- Set Min Delay and Max Delay (in seconds) between messages
- Set Batch Size (pause every N messages) and Batch Break duration
- Click ▶ START — TurboSender checks WPP connection, then starts sending
- Watch the real-time progress bar and per-message log (✅/❌ per contact)
- Click ⏹ STOP anytime to abort mid-campaign
👥 Bulk Group Send
- Click the Group Send tab
- Click "Fetch Groups" to load all your WhatsApp groups
- Browse the list — use the search box to filter by group name
- Check the groups you want to send to (or click Select All)
- Click "Use Selected" to populate the group IDs textarea
- Compose your message
- Optional: check "Tag All Members" to @mention everyone in each group
- Optionally attach media
- 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:
Result for Priya with offer=30% OFF:
Custom variable names are set in the Settings tab. Their values come from CSV columns 3 & 4.
📋 CSV Import
CSV Column Format:
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
- In Single Send or Group Send tab, click the "Attach File" button
- Select your file (Image, Video, Audio, PDF, or Document)
- File name appears in preview — click ✕ to remove
- Write your caption text in the message box (optional)
- Click START — media is sent with each message
🗓️ Message Scheduler
- Click the Scheduler tab in the extension panel
- Enter a campaign name (e.g., "Sunday Offer")
- Select type: Single contacts or Groups
- Enter phone numbers / group IDs in the target field
- Compose your message (variables work here too!)
- Pick a future date & time using the datetime picker
- Set per-message delay, then click "Schedule Campaign"
- Campaign appears in the list with status 🟡 Pending
- At the scheduled time, Chrome fires the alarm → campaign starts automatically
- Status updates to 🟢 Running, then ✅ Done
- Chrome notification appears when complete with sent/failed count
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
- Click the Filter tab
- Paste phone numbers in the textarea (or import from TXT)
- Set validation delay (seconds between each check)
- Click ▶ START FILTERING
- Valid numbers appear on the left panel (✅ green)
- Invalid numbers appear on the right panel (❌ red)
- Live counters update in real time
- Click "Export Valid" or "Export Invalid" to download as TXT
🔍 Contact & Group Grabber
Chat List Grabber:
- Go to the Grabber tab
- Click "Grab Contacts"
- TurboSender scans your chat list and extracts all contact numbers
- Numbers auto-download as a TXT file
Group Member Grabber:
- Enter the Group ID in the input field (you can get this from Group Send tab → Fetch Groups)
- Click "Grab Members"
- 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
Ready to Start?
Install TurboSender and start your first campaign in under 2 minutes.