Why Your WhatsApp Message Wasn't Delivered

When you send a WhatsApp message to a parent or prospective family, you might see it marked as "sent" but not "delivered." Here's what could be happening and how to fix it.

Common Reasons Messages Don't Get Through

1. Parent Was Offline for More Than 30 Days

WhatsApp holds messages for offline users for up to 30 days. If the parent doesn't open WhatsApp within that window, your message won't be delivered.

2. Your Number Was Blocked

If a parent has blocked your business number, messages won't go through. WhatsApp won't notify you directly due to privacy policies.

3. Geographic Restrictions

WhatsApp Business isn't available for users in certain regions:

  • Cuba
  • Iran
  • North Korea
  • Syria
  • Crimea, Donetsk, and Luhansk (Ukraine)

Note: As of May 15, 2024, Turkey is fully supported.

4. Outdated WhatsApp Version

Parents using old versions of WhatsApp may not receive your messages. They need to update to at least:

  • Android: 2.21.15.15 or newer
  • iOS: 2.21.170.4 or newer
  • Web: 2.2132.6 or newer

Parents also need to accept WhatsApp's latest Terms of Service at https://wa.me/tos/20210210

5. Marketing Message Limits

WhatsApp limits how many marketing messages a person can receive in a day (typically 5-6). If a parent has already received several promotional messages, yours may be temporarily blocked.

Pro Tip: Use utility templates (like appointment reminders or confirmations) instead of marketing templates when possible—these aren't subject to the same limits.

6. Invalid Phone Number

If the phone number isn't registered with WhatsApp or was entered incorrectly, your message won't go through.

7. Technical Errors

Sometimes messages fail due to technical issues on WhatsApp's end, like temporary API downtime or formatting problems with your message template.

8. Multiple Devices

You might see both "delivered" and "failed" statuses if the parent is logged into WhatsApp on multiple devices. If it reached at least one device, the message is considered delivered.

What to Ask Parents

If you're not sure why a message failed, try these steps:

  • Ask them to check that they haven't blocked your number
  • Have them send you a message first (this opens a 24-hour window for free-form replies)
  • Confirm they've accepted WhatsApp's latest Terms of Service
  • Ask them to update to the latest WhatsApp version
  • Verify they're not in a restricted region

Fixing Technical Issues

Authentication Errors

If you're getting authentication errors, your access token may be invalid or missing permissions.

How to fix it:

  1. Use Meta's Access Token Debugger to verify your token
  2. Ensure your token has these permissions:
    • whatsapp_business_management
    • whatsapp_business_messaging
  3. If not, regenerate your token with the correct permissions

Meta API Downtime

When Meta updates its systems, brief outages (up to 5 minutes) can occur. Just wait a few minutes and try again.

Understanding the 24-Hour Window

Once a parent messages your center, you have 24 hours to respond with any message you want. After that window closes, you can only reach out using pre-approved message templates.

This is why it's helpful to have parents initiate contact when possible—it gives you more flexibility in how you communicate.

Frequently Asked Questions

Why does my message show as "sent" but not "delivered"?

This usually means your message left Enrollio's system but didn't reach the parent's device. Common causes include:

  • Parent offline for over 30 days
  • Your number was blocked
  • Parent hasn't accepted latest WhatsApp terms
  • Outdated WhatsApp version
  • Invalid phone number
  • Marketing message limits reached
  • Geographic restrictions

What does "Message Undeliverable" mean?

It means the message couldn't reach the parent's device, usually because they blocked your number, were offline too long, or there's a technical restriction in place.

How can I tell if a parent blocked my number?

WhatsApp won't tell you directly. But if other messages to the same parent work fine or they're consistently unresponsive, blocking is possible.

What's the "high-quality user experience" error?

This happens when a parent has received too many marketing messages in one day (usually 5-6). WhatsApp temporarily blocks additional marketing messages to prevent spam.

Solution: Ask the parent to message you first, use a utility template instead, or wait and try again later.

Can I send WhatsApp messages to parents in any country?

No. WhatsApp Business is restricted in Cuba, Iran, North Korea, Syria, and parts of Ukraine (Crimea, Donetsk, and Luhansk).

What if I see both "delivered" and "failed" for the same message?

This happens when a parent is logged into WhatsApp on multiple devices. Your message reached at least one device, so it counts as delivered.

What should I do about authentication errors?

Use Meta's Access Token Debugger to check your token. Make sure it includes whatsapp_business_management and whatsapp_business_messaging permissions. If not, regenerate your token.