Errors When Sending Messages via WABA

Errors When Sending Messages via WABA

How to Find the Cause of an Error

If a message wasn’t delivered, an exclamation mark will appear next to it. To find out the cause, hover your cursor over it in the “Chats” section or in your message history. The error message will help you quickly understand what went wrong and how to fix it.

Error Descriptions

Re-Engagement message

You are attempting to send a custom (non-template) message via WABA outside the 24-hour window—that is, more than 24 hours have passed since the customer’s last message.

Solution: Custom messages via WABA can only be sent within an open 24-hour window. If the window is closed, the following options are available:

• send an approved template message (for a fee);
• use the SuperWhatsApp channel, which automatically selects the appropriate delivery method depending on the window’s status.

Business eligibility payment issue

An error occurred while sending a template message due to a payment issue in your Meta account.

Solution: Go to Meta Business Manager → the “Payments” section and check your linked payment method. If it’s outdated or rejected, add an up-to-date one.

Account billing issue

A general issue with Meta account billing that may partially restrict message sending.

Solution: Go to Meta Business Manager → the “Billing” section and check for any errors or notifications that require your attention.

Message undeliverable

Message undeliverable—the customer’s number is not registered on WhatsApp, is unavailable, or the customer has blocked your number.

Solution: Ask the customer for their current number or contact them through an alternative channel—such as Telegram or SMS.

Spam rate limit reached

Message sending limit exceeded—the account has been temporarily restricted due to suspicious activity.

Solution: Pause sending messages and wait for the restriction to be lifted. Once the restriction is lifted, review your messaging strategy: reduce the volume, increase message personalization, and ensure that your contact list is up to date and that customers have consented to receive messages.

Template not approved

The template did not pass Meta moderation or was rejected.

Solution: Check the reason for rejection in Meta Business Manager → “Message Templates” section, revise the template text to comply with Meta’s policies, and resubmit it for review.