Connect WhatsApp
Loopwave connects to WhatsApp as a linked device — the same mechanism WhatsApp Web and WhatsApp Desktop use. You scan a QR code once, and Loopwave stays connected until you unlink it.
Link a number
- Open Numbers and add a number
In the dashboard, go to Numbers and choose Add number. Optionally give it a label (for example, “Sales” or “Support”) so your team can tell numbers apart.
- Scan the QR code
Loopwave displays a QR code. On the phone holding that number, open WhatsApp → Settings → Linked Devices → Link a Device, then scan the code.
- Wait for Ready
The status moves through
starting→qr→connecting→ready. Once it shows Ready, the number is live. - Let history sync
After connecting, Loopwave pulls recent chat history in the background (several rounds over the first couple of minutes). Older conversations fill in as it syncs.
Keep the phone online with a working internet connection. Linked devices rely on the phone being reachable periodically, exactly like WhatsApp Web.
Connection states
| Status | Meaning |
|---|---|
starting | The session is being created. |
qr | A QR code is ready to scan. |
connecting | The code was scanned; the link is being established. |
ready | Connected and able to send and receive. |
disconnected | Temporarily dropped — Loopwave auto-reconnects. |
logged_out | The device was unlinked from the phone; re-scan to reconnect. |
If a number drops, Loopwave automatically tries to reconnect. If you see
logged_out, the link was removed from the phone side (or from WhatsApp’s Linked
Devices list) and you need to scan a fresh QR code.
Link more numbers
Loopwave is multi-number from the ground up. Repeat the steps above to add as many numbers as your plan allows; each runs as its own independent connection and appears in the unified inbox.
Pull older history on demand
If a re-link didn’t bring in enough history, you can request an on-demand backfill for a number. Loopwave fetches a batch of older messages (up to 200) from before the oldest message it currently has stored.
Rename or unlink a number
- Rename: change a number’s label any time from the Numbers screen.
- Unlink: removing a number logs it out and deletes its stored credentials. The conversations already synced to your database stay; the live connection ends.
Unlinking deletes the connection credentials for that number. To reconnect it later you will scan a fresh QR code.
Naming and identity
Loopwave resolves the best available display name for each contact and group — preferring a saved contact name, then a verified business name, then the WhatsApp push name. It also merges a contact’s anonymous and phone-based identifiers so the same person never shows up as two separate chats.
Next: keep your number safe→Read the outreach best practices before messaging at volume.