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

# Send a broadcast

> Messaging many customers at once over WhatsApp, SMS or email, including variable mapping from a spreadsheet.

One message to many customers, over WhatsApp, SMS or email.

## Before you start

For WhatsApp you need an [approved template](/help/campaigns/template-approval) and an
[official WhatsApp Business connection](/help/channels/whatsapp-cloud-api). The QR-code
connection cannot broadcast.

## The wizard

<Steps>
  <Step title="Details">
    Name the broadcast — for you, not the recipients — and choose the channel.
  </Step>

  <Step title="Template">
    Pick an approved template. Its variables determine what the next steps ask for.
  </Step>

  <Step title="Recipients">
    Choose from your customers, or upload a spreadsheet.
  </Step>

  <Step title="Variables">
    Map each `{{1}}`, `{{2}}` to a spreadsheet column or a fixed value. This is where
    personalization happens.
  </Step>

  <Step title="Review and send">
    Send now or schedule. **Check the preview** — it shows a real recipient's row with the
    variables filled in.
  </Step>
</Steps>

## Variable mapping

If your template says:

```text theme={null}
Hi {{1}}, your order {{2}} ships on {{3}}.
```

then upload a sheet with a column per variable and map them. Get the order wrong and every
message goes out wrong, which is why the preview step exists.

<Warning>
  Check the preview against a **real row**, not a made-up one. Broadcasts cannot be recalled
  once delivered — pausing stops what has not gone yet, not what has.
</Warning>

## While it is running

Broadcasts do not send instantly; they are paced to respect provider limits. You can
**pause**, **resume** or **cancel** mid-flight.

The recipient table shows per-person status — queued, sent, delivered, read, failed — and
**Retry failed** re-sends only the failures, so a temporary provider problem does not mean
starting over.

## Why messages fail

<AccordionGroup>
  <Accordion title="Not on WhatsApp">
    The number has no WhatsApp account. Nothing to fix; clean the list.
  </Accordion>

  <Accordion title="Bad number format">
    Numbers need the country code and no spaces or dashes. `+20 100 123 4567` should be
    `201001234567`.
  </Accordion>

  <Accordion title="Rate limited by the provider">
    You have hit your messaging tier limit. Verifying your business with Meta raises it —
    see [WhatsApp Business](/help/channels/whatsapp-cloud-api#business-verification).
  </Accordion>

  <Accordion title="Template no longer approved">
    A template's approval can be withdrawn after repeated user blocks or reports. Check its
    status under Templates.
  </Accordion>
</AccordionGroup>

## Keeping quality up

Every broadcast is measured by Meta through blocks and reports. Message people who expect
to hear from you, keep Marketing genuinely relevant, and do not re-send to people who never
respond. A poor quality rating cuts how many messages you may send per day, and it is much
easier to protect than to recover.