SendWave User Guideدليل مستخدم SendWave

1. Run SendWave-Setup-1.0.x.exe and follow the wizard (Next → choose folder → Install → Finish). Shortcuts are added to the Desktop and Start menu.
2. The first time you open SendWave it shows an Activation screen with your Machine ID (for example FB67-ECEE-F96D-AA3A). Press Copy and send it to your vendor.
3. You receive a licence key (a long text starting with SW1.). Paste the whole key into the box and press Activate.

Requirements: Windows 10/11, an internet connection, and Google Chrome or Microsoft Edge installed (used in the background for WhatsApp Web mode).

1. Open Dashboard. Wait up to a minute: a QR code appears.
2. On your phone open WhatsApp → Settings → Linked Devices → Link a Device and scan the code.
3. The dashboard shows your number as Connected. Your login is saved, so you do not scan again unless you log out.

• Stop / Reconnect in the top bar: stop the connection or restart it. Use Reconnect first if WhatsApp seems stuck, and wait about 90 seconds.
• Logout & Clear Session: unlink the number so you can scan a different phone. One number is linked at a time per installation.
• Menu Reconnect with visible browser (for troubleshooting): shows the browser window WhatsApp runs in.

Reading the dashboard

• Linked WhatsApp Accounts: your connected number with a Health score (/100), Age (hours since linked), Sent today and Failed (with the failure rate). A new number shows a warning to keep volume low.
• Tiles: total messages sent, groups, saved contacts, AI responses.
• Recent sessions: your latest sends with their status. View all opens Sessions.

1. Recipients – choose one way:
   • Manual Input: one contact per line: number, name, var1, var2, var3. Local numbers get the default country code (Anti-Ban settings).
   • Upload File: CSV or Excel with the same columns. Use Download template for a sample.
   • Google Sheets: paste the sheet link, press Load contacts. In Google Sheets: Share → General access → Anyone with the link → Viewer. Row 1 must be the headers (number, name, var1, var2, var3). Each tab has its own link (the gid= at the end). Private sheets are not supported.
   Invalid numbers, duplicates and opted-out contacts are removed or flagged automatically.
2. Message – write the text. Use {{name}} {{var1}} {{var2}} {{var3}} to personalise. Add up to 5 variants with + Add variant; with Rotate messages on, each contact gets the next variant (this makes messages look less identical).
3. Optional: attach a file (see Bulk Sender → Attachments), name the session, set the delay.
4. Press Send Messages. Progress and the Activity Log update live; use Pause, Resume or Stop at any time.

Attachments: allowed files and size limits

One attachment per message; the message text is sent as its caption. Press Attach Image (also in Group Blast).

Other file types, or files over the limit, are rejected with a message. Compress large photos and videos before sending. Large files are sent slowly to many people — keep campaigns light.

Open Scheduler, enter the recipients (one per line: +number, name), the message(s), and the send date & time, then press Add to Queue. At the time, SendWave starts a normal session using your Anti-Ban pacing; each run is saved in Sessions. Use Run now to start an item early.

Every send is saved as a session: recipients, messages, per-contact results (sent, failed, not on WhatsApp, replied). Open Sessions to search, filter, pin (pinned sessions are never deleted) or export results to CSV.

• Reuse: load a session's audience and messages into Bulk Sender to edit and send again.
• Resend: choose who should receive it — failed only, everything not delivered, delivered with no reply, everyone, or selected rows. Resends follow your rules (skip people who replied, skip opted-out, optional 50% slower pacing, cool-down).
• Settings (Anti-Ban & Resend) control how long sessions are kept: 30 days, 90 days, 1 year or forever.

Send one message to several of your WhatsApp groups. (QR mode only.)

1. Open Groups. Your groups load automatically (press Refresh list if you joined new ones). Use the search box to find a group.
2. Tick the groups, or Select All.
3. Write the message in the box; optionally attach an image or file (see Bulk Sender → Attachments).
4. Press Send to Selected. The send is saved in Sessions, so you can resend to groups that missed it.

• Rules (no AI cost): add keywords and an automatic reply. Match types: contains, exact, starts with. Rules are checked first. Test a sample message in the test box.
• AI replies (optional): in AI Config enter your own AI provider API key (stored only on this PC), choose a model and a system prompt (how the bot should behave), and choose the mode: Rules Only, Rules then AI or AI Only. AI usage is billed by your provider.
• Tick the account(s) the bot should answer on, then press Start chatbot. Stop it any time with Stop Bot.
• STOP: if a contact replies STOP, they are added to the opt-out list automatically and skipped in future sends. Manage the list in settings.

Check which numbers are really on WhatsApp before a campaign, so you do not waste sends or raise your failure rate.

1. Open Validator and paste the numbers, one per line (with country code, or local numbers get the default code).
2. Choose the account and the delay between checks (slower is gentler).
3. Press Validate Numbers. The counters show Total, Valid and Invalid live.
4. Press Download CSV to export, or Use valid numbers in Bulk Sender to load only the valid ones straight into a new send.

Extract contacts from your WhatsApp Business labels (for example “Customers”, “Leads”). (WhatsApp Business account, QR mode only.)

1. Open Label Export. Your labels appear with the number of chats in each; press Refresh Labels after changes. Standard WhatsApp accounts have no labels.
2. Tick one or more labels.
3. Optional: Fetch Contact Names and Remove Duplicates.
4. Press Extract Contacts, then download the CSV (Export from Labels) or send straight to Bulk Sender.

Back up conversations from your own WhatsApp account. (QR mode only.)

1. Open Chat Export. Your chats are listed with their message counts. Tick the ones you want, or Select All.
2. Choose the format: TXT (readable), CSV (for spreadsheets) or JSON (for developers). Optionally Include media file names.
3. Press Export chat(s) and save the file.

This page chooses how SendWave talks to WhatsApp: QR code (WhatsApp Web) – scan once with your phone (see Dashboard) – or the Official WhatsApp Cloud API described below. Press Save & connect after changing the mode.

Choose Official WhatsApp Cloud API. This uses Meta's own service: stable and much safer for opted-in contacts, but it has rules of its own.

1. Create a Meta Business account and a WhatsApp Business app in Meta for Developers; add and verify your number.
2. Copy the Phone number ID and the WhatsApp Business Account ID. Create a permanent System User token with the WhatsApp permissions.
3. Paste them on this page and press Save & connect. The dashboard shows your business number when connected.
4. Create message templates in WhatsApp Manager and wait for approval. In Bulk Sender / Scheduler pick the template and map {{1}}, {{2}} to name or var1–var3.

• The first message to a customer must be an approved template; free text works only within 24 hours after the customer last wrote to you.
• Replies, STOP and delivery status need a public webhook: this page shows the path (/webhook) and a verify token. SendWave runs on your PC only, so you need a secure public address (a tunnel or a server) — ask your vendor to help.
• Not available in this mode: groups, labels and chat export. Image limit is 5 MB.
• Meta charges per conversation/template according to its price list.

In Anti-Ban & Resend choose a profile: Conservative (safest, slowest), Moderate (recommended) or Aggressive, or set your own values: random delay between messages, maximum messages per hour and per day, sending hours (e.g. 9:00–21:00), typing indicator, and automatic pause (a session pauses itself after repeated failures or when a limit is reached, and resumes by itself when the limit or hours allow).

Rules that protect your number

• Message only people who agreed to receive your messages (tick the opt-in confirmation when asked). Always honour STOP.
• Start new numbers slowly: a few dozen a day, increasing over weeks. A brand-new number sending hundreds is the quickest way to be restricted.
• Vary the text (use variants and {{name}}); avoid identical messages with links to everyone.
• Use a business number you can afford to lose, or use the Official API mode for critical numbers.
• Many failures or "not on WhatsApp" results usually mean a bad list — clean it with the Validator.

The two tabs

• Anti-Ban: safety profile, random delay, hourly and daily limits, sending hours, typing indicator and auto-pause (shown above).
• Sessions & Resend: whether every send is saved, how long sessions are kept, the default resend target, who can receive a resend (skip people who replied, skip numbers not on WhatsApp, skip opted-out, require opt-in confirmation, slower resends) and the opt-out list (numbers that replied STOP; you can add or remove numbers).

• Update button (top bar): checks for a new version and installs it. WhatsApp changes often; keep SendWave updated. If updates are not set up in your copy, ask your vendor for the latest installer.
• Language: use the language menu in the top bar (English / العربية). The choice is remembered.
• Your data (sessions, settings, WhatsApp login, saved keys) is stored on your PC in %APPDATA%\wa-sender\data (menu → Open data / log folder). It stays when you uninstall. Copy the folder to back it up. Anyone with this folder can use your WhatsApp login, so keep it private.
• Licence: menu → Licence shows the holder and expiry. Send your vendor the new Machine ID when changing computers.

When you write, please include: your Machine ID, the SendWave version (shown under the logo in the side menu), a short description with a screenshot, and the wa.log file for connection problems (menu → Open data / log folder).