Switch unique for single-number setups
Most agencies start with one number per sub-account, and that's exactly the case Switch unique is built for. It's the streamlined version of the regular swap flow, optimized for sub-accounts that hold exactly one paired WhatsApp number.
Overview
A sub-account holding a single number is the most common Wazzap configuration. When you need to swap that number for a different one, the Switch unique action lets you do it in one operation: drop the old pairing, scan the new QR, and the sub-account picks up exactly where it left off.
Everything that lives at the sub-account level (mapping to your CRM, agents, automations, Spintax globals, webhooks, chat threads) is preserved. Only the underlying WhatsApp account changes.
If your sub-account is hosting more than one number (multi-line setup), use Switch numbers instead, which exposes the per-number selector.
How it differs from regular switch
- One paired number assumption. The flow skips the "pick which number to replace" step, because there's only one.
- Single button. A single "Switch" CTA in the sub-account dashboard replaces the multi-step picker.
- Faster recovery. Built for the most common emergency: my one number got banned, I need to be live again in 60 seconds with the warmed replacement.
When to use it
- The sub-account hosts one WhatsApp number.
- The current number is banned, burned, or being retired.
- You have the replacement phone warmed and ready to scan.
- You want to keep all CRM threads, agents, and automations intact.
Step-by-step procedure
- Open the Sub-account dashboard in Wazzap.
- On the sub-account tile, click the Switch button next to the current number.
- Confirm the replacement. The current pairing is released and a fresh QR is generated.
- On the new phone, open WhatsApp → Settings → Linked Devices → Link a Device and scan the QR.
- The tile flips to "Online". You're live again on the new number with all sub-account configuration intact.
The new number must be warmed before scanning. Brand-new SIMs scanned the same day they were registered are the fastest way to hit Meta's anti-spam on day one. See number warming first.
Edge cases
Voice channel attached to the sub-account
If the sub-account also has a voice channel (ElevenLabs, Twilio voice, an AI assistant doing calls), use Switch voice unique instead, which handles the voice-side reconfig together with the WhatsApp swap so the two stay in sync.
The old number is still online
Switch unique releases the old pairing automatically as part of the flow. You don't have to log out from WhatsApp → Linked Devices on the old phone first. After the swap, the old phone will simply show "Logged out from this device" the next time it goes online.
You change your mind mid-swap
If you released the old pairing but haven't scanned the new QR yet, you can re-pair the old number by scanning it again on the same QR screen. The sub-account doesn't care which number you bring back as long as the QR is scanned within the session window.
Troubleshooting
"Switch unique" not visible
Your sub-account is configured with more than one number. The dashboard switches to the multi-number picker. Use the general Switch numbers flow.
New QR scans, dashboard stays "Pairing"
The new phone scanned but didn't authenticate. Common cause: WhatsApp on the new phone is on an old version. Update the WhatsApp app, generate a new QR, and re-scan.
Old number reappears after a refresh
The pairing release wasn't acknowledged by WhatsApp's side yet, the dashboard is caching the old state. Hard-refresh and the swap result will load correctly.
For sub-accounts that aren't single-number, the broader Switch numbers flow gives you per-number control. For voice + WhatsApp combined, Switch voice unique is the right move.