All topics
Get started8Account, team & permissions44Units & fields70Records, views & tasks39WhatsApp & Cortex Chat68Email & social27Lead ads & distribution38Automations52Documents & quotes32Dashboards40Cortex AI18Developers & API12
Help Center·448 guidesAll topicsContact support

Why doesn’t the first WhatsApp message reach a new customer?

WhatsApp restricts starting chats with new numbers, with a recurring quota and a temporary lock. The session stays connected, but the first messages fail. Corteksa shows both on the session and alerts you.

5 min

Steps

1
Make sure the session is Working in WhatsApp Sessions.
2
In the New chats left column, point at the session’s badge to open Reaching new people, and read the quota and lock status.
3
If the failed messages are all to new numbers, stop cold messaging from this number until the restriction is lifted.
4
For campaigns and bulk follow-ups, use WhatsApp Cloud with approved templates.

How it works

This only applies to WhatsApp Web. WhatsApp applies 2 restrictions to a number:

Restriction
When it happens
When it’s lifted
New-conversation quota
When the quota for starting chats in the cycle is used up
Automatically at the end of the cycle
Temporary lock
When you message a large number of people who haven’t messaged you
Automatically at a set time. Reconnecting doesn’t help

In both cases, the session stays Working. Replies in existing chats and group messages aren’t affected.

Quota levels

Level
What it means
Normal
Far from the limit
First warning
Getting close to the limit
Second warning
About to run out
Limit reached
New chats are refused until the end of the cycle
Unknown
WhatsApp hasn’t reported the status yet

On the session’s card, Corteksa shows how much of the quota is used, the total, what’s left, the percentage used and when the cycle ends, plus when the lock will be lifted, if there is one. If it shows that the account has no limit, there’s no quota on it.

There’s also one summary line: whether the number can start new chats right now, and if not, why.

The alert

When the number hits either restriction, the session’s members get one notification, with the time the restriction will be lifted. And the failed message carries a clear reason, such as “This number has reached its limit for starting new chats in this cycle. Replies in existing chats still work.”

Updating the status

The status updates when you open the session page, if it’s more than 5 minutes old, and on any real refusal. You can press Check again, but a check doesn’t run more than once a minute per number.

If something goes wrong

What you see
Why
What to do
Messages to new numbers fail while the session is connected
A WhatsApp quota or lock.
Wait until it’s lifted, and use WhatsApp Cloud for campaigns.
All messages fail
The session is disconnected.
The quota information doesn’t show
WhatsApp hasn’t reported it yet.
Press Check again after a minute.

A real example

Namaa Academy
The situation

An employee sent an offer to 300 numbers from an Excel file through WhatsApp Web, and his messages to new numbers stopped for 2 days.

What they did
  1. The temporary lock showed on the session’s card, with the time it would be lifted.
  2. They moved campaigns to WhatsApp Cloud with an approved marketing template, and kept WhatsApp Web for replies.
The result

The lock didn’t happen again, and daily replies weren’t affected.

A made-up company, to show the idea. The numbers are rounded.

Good to know

A live check runs at most once a minute per number.
The status counts as stale after 5 minutes.
A lock whose time has passed shows as lifted.
WhatsApp itself sets these limits, and Corteksa can’t lift them.
Did this guide solve it?
If not, we’ll ask what was missing.
Open in Corteksa
Did this guide solve it?

We read every answer. To get a reply, use Contact support.