Guides
Why WhatsApp Messages Fail to Deliver (and How to Clean Your List)
The five reasons WhatsApp messages fail, which ones mean the number is the problem, and how to find and remove numbers you can’t reach.
You send a reminder to 300 members. The next morning, 276 have received it. What happened to the other 24? Some numbers were typed wrong a year ago. Some people switched phones. A few stopped your messages. And one or two failed for a reason that had nothing to do with the number at all.
This guide explains the common reasons a WhatsApp message fails, which ones mean the number is the problem and which mean the message is, and how to clean your list so your counts reflect the people you actually reach.
Sent, delivered, read: what they mean
- Sent: MsgOrb handed the message to Meta.
- Delivered: it arrived on the person's phone.
- Read: they opened it (if they haven't switched read receipts off).
- Failed: Meta couldn't deliver it, and told MsgOrb why.
Meta charges only for messages it delivers, so a failed message doesn't cost you a Meta fee. But a list full of failing numbers still hurts: those contacts take places on your plan, and your delivery numbers look worse than your real reach.
The five reasons messages fail
MsgOrb records every failure with Meta's reason and shows it in plain words. These are the ones you'll see most.
1. Not on WhatsApp, or this number can't receive WhatsApp messages
The number isn't on WhatsApp, is mistyped, or can't receive messages from businesses. This is a problem with the number. Check it with the person; if it's wrong or they don't use WhatsApp, remove it.
2. This person stopped marketing messages from you
They chose, inside WhatsApp, to stop marketing messages from your business. Don't send them Marketing templates. Utility messages they asked for, such as a receipt or an entry pass, can still be sent.
3. Outside the 24-hour window: send an approved template instead
A free-form message went to someone who hasn't written to you in the last 24 hours. The number is fine; the message type was wrong. Send an approved template instead, or wait until they message you. The 24-hour window, explained.
4. Meta held back a Marketing template to a US number
Meta doesn't deliver Marketing templates to US phone numbers. The number is fine. For messages people signed up for, use a Utility template: a factual notice about something they already belong to. MsgOrb's template library has dozens written that way.
5. No payment method on your WhatsApp Business Account
Meta needs a card on your WhatsApp Business Account before it delivers templates. Add one in Meta's Business settings: here's how. Every message will fail until you do, and none of them is the number's fault.
The quick rule: reasons 1 and 2 are about the number. Reasons 3 to 5 are about the message, so the number is fine and the next correct message will reach it. Only clean out numbers with the first kind of problem.
How to find failing numbers in MsgOrb
- Open Groups and the group you want to clean.
- If any number's latest message failed in the last 30 days, a red bar at the top says how many, and how many can't receive WhatsApp at all.
- Click Show failing numbers to list only those. Each is marked Failing, with the reason.
A later delivered message clears the mark by itself, so a number that failed once because of the 24-hour window won't stay flagged forever. For a big group, Search name or number above the roster finds one person fast. You can also see every failure across your account on the Delivery and Queue Health page.
How to remove them
- One at a time: click the remove button at the end of the row.
- All at once: click Select numbers WhatsApp can't reach. It ticks every number with a number problem and leaves the ones that failed for message reasons. Then click Remove selected and confirm.
Removed contacts are deleted from your organization's contacts, so they stop getting messages from every group, and their place on your plan is free again. You can add them back later if you get a correct number.
How to keep the list clean from the start
- Let people type their own number. With Text JOIN, people scan a QR code and send JOIN from their own phone, so the number can't be mistyped. A join link does the same.
- Use the country picker. Every phone field in MsgOrb has one, which prevents most mistyped numbers, especially for members with numbers abroad.
- Clean once a quarter. Open your biggest groups, show failing numbers, and remove the ones that can't be reached.
- Keep reminders Utility. Factual notices are delivered to US numbers; promotions aren't.
A clean list means your delivery numbers tell the truth and every place on your plan goes to someone you can reach. See list cleanup on the Broadcasts page, read the step-by-step help article, or start free.