Skip to main content
A valid API request and an approved template do not guarantee that every message will reach its recipient. WhatsApp uses quality signals and delivery controls to protect customers from unwanted messages. Diagnose the affected level before changing a template, increasing spend, or retrying a campaign.

​
Controls that can affect delivery

Pacing allows WhatsApp to evaluate responses to a template before releasing more messages. Do not interpret every delay as a transport failure. Pausing or disabling can make a template unavailable after negative feedback or poor engagement. Check the current template status before scheduling additional sends. Recipient-level marketing limits can prevent a customer from receiving another marketing message even when your own portfolio has capacity. These limits concern the customer’s overall experience, not only messages from your business. Meta describes these mechanisms in template fundamentals. Their thresholds and availability can change; do not promise a fixed quota for each customer.

​
Diagnose from the result

Use Message delivery statuses for the lifecycle of one message. Preserve the exact error code and relevant identifiers when contacting support.

​
Common error codes and the next check

YCloud can return its own errors and upstream WhatsApp errors. Preserve the actual code and details; the following are common Meta codes, not every possible YCloud result. For 131049, Meta advises waiting at least 24 hours before a possible resend when a recipient limit is suspected. Waiting does not guarantee delivery; first confirm consent, relevance, and whether another attempt is justified. This is different from 131050, which says the recipient opted out of marketing. Source: Meta error codes.

​
Run a focused diagnosis

Compare a small set of representative messages by template, sender, audience source, time, and error. Do not test by repeatedly contacting the same failing recipient. For example, if one template fails across several numbers while other templates work, investigate that template’s status and parameters first. If many templates fail after a billing change, examine billing and account setup before rewriting their copy. Create a short incident record: observed failure, affected scope, last known successful send, recent changes, containment action, and next owner. This turns “WhatsApp is not working” into a specific, testable problem.

​
Improve the customer experience

Start with relevance before volume:
  • Send what the customer expected when opting in.
  • Use recent customer intent and a clear reason to contact them.
  • Coordinate frequency across campaigns and automations.
  • Identify your business clearly.
  • Keep content accurate, useful, and easy to act on.
  • Make opting out straightforward and apply it promptly.
Monitor both delivery outcomes and customer responses. A high delivery rate with growing opt-outs is not a healthy campaign.

​
Retry deliberately

Retry only when the error indicates a recoverable condition and the message is still useful. Use bounded retries and avoid creating duplicate customer notifications. Do not repeatedly resend a blocked marketing message, rotate business numbers, or relabel promotional content as utility to bypass controls. If the customer initiates a new conversation, respond to their actual request using the permitted message type. Do not treat that interaction as permission to restart unrelated campaigns.