WhatsApp error 131049: why Meta didn’t deliver your marketing message

What WhatsApp error 131049 means

Error 131049 means WhatsApp received your marketing template but decided not to deliver it to that customer. The message gets a failed status, and the error tells you why. These are the exact strings Meta returns:

Meta links this error to its per-user marketing template limits. It applies to marketing templates, the category Meta uses for promotions, offers, cart reminders and other messages meant to drive sales.

Why WhatsApp limits marketing messages per customer

WhatsApp limits marketing messages per customer so people who stop reading promotions are not flooded with them. Meta says it may cap the number of marketing templates a WhatsApp user receives from any business in a given period when that person is less likely to be receptive. Three things follow from how Meta describes the limit:

• It is set per customer, across all businesses. Your store shares the customer’s marketing allowance with every other business messaging them, so your own sending volume is only part of the picture.
• It changes over time. Meta looks at the customer’s recent marketing read rate and at how many messages they have from friends, family and businesses. The limit adapts automatically as their engagement changes.
• A customer reply opens a 24-hour exemption. Each delivered marketing template counts toward the limit. If the customer replies to a marketing message, a 24-hour customer service window opens, and marketing messages you send inside that window do not count.

Meta also stops repeated retries. If you keep resending marketing templates within 24 hours to customers who have reached their limit, delivery to those customers may be unavailable for up to 24 hours, and every attempt returns 131049.

Which Whapi messages can hit error 131049

Only messages that Meta has categorized as Marketing count toward the per-user limit. Meta assigns the category when it reviews each template, using its utility vs marketing template rules. Here is how that usually plays out for the messages Whapi sends:

If you see 131049 on a message you think is transactional, check its category first. A order confirmation with a discount code or a “shop our new arrivals” line is mixed content, and Meta treats mixed content as Marketing.

How to fix WhatsApp error 131049

You fix error 131049 by waiting before you retry and by changing who you send marketing messages to, because the limit sits with the customer. Work through these steps in order:

1. 1

   Confirm the error code is 131049

   Check the error code on the failed message. Codes 131050, 130472 and 131048 also stop marketing messages, but each needs a different fix.

2. 2

   Wait at least 24 hours before resending to that customer

   Meta asks you to wait at least 24 hours before resending a template that failed with 131049. Retrying sooner returns the same error, and repeated retries can stop delivery to that customer for up to 24 hours. Customers who are not at their limit still receive your messages.

3. 3

   Check the category of the template

   Open WhatsApp Manager, go to Message templates and check the category. If a transactional message such as an order confirmation shows as Marketing, remove the promotional wording, then request a category review or submit it again as a new Utility template.

4. 4

   Send campaigns to customers who read them

   Meta weighs each customer’s recent marketing read rate. Send fewer campaigns to a narrower audience, such as recent buyers or customers with a specific tag, instead of your whole list.

5. 5

   Give customers a reason to reply

   When a customer replies to a marketing message, a 24-hour customer service window opens, and marketing messages sent inside that window do not count toward the limit. A quick reply button such as “Show me” makes replying one tap.

If you have connected Whapi to Claude, you can also ask “Why are my WhatsApp messages failing?” Seeing why messages failed is available on every Whapi plan.

On Pro and Team, Whapi campaigns can target segments built from Shopify data, such as purchase history, order value, product categories, customer tags and location. For example, send a new arrivals campaign to customers who bought from that product category instead of to every contact you have. Our WhatsApp marketing templates show how to word offers so customers have a reason to tap a button.

Error 131049 vs similar WhatsApp errors

Four error codes can stop a marketing message, and each one needs a different response. Use the code to decide what to do next:

For codes outside marketing, see error 131047 for an expired 24-hour window, error 131026 for an undeliverable number and the full WhatsApp Business API troubleshooting list.

Do you pay for messages that fail with 131049?

No. Meta charges only when a message is delivered, so a marketing template that fails with 131049 costs nothing. When the same customer receives it later, Meta bills the Marketing rate for their country. On Meta’s current rate card the Marketing rate is higher than the Utility rate in every market:

Because failed sends are free, the real cost of 131049 is a missed sale, not a bill. That is another reason to aim campaigns at customers who read them.

How to keep your marketing messages deliverable

Marketing messages stay deliverable when customers want them and act on them. Meta’s own message quality guidelines say to:

• Message only customers who opted in to hear from your business on WhatsApp.
• Make messages personal and useful, and keep them short.
• Avoid open-ended welcome or introductory messages.
• Avoid sending too many messages per day.
• Follow the WhatsApp Business Messaging Policy.

Keep transactional messages separate from promotions. Customers rarely mute a message about their own order, and Utility templates such as shipping updates are not counted toward the marketing limit.