Home WhatsApp | Connection, templates and sending Why Is My Message Not Being Sent? Complete Error Guide (WhatsApp, Twilio, and Email)

Why Is My Message Not Being Sent? Complete Error Guide (WhatsApp, Twilio, and Email)

Last updated on Sep 02, 2026

Sometimes your message may not be sent and an error message appears. We have mapped all cases using the details from Meta about what to do when each specific error appears.

Example of how the error message appears. The box will be red and will display a see details link that opens a modal:

You can view the error details by clicking see details:

Cloudchat displays the details for all error codes from Meta

Common Errors and Detailed Explanations

🔴 131049 – WhatsApp – Policy Violation

  • Description: Message not delivered to maintain healthy ecosystem engagement

  • Channel: WhatsApp

  • What it means: WhatsApp has blocked delivery due to policy violation.

  • Common Causes:

    • Content considered spam or of low quality.

    • High block/report rate from users.

    • Lack of valid opt-in.

  • Recommended Action:

    • Review approved templates and language used.

    • Improve opt-in collection.

    • Monitor quality metrics in Meta Business Manager.

🟠 131026 – WhatsApp – Message Undeliverable (generic)

  • Description: Message Undeliverable

  • Channel: WhatsApp

  • What it means: The message could not be delivered, without specific details.

  • Common Causes:

    • Invalid, deactivated, or blocked number.

    • User uninstalled the app.

    • Temporary error in Meta's infrastructure.

  • Recommended Action:

    • Validate numbers before sending.

    • Ensure updated opt-in data.

    • Reprocess sends in case of transient error.

🟡 131048 – WhatsApp – Spam Rate Limit Hit

  • Description: Spam rate limit hit

  • Channel: WhatsApp

  • What it means: The account has exceeded the allowed sending limit.

  • Common Causes:

    • Sending volume above the quality tier.

    • Low reputation account.

  • Recommended Action:

    • Segment sends.

    • Monitor reputation metrics.

    • Request limit review if necessary.

🟡 63024 – Twilio/Email/WhatsApp – Generic API Error

  • Description: Generic WhatsApp Cloud API error code

  • Channel: Multichannel (Twilio, Email, WhatsApp)

  • What it means: A generic API error without detailed cause.

  • Common Causes:

    • Network timeout or failure.

    • Invalid payload.

    • Transient API error.

  • Recommended Action:

    • Implement automatic retries.

    • Validate payloads.

    • Escalate to provider support in case of repeated errors.

🟡 130472 – WhatsApp – User Not Eligible

  • Description: User’s number is part of an experiment / not eligible

  • Channel: WhatsApp

  • What it means: The user's number cannot receive messages at this time.

  • Common Causes:

    • Number in Meta sandbox/test environment.

    • User not enabled to receive commercial messages.

  • Recommended Action:

    • Confirm number eligibility.

    • Escalate to provider if recurring.

🟠 #100 – Facebook – Invalid Action

  • Description: Invalid action (not owner of topic / invalid API call)

  • Channel: Facebook (API)

  • What it means: The call made is invalid.

  • Common Causes:

    • Incorrect endpoint.

    • Token without permission.

    • Invalid parameters.

  • Recommended Action:

    • Review payloads and permissions.

    • Check Graph API documentation.

🔴 131042 – WhatsApp – Business Eligibility Issue

  • Description: Payment or account not allowed

  • Channel: WhatsApp

  • What it means: The account is not eligible to send messages.

  • Common Causes:

    • Business in a restricted category.

    • Lack of verification in Business Manager.

    • Pending payment.

  • Recommended Action:

    • Resolve billing issues.

    • Verify eligibility in Meta Business Manager.

🟡 131047 – WhatsApp – Re-engagement Failed

  • Description: 24h window exceeded – Re-engagement message failed

  • Channel: WhatsApp

  • What it means: Message sent outside the 24h window without using a template.

  • Common Causes:

    • Response sent after the allowed limit.

  • Recommended Action:

    • Use approved templates for re-engagement.

    • Set up alerts to respect the window.

🟡 Additional Errors (by channel):

  • Email:

    • 451 4.7.1 → Rate limit reached on email server.

    • 535-5.7.8 → SMTP authentication failure.

    • 003 → Network timeout during send.

    • 2603 → Network unreachable.

  • Twilio:

    • 21617 → Message exceeds 1600 characters.

    • 63007 → Invalid “From” channel.

    • 63018 → Rate limit.

    • 63049 / 63032 / 63016 → General provider errors.