> ## 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 an SMS broadcast

> Create an SMS template, upload your contacts, and send a personalized SMS broadcast from the Wavix portal, then track delivery and link clicks.

In this tutorial, you send an SMS broadcast to a list of contacts from the Wavix portal. You create an SMS template with variables, upload a contacts file, send the broadcast, and track its delivery and link clicks.

## Prerequisites

* A [Wavix account](https://docs.wavix.com/getting-started/create-account.md) with funds. Sandbox accounts can't create broadcasts.
* A Sender ID approved for the destination country. To register one, see [Send SMS](https://docs.wavix.com/messaging/send-sms.md).
* To send to US numbers, a [10DLC campaign](https://docs.wavix.com/messaging/10dlc.md).
* A contacts file in the format described in [Contacts file](https://docs.wavix.com/messaging/broadcast/overview.md#contacts-file).

## Step 1: Create an SMS template

Every SMS broadcast uses an approved SMS template. We review each template before you can use it.

1. In the Wavix portal, go to **Solutions** → [**Broadcasts**](https://app.wavix.com/broadcasts/campaigns).
2. Select the [**Templates**](https://app.wavix.com/broadcasts/templates) tab.
3. Select **Create new**.

**1. General**

Enter the template name and select the destination country. You need at least one Sender ID registered for that country.

![SMS template wizard, General step, with the template name and destination country](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/sms-template-wizard-general.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=8d20be84f58350190a1580da91266268)

Select **Next**.

**2. Template**

1. Enter the template text. To personalize the message, add variables in double curly brackets, such as `{{name}}`. Each variable name must be unique.
2. If the text includes links, turn on **Shorten embedded URLs** to save characters and track link clicks.
3. Select the Sender IDs to use with this template.

![SMS template wizard, Template step, with the message text, URL shortener, and Sender ID selection](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/sms-template-wizard-template.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=ebcd12edb4becee632b55f22281d18c9)

The counter above the text shows the number of SMS segments. A message can be up to 1,530 GSM-7 characters, or 670 characters if it contains Unicode characters. The final length, and the charge, depend on the values that replace the variables.

Select **Next**.

**3. Summary**

Check the template details. To change them, select **Back**. To submit the template for review, select **Create**. You can't change a template after you submit it.

![SMS template wizard, Summary step](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/sms-template-wizard-summary.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=1c2ee8d3ab4cfecbbbbf9d3a217a9a01)

We review the template and send you an email when it's approved. Review can take a few days, depending on the country. The **Templates** tab shows the status of each template: **In review**, **Approved**, or **Declined**.

## Step 2: Prepare your contacts file

Create a CSV file without a header row. Put the phone numbers in the first column and the values for your template variables in the next columns. All numbers must be from the template's destination country.

```csv theme={null}
+12025550123,Ann,XMAS25
+12025550124,Ben,XMAS25
+12025550125,Carla,XMAS25
```

For all the rules and limits, see [Contacts file](https://docs.wavix.com/messaging/broadcast/overview.md#contacts-file).

## Step 3: Create the 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 WhatsApp is also on for your account, select **SMS**, then **Continue**.

**1. Broadcast details**

1. Enter a campaign name. Use letters, digits, and spaces only.
2. 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.
3. Select an approved template for the destination country.
4. Select a Sender ID. Only Sender IDs approved for the template appear.

![SMS broadcast wizard, Broadcast details step, with the uploaded contacts, template, and Sender ID](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/sms-broadcast-wizard-details.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=a1980abf3e6623efb3167377fea52113)

Select **Next**.

**2. Map variables**

Map each template variable to a column in your contacts file. Each variable needs its own column. The **Preview** column shows the value from the first row.

The Wavix portal skips this step if the template has no variables.

![SMS broadcast wizard, Map variables step](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/sms-broadcast-wizard-variables.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=db80b5940531399e31d15671d05072ba)

Select **Next**.

**3. Schedule**

1. Select **Send now**, or select **Schedule for later** and set the date, time, and time zone.
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, we send the messages as fast as possible.

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

Select **Next**.

**4. Summary**

Check the broadcast details. To change them, select **Back**. To create the broadcast, select **Create**.

![SMS broadcast wizard, Summary step](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/sms-broadcast-wizard-summary.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=c706571c5d956cd7ad579121b3a7d2b1)

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

## Step 4: Track the results

On the **Campaigns** tab, select a broadcast to expand it. You see:

* **Campaign Details**: contacts, Sender ID, schedule, link tracking, and charge.
* **Campaign Results**: messages sent, delivered, failed, and pending, and the delivery rate.
* **Error Ranking**: undelivered, expired, and rejected messages.
* **Tracking Information**, if you shortened links: clicks, click rate, and the operating systems, browsers, and languages of the contacts who clicked.

![Expanded SMS broadcast with delivery results, errors, and link click statistics](https://mintcdn.com/wavix/2Lx9yBBgHO2L9tA-/messaging/images/broadcast/sms-broadcast-analytics.png?fit=max\&auto=format\&n=2Lx9yBBgHO2L9tA-\&q=85\&s=331d5838a7307b815669ee7f559fb4e5)

To see each message of a completed or canceled broadcast, select **View in logs** in the menu at the end of its row. To get link statistics from your application, use the [Link Shortener API](https://docs.wavix.com/api-reference/link-shortener/list-short-link-metrics.md).

## Change a broadcast

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

* **Edit**: change the schedule and the sending speed of a scheduled broadcast.
* **Pause** and **Resume**: stop an active broadcast and continue it later.
* **Cancel**: stop the broadcast. Contacts that haven't received the message don't get it.

If your balance runs out, we pause the broadcast. Add funds, then resume it.

## Tips

* Keep messages short. Each variable can add characters and, with them, segments.
* Avoid all caps and repeated punctuation, which carriers can filter as spam.
* Include opt-out instructions where local rules require them, such as "Reply STOP to opt out."

## Next steps

You created an SMS template, sent it to a list of contacts, and checked the delivery and link results.

* If messages fail, find the cause in [SMS troubleshooting](https://docs.wavix.com/messaging/troubleshooting.md).
* To reach the same contacts on WhatsApp, [send a WhatsApp broadcast](https://docs.wavix.com/messaging/broadcast/whatsapp.md).


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