Why a message was not delivered

A message shows as failed, or never seems to arrive. Find where Piaflo shows the reason, then the fix for the common cases: number not on WhatsApp, template not approved, payment method, closed window.

All plans
On this page 3
  1. Check the status of the message
  2. The common causes
  3. Messages that wait

This article is about a message that Piaflo tried to send. If the customer never entered the flow at all, start with Why a customer did not enter a flow.

Check the status of the message

Open the customer's conversation in Inbox. Under each message you sent:

What you see What it means
One tick Sent to WhatsApp
Two ticks Delivered to the customer's phone
Two highlighted ticks Read
failed in red, with a reason under the message WhatsApp refused it, or Piaflo gave up
No message at all Not sent yet: it is waiting, see Messages that wait. A message Piaflo drops before sending, for example because its template was rejected, does not appear either

Failures also show in:

  • Analytics: Messages sent shows how many failed in the period.
  • The flow report, step by step, in the Failed column (Growth plan and above).
  • A campaign's page, under Failed messages, with each error code, its message and how many customers it hit.

To check that sending works at all, send yourself a template from Settings > Send a test message. See Send a test message.

The common causes

The number is not on WhatsApp

WhatsApp could not deliver to this number (Meta error 131026), usually because it has no WhatsApp account. Piaflo marks the contact Not on WhatsApp in the inbox and stops trying it: flows skip them with the reason "Phone number not on WhatsApp", and campaigns leave them out. Nothing to fix on your side, unless the customer gives you another number.

The template was rejected or disabled by Meta

A message based on a rejected or disabled template fails right away. Check its status in Templates, and see A template was rejected.

The template was never approved in time

A message based on a template still in review, or paused by Meta, waits. Piaflo tries again every 10 minutes. If the template is still not approved 24 hours after the message was due, the message fails.

No payment method on your Meta account

Meta only sends templates if your WhatsApp Business account has a valid payment method. Without one, templates cannot be sent. Settings > WhatsApp account then shows No valid payment method on this WhatsApp Business account, so Meta blocks templates. Click Add a payment method. See Meta payment method and display name.

The 24-hour window was closed

Free-text messages can only be sent within 24 hours of the customer's last message (Meta error 131047). Piaflo prevents this in most places: the inbox switches to templates when the window is closed, and the flow editor refuses a free-text step that is not placed after a customer reply. If it still happens, send a template instead.

Your number is limited or blocked

If Meta restricts your number, your messages are affected until the restriction is lifted. See Your number is limited or blocked by Meta.

Your WhatsApp number was disconnected

Messages fail when no WhatsApp number is connected at the moment they go out. Reconnect it from Settings: see Connect your WhatsApp number.

Too many messages to the same customer

When WhatsApp refuses because you sent the same customer too many messages in a short time (Meta error 131056), Piaflo waits a minute and tries again on its own.

Messages that wait

These cases delay a message without failing it:

  • The emergency stop is on. Settings > Emergency stop > Pause all outgoing messages holds every message. They go out when you turn it off.
  • Quiet hours. Marketing messages due during quiet hours (21:00 to 9:00 by default) go out after them.
  • A template waiting for Meta's approval, for up to 24 hours (see above).
  • A temporary error. Piaflo tries up to 5 times in all, waiting longer each time.

And a marketing message is skipped, without failing, when the customer has reached the weekly limit (3 marketing messages per 7 days by default). Both settings are in Settings > Sending rules.

Still stuck? Write to us with the flow name or the order number involved.