Start here
Connect a WhatsApp number
Give your agent a WhatsApp number: where the button is, the QR code or the code to type, the 30 minutes that follow and what to do if it disconnects.
Your agent writes and answers from a real WhatsApp number. You connect that number on the agent itself, in a window that shows a code to scan with the phone of the number. This page covers the connection. The WhatsApp numbers page covers everything else about a number.
What you need before connecting a number
Section titled “What you need before connecting a number”Before you open Agents to connect a number, check these 4 points.
- An agent. A number is always connected to an agent. See Create your first agent.
- A plan. On the free plan you create your agent and test it, and a plan connects it to a WhatsApp number. Without a plan, WhatsApp numbers is locked in the menu and opens Subscription. See Plan & billing.
- The Reconnect a number (QR code) permission. Without it, the button opens Restricted action: ask an admin of your team. See Team & roles.
- The phone of the number, in your hand, with WhatsApp installed on it: the code is scanned or typed on that phone.
Which number and which phone to use
Section titled “Which number and which phone to use”When you click Connect a number on your agent, the window first asks Which number are you connecting? The question is asked for a private-messages number WhatSetter doesn’t know yet.
- A number just for my business, Recommended and ticked already: a new SIM, an eSIM or your WhatsApp Business. The agent answers everyone who writes to you.
- My personal number, the one your family and friends use: Possible, but risky. If WhatsApp restricts this number, you lose your personal WhatsApp too. Your ongoing conversations stay yours: the agent only answers new contacts.
By continuing, you accept that WhatsApp alone decides its limits and blocks. Your answer sets how many first messages the number may send to new contacts each day: 5 to start with a dedicated number, 10 with your personal number, then more with time and answers. Replies to people who write to your agent are never limited. See How we protect your number.
Next to the code, the Good to know block recalls these rules too.
- One number serves one agent. A number that already answers for another agent is refused until it is disconnected from that agent.
- The agent answers even when the phone is off. Still open WhatsApp on that phone at least once every two weeks, or WhatsApp cuts the link.
You need the phone that carries the WhatsApp account of the number: the code is scanned or typed in WhatsApp on that phone, not on another one.
Connect a number with the QR code
Section titled “Connect a number with the QR code”- Open Agents and click your agent.
- Click Connect a number, at the top right. The same button is in the Summary tab, on the line A WhatsApp number, and in the Settings tab, section Number.
- If the window asks Which number are you connecting?, keep A number just for my business or choose My personal number, then click Show the code.
- On the phone of the number, open WhatsApp. Go to Settings on iPhone, or tap the three dots at the top right on Android, then Linked devices.
- Tap Link a device and point the phone at the code shown in the window.
The code appears as soon as you click Show the code, or as soon as the window opens when the question isn’t asked (a groups number, or a number you already answered it for). WhatsApp replaces it while you look for your phone: the first code lasts 60 seconds, the next ones 20 seconds, 6 codes in all. The window always shows the current code and counts them. When the 6 codes are used, click Show a new code.
From the Agents list, the button Connect on the line of an agent without a number opens the same window.
Connect without scanning: the code to type
Section titled “Connect without scanning: the code to type”In the window that opens when you click Connect a number on your agent, choose the tab Code to type when you cannot scan: no camera at hand, or the dashboard is open on the very phone to connect. On a phone screen, the window opens on this tab.
- Type the number to connect, complete, with its country code, then click Get the code.
- The window shows a code of 8 characters. Copy copies it.
- On the phone of the number, open WhatsApp and go to Linked devices. Tap Link a device, then “Link with phone number instead”, and type the code.
The window then waits for the phone. New code asks WhatsApp for another code. If WhatsApp gives no code, try again in a moment or go back to the QR code tab.
What happens right after the connection
Section titled “What happens right after the connection”In the connection window of your agent, once the phone has scanned or typed the code, the title becomes Phone linked. The window checks for a few seconds that the connection holds: keep it open.
It then shows the WhatsApp picture and name of the number, so you can see that it is the right one.
- If the agent is still a draft, the window offers Later and a button that starts with Activate. A draft answers nobody.
- For a private-messages number, the window recalls that it answers everyone who writes, with no limit, and that your lists’ pace is in the number’s panel. With your personal number, it says how many conversations from your phone stay yours.
- First messages to new contacts wait 30 minutes after a connection. It is on purpose: it protects the number. Replies go out right away.
- During these 30 minutes, a list that only this agent sends shows Blocked, then resumes by itself. The WhatsApp numbers page shows from what time first messages go out.
On the agent, the header now shows the number with Connected, and the button of a draft becomes Activate. See Bring contacts to your agent.
The window says it is not the same number, or that the number is already used
Section titled “The window says it is not the same number, or that the number is already used”In the connection window of your agent, three things can stop a connection once the phone is linked.
- This is not the same number: the agent was using a number and you linked another one, usually because you took the wrong phone. Click Link the other phone to start again, or Keep this number to change number on purpose. Ongoing conversations stay on the previous number. The new number’s panel, in WhatsApp numbers, then asks Tell us what this number is: its ceiling of first messages depends on it.
- The number already answers for another agent. Disconnect it from that agent first, on the WhatsApp numbers page, or use another number.
- The phone linked, then the connection dropped. Check that the phone has internet, then click Try again.
If your team already has a connected number to give to this agent, click Use a number already connected in the window: the number moves to this agent right away, with nothing to scan, and the window says which agent loses it. See WhatsApp numbers.
What the connection status of your agent means
Section titled “What the connection status of your agent means”Open Agents and click your agent: next to its number, the header shows one of these 5 connection statuses.
| Status | What it means |
|---|---|
| No number | No number is connected to this agent yet. Click Connect a number. |
| Connecting | The connection is starting or coming back. Wait a moment. |
| QR code to scan | WhatsApp asks for a new scan of this number. Click Reconnect. |
| Connected | The number works: the agent can send and answer. |
| Disconnected | A number is linked but its connection is down: nothing goes out. Click Reconnect. |
Opening the connection window and closing it without scanning leaves the agent on No number: nothing was connected.
What to do if the number disconnects
Section titled “What to do if the number disconnects”Open Agents: an active agent whose number dropped is listed under To check, marked Disconnected, with the button Reconnect. You are also warned by email. Choose who receives this email in the Settings tab of the agent, section Hand-off & alerts, under If its number disconnects.
While its number is disconnected, the agent answers nobody and sends nothing. It stays active: you do not have to switch it on again. A list that only this agent sends shows Blocked and resumes by itself after the reconnection.
- Click Reconnect, in the list or on the agent.
- Scan the code with the same phone, or use Code to type. The question Which number are you connecting? doesn’t come back for a number you already answered it for.
- Wait for Connected. First messages to new contacts wait 30 minutes again, and replies go out right away.
A number can drop because the device was removed from the linked devices of the phone, because WhatsApp stayed closed too long on that phone, or because WhatsApp restricted the account. The WhatsApp numbers page gives the reason for each number.