This page covers how to prepare your contacts file, import it into the extension, save your sending results, and clear the table when you’re ready for a new campaign.
Excel File Structure
At minimum, you need one column with phone numbers. The full structure looks like this:
| Column | Purpose | Who fills it |
|---|---|---|
| 1st — Recipient Phone | Digits only, 11–14 characters. Example: 12125551234 | You |
| 2nd — Recipient Name | For message personalization. Can be left empty | You |
| 3rd — Status | Verification or delivery result | Program automatically |
| 4th — Sender Phone | Tracks the account–contact pair; helps reduce ban risk | Program automatically |
| 5th and beyond | Any data for variable substitution in the message template | You |
⚠️ Leave columns 3 and 4 blank — the program fills them automatically. Anything you enter manually will be overwritten.
💡 Column headers in the first row are detected automatically. If there are no headers, the program uses defaults:
{{Phone Number}},{{Name}},{{Status}},{{Sender Phone}}. These names are used in template substitutions.
How to Import a File
- Click “Import Excel” in the extension interface.
- Select your
.xlsxfile on your computer. - The program will validate the structure and populate the table.
Automatic processing on import:
- Duplicate numbers are removed (if enabled in settings; the first entry is kept).
- Empty rows are ignored.
- Numbers with invalid format are skipped with a notification.
Correct number format: digits only, no spaces, parentheses, or hyphens, 11–14 characters long.
- ✅
12125551234 - ❌
+1 (212) 555-12-34
Exporting Results
After sending, click “Export Excel” — you’ll download a file with all recipient numbers, delivery statuses, names, and the sender account number.
If the table is empty — the “Export” button will download a blank template with the correct column headers, so you can fill it in and re-import:
- Click “Export” with an empty table.
- Fill in the downloaded file with your data.
- Upload it back using “Import Excel.”
Auto-Save
All data is stored locally in your browser (Chrome Storage) — only on your computer, never sent to the internet. Data persists through page reloads, closed tabs, and browser restarts. Uninstalling the extension will delete the data along with it.
💡 Pro tip: export your results regularly as a backup, in case the extension is reset or reinstalled.
Clearing the Table
Click “Clear Table” and confirm. All numbers, statuses, and local storage will be erased. The interface will be ready for a fresh import.
Use Cases
Simple broadcast — one column of numbers, the same message to everyone.
Personalized messaging — add a name column and use {{Name}} in your message; each recipient gets a message addressed to them personally.
Handling delivery errors — export after sending, review the status column, fix any bad numbers, and re-import.
Extra data fields — columns 5 and beyond can hold any data (city, product, order amount) and be referenced in your message template as {{column_header}}.