# Create an SMS Campaign

An SMS (Short Message Service, a standard text message) campaign sends one text or multimedia message to a whole list of recipients in a single run, so you can reach a large group of customers on their mobile phones at once. This page walks you through building a campaign on an SMS channel.

## Before you start

Your system must be running firmware **84.20.0.21** or later.

You also need the following in place before you create a campaign.

### An SMS message channel

[Set up and configure an SMS channel](/pbx/contact-center-guide/omnichannel-messaging-administrator-guide/#omnichannel-messaging-administrator-guide__sms) first.

:::note
Confirm that your account with the channel's service provider has enough credit or quota to cover the volume of messages you plan to send.
:::

### A list of contacts

Have the recipient phone numbers ready. A single campaign can target up to **1,000 contacts**.

You can supply the recipients in any of three ways:

- Type the numbers in by hand.
- Import a CSV (comma-separated values) file of phone numbers.
- Pull numbers from an existing company phonebook.

If you plan to import a CSV file, it must meet these requirements:

- **Format**: UTF-8 encoded `.CSV`
- **Size**: under 50 MB
- **File name**: fewer than 127 characters
- **Number column**: use a `Number` field for the phone numbers, entered in E.164 format (the international phone number standard: a plus sign, the country code, then the number, for example `+1xxxxxxxxxx`)

:::caution
Phone numbers that are not in E.164 format can fail to send. Store every number with the leading plus sign and country code, whether you type it, import it, or pull it from a phonebook.
:::

![Example CSV showing phone numbers in a Number column in E.164 format](/images/pbx/msg-campaign-contact-list.png)

If you plan to pull numbers from a phonebook, store the phone numbers there in E.164 format.

![Phonebook entry with a phone number stored in E.164 format](/images/pbx/number-format.png)

### A routing target (optional)

If you want the campaign to open a session for each recipient automatically, decide on the routing target in advance. A target can be either an extension or a [message queue](/pbx/contact-center-guide/create-a-message-queue/).

## Create the campaign

1. Sign in to the PBX (Private Branch Exchange, your phone system) web portal and open **Messaging > Message Campaign**, then click **Add**.

2. In the **Basic** section, fill in the core details:

   - **Name**: Give the campaign a recognizable name.
   - **Message Channel**: Choose the SMS channel to send from.
   - **Sender**: Choose the number tied to that SMS channel that the messages will come from.
   - **Recipient**: Add the recipients using one of the methods below.

   **Enter numbers manually**

   ![Adding recipient phone numbers by hand](/images/pbx/manually-add-number.png)

   1. Select **Input & Import**.
   2. Click **Add** and type each phone number in E.164 format (for example, `+1xxxxxxxxxx`).

   **Import a CSV file**

   ![Importing a CSV file of recipient phone numbers](/images/pbx/import-message-contact.png)

   1. Select **Input & Import**.
   2. Click **Import**.
   3. In the pop-up, click **Browse** and choose your file.
   4. Click **Import**.

   **Use an existing phonebook**

   ![Selecting recipients from an existing phonebook](/images/pbx/message-phonebook.png)

   1. Select **Phonebooks**.
   2. In the **Phonebooks** drop-down, pick the phonebook to use.
   3. In the **Number Type** drop-down, choose which number type to pull. The system collects the numbers stored under the types you select.

3. In the **Message Content** section, build the message you want to send. You can send a plain text message (SMS) or a multimedia message (MMS) that carries a file.

   **Send a text message (SMS)**

   ![Composing the text of an SMS message](/images/pbx/message-text.png)

   1. Select **Text**.
   2. Type your message in the text field. Add emojis wherever you like.

   :::note
   A text message can be up to 1,600 characters, and emojis are supported.
   :::

   **Send a multimedia message (MMS)**

   ![Attaching a file to a multimedia message](/images/pbx/upload-file.png)

   1. Select **File**.
   2. Click **Choose a File** and pick the file to attach.

   :::note
   - The file types you can attach depend on the SMS channel's service provider.
   - A file cannot exceed 100 MB.
   :::

4. In the **Sending Rules** section, set when the campaign goes out and whether it opens sessions.

   Under **Send Time**, choose one of the following:

   | Option | What happens |
   |--------|--------------|
   | Send Now | The campaign goes out as soon as you save it. |
   | Schedule Sending | The campaign is sent automatically at a date and time you set. |
   | Do NOT Send, Save as Draft | The campaign is saved as a draft so you can edit or send it later. |

   :::caution
   With **Send Now** selected, the campaign goes out the moment you click **Save**, reaching every recipient (up to 1,000) and drawing down your provider credit or quota. Sent messages cannot be recalled. If the campaign is not finished, choose **Do NOT Send, Save as Draft** so you can review it first.
   :::

   ![Setting a specific date and time to send the campaign](/images/pbx/specified-date-and-time.png)

   Under **Send Mode**, choose whether to create sessions:

   | Option | What happens |
   |--------|--------------|
   | Create session and send message | The system opens a session for each recipient as the campaign sends, and assigns each session to your chosen target (an extension or a message queue). |
   | Send messages directly without creating session | No sessions are created, and the messages do not appear in **External Chat Logs**. |

   ![Choosing the extension or message queue that campaign sessions are assigned to](/images/pbx/message-target.png)

   :::note
   If a recipient already has an active session, the campaign message is delivered to that existing session rather than opening a new one and assigning it to your target.
   :::

5. Click **Save**.

## What happens next

The campaign is created and appears in the campaign list.

- If you sent it immediately, its status shows as **Executing** and messages go out to the recipients right away.

  ![Campaign list showing a campaign with Executing status](/images/pbx/immediate-campaign.png)

- If you scheduled it, its status shows as **Scheduled** and the messages are sent automatically at the set time.

  ![Campaign list showing a campaign with Scheduled status](/images/pbx/scheduled-campaign.png)

Once a campaign reaches **Completed** status, you can review how it did from the campaign list.

- Glance at the **Result** and **Response Rate** columns for a quick summary.

  ![Result and Response Rate columns summarizing a completed campaign](/images/pbx/glance-at-campaign-result.png)

- Click the details icon ![Details](/images/pbx/detail.png) to open the full send report.

  ![Detailed sending report for a completed campaign](/images/pbx/view-campaign-details.png)

:::tip
- If some messages failed, click the retry icon ![Retry](/images/pbx/Restore.png) to send them again.
- To reuse a campaign as the basis for a new one, click the duplicate icon ![Duplicate](/images/pbx/role%20management_copy.png) to copy it.
:::