Help for owners
My WhatsApp messages are not reaching my customers
Short answer
WhatsApp refuses delivery for specific, listed reasons: the 24-hour window has closed and no template was used, the customer has not accepted the latest terms, a marketing message was held back, your number hit a limit, or billing is broken. The error code on the failed message tells you which one.
Does this sound like your situation?
- The message is sent from my system but the customer never sees it.
- Some customers get messages and others never do.
- My developer sees error numbers I do not understand.
- Messages worked yesterday and fail today.
- Replies work but my reminders do not.
Why does this happen?
The 24-hour window has closed
When a customer messages you, a 24-hour window opens, and each new message from them resets it. Outside the window you cannot send free-form messages; you must use an approved template, and the customer must have opted in. The matching error is 131047.
Confirmed by developers.facebook.com
The recipient cannot receive it
Meta lists error 131026, unable to deliver, as possible when the recipient has no WhatsApp number, has not accepted the latest Terms of Service and Privacy Policy, or runs an outdated WhatsApp version.
Confirmed by developers.facebook.com
Marketing messages were held back
Error 131049 means the message was not delivered to maintain healthy ecosystem engagement. Meta advises waiting at least 24 hours before resending, because retrying sooner will likely fail again.
Confirmed by developers.facebook.com
Limits or billing on your side
Error 130429 means the throughput limit was reached, 131048 means restrictions on how many messages the number can send, often after blocked or spam-flagged messages, and 131042 is a payment method problem such as an unattached account or one over its limit.
Confirmed by developers.facebook.com
Nobody is reading the failure
A failed send produces a status webhook with the message id and error. If your system ignores those, failures look like silence.
Confirmed by developers.facebook.com
What can I do about it today?
- Pick one failed messageChoose one customer and one time. A single example is easier to trace than many.
- Ask for the error codeAsk whoever runs the integration for the code and text on that failed message, and look it up in Meta's list.
- Check whether the customer wrote recentlyIf they did not, the message needs an approved template.
- Check billing in WhatsApp ManagerLook for unpaid balances or a removed payment method on the account.
- Do not resend in a loopRepeating the same message can make a limit or quality problem worse.
When should I bring someone in?
- Many customers are affected at once.
- The number shows a quality or limit warning.
- Failures are not being recorded anywhere you can see.
How do I handle it?
- Collect the failure recordsI pull statuses and error codes for a sample of messages and group them by reason.
- Match each reason to its causeWindow, template, opt-in, limit, billing or recipient, each has a different fix.
- Fix the sending logicThe system picks a template or a free-form message depending on the window, and does not retry blindly.
- Store delivery statusStatuses from webhooks are saved so you can see sent, delivered, read or failed per customer.
- Alert on patternsA rise in one error code triggers a message to you before customers complain.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Why do some customers receive messages and others not?
Delivery depends on each recipient, on whether their window is open and on opt-in, so results can differ between customers.
What does error 131047 mean?
Meta describes it as more than 24 hours having passed since the recipient last replied, so a template message is needed.
Will Meta tell me why a customer did not get it?
Sometimes. The failed status carries an error, but it may only name a category such as unable to deliver.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.