Skip to main content

Messages aren't arriving

Always start with Marketing › Messaging › Messages (what was sent and in what status) and Marketing › Messaging › Communication Errors (why it failed). Both require the Outbound Messages permission.

First, locate the message​

  1. In Marketing › Messaging › Messages, Outgoing tab, find the member with Search... and look at Delivery Status.
  2. If the status is Failed, Bounced or Dropped, open Marketing › Messaging › Communication Errors.
  3. Filter by Channel and Direction, and search by Recipient. Read Error Code and Error Message.

Symptoms and causes​

SymptomLikely causeWhat to do
Lots of WhatsApp errors at onceRestricted account or disabled templateSee Meta health: quality, tier and Account Review Status
The account is restrictedMeta limits the number because of low quality, excess sends or opt-outsDon't push: fix the cause. Only Meta can lift it; the platform stops sending while it lasts
A template gives an errorIt is Pending, Rejected or DisabledCheck the Approval status and the Refuse Reason in WhatsApp
Only one recipient failsNumber blocked or not on WhatsAppDon't retry. Check the contact on their Members record
The status stays at Pending, Queued or SendingThe send is still in progress, or there is a rate limitWait a few minutes. Rate limits are retried automatically
Simulated statusIt is a test with no real sendCheck that the send is not a simulation
The WhatsApp channel doesn't appear or can't be connectedYour edition doesn't include the WhatsApp Channel feature (Growth and Enterprise) or the permission is missingSee Editions and features and Connect WhatsApp
You can't create more channelsYou have reached your edition's channel limitSee the limits in Editions and features
The WhatsApp link or QR leads to the webchatThe WhatsApp destination is pausedResume it in Marketing › Channels › Meta health (Resume WhatsApp destination) or in the channel
Telegram doesn't write to a memberThe member hasn't linked their accountThey should send /start and their code to the bot. See Messaging
An incoming message triggers nothingIt doesn't match any keywordConfigure the Hub flow in Messaging
Portal access codes don't arriveNo active channel for the memberSee Members can't sign in
Before resending in bulk

If WhatsApp shows errors all at once, don't relaunch the broadcast. Resending against a degraded account worsens quality and can end in a block.

If the Meta status worsens​

  1. Open View History and find the reading where it changed.
  2. Check which broadcast or campaign was going out at that time in Messages.
  3. Pause the suspect template or broadcast.
  4. Wait about 30 minutes and click Refresh Now (permission Refreshing Meta Health).

Meta can take hours to reflect a deterioration: you will see delivery failures before the quality change.