> ## 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.

# Send a WhatsApp broadcast

> Send an approved WhatsApp template to a list of contacts from the Wavix portal, with personalized text, a media header, and buttons.

> [!NOTE]
>
> WhatsApp is in preview. Features, limits, and the WhatsApp API can change before general availability.

In this tutorial, you send a WhatsApp broadcast to a list of contacts from the Wavix portal. You choose a sender and an approved template, upload a contacts file, personalize the message, and send a test before you create the broadcast.

## Prerequisites

* WhatsApp on for your Wavix account, with WhatsApp broadcasts turned on. To get WhatsApp, [request WhatsApp access](https://docs.wavix.com/messaging/whatsapp/request-access.md). To turn on broadcasts, contact our support team.
* A connected WhatsApp sender.
* A template that Meta approved for that sender. For template categories and review, see [WhatsApp concepts](https://docs.wavix.com/messaging/whatsapp/concepts.md#message-templates).
* A contacts file in the format described in [Contacts file](https://docs.wavix.com/messaging/broadcast/overview.md#contacts-file).
* Opt-in from every contact on the list. Meta requires it, and messages that contacts don't expect lower your sender's [quality rating](https://docs.wavix.com/messaging/whatsapp/concepts.md#quality-rating).

> [!WARNING]
>
> Broadcast doesn't remove contacts who opted out of your WhatsApp messages. Remove them from the contacts file before you upload it.

## Check your messaging limit first

Your sender's [messaging limit](https://docs.wavix.com/messaging/whatsapp/concepts.md#messaging-limits) sets how many customers it can start conversations with in a rolling 24-hour period. Broadcast doesn't split your list to fit the limit. Keep the number of contacts within the limit, or split the list into several broadcasts on different days. To check the limit, open your sender on the WhatsApp page of the Wavix portal.

## Step 1: Start a WhatsApp broadcast

1. In the Wavix portal, go to **Solutions** → [**Broadcasts**](https://app.wavix.com/broadcasts/campaigns).
2. On the **Campaigns** tab, select **Create new**.
3. If SMS is also on for your account, select **WhatsApp**, then **Continue**.

The broadcast wizard opens. The **Preview** panel on the right shows the message as contacts see it, with the values from the first row of your contacts file.

## Step 2: Enter the broadcast details

1. Enter a campaign name.
2. In **WhatsApp sender**, select the number to send from. The Wavix portal shows the sender's quality rating.
3. In **Template**, select an approved template. Only templates that Meta approved for the sender's WhatsApp Business Account appear.
4. In **Contacts**, upload your contacts file. The Wavix portal shows how many contacts it imported, how many rows it left out, and the destination country. To see the rows it left out, select the download icon.

![WhatsApp broadcast wizard, Broadcast details step, with the sender, template, and uploaded contacts, and the message preview](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/whatsapp-details.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=fc7df65d068ad7a28ce68582fbf85949)

Select **Next**.

Broadcast doesn't support templates with named parameters, such as `{{first_name}}`, or with more than 50 parameters in the body. The Wavix portal tells you when you select one. Use a template with numbered parameters, such as `{{1}}`. Carousel templates aren't supported.

## Step 3: Set up the message

The Wavix portal skips this step if the template has no variables, no header, and no buttons to set up.

![WhatsApp broadcast wizard, Message step, with the header image URL, variable mapping, and buttons](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/whatsapp-message.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=6e03b89a2f16580d2fdc79165cc8c1ed)

1. **Header**: if the template has a media header, enter a public HTTPS link to the file. Every contact gets the same file.

   | Header | File | Maximum size |
   | :- | :- | :- |
   | Image | JPG or PNG | 5 MB |
   | Video | MP4 | 16 MB |
   | Document | PDF. Also enter the file name that contacts see. | 100 MB |

   For a location header, enter the latitude and longitude in decimal degrees. For a text header with a variable, enter the text.
2. **Personalize the message**: map each variable in the message body to a column in your contacts file. Each variable needs its own column.
3. **Buttons**: for a link button, enter the end of the link. The start of the link is fixed in the template, and every contact gets the same link. For a copy code button, enter the code. Phone number buttons use the number in the template.

Select **Next**.

## Step 4: Schedule the broadcast

1. Select **Send now**, or select **Schedule for later** and set the date, time, and time zone. To send now, your Wavix account needs a time zone in its settings.
2. To control how fast the broadcast sends, turn on **Rate limit**, then select **Per minute**, **Per hour**, or **Per day** and enter the maximum number of messages, from 1 to 999. With the rate limit off, the broadcast sends as fast as your sender allows.

![WhatsApp broadcast wizard, Schedule step, with the send time and message throttling](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/whatsapp-schedule.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=9ed4ea89e113629ed662eb59f00bf56c)

Select **Next**.

## Step 5: Send a test and create the broadcast

1. Check the broadcast details. To change them, select **Edit** next to a section.
2. In **Send a test message**, enter your own WhatsApp number in international format, then select **Send test**. The test uses the values from the first row of your contacts file. We charge test messages at the standard WhatsApp rate, and they don't count in the broadcast results.
3. Check the test message on your phone. Then select **Create**.

![WhatsApp broadcast wizard, Summary step, with the broadcast details, delivery settings, and the test message form](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/whatsapp-summary.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=ce4896d31a5fff3c63334f5b4d7f7e86)

The broadcast appears on the **Campaigns** tab as **Scheduled**, or as **Active** if you selected **Send now**.

## Step 6: Follow the broadcast

On the **Campaigns** tab, select the broadcast to expand it. You see the number of contacts, the sender, the country, the schedule, and the sending speed.

A broadcast is **Completed** when it sent the message to every contact, not when every message is delivered. To follow the delivery of each message, go to **History** → **WhatsApp** in the Wavix portal.

## Change a broadcast

Select the menu at the end of the broadcast's row:

* **Pause** and **Resume**: stop an active broadcast and continue it later with the contacts that haven't received the message.
* **Cancel**: stop the broadcast. Contacts that haven't received the message don't get it.

You can't edit a WhatsApp broadcast. To change one that hasn't started, cancel it and create a new one.

## Why a broadcast stops

We cancel a broadcast and send nothing more when:

* Meta no longer approves the template, for example because Meta paused or disabled it.
* WhatsApp broadcasts are turned off for your account.
* More than half of the contacts can't receive the message, for example because their rows lack the data for the template variables.

Contacts that the message can't reach are skipped, and the broadcast continues with the others.

## Next steps

You sent an approved WhatsApp template to a list of contacts, with a test message first.

* If messages fail, find the cause in [WhatsApp troubleshooting](https://docs.wavix.com/messaging/whatsapp/troubleshooting.md).
* To send WhatsApp messages from your application, use the [WhatsApp API](https://docs.wavix.com/api-reference/whatsapp/send-a-whatsapp-message.md).


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