Skip to content
QuickSamvaad

Troubleshooting: Meta error codes and fixes

What Meta's error codes mean in plain language and what to do about each one, plus fixes for connections, templates, campaigns, bots, imports and webhooks.

Reading time
9 min
Last updated
Applies to
QuickSamvaad web app

When WhatsApp refuses a message, QuickSamvaad shows Meta's error code and what it means beside the message, in the campaign report and in the API. Find the code below. Paste a code into the help center search to jump straight to it.

Error codes

The 24-hour window

131047

Not retried

Conversation window closed

What it means
More than 24 hours have passed since the customer last wrote to you, so WhatsApp only accepts an approved template. QuickSamvaad marks the window as closed straight away.
Fix
Send an approved template instead. In the inbox the composer switches to Templates only on its own; once the customer replies, the window opens again for 24 hours.

About the recipient

131049

Never retried

Meta's marketing limit for this person

What it means
Meta caps how many marketing messages one person receives from all businesses, to keep WhatsApp useful for them. This person reached the cap. It is not a fault in your template or your account.
Fix
Do nothing now. QuickSamvaad never retries this error and rests the contact from marketing for 24 hours; campaigns skip them until then as Resting after Meta's limit. Utility and service messages still go through. Sending fewer, more relevant offers helps more of them land.

130472

Never retried

Part of Meta's experiment

What it means
Meta holds back marketing messages to a small group of people to measure how marketing affects them. This person is in that group.
Fix
Nothing to fix. QuickSamvaad never retries it, and leaves the contact out of marketing campaigns (shown as In Meta's holdout group) until they message you again.

131026

Not retried

Can't receive WhatsApp

What it means
The number isn't on WhatsApp, is on a very old version of the app, or the person hasn't accepted WhatsApp's latest terms. Meta deliberately doesn't say which.
Fix
Check the number and its country code on the contact. If it is right, ask the customer to update WhatsApp, or reach them another way. Repeated sends to the same number fail the same way.

131050

Not retried

They stopped marketing messages

What it means
The person turned off marketing messages from your business inside WhatsApp.
Fix
Respect it. Leave them out of promotions; they can still get order updates, reminders and replies to their own questions.

Speed limits

131056

Retried automatically

Too many messages to one person

What it means
Your number sent messages to the same person faster than WhatsApp allows for one pair of numbers.
Fix
QuickSamvaad waits and tries again automatically, leaving a longer gap each time. If you see it often, send one longer message instead of several short ones in a row.

130429

Retried automatically

Number throughput limit

What it means
Messages were sent faster than your number's per-second limit (80 a second on the Cloud API, 20 for coexistence numbers).
Fix
QuickSamvaad paces sends below this limit and retries automatically. If a message still fails with this code, contact us with the campaign name.

131048

Retried automatically

Spam rate limit

What it means
Meta slowed your number because many recipients blocked or reported it recently.
Fix
Sending pauses briefly and resumes on its own. Before your next campaign, send only to people who agreed to hear from you and check your quality rating in Settings → Channels.

Template and content errors

132000

Not retried

Variables don't match the template

What it means
The number of values sent didn't match the number of variables in the approved template.
Fix
Open the campaign's Message step (or the bot step) and map every variable. If the template was edited on Meta recently, refresh templates and map again.

132001

Not retried

Template not found on Meta

What it means
No approved template with this name exists in this language on your WhatsApp Business Account.
Fix
Check the template's language and status in Templates. If you created or changed it in WhatsApp Manager, use Sync from Meta in Templates so QuickSamvaad picks it up.

132005

Not retried

Message too long

What it means
With the values filled in, the message is longer than Meta allows.
Fix
Shorten the values you map into variables, or tighten the template body.

132007

Not retried

Content policy

What it means
Meta's commerce or content policy blocked the filled-in message.
Fix
Change the wording or the values you insert. Check Meta's WhatsApp Business Messaging and Commerce policies for what is not allowed.

132012

Not retried

A value has the wrong format

What it means
A variable's value didn't match what the template expects, for example text where a media header needs a file.
Fix
Check the header media and every mapped value against the template's preview.

132015

Not retried

Template paused

What it means
Meta paused the template because recipients reacted badly to it (blocks, reports, low read rates).
Fix
Campaigns using it pause themselves. Wait for Meta to unpause it, or create a better-targeted template and send that.

132016

Not retried

Template disabled

What it means
Meta disabled the template after repeated quality problems. It can't be sent again.
Fix
Create a new template with different wording and send it to a narrower, opted-in audience.

131008

Not retried

A value is missing

What it means
A required variable had no value.
Fix
Add a fallback when you map the variable, so contacts without that attribute still get a sensible message.

131009

Not retried

A value isn't valid

What it means
Meta rejected one of the values, often a malformed link or phone number.
Fix
Check URL and phone values in the mapping; links must be full https:// addresses.

131053

Not retried

Media couldn't be sent

What it means
Meta couldn't download or process the image, video or document.
Fix
Use a supported file type and size, and make sure any link is public (not behind a login).

Your Meta account

131042

Not retried

Payment issue on your Meta account

What it means
Meta couldn't charge your payment method for paid messages.
Fix
Add or fix the card in Meta's Billing hub for your business portfolio. Paid messages fail until it is fixed; replies inside an open window are not affected.

131031

Not retried

Account locked

What it means
Meta locked your WhatsApp Business Account, usually after a policy review.
Fix
Open WhatsApp Manager to see the reason and request a review.

368

Not retried

Temporarily blocked by Meta

What it means
Meta restricted the account for a policy violation.
Fix
QuickSamvaad pauses the number for an hour and shows an alert. Check WhatsApp Manager for the reason before sending again.

190

Retried automatically

Connection to Meta expired

What it means
The access QuickSamvaad holds for your WhatsApp account is no longer valid, for example because someone removed it in Meta Business Suite.
Fix
QuickSamvaad pauses the number, keeps your messages queued and shows an alert. An owner or admin should connect the number again from Settings → Channels; queued messages then go out on their own.

Quality or messaging limit changed

You seeDo this
Quality rating dropped to yellow or redPause marketing campaigns. Look at the last few campaigns' read rates and opt-outs, narrow your segments to recently active, opted-in contacts and make opting out easy. Quality recovers as recipients respond better.
Messaging limit went downMeta lowers limits after quality problems. Campaigns already respect the new limit and spread sends over more days. Improve quality before large sends.
Number shows CriticalOpen the number in Settings → Channels for the reason. If Meta restricted it, check WhatsApp Manager; if the connection was lost, an owner or admin should connect it again.
Display name declinedChange it in WhatsApp Manager so it clearly matches your business name, then wait for review.

Connection problems

  • Meta's window doesn't open: allow pop-ups for QuickSamvaad and turn off blockers for facebook.com, then try again.
  • "Connected to another workspace": a WhatsApp Business Account belongs to one workspace at a time. Disconnect it there first.
  • "The authorisation expired": Meta's code is single-use and short-lived. Start again; finished steps are reused.
  • Messages stopped arriving: check the number's health in Settings → Channels. If it shows a connection problem, someone may have removed QuickSamvaad's access in Meta Business Suite; connect the number again.

Template problems

  • Rejected: open the template to read Meta's reason, fix it and submit again. The template guide lists every common reason.
  • Approved as Marketing instead of Utility: Meta found promotional wording. Remove it and create a new utility template, or keep it as Marketing.
  • Can't edit an approved template: Meta allows one edit per template in 24 hours, and the edit goes back to review.
  • Created in WhatsApp Manager but missing here: use Sync from Meta in Templates; it also runs every night.

Campaign problems

You seeWhyFix
Paused: template paused or disabledMeta paused the template for low quality.Resume once it is approved again, or cancel and use another template.
Paused: sending number disconnectedThe number lost its connection.Connect it again, then resume.
Paused after repeated errorsSending hit errors several times in a row.Resume to try again. If it pauses again, contact us.
Waiting for quiet hoursIt's between quiet-hours start and end in the campaign's time zone.Nothing; it continues when quiet hours end. Change quiet hours on the next campaign if you need to.
Waiting for the messaging limitThe audience is bigger than today's limit.Nothing; the rest goes out as the 24-hour limit frees up.
Failed: schedule missedIt couldn't start within six hours of its time.Schedule it again. It was not sent at an odd hour.
Fewer recipients than expectedContacts were left out: no consent, opted out, resting after Meta's limit and so on.The review step and the report list every reason with a count.

A bot isn't replying

  1. Is the bot published? Drafts never run.
  2. Does the trigger match? Test the customer's exact words in the simulator.
  3. Is the conversation assigned to a person? Bots don't start in assigned conversations.
  4. Did a bot already hand this conversation off? It stays with people until the conversation is resolved.
  5. Did the customer send an opt-out word? That stops the bot.
  6. Is the window closed? Free-form bot messages wait until the customer writes again.

Import problems

  • Wrong characters or the import fails at once: save the file as CSV UTF-8 (in Excel: Save As → CSV UTF-8).
  • Many rows rejected: download the error report. It lists the row, column and reason, such as a phone number that isn't valid for the default country.
  • Numbers read as the wrong country: include the country code, or set the default country before starting.
  • Contacts skipped: duplicates within the file, or existing contacts when "update existing" is off.

Webhook endpoint turned off

QuickSamvaad turns a webhook endpoint off after 50 failed deliveries in a row. Fix your endpoint, turn it back on in Settings → Developer, then redeliver the events you missed from the delivery log. Details in Developers.

Still stuck?

Contact us with the campaign or conversation, the time, and the error code you see. Never send us passwords or your Meta login.

Was this helpful?

If something was missing, unclear or wrong, tell us. We update these guides from what you send.

Send feedback