Channels
WhatsApp numbers
See every WhatsApp number of your team and what its status means, then connect, reconnect, move or disconnect a number.
Your agent writes and answers from a real WhatsApp number. The WhatsApp numbers page lists every number of your team, says whether each one is connected right now, and lets you connect, reconnect, move or disconnect a number. It replaces the old WhatsApp Agents page. What the old dashboard called a campaign is now an agent.
What the WhatsApp numbers page shows
Section titled “What the WhatsApp numbers page shows”Open WhatsApp numbers, under Channels in the sidebar. The page has one row per number your team has connected, including the numbers that are offline today. A row shows the WhatsApp picture and name of the number, the number itself, a status, and one sentence that says what it does, for example “Answers for Julia”.
The top of the page counts your numbers and how many of them are connected, and holds the Connect a number button. The status of each number is asked from WhatsApp when you open the page, then again every minute while the page stays open.
Click a row to open the number. Its panel says why it is down when it is, what it sent today, which agent it works for, its role and its profile picture. Click the number under its name to copy it. Message it on WhatsApp opens a WhatsApp chat with this number, a quick way to write to your own agent.
How numbers are grouped: To check, Connected, Offline
Section titled “How numbers are grouped: To check, Connected, Offline”On the WhatsApp numbers page, the rows are sorted into three groups, so that the numbers that need you come first.
| Group | Numbers in it |
|---|---|
| To check | The agent of the number is active, but it cannot write normally: the number is disconnected, or WhatsApp limits it. |
| Connected | Numbers that are connected, or connecting, with nothing wrong. |
| Offline | Numbers that are not connected and serve no active agent. Nobody is waiting for them. |
When the other groups hold numbers, Offline is folded: click Show numbers to open it and Hide to fold it back. In To check and Connected, numbers are sorted by name. In Offline, the number that went offline most recently comes first.
What each status of a number means
Section titled “What each status of a number means”On the WhatsApp numbers page, each number carries one status, on its row and in its panel.
| Status | Meaning |
|---|---|
| Connected | The number is linked to WhatsApp. The sentence next to it says who it works for: “Answers for Julia”, “Follows the groups of Julia”, “Connected, but no agent uses it”, or that its agent is paused or not active yet. |
| Limited | The number is connected, but WhatsApp itself limits it: its message quota is reached, or WhatsApp refuses new contacts until a date. |
| Paused | The number is connected and its agent answers, but its automatic brake stopped its first messages until the date written on its row: almost nobody was answering, or 3 people asked to stop in a day. Replies go on. |
| Connecting | The link with WhatsApp is being set up. |
| Disconnected | The number is no longer linked and its agent is active: the agent cannot answer. The row has a Reconnect button. |
| Offline | The number is not linked and no active agent uses it. Its panel offers Reconnect, or Connect to an agent when no agent is linked to it. |
A number that reads “Connected, but no agent uses it” answers nobody until you give it to an agent.
What the figures of the day mean
Section titled “What the figures of the day mean”On the WhatsApp numbers page, a connected number whose role is Private messages shows a counter on its row, for example “12 / 50 new contacts”. Click the row: under Today, the panel of the number shows two counters.
- New contacts: first messages sent today to people never contacted before, lists and sign-ups together, plus the follow-ups to leads who never replied, against the limit of the day. This limit is the number’s ceiling: it follows its ladder, from 5 to 30 a day depending on what the number is, its age and its answers. A number you haven’t said what it is yet keeps 50 a day by default. Once the limit is reached, the contacts of your lists wait for the next day.
- Messages sent: everything the number sent today, replies and follow-ups included, against its daily total, 150 by default. Once the total is reached, first messages and follow-ups wait for the next day.
Replies are never blocked by these two limits. Both counters start again every day at midnight UTC. They belong to the number and do not depend on your plan. See How we protect your number.
A number’s safety: its type, its ladder and its state
Section titled “A number’s safety: its type, its ladder and its state”On the WhatsApp numbers page, click a number whose role is Private messages: its panel has a Number safety part. It says how many first messages this number may send to new contacts today, and why.
- Type: the answer given when it was connected, A number just for my business or My personal number. Change changes it.
- A state, next to the title: Warming up while the number climbs its ladder, Ready at the top, Slowed down, Paused or Limited by WhatsApp.
- The ladder, one bar per step: today’s is solid, the next one says its date or the reply rate it waits for.
- Today’s ceiling, for example “5 first messages to new contacts today, for this whole number.”, and when it rises. Every list and cold follow-up from the number shares it. Replies are never limited.
- The reply rate to the week’s first messages, or “Not enough first messages yet to read a reply rate.”
- For your personal number, how many conversations from your phone stay yours: the agent doesn’t answer them. Give them back to the agent lets it answer them again.
When the number is Paused or Limited by WhatsApp, the part says why and until when, instead of the ceiling. During a pause, the number’s row also shows Paused and the date it resumes. The details of the ladder and the brake are in How we protect your number.
Why does my number only send 5, 10 or 20 first messages a day?
Section titled “Why does my number only send 5, 10 or 20 first messages a day?”That figure is your WhatsApp number’s ceiling for the day: the first messages it may send to new contacts today, all its lists and its follow-ups to leads who never replied together. Replies to people who write to your agent are never limited. To read it, open WhatsApp numbers, click the number and look at Number safety: the panel says for example “5 first messages to new contacts today, for this whole number.”, then when it rises.
Four things set that figure.
- The number’s ladder. A dedicated number starts at 5 a day, then 10 on day 4, 15 on day 8 and 20 on day 15. Your personal number starts at 10, then 15 on day 4 and 20 on day 8.
- The answers. Above 20, a step only opens if at least 20% of people answer (25% for the last one, at 30 a day), over at least 30 first messages in the last 7 days. While the panel says “Not enough first messages yet to read a reply rate.”, the number stays at 20 at most.
- The brake. If fewer than 15% of people answer, the ceiling is halved and the number shows Slowed down. If almost nobody answers, or if 3 people ask to stop in a day, it shows Paused and sends no first messages until the date shown.
- Your lists. A list’s Pace (20 a day by default) and its Warm-up (3 on the first day for 20 a day over 7 days) can ask for less than the ceiling. All the number’s lists share its ceiling, and none goes above it.
There is no setting to raise the ceiling by hand: it rises on its own with the number’s age and its answers. A number connected before the question Which number are you connecting?, that you haven’t said what it is yet, keeps its previous limit, 50 a day by default. See How we protect your number.
Say what a number is, or change the answer
Section titled “Say what a number is, or change the answer”On the WhatsApp numbers page, a number connected before the question Which number are you connecting? reads “tell us what this number is” on its row. Until you answer, it keeps its previous limit, 50 new contacts a day by default.
- Click the number. Under Number safety, the panel shows Tell us what this number is.
- Click Answer.
- In the This number is… window, choose A number just for my business or My personal number.
- Click Save. Its ladder applies right away.
To change an answer you already gave, click Change next to Type, in the same part. With My personal number, the conversations already on your phone stay yours. The question also comes back when you link another phone on an agent whose number was known: until you answer, the new number’s ceiling is 10 a day. Answering needs the Reconnect a number (QR code) permission.
Connect a new number with the QR code
Section titled “Connect a new number with the QR code”A number is always connected to an agent, in a window that shows a code to scan with the phone of the number.
- Open WhatsApp numbers and click Connect a number. On an agent’s page, the Connect a number button of its header opens the same window, already set on that agent.
- Choose the agent that will answer with this number and click Continue. The list only holds the agents that are not answering on a number right now.
- For a private-messages number WhatSetter doesn’t know yet, the window asks Which number are you connecting? Keep A number just for my business, ticked already, 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, and tap Link a device.
- Point the phone at the QR code shown in the window.
- Keep the window open for the few seconds it checks that the link holds. It then shows the WhatsApp picture of the number and says it is connected.
The QR code changes after 60 seconds, then every 20 seconds. After six codes, click Show a new code. If the agent is still a draft, the last screen offers to activate it: a draft answers nobody. The step-by-step guide is on Connect a WhatsApp number.
Connect without a camera: the code to type
Section titled “Connect without a camera: the code to type”In the window that connects a number, choose Code to type instead of QR code when you cannot scan, for example when the dashboard is open on the very phone you want to connect. On a phone screen, the window opens on this choice.
- Under WhatsApp number to connect, type the number with its country code.
- Click Get the code. WhatsApp gives a code of 8 characters, shown in the window.
- On the phone of the number, open WhatsApp and go to Linked devices. Tap Link a device, then “Link with phone number instead”.
- Type the code on the phone. Copy copies it and New code asks WhatsApp for another one.
The window then waits for the phone. If WhatsApp gives no code, try again in a moment, or go back to QR code.
Which number to use for an agent
Section titled “Which number to use for an agent”Before the code of a private-messages number it doesn’t know yet, the window that connects a number asks one question: Which number are you connecting?
- 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. Its first messages start at 5 a day and climb up to 30.
- 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, and goes quiet in a conversation where you reply yourself from your phone. Its first messages start at 10 a day and never go above 25.
By continuing, you accept that WhatsApp alone decides its limits and blocks. Click Show the code. For a groups number, the question isn’t asked. Next to the code, the Good to know block recalls the rules.
- One number serves one agent. To have several agents working at the same time, connect one number per agent.
- For a group agent, use a number that is already in your groups, or that you can add to them.
- 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 at hand: the code is scanned or typed in WhatsApp on that phone.
Why first messages wait 30 minutes after a number is connected
Section titled “Why first messages wait 30 minutes after a number is connected”After a WhatsApp number is connected, its first messages to new contacts wait 30 minutes. It is on purpose: it protects the number.
The wait starts when an agent gets a number for the first time, when a number is linked again with a code, and when a number comes back after at least 10 minutes offline. A drop of a few seconds does not start it. A connected number that only changes agent, with Use a number already connected, does not wait.
During these 30 minutes, the first messages of your lists, the first messages to people who signed up and the follow-ups are held, then leave by themselves. Replies go out right away. A list that only this agent sends reads Blocked during the wait, then resumes by itself.
On the WhatsApp numbers page, the row of the number says “first messages from” followed by the time, and its panel says the same.
Why does my agent say Disconnected?
Section titled “Why does my agent say Disconnected?”Disconnected means the WhatsApp number of the agent is no longer linked to WhatsApp. You see it on the row of the agent in Agents, in the header of the agent, and on the WhatsApp numbers page in the To check group.
While it lasts, nothing goes out from this number: the agent answers nobody, a list that only this agent sends waits, and in Conversations the message box is locked, so you cannot answer by hand either. The agent stays Active: it answers again as soon as a number is back.
Open the number on WhatsApp numbers to read the reason when it is known: it was disconnected from WhatSetter, or WhatsApp closed the link because the device was removed from the phone, the phone stayed too long without opening WhatsApp, or the account was restricted.
To fix it, click Reconnect and link the phone again. The header of the agent can read QR code to scan instead: it is the same situation, and the same fix. No number is another case: the agent never had a number, or its number was given to another agent. Click Connect a number.
Reconnect a number that dropped
Section titled “Reconnect a number that dropped”To reconnect a WhatsApp number, you link its phone again. Nothing else has to be set up again.
- Open WhatsApp numbers. The number is in the To check group, with the status Disconnected.
- Click Reconnect on its row. The window opens on the code to scan, for the agent of this number. On the agent’s page, the Reconnect button of its header opens the same window.
- On the phone of the number, open WhatsApp, go to Linked devices, tap Link a device and scan the code. Code to type works too.
If you link another phone than the one the agent was using, the window stops on This is not the same number. Click Link the other phone to start again, or Keep this number to change number on purpose. Ongoing conversations stay on the previous number.
After a reconnection, first messages to new contacts wait 30 minutes and replies go out right away.
Give an agent a number that is already connected
Section titled “Give an agent a number that is already connected”When a WhatsApp number of your team is connected, you can give it to another agent without scanning anything, and the number does not wait 30 minutes.
- Open Agents, click the agent, then the Settings tab and the Number section.
- Click Use a number already connected. If the agent already has a working number, the button reads Change number.
- Pick a number. The list only holds the numbers that are connected right now, for the same kind of work, private messages or groups. Each line says whether the number is free or which agent answers on it.
- Click Use this number.
If another agent of the same kind holds the number, a warning says so before you confirm: that agent is left without a number and stops answering. Its prompt, its knowledge and its settings are kept, and you can connect another number to it later. The number is not disconnected from WhatsApp.
You can also start from WhatsApp numbers: click Connect a number, choose the agent, then click Use a number already connected under the steps.
Change the number of an agent
Section titled “Change the number of an agent”To change the WhatsApp number of an agent, open Agents, click the agent, then the Settings tab and the Number section.
- To move the agent to a number your team has already connected, click Change number, pick the number and click Use this number. Nothing is scanned.
- To move the agent to a number that is not connected yet, first disconnect its current number: open that number on the WhatsApp numbers page and click Disconnect. Then come back to the agent and click Connect a number to scan the code with the new phone.
When you scan a phone that is not the one the agent was using, the window stops on This is not the same number and asks you to confirm with Keep this number. Ongoing conversations stay on the previous number.
Can two agents use the same number?
Section titled “Can two agents use the same number?”No. On the WhatsApp numbers page, the rule is written at the top: a number answers for one agent only. These cases come up.
- You scan a number, or link it with a code, while it already answers for another agent. Right after the link, WhatSetter asks WhatsApp whether this phone already answers elsewhere, and undoes the new link. The window says, for example, This number already answers for Julia. It was not linked a second time. Disconnect the number from that agent first, or use another number. When the number answers in another workspace, the window says This number already answers on another connection. It was not linked a second time. without naming anyone.
- If the new link could not be undone from the app, the window asks you to do it on the phone: open WhatsApp, then Linked devices, and log out the device added last.
- The number belongs to an agent of your team that is offline right now. The window asks before taking it, with This is Julia’s number: Give it to Emma moves it to the agent you are connecting, and Julia is left with no number.
- You give a connected number to another agent with Use a number already connected. The number moves, and the agent that had it shows No number.
The panel of a number can list several agents under Agents: they are the agents this number has served. Only one of them answers on it at a time. To have two agents working at the same time, connect two numbers. Your plan sets how many agents can be active together: see Subscription.
Numbers for private messages and numbers for groups
Section titled “Numbers for private messages and numbers for groups”A WhatsApp number has one role at a time. On the WhatsApp numbers page, open the number: the role is under Role.
- Private messages: the number answers in private the people who write to your agent.
- Groups: the number follows and runs your WhatsApp groups. It does not answer private messages.
A number takes the role of the agent it is connected to: Groups for a group agent, Private messages for any other agent. The window that connects the number says so under its title.
To change the role of a connected number, pick the other role under Role and confirm with Change role. The connection restarts: allow less than a minute to go back to private messages, one to three minutes to move to groups, and keep the page open meanwhile. A number can only be given to an agent of its own kind. The figures of the day are shown for the Private messages role only. See WhatsApp groups.
Disconnect a number
Section titled “Disconnect a number”Disconnecting removes a WhatsApp number from the linked devices of its phone. You do it from the panel of the number.
- Open WhatsApp numbers and click the number.
- Click Disconnect, at the bottom of the panel.
- Confirm with Disconnect.
If an active agent was answering on this number, it stops answering until a number is reconnected to it. The agent keeps its status and remembers its number: Reconnect brings it back with a new scan. Conversations and leads stay in WhatSetter.
Disconnecting is also how you free an agent for a number that is not connected yet: disconnect its current number, then click Connect a number on the agent and scan the code with the new phone.
When WhatsApp limits a number
Section titled “When WhatsApp limits a number”WhatsApp can limit a number by itself. On the WhatsApp numbers page, the number then moves to the To check group with the status Limited, and its panel says which limit applies.
| What the panel says | What it means |
|---|---|
| New contacts blocked | WhatsApp refuses new contacts from this number until the date shown. No first message leaves it until then. The agent keeps answering ongoing conversations. |
| WhatsApp quota reached | WhatsApp refuses new messages from this number until the date shown. Replies in ongoing conversations still go through. First messages and follow-ups wait for the reset. |
You have nothing to do: sending resumes by itself when the limit is lifted. The same information shows in Agents, with Sending limited or Cap reached and the button See the limits, and in the Activity tab of the agent, under WhatsApp number, where Messages this cycle says how much of WhatsApp’s own quota is used. It is checked every 15 minutes.
The profile picture and name of a number
Section titled “The profile picture and name of a number”On the WhatsApp numbers page, the picture and the name of a number are those of its WhatsApp account. You do not set them in WhatSetter: change them in WhatsApp, on the phone of the number.
The picture is copied when the number connects, then read again once a day when you open the page. To update it at once, open the number and click Refresh picture, under Profile picture. The number has to be connected. While a number is offline, the page keeps the last picture seen on WhatsApp.
The agent that answers on a number wears the same picture in the app. A number without a picture shows the initials of its WhatsApp name.
Who can connect, reconnect or disconnect a number
Section titled “Who can connect, reconnect or disconnect a number”What a member of your team can do with WhatsApp numbers depends on the permissions of their role, set in Team.
| Action | Permission needed | Roles that have it by default |
|---|---|---|
| Open the WhatsApp numbers page | See the numbers | Owner, Admin, Editor, Viewer |
| Connect or reconnect a number, change its role | Reconnect a number (QR code) | Owner, Admin, Editor |
| Say what a number is, change the answer, give its conversations back to the agent | Reconnect a number (QR code) | Owner, Admin, Editor |
| Give an agent a number already connected | Reconnect a number (QR code) and Edit agents and their prompts | Owner, Admin, Editor |
| Disconnect a number | Disconnect a number | Owner, Admin |
A Responder has none of these permissions. Without the permission, the button is greyed and opens Restricted action, which tells you to ask an admin of your team. See Team & roles.
A paid plan is needed to connect a number
Section titled “A paid plan is needed to connect a number”Connecting a WhatsApp number requires a paid plan. On the free plan you build your agent and test it. A plan connects it to your WhatsApp number.
Without a plan, WhatsApp numbers is locked in the sidebar and opens Subscription. Each plan includes a number of agents that can be active at the same time, with one WhatsApp number each: 1 on Starter, 3 on Business, 10 on Scale. The daily limits of a number do not depend on the plan.
When all the agents of your plan are active, a newly connected agent cannot be activated: pause another agent or change plan. See Subscription.