🛠️ Installation Guide
Up & Running in Under 5 Minutes
Follow these steps to install TurboSender, set up WPP.js, connect WhatsApp Web, and send your very first campaign — completely free.
⚙️ Requirements
What You Need First
Google Chrome
Version 90+ required. TurboSender uses Chrome Manifest V3 & Service Workers. Edge (Chromium) also works.
Active WhatsApp Account
Any active WhatsApp number on Android or iPhone. You'll scan a QR code to link with WhatsApp Web.
wpp.min.js File
A single JavaScript file (~10MB) that powers the messaging engine. You'll download it in Step 2.
Contact List (CSV/TXT)
Your customer contacts in CSV or TXT format with phone numbers. For bulk sending only — optional to start.
📋 Steps
Installation Step by Step
1
Download the TurboSender Extension Folder
Download the TurboSender Chrome Extension from the official source. You'll receive a ZIP file containing the extension folder.
- Click the button below to download the extension package
- Extract the ZIP file to a permanent folder on your computer (e.g.,
Documents/TurboSender/) - ⚠️ Do not delete or move this folder after installing — Chrome loads the extension from it
2
Download WPP.js (Messaging Engine)
TurboSender uses WPP.js (whatsapp-web.js) as its WhatsApp messaging engine. This is a standalone JS file you download once and place inside the extension folder.
- Download
wpp.min.jsfrom the official WPP.js GitHub release - Place it in the
libs/subfolder inside your TurboSender extension folder - Path should look like:
TurboSender/TS-Chrome-Extension/libs/wpp.min.js
📂 FOLDER STRUCTURE
TurboSender/
└── TS-Chrome-Extension/
├── manifest.json
├── background.js
├── content.js
├── sidepanel.js
└── libs/
└── wpp.min.js ← place here
3
Open Chrome Extensions Manager
Navigate to Chrome's extension management page to load TurboSender as an unpacked (developer) extension.
- Open a new Chrome tab
- Type in the address bar:
chrome://extensionsand press Enter - In the top-right corner, toggle Developer mode ON
- You'll see new buttons appear: "Load unpacked", "Pack extension", "Update"
Note: Developer mode is required for manually loaded extensions. This is normal and safe for personal use.
4
Load TurboSender as Unpacked Extension
Now tell Chrome where to find the TurboSender extension folder you extracted in Step 1.
- Click "Load unpacked" button (appears after enabling Developer mode)
- In the file picker, navigate to your extracted
TS-Chrome-Extension/folder - Select the folder (not any file inside it) and click Select Folder
- TurboSender should appear in the extensions list with its icon
✅ You should see the TurboSender card in chrome://extensions with a blue on/off toggle.
5
Pin TurboSender to Your Toolbar
Pin the extension to your Chrome toolbar for one-click access to the side panel.
- Click the puzzle piece icon 🧩 in the top-right of Chrome toolbar
- Find TurboSender in the list
- Click the pin icon 📌 next to it
- The TurboSender icon now appears permanently in your toolbar
6
Open WhatsApp Web & Load WPP.js
TurboSender works on top of WhatsApp Web. You need to open it and inject the messaging engine.
- Go to web.whatsapp.com in Chrome
- Scan the QR code with your phone's WhatsApp → link as a device
- After WhatsApp Web loads, click the TurboSender icon in the toolbar
- The side panel opens → click "Load WPP.js" or "Connect"
- Wait ~10 seconds for the engine to initialize
- You'll see a green "✅ Connected" status once ready
⚠️ You must be on the
web.whatsapp.com tab when using TurboSender. Keep the tab active during sending.
7
🎉 Send Your First Message!
You're fully set up! Now let's send your first message.
- In the TurboSender side panel, click Single Send or Bulk Send
- Enter a phone number (with country code, e.g.
919876543210) or import CSV - Type your message — optionally use
{name}or other variables - Set delay to
5seconds (recommended for first test) - Click Send and watch the progress log
💡 Setup Tips & Troubleshooting
Extension shows "Invalid manifest" error
Make sure you selected the
TS-Chrome-Extension/ folder (containing manifest.json), not a parent folder. Also ensure wpp.min.js is present in the libs/ subfolder.Side panel opens but nothing loads
Refresh the WhatsApp Web tab, click the TurboSender icon again, and wait 15 seconds. If the issue persists, try disabling other extensions that might conflict with WhatsApp Web.
WPP.js shows "Connection failed"
Ensure WhatsApp Web is fully loaded (chats visible) before clicking Load/Connect in TurboSender. If your phone disconnects from internet during this, re-scan the QR code.
My WhatsApp account shows "too many messages" warning
Immediately stop sending. Increase delay to 8–12 seconds and reduce batch sizes. Read the Anti-Ban Policy for exact recommended settings.
Can I use TurboSender on Edge browser?
Yes! Microsoft Edge is Chromium-based and follows the same Chrome Extension Manifest V3 standard. The installation steps are identical — just use
edge://extensions instead of chrome://extensions.