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

# Broadcast overview

> Learn how Broadcast sends one message to thousands of contacts by SMS or WhatsApp, who can use it, and how to prepare the contacts file.

Broadcast sends one message to up to 100,000 contacts at once, by SMS or by WhatsApp. You upload your contacts in a CSV file, choose an approved template, and send the broadcast now or schedule it. Each contact gets their own copy of the message, personalized with the data from their row in the file.

You create and manage broadcasts in the Wavix portal, under **Solutions** → [**Broadcasts**](https://app.wavix.com/broadcasts/campaigns). Broadcast has no API. To send messages from your application, use the [SMS API](https://docs.wavix.com/messaging/send-sms.md) or the [WhatsApp API](https://docs.wavix.com/api-reference/whatsapp/send-a-whatsapp-message.md).

## Channels

Each broadcast uses one channel. When you select **Create new**, the Wavix portal asks you to choose SMS or WhatsApp if both are on for your account.

![Create broadcast dialog with the SMS and WhatsApp channels](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/channel-chooser.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=136a4d8d1078661b6a1a49de2ea609b1)

| | SMS | WhatsApp |
| :- | :- | :- |
| **Template** | An SMS template that you create in the **Templates** tab and we approve | A WhatsApp template that Meta approves for your sender |
| **Sender** | An approved Sender ID | A WhatsApp sender registered to your WhatsApp Business Account |
| **Content** | Text and links | Text, a header with an image, a video, a document, or a location, and buttons |
| **Personalization** | Template variables mapped to columns in the contacts file | Template variables in the message body mapped to columns in the contacts file. The header and buttons are the same for every contact. |
| **Link tracking** | Optional short links with click statistics | Not available |
| **Test message** | Not available | Send one test message before you create the broadcast |
| **Results in the broadcast list** | Delivery rate, charge, and delivery and click statistics | Contacts, sender, country, and schedule. Follow each message in **History** → **WhatsApp**. |
| **Edit after you create it** | Change the schedule and the sending speed while the broadcast is scheduled | Not available. Cancel the broadcast and create a new one. |

To send a broadcast, see [Send an SMS broadcast](https://docs.wavix.com/messaging/broadcast/sms.md) or [Send a WhatsApp broadcast](https://docs.wavix.com/messaging/broadcast/whatsapp.md).

## Who can use Broadcast

* **SMS broadcasts** need permission to send SMS for your user in the Wavix account.
* **WhatsApp broadcasts** need WhatsApp on for your account and WhatsApp broadcasts turned on. To turn them on, contact our support team. To get WhatsApp, [request WhatsApp access](https://docs.wavix.com/messaging/whatsapp/request-access.md).
* Sandbox accounts can't create broadcasts.
* If your account is suspended, you can't create a broadcast or resume a paused one.

## Contacts file

Both channels take the same contacts file: a CSV file with one contact per row.

* Save the file as UTF-8.
* Don't include a header row.
* Put the phone number in the first column, in E.164 format, such as `+12025550123`. The plus sign is optional.
* Put the data for template variables in the other columns, such as the contact's name or an order number. The Wavix portal numbers the columns in the order they appear: **Column 1**, **Column 2**, **Column 3**.
* Use the same number of columns in every row.
* Use phone numbers from one country only.
* Separate the columns with commas, semicolons, spaces, tabs, or vertical bars.

| Limit | Value |
| :- | :- |
| File size | 25 MB |
| Rows | 100,000 |
| Columns | 25 |

```csv theme={null}
+12025550123,Ann,A-1042,Friday
+12025550124,Ben,A-1043,Monday
+12025550125,Carla,A-1044,Monday
```

When you upload the file, the Wavix portal checks every row. It shows how many contacts it imported and how many rows it left out because the number is invalid or appears more than once. Download the rows it left out, fix them in your file, and upload it again.

## Broadcast status

| Status | Meaning |
| :- | :- |
| **Scheduled** | The broadcast starts at the date and time you set. |
| **Active** | The broadcast is sending messages. |
| **Paused** | You paused the broadcast. It sends nothing until you resume it, then continues with the contacts that haven't received the message. |
| **Completed** | The broadcast sent the message to every contact. Check the delivery status of each message to see whether it was delivered. |
| **Canceled** | You canceled the broadcast, or we canceled it. For the reasons, see [Why a broadcast stops](https://docs.wavix.com/messaging/broadcast/whatsapp.md#why-a-broadcast-stops). Contacts that hadn't received the message don't get it. |

To change a broadcast, select the menu at the end of its row in the broadcast list.

| Status | SMS | WhatsApp |
| :- | :- | :- |
| **Scheduled** | Edit, Cancel | Cancel |
| **Active** | Pause, Cancel | Pause, Cancel |
| **Paused** | Resume, Cancel | Resume, Cancel |
| **Completed** or **Canceled** | View in logs | None |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.