Troubleshooting · Diagnostic

WhatsApp Message Not Delivered: 5 Causes & How to Fix Each

When a WhatsApp message fails, it falls into one of 5 specific causes. Each has a specific fix. This guide is the 5-minute diagnostic flow plus the prevention checklist so you stop seeing this error.

5 root causes5-min diagnosisFixable: 4 of 5
5CausesQuality limit · blocked · template · opt-in · 24hr
4Fixable causesOnly "blocked" has no recovery
5minDiagnosis timeCheck error code · match to cause
24hCustomer service windowAfter that, templates only

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

1

Quality limit

You hit your messaging tier cap. Pause sending. Check Business Manager.

2

Recipient blocked

They removed your number. No recovery — Meta protects them.

3

Template rejected

Marketing template not approved. Resubmit per Meta rules.

4

Missing opt-in

Recipient never consented. Get opt-in before any marketing.

5

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.

How to check: WhatsApp Business Manager → Account Quality → "Messaging Limits" + "Quality Rating." If quality is yellow or red, focus on fixing that before hitting tier limits again. See the banned account guide for the longer recovery path.

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

Step 1

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
Step 2

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

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 free

Frequently 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.