# SMS Campaign

## 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="/files/gORWzmuLv0AuEztFbCXr" alt=""><figcaption></figcaption></figure>

2. Choose a meaningful name for your campaign.

<figure><img src="/files/f4MoVoFogTYXyvXNTPfH" 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="/files/cMm4pXijF1P4sNbL16Es" 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="/files/9F3bw90LavJN3VN6KDEH" 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="/files/HTMC3L7x1xEfAbIkSEQJ" 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="/files/czwljvQgwqooukdVjhcR" 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="/files/2kTs48r1UNku63de1bfD" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/MNuWH98W3bed9Zj0uAvA" 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="/files/1GxTxvVtgrsE3lnXho8T" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/GEwRjghYULJNRoYuluIC" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.monogoto.io/hub/campaigns/sms-campaign.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
