Channels
How we protect your number
How WhatSetter paces first messages, follow-ups and replies to protect your WhatsApp number: daily limits, sending hours, warm-up and waits.
WhatsApp can limit or ban a number that writes to too many new people, too fast. WhatSetter never sends in bursts: every send goes through limits, hours and waits. Most of them are built into the sending engine and have no off switch. The others are settings of your lists, with safe defaults. This page says what the engine does, with its figures. It is what people call anti-ban protection.
What protects your number, at a glance
Section titled “What protects your number, at a glance”Whatever sends a message from the WhatsApp number of your agent, a list, a form, a follow-up or the API, the same protections apply.
- Each number has a daily limit of new contacts and a daily total of messages.
- A number’s ceiling of first messages climbs step by step with its age and its answers (its ladder), and brakes on its own when almost nobody answers.
- Each list has a pace you choose, with a recommended value and a maximum.
- A warm-up starts a list gently over several days.
- Lists and follow-ups only send during set hours and days.
- First messages leave a few at a time, minutes apart, after a “typing” indicator.
- A number that was connected a moment ago waits 30 minutes before writing to new contacts.
- Nobody gets two first messages from your team, or a first message in the middle of a conversation.
- When WhatsApp limits a number, new contacts stop by themselves and resume later.
Replies to people who write to your agent are never blocked by these protections.
Before connecting: which number are you connecting?
Section titled “Before connecting: which number are you connecting?”Right before the code to scan, the Connect a number window asks one question: Which number are you connecting? It is only asked for a private-messages number, and it doesn’t come back when you reconnect a number you already answered it for.
- A number just for my business, marked 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 step by step (the ladder below).
- My personal number, the one your family and friends use. The window warns: Possible, but risky. If WhatsApp restricts this number, you lose your personal WhatsApp too. Your ongoing conversations stay yours, with nothing to tick: we note the numbers of your existing chats, never their messages, and the agent doesn’t answer them. A new contact who writes to you gets the agent. When you reply yourself from your phone, the agent goes quiet in that conversation.
There is no box to tick. One line under the question says that by continuing, you accept that WhatsApp alone decides its limits and blocks, and that WhatSetter isn’t responsible for them. Click Show the code: the answer is kept with the number as soon as the phone links. You find it afterwards in the number’s panel, under Number safety, and Change changes it.
A number connected before this question keeps its previous limit, 50 new contacts a day by default. Its panel, in WhatsApp numbers, offers Tell us what this number is: click Answer, choose, then Save. Its ladder applies right away. If you link another phone on an agent whose number was known, the question is asked again in the new number’s panel, and its ceiling stays at 10 a day until you answer.
Your number’s ladder
Section titled “Your number’s ladder”Every number has a ceiling of first messages to new contacts per day. All its lists and its follow-ups to leads who never replied share it. It rises with the number’s age, and its last steps only open when people answer.
| Your number | At first | Then | At the top |
|---|---|---|---|
| A number just for my business | 5 a day | 10 on day 4, 15 on day 8, 20 on day 15 | 25 on day 22, then 30 on day 31, if at least 20 then 25% of people answer |
| My personal number | 10 a day | 15 on day 4, 20 on day 8 | 25 on day 15, if at least 20% of people answer |
For a dedicated number, day 1 is the day you answered the question, even for a number connected long ago. For your personal number, the ladder counts from the number’s first connection to WhatSetter. The reply rate is read on the first messages of the last 7 days, from 30 first messages: before that, the number stays at 20 a day at most.
A list set above the ceiling isn’t at fault: that day, the number sends its ceiling. The number’s panel shows the ladder, today’s step and the date of the next one, and each list’s Sending tab, under Your number’s ceiling, says what the number will send.
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.
The automatic brake
Section titled “The automatic brake”Every 15 minutes, WhatSetter looks at how many people answer the number’s first messages over the last 7 days. A first message younger than 12 hours isn’t counted yet.
- From 30 first messages, if fewer than 15% of people answer, the pace is halved, never below 3 a day: the number shows Slowed down.
- From 50, if fewer than 8% answer, first messages stop for 3 days: the number shows Paused with the date they resume, and the team’s owner gets an email.
- If 3 people ask to stop in a day, first messages stop for 24 hours.
- After a pause, the number restarts at half its pace for a week, until new answers show it’s fine.
During a pause, the agent keeps answering everyone who writes. This brake comes from WhatsApp’s rule that caps, every month, the messages sent to people who don’t answer: the reply rate is what keeps your number alive.
Who a list’s contacts are
Section titled “Who a list’s contacts are”The first question of a list import is Who are these contacts?
- My customers or past customers and People who gave me their number (a form, an ad, a trade show, a meeting): the list is imported.
- Contacts who don’t know me (a bought, shared or scraped file): it’s possible, but it’s what gets numbers banned the most. WhatsApp’s rules ask that the person gave you their number, WhatsApp caps every month the messages nobody answers, and every person who blocks or reports you lowers your number. The window says so and asks you to tick “I take the risk”: WhatsApp may limit or ban your number, and WhatSetter isn’t responsible for it. If you do it, use a dedicated number, never your personal one, and a short first message saying who you are and how you got the contact, with a real question and “reply stop”. Even better, a link or a form brings them to you.
A list imported before this question asks it once, when you click Launch sending. When a list of contacts who don’t know you goes out from your personal number, the launch summary says so again. Your number’s ladder and brake apply to every list, these included. For a message you write yourself, the Message tab ticks what gets answers: no link, a question, who’s writing, and “reply stop”.
How many messages a number can send per day
Section titled “How many messages a number can send per day”Each connected WhatsApp number has two daily limits. Open WhatsApp numbers, click the number, and read them under Today.
- New contacts: first messages to people never contacted before, lists and sign-ups together, plus the follow-ups to leads who never replied. The limit follows the number’s ladder, above: from 5 to 30 a day depending on what the number is, its 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. Once it is reached, the contacts of your lists wait for the next day.
- Messages sent: everything the number sent, replies and follow-ups included. The total is 150 a day by default. Once this total is reached, first messages and follow-ups wait for the next day.
Replies are never blocked by these limits: they are counted in the total, and they still leave when it is reached. Both counters start again every day at midnight UTC.
These limits belong to the number. They do not depend on your plan, and the lists sent by the same agent share them. The messages of your plan, counted per month, are another limit: see Subscription.
How many first messages a list sends per day
Section titled “How many first messages a list sends per day”Open Lists, click the list, then the Sending tab. Under Pace, a slider sets how many first messages each agent of the list sends per day.
- The slider goes from 1 to 40. The recommended value is 20, and it is the value a new list starts with.
- Up to 10 a day is best for a new or rarely used number. Up to 20 is the right balance for most numbers. Above 20, WhatsApp may limit a recent number: keep it for an older number that is used to sending a lot.
- With Share between several agents, the list sends the pace of one agent multiplied by the number of agents. Each agent keeps its own pace.
- The real number of sends changes a little from one day to the next, up to 15% above or below the pace.
When the same agents already write for other lists, the page warns you if the total goes above 40 first messages a day per agent. The daily limit of new contacts of the number applies on top. See Lists.
Warm-up: start a list gently
Section titled “Warm-up: start a list gently”Open Lists, click the list, then the Sending tab. Under Pace, the Warm-up switch makes the list start below its pace and reach it step by step.
- Warm-up is on by default, over 7 days. You can choose 5, 7, 10 or 14 days.
- The first day, the list sends 15% of its pace. The share grows on every sending day and reaches 100% on the last day of the warm-up.
- Example with a pace of 20 first messages a day over 7 days: 3 the first day, then 6, 9, 12, 14 and 17, and 20 from day 7.
- With the switch off, the list sends its full pace from day one.
The warm-up belongs to the list. The number also has its own ladder, shared by all its lists: a list faster than the ladder simply sends the number’s ceiling that day.
The hours and days messages go out
Section titled “The hours and days messages go out”First messages and follow-ups only leave during set hours. Replies leave at any time, when someone writes to your agent.
For a list, open Lists, click the list, then the Sending tab. Under Hours you set three things.
- Days: the days the list sends. By default, Monday to Friday.
- Time slots: by default 9:00 to 12:00 and 14:00 to 18:30. The presets are Morning and afternoon, All day (9:00 to 18:00) and Late afternoon (17:00 to 20:30). You move the ends of a slot by half hours, and Add a time slot gives up to 4 slots.
- Time zone: the hours are those of the city you choose.
Outside these hours the list reads Scheduled and resumes at the next slot.
Follow-ups go out between 9:00 and 19:00 in the Follow-up time zone of the agent, and not on Sundays unless you turn on Follow-ups on Sundays. Both settings are in the Settings tab of the agent, section Sending. See Automatic follow-ups.
Why first messages leave slowly
Section titled “Why first messages leave slowly”When a list is sending, its first messages are spread over the time slots of the day instead of leaving together. This is how the engine sends them.
- It sends a small batch at a time, a few times an hour: 6 contacts at most per batch for a list.
- Before each first message it waits 2 to 4 minutes, shows “typing” for a few seconds, then sends.
- It then waits 1 to 4 minutes before the next contact.
- Before writing, it checks that the number is on WhatsApp. A number without WhatsApp is skipped and receives nothing.
- By default each first message is written for its contact by the agent, so the text changes from one contact to the next.
This is why a list of 20 first messages a day takes the whole day, and why the Expected end shown in the Sending tab of a list is an estimate. There is no setting to remove these waits.
First messages to people who sign up
Section titled “First messages to people who sign up”When someone fills in one of your forms, your agent writes first, but not within the second.
- Open Agents, click the agent, then the Settings tab and the Sending section. First message delay is the time between the form and the first message: 3 minutes at least, 24 hours at most.
- Two first messages from the same number leave a few minutes apart. When several people are waiting, the most recent sign-up goes first.
- Sign-ups wait while the number is disconnected, during the 30 minutes that follow a connection, and while WhatsApp refuses new contacts from the number. Their first message leaves by itself afterwards.
- A number that is not on WhatsApp receives nothing. Someone the agent already sent a first message to does not get a second one by signing up again.
These first messages count in New contacts, with those of your lists. People who write to you first, from one of your links for example, are answered: a reply is never blocked. See Forms.
The 30-minute wait after a number is connected
Section titled “The 30-minute wait after a number is connected”After a WhatsApp number is connected, its first messages to new contacts wait 30 minutes. Replies go out right away.
- The wait starts when an agent gets a number for the first time, when a number is linked again with a code, and when it comes back after at least 10 minutes offline. A drop of a few seconds does not start it.
- It holds the first messages of lists, the first messages to people who signed up, and follow-ups. They leave by themselves afterwards. Follow-ups to leads who never replied wait longer: 24 hours after a number is linked with a QR code.
- On a list shared between several agents, the other agents take the contacts of the waiting agent meanwhile, at their own pace.
- A connected number that is given to another agent, without a new scan, does not wait.
On the WhatsApp numbers page, the row of the number says from what time first messages go out. See WhatsApp numbers.
How the agent makes a reply look human
Section titled “How the agent makes a reply look human”A program answers within the second. A person reads, types, then sends. In a WhatsApp conversation, your agent does the same for each reply.
- It waits a few seconds, then marks the conversation as read.
- It shows “typing” for a time that depends on the length of the reply.
- It sends.
That is why a reply takes a little while. It is intended, and there is nothing to set up.
First messages and follow-ups also show “typing” before they leave. In the Settings tab of the agent, section Sending, the switch Split long replies lets the agent break a long answer into several messages, where it reads naturally: 3 at most, or 2 if you choose Up to 2 under Messages per reply.
Can the same person receive two first messages?
Section titled “Can the same person receive two first messages?”No. When you start a list, WhatSetter checks who your team has already written to, and who already talks with it, whatever the agent. These contacts are set aside: they get no second first message, and you find them under Set aside in the Contacts tab of the list. The window that starts the list says how many were set aside and why.
The exception is Re-engagement, in the Message tab of the list, under Already contacted. This block appears when the list holds people already contacted. A re-engagement sends one message that refers back to the earlier one, under these rules.
- Never to someone who replied.
- Always from the agent that wrote the first time.
- After a minimum delay since the last message: 14, 30, 60 or 90 days, 30 by default.
- 2 unanswered attempts at most, the first message included.
- No follow-up after it.
If the option reads Coming soon to your account, it is not available on your account yet. Don’t write to them is the recommended choice.
What happens when WhatsApp limits a number
Section titled “What happens when WhatsApp limits a number”WhatsApp can limit a number by itself. WhatSetter reads these limits every 15 minutes and stops by itself what WhatsApp would refuse. On the WhatsApp numbers page, the number then reads Limited.
- New contacts blocked: WhatsApp refuses new contacts from the number until a date. No first message leaves it until then, from a list or to a sign-up, and follow-ups wait. The agent keeps answering ongoing conversations.
- WhatsApp quota reached: WhatsApp refuses new messages from the number until its quota resets. Replies in ongoing conversations still go through. First messages and follow-ups wait for the reset.
- When the number comes close to WhatsApp’s quota, sending slows down before the limit: lists send one new contact at a time from that number, first messages to sign-ups are spaced twice as far apart, and follow-ups to leads who never replied wait until it passes.
Everything resumes by itself when the limit is lifted. Meanwhile a list that only this agent sends reads Blocked. On a list shared between several agents, the others take its contacts.
What happens when a number disconnects
Section titled “What happens when a number disconnects”A disconnected WhatsApp number sends nothing: no reply, no first message, no follow-up. The agent is not paused: it stays Active and starts again by itself as soon as its number is reconnected.
- A list that only this agent sends reads Blocked, then resumes by itself. On a list shared between several agents, the others take its contacts at their own pace, so no number sends more than planned.
- People who sign up meanwhile wait, and get their first message after the reconnection.
- You are warned by e-mail when the number of an active agent has been down for 30 minutes, then reminded after 24 hours and after 48 hours. Choose who receives this e-mail in the Settings tab of the agent, section Hand-off & alerts, under If its number disconnects.
After the reconnection, first messages to new contacts wait 30 minutes. To reconnect a number, see WhatsApp numbers.
The API follows the same rules
Section titled “The API follows the same rules”If you send messages through the API, the engine applies the same protections to the WhatsApp number.
- You cannot write to someone who was never contacted:
POST /messagesanswers409 lead_not_contacted. A first contact goes through a list. - Each message sent through the API counts in the daily total of the number. Once the total is reached, the API answers
429 quota_exceededuntil midnight UTC. - If the number is disconnected, the API answers
503 agent_disconnected. - By default, a message sent through the API is marked as read, shows “typing”, then leaves, like a reply of the agent.
See Errors, limits and idempotency.
What you can do to protect your number
Section titled “What you can do to protect your number”The engine controls the pace of your WhatsApp number. It cannot choose your contacts for you. The rest is in your hands: here is how to avoid getting your number limited, blocked or banned by WhatsApp.
- Write to people who know you: customers, people who filled in a form, people you already spoke with. A bought or shared file is at your own risk: the import says so and asks you to tick a box.
- A short first message with your name, a real question and “reply stop if you’re not interested”, without a link or attachment.
- Use a number just for your business rather than your personal one, and answer Which number are you connecting? honestly: its ladder depends on it. Open WhatsApp on its phone at least once every two weeks, or WhatsApp cuts the link.
- For a new or rarely used number, keep the Pace of your lists at 10 first messages a day or fewer, and leave Warm-up on.
- For people your team already contacted, keep Don’t write to them, the recommended choice in the Message tab of a list.