WhatsApp

Why my WhatsApp message was not sent

Updated on 6 min read

A message that does not go out always shows its reason in WYP.chat. The most common causes are 24 hours without a message from the customer, a number that does not use WhatsApp, and no payment card at Meta. Each has its fix, set out below with the error code WhatsApp sends us.

Where to see the reason

  • In a conversation: under the message, Failed, then the reason in one sentence and, when trying again makes sense, the Retry button.
  • In a campaign: the campaign page, Exclusions and failures section: each reason and how many contacts it affects.

Temporary errors (WhatsApp cannot be reached right now, too many sends in a short time) are retried automatically. The others wait for you to act: sending the same message again unchanged would fail again.

The customer has not written for 24 hours

WYP.chat shows: “Free replies are over (24 hours passed)”. WhatsApp code: 131047.

After 24 hours without a message from the customer, WhatsApp only accepts an approved template. Send a template from the conversation, or wait for the customer to write again: see Write to a customer after 24 hours.

The number does not receive WhatsApp

WYP.chat shows: “Message not delivered: the number may not use WhatsApp”. Code: 131026.

WhatsApp does not say which of these reasons applies:

  • the number has no WhatsApp account, or it is mistyped (check the country code);
  • the customer has not accepted WhatsApp’s latest terms;
  • their app is too old.

Do not keep resending. Reach the customer another way (call, text, email) and ask them to message you on WhatsApp, or to update the app.

The customer has refused your messages

  • “This customer has blocked marketing messages from your business” (code 131050): they turned off your offers in WhatsApp. Do not insist: they will not receive them any more. Your service messages (order, appointment) still go out.
  • “This contact has opted out of marketing messages”: they replied STOP. WYP.chat no longer sends offers to this contact, even if it is deleted and created again.
  • A marketing message to a contact without consent is not sent at all: get their consent first, see WhatsApp consent form on your website.

WhatsApp is limiting your offers to this customer

WYP.chat shows: “WhatsApp has limited marketing messages to this customer for now”. Code: 131049.

WhatsApp caps how many marketing messages one person receives, across all businesses. The message is neither delivered nor charged. Wait at least 24 hours before resending: an earlier attempt comes back with the same error.

No card at Meta

WYP.chat shows: “No valid payment method on the WhatsApp Business account”. Code: 131042.

Templates do not go out without a payment method at Meta. Add a card to your business’s WhatsApp Business account, in Meta’s billing centre: see What you pay Meta on WhatsApp. The same code appears if the account has no time zone or currency, or if it was deleted or suspended.

The WhatsApp account is restricted

WYP.chat shows: “The WhatsApp Business account is restricted”. Codes: 368, 131031, 130497 (sending banned to some countries for your sector).

All your messages fail, for all your customers at once. Only you can ask Meta for a review: see WhatsApp account restricted or blocked by Meta.

A template problem

  • “The template variables are missing or invalid” (codes 132000, 132005, 132007, 132012, 132018): a variable is empty or one too many. In a campaign, give each variable a fallback text (for example “Hello” when the first name is missing).
  • “This template no longer exists on WhatsApp” (code 132001): it was deleted, or it is not approved in the chosen language.
  • “WhatsApp has paused or disabled this template”: paused for low quality (code 132015), edit it and wait for its new approval; disabled for good after several pauses (code 132016), create a new one with different text.

Too many messages in a short time

  • “Too many messages in a short time. Retrying automatically.” (code 130429): WYP.chat retries on its own.
  • “Too many messages sent to this customer” (code 131056): wait before writing to them again. Your other customers receive as normal.

WhatsApp is limiting sends from your number

WYP.chat shows: “WhatsApp is limiting sends from your number”. Code: 131048.

Meta restricts how many messages your number can send. According to Meta, this can come from too many messages being blocked or reported as spam. It is not a passing rush: WYP.chat does not retry on its own, because each new attempt goes out from the same restricted number.

Open Meta’s WhatsApp Manager and check the quality status of your number and your templates. The Retry button is still there, but a new attempt may fail while the limit lasts.

WhatsApp is limiting sends from your account

WYP.chat shows: “WhatsApp is limiting sends from your account”. Code: 131064.

According to Meta, your account has reached its message limit because some templates are classified in the wrong category. The limit applies to templates and to messages written directly alike. WYP.chat does not retry on its own: a new attempt would fail while it lasts.

Check the category of each template and fix any that do not match its content: see Prepare a template. Meta lifts the limit on its own at the end of its enforcement period, without saying how long it lasts. After that, the Retry button sends the message again.

A file was refused

WYP.chat shows: “File type not accepted by WhatsApp”, “File too large for WhatsApp” or “The file could not be passed on to WhatsApp” (code 131053). Send a JPEG or PNG image, an MP4 video, audio, a PDF or an Office document, within the sizes WhatsApp accepts (5 MB for an image, 16 MB for a video or audio, 100 MB for a document): the same rules apply to files you receive, see Why a file you received was refused.

A connection problem

  • “Access to this channel has expired or was revoked” (codes 190, 200, 131005): an administrator reconnects the number in Settings › Channels.
  • “Meta’s AI is handling this conversation”: Meta’s AI agent is answering this customer and Meta refuses WYP.chat’s replies. The reason shown says where to give WYP.chat control in Meta Business Suite.
  • “Meta’s test number can only message recipients added to its list” (code 131030): a Meta test number only writes to the numbers you have added to it. With your real number, this limit goes away.

An issue on our side

  • “Message not sent: an issue on our side blocked it”: nothing was received, click Retry.
  • “Sending was interrupted: we do not know if it went out”: first check whether the customer got it (a reply from them, for example), then retry only if needed, so it is not sent twice.
  • “WhatsApp cannot be reached right now” (codes 131000, 1, 2): retried automatically.

Related articles