> For the complete documentation index, see [llms.txt](https://docs.monogoto.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.monogoto.io/hub/campaigns/sms-campaign.md).

# SMS Campaign

This section explains how to create and use SMS OTA (Over-The-Air) campaigns effectively.

## What is an SMS Campaign?

An SMS campaign is an over-the-air campaign to send SMS to single/multiple SIMs based on criteria. For example, which SMS campaign you can configure remotely the IP of the server which the SIM should communicate with.&#x20;

## How to Create an SMS Campaign?

In order to create a campaign, you will need to  follow the next steps:

1. Access the "Campaigns" in the left sidebar and click on the “Create Campaign” button.

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FoqH3R1dSgHtYiYeMhk51%2Fimage.png?alt=media&amp;token=d27dadb1-a1d3-4151-bc69-82c70f79849d" alt=""><figcaption></figcaption></figure>

2. Choose a meaningful name for your campaign.

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FTulpbcWK5LguJU21FOiV%2Fimage.png?alt=media&amp;token=7338f6d2-6c16-4ac9-b3cc-7981d37da334" alt=""><figcaption></figcaption></figure>

3. Set the filtering criteria based on your preferences.

* Country name: Filters out any SIMs not detected in the selected country.
* Operator name: Available only after selecting a country; it filters out SIMs not detected on the chosen network.
* Group name: Includes only SIMs that belong to the selected group.
* Tags: Includes only SIMs that are assigned with the chosen tag.
* IMSI: Includes only the SIMs whose IMSI you have entered.
* IMEI: Includes only the SIMs detected on the entered IMEI.
* ICCID: Includes only the SIMs whose ICCID you have entered.

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2F4p0F2bLxbXKGZQ4ZdJrz%2Fimage.png?alt=media&amp;token=38d127bd-19e5-4665-a3a9-02e562f3398e" alt="" width="375"><figcaption></figcaption></figure>

3. Select an event from the dropdown menu to determine when the campaign will send an SMS. You can select from the following options:

* Data session: The campaign will be triggered when a new data session starts.
* Network registration: The campaign will be triggered when a new network registration is detected.

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2F11zTqWvUSr6CoV451McC%2Fimage.png?alt=media&amp;token=6c790195-1865-4444-879b-867856f411da" alt="" width="375"><figcaption></figcaption></figure>

4. Once you have filled out all the tabs to your preference, click on Next.
5. Insert the number or name from which you would like the SMS to be sent.

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2F9XthchBy23i9NXDTzkA0%2Fimage.png?alt=media&amp;token=2e7c6e1e-a0c5-4741-b506-52f05c43831e" alt="" width="375"><figcaption></figcaption></figure>

6. Click on “Add Command” and insert the content of the SMS you wish to send. If desired, you can add a criteria text (for example: "OK"), which will be sent back from the SIM (MO SMS) once the command successfully sent.

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FO8zuWid1hBGrgmwaphhH%2Fimage.png?alt=media&amp;token=721b4db8-1818-47a6-8c05-62836a1a4a02" alt="" width="375"><figcaption></figcaption></figure>

7. Once you have filled out all the tabs to your preference, click on the "Create Campaign" button. You will now see your new campaign listed in the OTA Campaigns Table.

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FrctFbwIUr2G9mVfdZwX1%2Fimage.png?alt=media&amp;token=d28bd642-c63a-4b4c-b8ee-5ff364ae8d7a" alt=""><figcaption></figcaption></figure>

8. To activate the campaign, click on the three dots next to it and select "Start".

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FARimm5lqMwRJA1b8sZLR%2Fimage.png?alt=media&amp;token=53063b89-7a34-4d92-ad90-094aa669e5f1" alt=""><figcaption></figcaption></figure>

You can monitor your campaign’s status in the table under the Status column, as well as in the doughnut graph located in the top bar.

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2F0lvdOHwiAHw4aqhDSMdV%2Fimage.png?alt=media&amp;token=77cf0353-7cdb-4672-9f91-295aab221c0e" alt=""><figcaption></figcaption></figure>

If you wish to pause the campaign, click on the three dots again and select "Pause".

<figure><img src="https://3922449203-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0mPxGpottOEfcucXOR%2Fuploads%2FG90z9nWP9yYtCNpx00wN%2Fimage.png?alt=media&amp;token=3aa5eedf-ff66-4dd8-b500-f2b6fc327ff9" alt=""><figcaption></figcaption></figure>
