Skip to main content

WhatsApp error 131049 when a marketing message isn't delivered

WhatsApp error 131049 means Meta chose not to deliver a marketing template to keep a healthy ecosystem. Learn why it happens and what you can do in Octopods.

Written by Mohamed Elbadwihi

WhatsApp error 131049 means Meta chose not to deliver your marketing template to that person "to maintain healthy ecosystem engagement". Meta makes this decision, not Octopods, and there's no setting that overrides it. Your template and channel are fine. You can try again later, or reach the customer in a way that isn't a marketing template.

Meta's per-user limit on WhatsApp marketing messages

Meta limits how many marketing templates each WhatsApp user receives from businesses. When a person reaches that limit, Meta stops delivering more marketing templates to them for a while and returns error 131049.

  • It only applies to marketing templates. Utility and authentication templates, and free-form replies inside an open 24-hour conversation window, aren't affected.

  • It applies even to loyal customers. Meta decides per recipient, based on how that person engages with marketing messages. Your relationship with the customer doesn't change it.

  • Meta doesn't say who is limited or for how long. You can't check in advance which recipients will be blocked.

  • It's not an account penalty. The error is about the recipient, not your number's quality rating.

Where you see error 131049 in Octopods

The failure reason shows wherever you track a message:

  • Intercom Inbox App: in View sent messages, click the failed row.

  • HubSpot: in the contact's Message History on the Octopods card.

  • Broadcasts (Intercom): in the Failed Contacts section of the broadcast detail page, or in the CSV from Download as CSV.

  • API: in the failure_reason field when you check the message status.

What to do when a WhatsApp marketing template isn't delivered

  1. Wait before you try again. Resending straight away is likely to fail again. In a broadcast, don't click Resend Failed Messages right away for contacts with this error.

  2. Wait for the customer to write. When the customer messages you, a 24-hour window opens. Free-form replies inside that window are delivered as usual.

  3. Use the right category. If the message is truly transactional, such as an order update or appointment reminder, send it as a utility template. Don't label marketing content as utility. Meta rejects templates in the wrong category.

  4. Try another channel. If the message is urgent, contact the customer on another channel, such as SMS.

  5. Send fewer, more relevant marketing messages. Send only to opted-in contacts who are likely to engage. This also protects your number's quality rating.

WhatsApp error 131049 FAQs

Is error 131049 caused by Octopods?

No. Meta returns it and Octopods shows it to you.

Can Octopods support or Meta support whitelist a customer?

No. Meta doesn't offer a way to bypass this limit for a recipient.

Will a utility template get through?

The per-user marketing limit doesn't apply to utility templates. Only use utility for real transactional messages. Meta reviews the category.

Why did it work yesterday for the same customer?

The limit changes over time based on how many marketing messages the person has recently received and how they engage with them.

Learn more about WhatsApp for Intercom.

Related articles

Did this answer your question?