Fix the WhatsApp "Message Undeliverable" Error in Sparkforge

By Sparkforge Support Team ·Last reviewed May 3, 2026

WhatsApp Message Undeliverable errors come from missing WhatsApp on the recipient's number, marketing-template throttling, outdated app versions, declined ToS, or being blocked. Most cases resolve with a utility template or by waiting for the recipient to message you first.

When a Sparkforge WhatsApp send fails with Message Undeliverable, the cause is one of five things. Identify which, then apply the matching fix.

1. The recipient's number doesn't have WhatsApp

Not every phone number is WhatsApp-active. Verify the contact has WhatsApp by checking against a tool like 2chat.co/tools/whatsapp-checker. If they don't, switch the channel to SMS or email.

2. Marketing template limit reached

Meta caps how many marketing templates a single recipient can receive across all businesses in a given period. Once they hit the cap, your marketing template is blocked. The cap isn't specific to your business — it's a Meta-wide protection.

Fix: send a utility template instead (no cap), or wait and retry later.

3. The recipient hasn't accepted Meta's updated terms

If the recipient hasn't accepted Meta's current Terms of Service or Privacy Policy on WhatsApp, your messages won't deliver to them. There's nothing to do on your side — the contact has to accept the terms inside their app.

4. The recipient is on an outdated WhatsApp version

Meta requires minimum app versions for delivery. Recipients below these versions won't receive your messages:

Android: 2.21.15.15
SMBA (WhatsApp Business Android): 2.21.15.15
iOS: 2.21.170.4
SMBI (WhatsApp Business iOS): 2.21.170.4
KaiOS: 2.2130.10
Web: 2.2132.6

Ask the contact to update the app, or fall back to SMS/email.

5. The recipient blocked your business number

If they blocked you, no message gets through. There's no fix on the sending side — the contact has to unblock the number.

Two reliable workarounds

Send a utility template: utility templates are exempt from marketing throttling and bypass the most common cause of the error.
Have the customer message first: when a recipient initiates the conversation, the 24-hour customer service window opens and free-form messages flow normally.

Frequently Asked Questions

How do I know which of the five causes triggered the error?

Sparkforge surfaces a generic Message Undeliverable error. Start by checking if the number has WhatsApp at all, then check whether you're sending a marketing template. Those two cover most cases.

Why does sending a utility template work?

Utility templates (confirmations, reminders, account updates) are exempt from Meta's marketing throttle. They also have higher deliverability when ToS or app-version issues exist on the recipient side.

What if I just need to send a one-off marketing message?

Wait until the recipient initiates a conversation with you — that opens a 24-hour customer service window where you can send free-form messages without template restrictions.

Can I tell if the recipient blocked my number?

WhatsApp doesn't expose a direct blocked-status indicator. Persistent Message Undeliverable errors to the same contact while other messages flow normally are a strong signal.