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

# Broadcast

> Reach many contacts at once: pick a template, choose an audience, and send.

Broadcast lets you send an approved WhatsApp [template](/guide/templates) to many contacts in one action. Open the **Broadcast** page from the sidebar.

There are two ways to work: save reusable **groups**, or compose a one-off broadcast and target an audience on the fly.

<Note>
  Only contacts with a WhatsApp conversation can receive a broadcast. Every
  audience shows how many contacts it actually reaches on WhatsApp.
</Note>

## Contact groups

A contact group is a named, reusable audience. Choose **New group**, name it, and pick contacts (search by name, email, or phone). Each group card shows its size and how many members are reachable on WhatsApp, with a quick **Send template** action.

## New broadcast

Choose **New broadcast** to compose a send in three steps:

1. **Template** — pick an approved WhatsApp template.
2. **Audience** — choose how to target contacts:
   * **Group** — one of your saved groups.
   * **Contacts** — hand-pick contacts.
   * **Filters** — target by attributes (see below).
   * **Import** — upload a spreadsheet of recipients.
3. **Variables** — fill the template's `{{1}}`, `{{2}}` values (the same for everyone, unless you import a personalized sheet).

The composer shows the live **reach** — how many contacts the audience hits on WhatsApp — before you send.

### Filters

Build an audience from contact and conversation attributes. Filters combine together (AND):

* **Tags** — labels you apply to contacts (see [Tags](#tags))
* **Country** — derived from the contact's phone number
* **Last agent assignee** — the agent last assigned to the contact's chat
* **Last team assignee** — any agent on the chosen team(s)
* **Status** — open and/or closed chats
* **Unread** — contacts with unread incoming messages
* **Language** — the contact's [language](#language)
* **Last activity** — a date range of last conversation activity

### Import a list (Excel)

To send to a list with per-recipient values, use the **Import** tab:

1. Pick your template first, then choose **Download sheet**. You'll get an `.xlsx` with a `phone` column plus one column per template variable.
2. Fill one row per recipient and save.
3. Choose **Upload filled sheet**. Phones are matched to existing WhatsApp contacts; each recipient receives the template with their own variable values. Numbers with no WhatsApp conversation are reported as unreachable.

CSV files work too.

## Tags

Tags are labels you apply to contacts to build audiences. On the **Contacts** page, use the tag control on any row to apply existing tags or create a new one on the fly. Then target a tag from the broadcast **Filters**.

## Language

Set a contact's language on the **Contacts** page. Use it to broadcast in the right language — for example, send the Arabic version of a template only to Arabic-speaking contacts.

## History

Each send is recorded under **Recent broadcasts** with its audience, template, and result: **completed** (all delivered), **partial** (some failed), or **failed** (none delivered).

<Warning>
  Template messages may be billed by WhatsApp/Meta depending on category and the
  recipient's country. Make sure your audience expects to hear from you to protect
  your WhatsApp quality rating.
</Warning>

## API

Manage groups and send broadcasts from your own systems:

* `GET /api/v1/contact-groups` — list groups and their members
* `POST /api/v1/contact-groups` — create a group from contact IDs
* `POST /api/v1/contact-groups/{groupId}/broadcasts` — send a template to a group
* `POST /api/v1/broadcasts` — send a template to an audience (group, contacts, filter, or imported recipients)

See the [API reference](/api-reference/introduction) for details.