WhatsApp Bulk Messaging Delivery Issues

When sending bulk messages through Socialone, most campaigns are delivered successfully. However, sometimes certain messages may face delivery issues due to platform restrictions, user account conditions, or technical errors.

These issues may include Message Undeliverable, Healthy Ecosystem Restriction, User Number in Experiment, Business Eligibility or Payment Issue, Generic Errors, and Media Upload Errors. This guide explains what each issue means, why it occurs, and how you can resolve it.

Overview links: Documentation Home · Settings Overview

Where to Find This

• Campaigns → Broadcasts, open a campaign to see delivery status.

Settings Quick Map

• Settings → Templates: improve template quality to reduce failures.
• Settings → Platforms: confirm WhatsApp is connected.
• Settings Overview

Common Error Codes

• 131026 — Recipient is not on WhatsApp.
• 131021 — Invalid phone number.
• 131047 — Outside 24h window; use a template.
• 130429 — Rate limit reached; retry later.
• 100 — Message rejected due to invalid content.

Message Undeliverable

What it means: The message did not reach the recipient.

Why it happens:

• Invalid or inactive phone number.
• Recipient not on WhatsApp.
• User blocked your business.
• Temporary connectivity issues.

How to resolve:

• Verify the phone number is valid and active.
• Ensure the user has WhatsApp installed.
• Encourage customers to save your business contact.
• If blocked, the message cannot be delivered.

This message was not delivered to maintain healthy ecosystem engagement

What it means: WhatsApp blocked the message to prevent spammy or unwanted communication.

Why it happens:

• Too many bulk messages sent within a short period.
• Template received negative user feedback.
• Template content is too promotional or low quality.

How to resolve:

• Use Meta-approved, conversational templates.
• Personalize your messages for better engagement.
• Avoid spamming the same users frequently.
• Monitor template quality score in Meta Business Manager.

User’s Number is Part of an Experiment

What it means: Meta is testing delivery behaviors for certain users, which may affect message delivery.

Why it happens:

• The recipient is part of Meta’s experimental group.

How to resolve:

• No action required. Delivery may vary temporarily.
• Try resending later or using a different template.

Business Eligibility Payment Issue

What it means: Your business account has billing or payment-related problems.

Why it happens:

• Payment failed or not set up correctly.
• Message quota exceeded without top-up.

How to resolve:

• Check billing in Meta Business Manager.
• Add or update a valid payment method.
• Ensure your account has sufficient credits.

Something Went Wrong

What it means: A generic error occurred due to a system or API issue.

Why it happens:

• Temporary WhatsApp API downtime.
• Connectivity or server-side issues.

How to resolve:

• Retry sending after some time.
• If the issue persists, contact Socialone support.

Media Upload Error

What it means: The attached media file could not be uploaded or processed.

Why it happens:

• File too large (over WhatsApp’s size limits).
• Unsupported file format.
• Poor internet connection during upload.

How to resolve:

• Check WhatsApp’s media size limits (images < 5MB, videos < 16MB, docs < 100MB).
• Use supported file formats (JPG, PNG, MP4, PDF).
• Retry upload after compressing or resizing the file.

Best Practices to Reduce Delivery Issues

• Always use Meta-approved templates.
• Keep content helpful, relevant, and non-spammy.
• Send only to opted-in, valid numbers.
• Monitor template quality in Meta’s WhatsApp Manager.
• Ensure your billing setup is valid and active.

Next Steps

• Template Setup
• Broadcasts Overview
• API Messaging

Need Assistance?

If you continue to face delivery issues, please reach out to our support team anytime for help.