Skip to content

WhatsApp Setup ​

At a glance ​

LocationSettings → WhatsApp → Health
PlanAll plans, including the free tier
Related features4
computer silentrouter powered onself disconnectnetwork blocking qrinternet filter

Connect your WhatsApp number to Spun by scanning a QR code; this is the first step to using the inbox. A new account does not need to install anything first.

Confirming your connection country ​

The connect screen opens with We'll connect it from: and a country picked from where you are signing in, with the hint "This should be the country where you normally use WhatsApp." (and "Using a VPN? Pick the country where you normally use WhatsApp."). Press Continue to QR to accept it, or Change to search for another country.

On the first days you sign in to a new account that has never linked WhatsApp (3 different days by default), the connect screen can skip this step and open straight on the QR with that country already confirmed: the line above the code reads "Connecting from [country] via the Spun connection" (or via a Spun connection) with one Change Connection button, so you can still pick another country before you scan.

On a re-link or retry QR screen the same pill carries the status, for example "Connecting from [country] · Active · Change". An account that never linked keeps the Connect your WhatsApp title after a dropped first attempt; Reconnect your WhatsApp is for an account that linked before.

This happens only in a computer browser on a home or office internet line, for a country Spun can connect from that matches any country already saved for the account, and while connections from that country are not paused; in every other case the screen starts at the country step as above.

On a phone it opens on the One more step to connect step instead, because the code has to appear on another screen. After those first days the connect screen no longer opens by itself; the connect card in the empty inbox and Connect WhatsApp in the banner still work.

If the country picked under Change differs from the country you are signing in from (and you are not on a VPN), Spun asks once before saving it: "Your phone appears to be in [country]", with Keep [country] or Connect from [picked country].

How Spun connects from your country ​

Spun then connects your WhatsApp from that country in one of three ways, and the screens name which one. (1) A Spun connection in [country]: used when Spun has its own connection in that country.

The wait screen says "Your channel is being connected from [country], so WhatsApp sees you where you are." (usually under 5 minutes), and on a first connection the QR screen shows "Connecting from [country], where your phone is · Change Connection".

(2) A Spun connection set up for your country: used when Spun has no standing connection of its own in that country yet. The wait screen says "Your connection is being set up in [country]", and on a first connection the QR screen shows the same "Connecting from [country], where your phone is · Change Connection".

(3) Your own computer (Self Proxy): never the default, and always one tap away. The · Change Connection link next to the country lets you fix the country before you scan; after linking, the country is shown for information only ("Country is set when you connect.") and cannot be edited on that screen.

Spun never shows a QR over a plain server connection: if no Spun connection can be set up, you get a clear message instead of a QR. Before a QR is shown, Spun checks that the code really goes through the connection your account should use.

If it cannot confirm that, no QR is shown: the screen says "We could not confirm your connection yet" (try again in a few minutes) or We could not confirm your connection with a way to contact support. Some networks and internet filters stop the request for the code before it reaches Spun.

Spun then tries a second way to fetch the code by itself, and if that is blocked too, the screen says "This network is blocking the QR code from loading. Open web.spun.com on a computer and scan the code shown there, or switch to another network and tap Try again." Media (photos, videos, voice notes, documents) is transferred between Spun's WhatsApp gateway and WhatsApp directly: only the WhatsApp session itself travels through the Spun connection or your computer.

If Spun cannot connect from the chosen country yet, the screen says "We can't connect from this country just yet" and "You can still connect using your own computer.", with Use my computer (Self Proxy), Contact us and Choose another country.

QR screen and after the scan ​

On a first connection the QR screen shows three steps without asking which phone you have: Open WhatsApp on your phone, then iPhone: tap Settings and Android: tap the ⋮ menu together as the second step, and "Tap Linked devices, then Link a device, and scan this code".

When you signed up on a phone, or opened the code on a computer from a link your phone shared, the screen already knows that phone and shows only its own steps (on an iPhone, Settings, Linked devices, Link a device; on Android, the ⋮ menu, Linked devices, Link a device), with Show me opening a picture of the Linked devices screen for that phone.

On a computer the code and these steps sit side by side.

Under them two short lines say: "Your WhatsApp keeps working on your phone." and "Spun shows under Linked devices as a browser. Tap it, then Log out, to disconnect." Under those, "What access am I giving Spun?" opens a short explanation of what a linked Spun receives and stores, which AI features run on message content, who in the workspace sees the conversations, and what disconnecting does, with a link to the security page (How Spun handles your data).

No welcome spin pops up over the connect screen while a code is on it; it waits until after the connect screen closes (for the account's manager it then sits under the code on the welcome page, described below).

If you close or skip the code before linking, Spun may ask once "What stopped you from connecting?" in a small corner card; answering is optional.

Self Proxy is offered as an option in one light line below:

  • "Want a connection only you use? You can run it from your own computer or a Spun Box later." with Learn more about Self Proxy, which opens a small Self Proxy box under that line explaining that Self Proxy runs your WhatsApp connection from your own internet line, the same address every day, used only by you
  • That it is optional
  • That you can scan now and switch any time in Settings, under WhatsApp

It then lists Two ways to run it:: "From your computer: a small program you install." with the Use my computer button, and "From a Spun Box: a small router in your office, so nothing depends on a computer staying on. Details in Settings, under WhatsApp." Someone who already chose their own computer, or whose number ran through a computer before, sees the earlier wording, including a line under the QR naming what the code connects through.

The code refreshes by itself while it is open, and Code refreshed shows under it for a moment when it does.

After the scan, the screen says "Connected. Your WhatsApp is syncing.":

  • New messages, chats and history are there right away, profile photos and contact names load gradually over the next day (see Link Sync), and Open inbox works at once
  • On a Spun connection set up for your country it adds "You're on a Spun connection. We'll remind you to move it to your computer or a Spun Box once your chats have synced." Every new scan (a first link or a re-scan) copies recent history too, on every plan: up to 200 messages per chat, newest chats first, within the plan's history window
  • Once a very large account passes 50,000 copied messages, the remaining older chats get 25 each

An organization-set history depth or per-chat message limit still applies. A reconnect without a new scan only fills the gap since the disconnect, and Deep sync (paid) goes back up to 500 messages per chat. In these answers the managed connection means either kind of Spun connection.

The country you confirm is saved as your connection country, and Spun keeps checking that a Spun connection set up for your country really leaves from that country; if a check fails, new connections are paused while the team looks into it, so a QR may briefly be unavailable.

Moving to Self Proxy ​

Self Proxy, which runs the connection from your own Windows or Mac computer, or from a Spun Box (a router you buy yourself), on your own internet line, is optional and is the most stable setup: account admins see a Run your connection from your computer card on the Health tab ("You're connected through a Spun connection in [country]..." or "You're connected through a Spun connection in [country]. For everyday use, switch to one that runs from your own computer..."), and Settings → WhatsApp shows a Current connection card (Spun connection in [country] or "A Spun connection in [country]. For everyday use, move it to your computer or a Spun Box." with Set it up).

On a Spun connection, once your first chats have synced, a banner appears once at the top of the inbox: "Your WhatsApp is on a shared Spun connection. For the most stable setup, move it to your own computer or a Spun Box." with Set it up and Later (Later hides it for good; the Settings card stays).

For managers whose approved computer is already online and ready while WhatsApp still runs on a Spun connection, the banner instead reads Your computer [name] is ready ("WhatsApp still runs on a Spun connection. Switch it to your own computer for the most stable setup.") with Switch now (or Open settings when the switch needs its own confirmation there) and Not now, which hides it for 7 days.

Moving to your own computer is a one-way, deliberate switch: Spun never moves a line back to a Spun connection by itself, and never switches between one Spun connection and another. Switching briefly pauses the WhatsApp connection and in rare cases WhatsApp asks you to scan the code again.

From a Spun connection set up for your country the switch is available now; from a standing Spun connection the Your computer is ready sheet shows Switch now once Spun has switched that step on, and Coming soon until then, while the installed computer waits on standby.

Organisations already on Self Proxy stay on Self Proxy, and Spun never moves them to the managed connection by itself. If you choose Self Proxy on a phone or tablet, the screen says "This step needs a Windows or Mac computer" and offers Email me the link or Copy link so you can carry on at the computer.

Skipping and the welcome page ​

You can also skip WhatsApp for now (Skip for now) and use meetings and Spun Chat, then connect a number later from Settings. Until a number is linked, closing the connect screen does not lose the code.

For the account's manager (not when a Spun admin is viewing the account, and not after Skip for now), the inbox opens on a welcome page instead of Spun Concierge, which stays one click away at the top of the chat list.

From top to bottom the welcome page shows:

  • The "What stopped you from connecting?" question as a row of short answers (only after a code was closed without linking)
  • The code card with the country line, Change settings and the WhatsApp steps
  • Three short cards under "What you get once WhatsApp is linked": Your voice notes arrive as text, Every chat gets a summary and "Replies drafted for you, you tap send", each with one line, a still picture where there is one, and Scan the code above (scrolls back up to the code), and More opens a fourth card, Ask Weave what happened today
  • For an account that signed up from the Spun page about AI assistants, or that already has an API key or an AI assistant connection, the first card is "Ask Claude or ChatGPT about your customers" ("Paste one URL, sign in with Spun (org managers only), and ask. 100 calls a month on the trial.") and "Replies drafted for you, you tap send" moves under More
  • Then the welcome spin card (while it is scrolled out of view, a Spin to win button floats at the bottom of the page and takes you back to it)

Welcome page videos and behavior ​

Some accounts see, in place of the three cards, "[number] reasons to connect your WhatsApp today" ("Scan the code above and try them with your own chats.", or on a phone "Open the code on another screen and try them with your own chats."), a column of short silent videos of Spun features grouped under headings in this order: Teamwork, AI, Automations, Insights, WhatsApp, Messaging, Integrations, Plans, Security.

Each video has a one-line caption, Play with sound (a narrated version; only one video plays at a time and a video stops when scrolled away), Try it on most cards (opens that feature) and Scan the code above (scrolls back up to the code).

Tapping a video, or its expand button, opens it large with sound and the player controls: full screen on a phone, a large window on a computer; every other video pauses, and X, Esc or Back closes it at the same place in the list.

On a computer the welcome page fills the conversation area whenever no conversation is open, and the chat list shows only a Connect WhatsApp line; clicking that line closes the open chat and brings the welcome page back at the code. On a phone the chat list holds the same page, with the copy-and-share step in place of the code.

For the manager the welcome spin no longer pops up after login; Your saved spin in the menu brings the welcome page back at the spin card. On a data-saving connection, with reduced motion turned on, or on a network that blocks the video player, the videos show as still pictures with their captions.

While a first code is still being prepared, the connect screen offers "While your code gets ready, see what you can do", which closes it and opens the welcome page at the cards (or the videos); the code stays at the top of the page and Your code is ready still says when it is ready.

After five minutes without a scan the code pauses with Tap to refresh the code, and a tap brings a fresh one. Once the number links, the welcome page goes away.

In a session that showed it, the conversation area then shows "[number] things to try with your chats" with the same videos while the chats sync, once per account and never together with the plan choice page or the next-step card; X closes it.

After Skip for now the empty inbox shows a one-line Connect WhatsApp link instead for the rest of the session.

Phone linking and code alerts ​

If you are on your phone and have no second screen to scan from, use the Share to Friend tab on the reconnect screen: press Generate Share Link, open the link on another phone, tablet or computer, enter the passcode shown, and scan the QR that appears there.

On a phone, the connect screen is One more step to connect: WhatsApp lives on that phone, so the code must appear on another screen, and the screen offers three ways to carry the link over, Email me the link first, then Copy link and "Share...", for a link that stays valid for 15 minutes.

Email me the link sends the same link to the email address of the account in one tap (in your language, with the English under it, through the same setup emails Spun already sends), and the line under the buttons confirms "Sent to s***@gmail.com, open it on a computer or a second phone"; it can be sent once every 10 minutes, and after a manual send Spun holds back its own open the link on another device reminder for a day so nobody gets two.

The line under the buttons says what is true right now:

  • Nothing happens on this phone until the link is open elsewhere
  • Link copied or Link sent with what to do next
  • The link is open on the other screen. Your code is being prepared: a first connection can take a minute or two
  • "Your code is showing on the other screen. Scan it with WhatsApp on this phone, using the steps below." with this phone's own steps and the same linked-device card, and the phone buzzes briefly when the code appears
  • Or, if the link was opened on the same phone, a warning that WhatsApp cannot scan a code on its own screen, with the advice to send the link to a friend's phone or open it on a computer

"No computer nearby?" on that screen explains that any phone with a browser works: send the link to a friend or family member on WhatsApp, they open it, and you scan the code on their screen with WhatsApp on your phone (they see no account details). Still stuck? Contact us under it opens a support message.

The page the link opens shows the QR with the three WhatsApp steps; opened in a phone browser it warns that WhatsApp on that phone cannot scan it, and while the code is still being prepared it says so after 45 seconds and again after 3 minutes instead of a bare spinner.

If you switch to another tab or close the connect screen while the code is being prepared, Spun tells you when it is ready: the browser tab title starts with Code ready, and if the connect screen was closed a message Your code is ready appears in the inbox with Show code, which opens it again.

On a Free MCP account, a scanned number that is already on another Free account is not linked: the screen says "This number is already on a Free account" ("Each WhatsApp number can be on one Free account.") with Use another number and Write to us.

When a scan or line fails ​

If a scan is refused (your phone links and WhatsApp drops it moments later), the QR screen says "The connection did not finish. Scan the new code to link again." After a second drop it adds "Two scans did not hold. Your own computer usually fixes this." above the Self Proxy explanation, opened, with Use my computer, which is the usual fix.

When a connected line stops working, Spun never swaps the channel behind your back: the reconnect screen diagnoses the cause first and shows the matching step, whether your proxy computer is offline (turn it on and WhatsApp resumes by itself), your computer is online but its tunnel is down (restart the Spun Proxy service on it; reloading the channel will not help), Spun has not heard from your computer since a time it shows (check that the computer is turned on and connected to the internet; for a Spun Box, check that the router is powered on and its internet cable is plugged in), WhatsApp is paused because the computer appears outside your protected country (turn off the VPN or proxy on it; there is nothing to scan or replace), the computer's network or internet filter blocks WhatsApp (the screen says so and can offer the Spun connection instead, see Self Proxy), Spun is switching you to another computer (keep the page open), WhatsApp is no longer linked to this device, the connection no longer exists and must be set up again, or the cause is unclear (reload the connection, which keeps your number).

The reconnect screen never offers to replace the channel. If none of its steps helps, Contact support opens a Human Support ticket and the team takes it from there.

Relinking, country changes and banned numbers ​

Linking again after a disconnection keeps your setup: the screen shows Your WhatsApp connects from: with the country from your first connection and "This should be the country your phone is in now. If you moved, change it before you scan." Continue to QR links again on the same connection.

Change opens the country list; after picking the new country the manager types its name and a short reason to confirm, Spun moves the connection to that country, and the QR follows on the same connection. The country can only change while WhatsApp is waiting for a new scan, never while it is connected.

Account admins on the managed connection see the current country in the Connection Region section of Settings → WhatsApp → Health: WhatsApp connects from [country], a line saying what carries it (a Spun connection or your internet provider), "This is the country WhatsApp sees. It should be the country your phone is in." and a Change country button.

The button opens the reconnect screen only while WhatsApp is waiting for a scan; while WhatsApp is connected it is unavailable and the section says "To change it, disconnect WhatsApp first. You pick the new country when you scan the code again." If your computer is no longer set up to run the connection, the screen says so and offers Continue to QR through a Spun connection in the country shown, or Set up a computer.

If your organisation uses Self Proxy and every Self Proxy computer is offline, WhatsApp waits until one comes back; Spun does not switch it to the managed connection by itself.

If WhatsApp has banned the number, the screen opens with Once WhatsApp has restored your number and the My number is restored - reconnect button, with WhatsApp's own recovery steps below under If your number is still blocked (a number that is still blocked cannot be connected); once the number is restored, that button links it again: it asks whether WhatsApp works on the phone again, then offers reconnect from my own computer (recommended, opens the Self Proxy install step) or reconnect through the Spun connection (a shared address, with a note that this carries more risk for a number that was just blocked); a number that was blocked while on Self Proxy gets a single reconnect button.

Next-step prompts for new managers ​

A manager who signed up from the Spun page about connecting ChatGPT or Claude (MCP), or the page about sharing WhatsApp with a team, sees one line above the QR steps: "Step 1 of 2: link your WhatsApp" and what comes next.

After the first link a small card in the corner of the inbox offers that next step: the MCP link (https://api.spun.com/api/mcp) with a Copy button, the short steps to add it in Claude or ChatGPT and the full guide, or an Invite your team button that opens the team sharing wizard.

The card waits until the plan choice page is answered and never covers it; it closes for good once the organization's first MCP call arrives or the first teammate is invited, or when it is closed with X. Invited team members and additional lines never see the line or the card.

Connection status, iPhone and extra lines ​

The connection banner at the top of the inbox says WhatsApp not connected yet before your first connection and WhatsApp disconnected afterwards, and has a gear icon for connection settings and a Connect WhatsApp or Reconnect WhatsApp action.

In the iPhone and Android apps, before the first connection, the banner reads "To connect WhatsApp, open Spun on a computer." with a Send me the link button that opens the same connect screen: the connect code has to appear on another screen, and a person with no other screen can still use "No computer nearby?" there.

A person the inbox is shared with (a sharee) never links or reconnects its number, whatever their role: they get no connect screen, QR code, share link or pairing code for it, and while the line is disconnected their banner reads "WhatsApp is disconnected. Only the account owner can reconnect it." When the network of your Self Proxy computer blocks WhatsApp, the banner shows a red Network blocks WhatsApp, click to change chip that opens that problem screen.

An account created in the iPhone app connects WhatsApp from the web login; the iPhone app itself has no connect screen. Additional WhatsApp numbers can be added as extra lines.

The Settings → WhatsApp → Health tab shows connection status and hosts the Self Proxy card, or, for admins on the managed connection, the Run your connection from your computer card.

If WhatsApp unlinks the device within the first hour after a first link (the phone shows the linked device gone), the connect screen shows a new QR code on the same connection with the line "WhatsApp unlinked the connection. This happens often on a first link - please scan once more."; one such retry is offered per day.

A disconnect you start yourself, for example Disconnect now & show new QR in Settings → WhatsApp → Data, is not counted as WhatsApp unlinking the device and does not use up that retry.

After a second unlink on the same day the screen says "WhatsApp unlinked the connection twice. Wait a little, then connect from your own computer (Self Proxy), or try again tomorrow." with a button to connect from your own computer, and no code is shown until the next day.

When a line drops, Spun emails the account: the first email explains that the line can be made to hold, with Self Proxy on a Windows or Mac computer or a Spun Box with no computer, and keeps rescanning as the quick way back.

When the account's first link held for less than 24 hours, the email about 6 hours after the drop is a personal letter from the founder instead of the usual reminder, once per account: it explains that WhatsApp often cuts a newly linked device in the first hours, that nothing is wrong with the account, the same two ways to make it hold and the rescan, and you can reply to it to say what you are trying to do and where it stopped.

Inside the app the same two ways are named where you are. Under the WhatsApp unlinked the connection line the connect screen adds "To stay connected, run the connection from your own computer or a Spun Box.", with Use my computer and a Spun Box guide link (not shown when the line already runs through your own computer).

When your first link held for less than 24 hours and the line is now disconnected, the banner at the top of the inbox shows Make it hold first, which opens Settings → WhatsApp where the Self Proxy card is, with Reconnect WhatsApp second; only account managers see it, and not when the line already uses Self Proxy.

Pairing code with a phone number ​

If you are on your phone and have no other screen at all, "No computer nearby?" on that step also offers Link with a phone number instead: Spun first prepares your connection exactly as it does for the QR, then the screen shows the steps in WhatsApp first (Linked devices, Link a device, Link with phone number instead), because the code works for about a minute: find that screen in WhatsApp, come back, enter your WhatsApp number, press Get pairing code and type the 8-digit code into WhatsApp.

Scanning the QR from another screen is the more reliable way, so the screen names the code as a last resort. Getting the code can take up to 30 seconds, because Spun first makes sure the connection has enough time left for you to type the code.

The screen shows no countdown; after about a minute it says the code has probably expired and Get a new code becomes the main button, which you tap to get another, and Use the QR code instead goes back.

The screen replaces a code by itself in one case only: when the connection behind the code reset before the code could be used, it shows a new code with the note "The previous code expired before it could be used. Here is a new one." It does this at most twice in a row, then marks the code as expired and leaves Get a new code to you.

On the QR screen of a phone the same option is a small line under the code: "No other screen? Link with a phone number instead".

How to use ​

  1. Go to Settings → WhatsApp → Health, or follow the connect screen shown on first login.

  2. Check the country under We'll connect it from: (press Change if it is not the country where you normally use WhatsApp), then press Continue to QR. If you prefer to run the connection from your own computer, press Learn more about Self Proxy on the Self Proxy line under the QR, choose Use my computer and install Self Proxy.

  3. Follow the steps beside the code: open WhatsApp on your phone; on an iPhone tap Settings, on Android tap the ⋮ menu; then tap Linked devices, then Link a device, and scan the QR code. Linking does not log you out of WhatsApp on your phone.

  4. Wait for the green Connected status.

    Once the history sync finishes, the welcome screen shows up to three cards built from your own data (how many voice notes arrived as text, how many chats synced with the busiest one summarized, how many people are waiting for a reply); tap a card to open that voice note, that chat with its summary, or the Awaiting reply filter.

    A card with a count of zero is not shown.

  5. If the line later stops working, open the reconnect screen, read the diagnosis, and take the step it offers (turn your proxy computer on, restart its proxy service, turn off a VPN, re-scan or reload), or press Contact support.

  6. To move later to a connection that runs from your own computer, an admin uses Set it up on the Run your connection from your computer card in Settings → WhatsApp → Health. The same connection can also run from a Spun Box.

  7. On a phone with no other screen at all, open "No computer nearby?" on the connect step and tap Link with a phone number instead: first open the code screen in WhatsApp (Linked devices, Link a device, Link with phone number instead), then come back, enter your WhatsApp number, press Get pairing code and type the code into WhatsApp within about a minute.

    If the code has expired, tap Get a new code. Scanning the QR from another screen is the more reliable path, so use the code only when there is no other screen.

FAQ ​

  • How do I connect my WhatsApp?
  • My QR code is not working
  • How to reconnect WhatsApp
  • Why does my WhatsApp keep disconnecting?
  • How do I scan the QR without a computer?
  • Can Spun email me the connect link?
  • Do I need to install anything to connect WhatsApp?
  • Why does Spun ask which country I use WhatsApp from?
  • What if Spun cannot connect from my country?
  • Why is my WhatsApp paused?
  • What is a Spun connection?
  • Can I change my connection country after linking?
  • Do my photos and videos go through my connection?
  • Why is there no button to replace my channel?
  • Why is the QR code not shown?
  • What does "This QR connects through" mean?
  • Why does Spun say my computer is no longer set up to run the connection?
  • Why does the banner say my network blocks WhatsApp?
  • Where do I see which country my WhatsApp connects from?
  • Why did the QR code open by itself when I signed in?
  • Where did my QR code go?
  • Why is Spun Concierge not open when I sign in?
  • What are the videos under my QR code?
  • How do I watch a feature video full screen?
  • I pressed disconnect myself - does that use up my retry?
  • Why does the connect screen say Spun has not heard from my computer?
  • Why can I not reconnect WhatsApp in an inbox that was shared with me?
  • Why does the QR screen say this network is blocking the QR code?
Was this page helpful?

Spun Docs - the documentation for Spun, the WhatsApp team inbox by Spun Life LLC.