WhatsApp troubleshooting

Connecting

What you see	Why	What to do
Waiting for Meta… and no window opens	Your browser blocked Meta’s sign-in window (pop-up or ad blocker).	Allow pop-ups and facebook.com for this site, then Retry.
You closed Meta’s window… Nothing was connected.	The window was closed before Finish.	Click Try again.
The sign-in with Meta took too long	Meta’s one-time sign-in code lives 30 seconds.	Click Connect with Meta again.
Meta did not share a WhatsApp Business Account	No account was picked in Meta’s window.	Connect again and pick your account.
This number already has a two-step verification PIN	The number was used with WhatsApp before.	Enter its PIN, or reset it in WhatsApp Manager.
WhatsApp needs to confirm you own this number	The number isn’t verified yet.	Verify number: we send a code by text or voice call.
That code did not work	Wrong or expired code.	Check the 6 digits, or ask for a new code.
WhatsApp is limiting attempts for this number	Too many tries.	Wait a few minutes, then retry.
WhatsApp is still removing this number from a previous account	The number was just deleted elsewhere.	Wait a few minutes, then retry.
This WhatsApp number is already connected to another oyehello workspace	One number belongs to one workspace.	Disconnect it there first, or use another number.
This WhatsApp Business Account has no phone number yet	The account has no number.	Add one (in WhatsApp Manager or Numbers), then Retry.
We could not finish linking your account to oyehello	Meta didn’t accept the webhook subscription.	Retry.
One-click Connect with Meta is not available / at capacity this week	Not switched on for your workspace, or Meta’s weekly limit on new businesses is reached.	Connect with a token (ask your developer), or contact support.
WhatsApp connection is temporarily unavailable on our side	Our server can’t store credentials safely right now. Nothing was saved.	Contact support.
WhatsApp no longer accepts this connection / access expiring	Meta’s access expired or was revoked.	Reconnect with Meta.
WhatsApp is disconnected: oyehello was removed from your WhatsApp Business Account	The app was removed, or the account deleted, in Meta.	Reconnect.

Messages

Each failed message shows why in plain words and what to do. The common reasons (Meta’s error codes, and ours for messages we refused before contacting Meta):

Reason shown	Code	What to do
The 24-hour reply window had closed	131047, -1004	Send an approved template instead.
Could not be delivered	131026, 130403, 130472	The number may not be on WhatsApp, may use an old app, or blocked you. Reach them another way.
Held back by WhatsApp (marketing limit)	131049	WhatsApp limits marketing messages per person. Try again in a day, or use a utility template.
Customer stopped marketing messages	131050	Send them only utility messages.
Customer opted out	-1001	They replied STOP or are on your do-not-contact list.
No WhatsApp opt-in recorded	-1006	Record their opt-in, or use a utility template.
Template not approved	-1007	Use an approved template.
Template not found	-1008, 132001	Sync templates, or check the template is approved in that language.
Template values did not match	132000, 132005, 132007, 132012, 132018	Check the number and format of the values.
Template paused or disabled	132015, 132016	Edit and resubmit, or use another template.
Sending too fast	4, 80007, 130429, 131056	Retried automatically (a campaign waits a little longer each time, without using up anyone’s attempts); slow the campaign pace if it repeats.
WhatsApp limited this number	131048	Pause campaigns and review your templates - customers reported or blocked messages.
WhatsApp connection expired	190, 0	Reconnect WhatsApp.
WhatsApp connection is missing a permission	10, 131005, 200-299	Reconnect and allow every permission.
WhatsApp restricted your account	131031, 131037, 368	Check the account and display name in WhatsApp Manager.
Problem with your Meta payment method	131042	Fix the payment method in WhatsApp Manager.
Your number is not registered	133010, 131045	Register it again on Numbers.
Message too long	-1003	Keep messages under 4,096 characters.
WhatsApp does not support this message	131051, -1005	Send text or a supported attachment (at most 3 buttons, 10 list rows).
WhatsApp was temporarily unavailable	131000, 131016, 2	Retried automatically.

Message statuses

Status	Meaning
Queued	Waiting to be sent (for example paced by a campaign).
Sent (one tick)	WhatsApp accepted it.
Delivered (two ticks)	It reached the customer’s phone.
Read (two blue ticks)	The customer opened it (if they share read receipts).
Failed (cross)	Not delivered - the reason and next step are shown.
Delivery unknown	WhatsApp didn’t confirm in time. It may still arrive; it’s never sent twice.
Received	A message from the customer.
Deleted	The customer deleted it, or it was erased on request.

Templates

Template statuses and what to do are on Templates. A rejected template shows Meta’s reason and recommendation; edit and save it to send it for review again.

Campaigns pausing themselves

Reason shown	What to do
WhatsApp limited sending because people reported or blocked messages	Wait for the limit to lift, review the template and audience, then Resume.
The template is no longer approved	Get it approved again (or pick another template in a new campaign), then Resume.
WhatsApp no longer accepts the template as it is	A language was deleted or the template changed in WhatsApp Manager. Templates re-sync on their own; check it on Templates, then Resume - nobody on the list was skipped.
The same error stopped every message	For example a header image link that no longer works. Fix it, then Resume - nobody on the list was skipped. If the same error comes back after you resume, the campaign does not pause for it again: those people are marked failed with that error and the rest are sent.
The sending number was stopped	Make the number live again on the Numbers card and Resume, or duplicate the campaign on another number.
The number or template quality rating dropped to RED	Improve quality first; Resume asks you to confirm.
Too many messages could not be delivered	Usually numbers not on WhatsApp - clean the list, then Resume.
Meta restricted your WhatsApp Business Account / payment method problem	Fix it in WhatsApp Manager, then Resume.
The WhatsApp connection expired	Reconnect WhatsApp, then Resume.
Meta made the template a marketing template	It now only goes to people with a marketing opt-in.
New people were added to the list	Resume to message them.

Inbox and agents

What you see	What to do
A teammate is handling this conversation	They hand it back or release it; you can’t take it from them.
Your helpdesk is handling this conversation	Your helpdesk hands it back through the API.
24-hour reply window closed - send a template	Pick an approved template in the composer.
No AI agent on this number	Choose the number in a WhatsApp agent’s Settings → WhatsApp.
A conversation on a stopped number	Messages to a stopped number still arrive in Unassigned, but nobody can reply until it is made live again on the Numbers card.
You don’t have access to customer files	Ask an admin for agents or settings access.
The agent doesn’t reply	Check the flow is published, the agent has the number, the number is live, WhatsApp agents are on, and the wallet has balance. Messages still reach Unassigned meanwhile.

---

Back to WhatsApp overview