> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nova.galaxa.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Error Codes & Troubleshooting

> Reference guide for Meta WhatsApp delivery failure codes, frequency caps, and how Galaxa Nova handles them automatically.

# Meta Error Codes & Troubleshooting

When delivering high-volume WhatsApp broadcast campaigns, Meta’s Cloud API enforces delivery limits, quality ratings, and spam protections.

Understanding Meta’s error codes helps merchants protect their phone number health and maintain high delivery rates.

***

## Meta Delivery Failure Codes Matrix

| Error Code | Error Title | Why It Happens | How Galaxa Nova Handles It | Merchant Action |
| :- | :- | :- | :- | :- |
| **`131049`** | **Message Undeliverable (Frequency Limit)** | Meta limits how many marketing messages a user can receive across all businesses in a 24-hour window to protect user experience. | **Enqueued in Smart Retry:** Nova places the recipient in a delayed retry queue (+12h, +24h, +48h) with randomized jitter. | **None required.** Nova handles retry scheduling automatically. |
| **`131026`** | **Message Undeliverable (Invalid / Non-WhatsApp)** | The recipient phone number is not registered on WhatsApp or has blocked business communications. | **Suppressed & Isolated:** Nova isolates the number and excludes it from your campaign delivery denominator. | **None.** Number is automatically flagged to prevent future charges. |
| **`130429`** | **Rate Limit Hit (Throughput Cap)** | Your WhatsApp Business account exceeded its messages-per-second Cloud API throughput limit. | **Automatic Throttling:** Nova automatically throttles dispatches and smooths delivery spikes across rolling windows. | **None.** Delivery automatically resumes within limits. |
| **`132000`** | **Template Content Mismatch** | A custom template is missing required dynamic text values. | **Pre-Flight Validation:** Nova validates message content before dispatching, preventing faulty messages from hitting Meta. | **Review Template Text** in your campaign setup. |
| **`131051`** | **Unsupported Message Type** | Attempting to send rich media or interactive buttons that are not supported by the customer's older WhatsApp version. | **Graceful Degradation:** Nova converts interactive elements to standard links for older handsets. | **None.** |

***

## Phone Number Quality Ratings

Meta assigns every WhatsApp Business phone number a real-time Quality Rating visible in your Galaxa Nova Dashboard:

* **Green (High Quality):** The account is operating normally with high message engagement and low user block rates.
* **Yellow (Medium Quality):** A small increase in user blocks or spam reports has occurred. Review recent broadcast copy and audience targeting.
* **Red (Low Quality):** Multiple recipients have reported or blocked your number. Meta may restrict daily messaging limits until engagement improves.

***

## Brand Safety Safeguards

> [!TIP]
>
> Nova includes built-in safeguards to ensure your phone number remains in the **Green** tier:

1. **Automatic Unsubscribe Handling:** Any customer who replies with words like *"STOP"*, *"UNSUBSCRIBE"*, or *"REMOVE"* is immediately opted out of future promotional campaigns.
2. **Inbound Support Suppression:** If a customer opens a live support inquiry with your brand while a marketing retry is pending in the queue, Nova immediately suppresses the marketing message to avoid customer frustration.
3. **Wholesale Spend Cap:** Hard limits prevent unintentional mass dispatches that could harm your sender reputation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.