If a message isn't delivered, here's the 5-minute diagnosis
"WhatsApp message not delivered" is a stressful search to type when a customer message disappears into the void. The good news: WhatsApp delivery failures fall into 5 specific causes, and each has a specific fix. Within 5 minutes you'll know which one you hit.
The 5 causes — diagnose yours first
Quality limit
You hit your messaging tier cap. Pause sending. Check Business Manager.
Recipient blocked
They removed your number. No recovery — Meta protects them.
Template rejected
Marketing template not approved. Resubmit per Meta rules.
Missing opt-in
Recipient never consented. Get opt-in before any marketing.
Outside 24hr window
Can't send free-form; need approved template.
Cause 1 — Quality rating + messaging tier limits
Meta gives you a starting tier (typically 1,000 unique recipients in 24 hours for Tier 1) and grows you to Tier 2 (10K), Tier 3 (100K), Tier 4 (unlimited) based on quality. When you hit your cap, additional messages don't deliver until the rolling window resets.
Cause 2 — Recipient blocked your number
If the customer blocks your WhatsApp number, your messages to them simply don't deliver — Meta does not show you that they blocked you. The single dropped message looks identical to other delivery failures. This is intentional, to protect the recipient.
Fix: There isn't one. The recipient must unblock you. Going forward: track block + report rates carefully (they show up as quality-rating drops). Send less, send more relevant, segment better — see customer segmentation.
Cause 3 — Template not approved (or got rejected)
Templates that Meta hasn't approved cannot be sent. If your template was approved last week and rejected this week, Meta sometimes re-reviews templates and pulls approval. Check WhatsApp Manager → Message Templates for status.
Fix: Read the template approval guide — covers the 6 rejection reasons and the fix per reason. Resubmit with a corrected version. Marketing templates take longer than Utility; categorisation matters.
Cause 4 — Recipient never opted in
Specifically for promotional/Marketing messages: if your contact list includes numbers without recorded opt-in, sends to those numbers will fail with policy violations. Meta increasingly enforces this — opt-in is no longer "nice to have."
Fix: Audit your opt-in records (Go4whatsup has consent timestamps). Remove non-opted-in contacts from marketing sends. Use Utility templates (transactional, no opt-in required) where possible. Read the opt-in guide for compliant collection.
Cause 5 — Outside the 24-hour customer service window
WhatsApp's free-form messaging is gated by the 24-hour rule: once a customer messages you, you have 24 hours to reply with free-form messages. After 24 hours of customer silence, you must use a pre-approved template.
If you try to send a free-form message after the window, it doesn't deliver. Common gotcha: agent responds 26 hours after customer's last message → fails.
Fix: Use a Utility template (cheapest tier) to re-open the conversation, or use an Marketing template if you have opt-in. The conversation window resets when the customer replies.
How to actually fix it — the diagnostic flow
Check the error code
- WhatsApp Manager → Logs → find the message
- Error codes 130472, 131056, 132012 etc each map to a specific cause
- If using a BSP, check the platform's send-log
Match to one of the 5 causes above
- Quality limit → pause, check Account Quality
- Blocked → no fix; segment better next time
- Template rejected → resubmit corrected
- No opt-in → audit consent records
- 24hr window → use Utility template
Prevention — don't hit this in the first place
- Watch quality rating daily — yellow is a warning, not a normal state.
- Segment your sends — irrelevant messages = blocks = rating drop.
- Opt-in records, always — explicit, timestamped, on every contact.
- Submit templates correctly — Utility for transactional, Marketing only for offers.
- Respect the 24hr window — train agents on the rule.
How Go4whatsup helps prevent and diagnose delivery failures
Three structural pieces: Quality dashboard shows your current tier + quality rating live so you don't hit caps blind. Opt-in audit trail with timestamps for every contact — no surprise rejections. Template management shows live approval status and reasons for rejection. Error code translator in the send-log maps Meta error codes to fixes.
Run WhatsApp without the delivery anxiety
Live quality dashboard · opt-in audit trail · template approval status · error code translator. Free-forever plan, no credit card.
Book a live demo Start freeFrequently asked questions
Why is my WhatsApp business message not being delivered?
Five common causes: (1) you hit your messaging tier limit, (2) the recipient blocked your number, (3) your template was rejected or de-approved by Meta, (4) the recipient never opted in to receive marketing messages, or (5) you sent a free-form message outside the 24-hour customer service window. Check WhatsApp Business Manager for the specific error code.
How do I check why a WhatsApp message failed?
Open WhatsApp Business Manager → Account → Logs (or your BSP's send-log). Find the message and check the error code. Codes like 130472, 131056, 132012 each map to a specific cause. Then match the cause to one of the 5 fixes above.
Can I recover from being blocked by a WhatsApp recipient?
No — Meta does not show you who blocked you and you cannot unblock yourself. The recipient must unblock you on their device. Going forward, focus on relevance and segmentation to reduce blocks before they happen.
Why was my WhatsApp template rejected by Meta?
Six common reasons: wrong category (Utility vs Marketing), variables without examples, URL shorteners, promotional language in a Utility template, spelling/grammar errors, missing opt-in/unsubscribe language. See the template approval guide for the fix per cause.
What is the WhatsApp 24-hour customer service window?
Once a customer messages you, you have 24 hours to reply with free-form (non-template) messages. After 24 hours of silence, you must use a pre-approved template to re-open the conversation. The window resets every time the customer replies.
How can I prevent WhatsApp delivery failures going forward?
Five rules: watch quality rating daily, segment your sends so messages are relevant, record opt-in for every contact with timestamp, submit templates with correct categorisation (Utility vs Marketing), and train agents on the 24-hour window rule.