A message fails to send
What the Failed status means, the most common reasons (24h window, disconnected channel, invalid number), and how to retry.
What a failed message looks like
When a message isn't delivered, the bubble shows the label Not sent and a red tick reading Failed. Hover over it and the tooltip shows the time and, when the channel reports it, an error code in parentheses. This means the message left your side but the channel (WhatsApp, Instagram, etc.) rejected it.
Retry sending
- Find the message with the red Failed tick.
- Click the Retry button (tooltip Resend this message).
- The tick changes to Sending… and, if all goes well, switches to sent/delivered.
If it fails again with the same code, the issue isn't temporary: check the reasons below before retrying again.
Most common reasons
- 24-hour window closed (WhatsApp): outside the 24 hours since the customer's last message you can't send free text. You must use an approved template. This is the most frequent cause.
- Channel disconnected or token expired: if the channel lost its session (for example error 190 on WhatsApp), no messages go out. The channel must be reconnected from the channel settings.
- Invalid number or account: the recipient doesn't have WhatsApp, blocked the number, or the account doesn't exist.
- Content rejected: file too large, a format the channel doesn't support, or text that breaks the platform's policies.
- Rate limit: too many sends in a short time; wait a few seconds and retry.
- No connection: your own network dropped while sending. Retry when it's back.
Verify
After retrying, wait for the tick to stop showing Failed. A single gray tick means sent; delivery/read ticks confirm it arrived. If the error code persists, note it down: it helps you and support pinpoint the exact cause.
If it keeps failing
- Confirm with another tool that the number has WhatsApp active.
- Try sending to another contact on the same channel: if that also fails, the channel is the problem (reconnect it); if only that contact fails, the recipient is the problem.
- If the channel is down, ask an admin to reconnect it.
Tips
- For customers outside the 24-hour window, start with a template; once the customer replies, the window reopens for free text.
- The tooltip's error code is the most useful clue for support.
Related articles
Related articles
-
How to assign conversations to agents and teams
Learn how to distribute inbox conversations among your agents and teams, manually or automatically.
-
Inbox complete guide
The inbox in depth, in 25 chapters: filters and views, the editor with quick replies and sequences, notes, assignment, AI in the chat, the contact panel, WhatsApp, calls, statuses, Team and shortcuts.
-
The five conversation statuses: open, pending, snoozed, resolved and closed
Every conversation in the Inbox has a status: Open, Pending, Snoozed, Resolved or Closed. What each one means, how a chat gets there, how to change it and how to filter by status.
-
Start here: the inbox in 7 minutes
The inbox essentials in a short video: the list, filters, quick replies, notes, assignment, tags, WhatsApp templates and statuses.
-
Conversation statuses: open, snoozed, and resolved
Understand what each conversation status means and when to use them to keep your inbox tidy.