> ## Documentation Index
> Fetch the complete documentation index at: https://clapvo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Message not delivered

> Common reasons a message did not reach a recipient.

Most delivery issues fall into a handful of categories. Walk through them in order.

## Common causes

* The recipient phone number is invalid or missing the country code
* The recipient does not have WhatsApp on that number
* The recipient has blocked your number
* Your number was rate-limited or temporarily restricted by WhatsApp
* The connection sending the message went offline mid-send

## Steps to diagnose

<Steps>
  <Step title="Check the phone number format">
    It must include the country code (for example, `+1`, `+91`, `+55`).
  </Step>

  <Step title="Check the connection status">
    Open **Connections**. Make sure the sending number is connected.
  </Step>

  <Step title="Try sending again">
    Open the chat or campaign and retry the send.
  </Step>

  <Step title="Test with a known-good number">
    Send to a colleague to confirm the connection itself works.
  </Step>

  <Step title="If many recipients failed">
    Your number may be rate-limited. Slow down sends, enable [randomize sender](/docs/product/campaigns/randomize-sender), or pause to let limits reset.
  </Step>
</Steps>

## Tips

* If undelivered messages are a recurring problem on one number, that number may have a poor sender reputation. Add more connections and rotate.
* For campaigns, use [randomize sender](/docs/product/campaigns/randomize-sender) and [randomize message](/docs/product/campaigns/randomize-message) together to protect deliverability.

## Related

* [Randomize sender](/docs/product/campaigns/randomize-sender)
* [Randomize message](/docs/product/campaigns/randomize-message)
* [WhatsApp number disconnected](/docs/support/troubleshooting/whatsapp-disconnected)