# Send an SMS

## Selecting the communication type

For configuring the type of alert, under **Select communication type**, enter/select the values for the following fields:

<figure><img src="/files/tF2XXNSaiOov5bMeVf2W" alt=""><figcaption><p>Send an SMS</p></figcaption></figure>

| Select communication type | Select **SMS** as the type of alert that you want to configure             |
| ------------------------- | -------------------------------------------------------------------------- |
| SMS Body                  | Enter the text that you want to send in the SMS                            |
| Mark SMS as promotional   | Turn on this toggle switch if you want to send a promotional alert message |

{% hint style="info" %}
**Note**: To fetch and send out dynamic values in the alerts, use the following syntax:`[[$<key of the field>]]`

Please refer to the above image for an example of the use of keys for dynamic values. In this example, **e** is the key that is obtained from the backend, the dynamic value of which will be sent out in the SMS.
{% endhint %}

{% hint style="warning" %}
You are required to go through a few additional steps for whitelisting SMS templates before the system can send out messages:

1. Get your message template whitelisted from a DLT platform and obtain a template ID.
2. Enter this template ID in a bulk SMS provider platform and get it accepted.

You can now manage your SMSes and templates in the bulk SMS provider platform. For more information, see <https://www.trai.gov.in/>.
{% endhint %}

## Selecting the receivers for your SMS

For configuring the receivers of the alert, under **Select receivers**, select the required options from the fields below:

<figure><img src="/files/jEUuru4LTskHluEOSPRT" alt=""><figcaption><p>Select Receivers</p></figcaption></figure>

| Field                                             | Description                                                                                  |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Users who are present in company defined roles    | You must select the roles to which the SMS is to be sent.                                    |
| Phone Numbers from a particular field in the form | You must select the fields, having the Phone Number to which you want to send the SMS alert. |
| Custom Phone number list                          | You must enter the Phone Number(s) to which you want to send the SMS alert.                  |

## Setting a condition for your alerts

Now the last stage is where we configure the notification alerts to be sent out based on a predefined condition.&#x20;

Refer to the steps to configure a condition for alerts [**here**](https://docs.senpiper.com/alarm-builder/setting-up-an-alarm/add-new-alarm/defining-the-communication-type/pages/-MhrvLO7WH40juxnOipm#3.-setting-a-condition-for-your-alerts).


---

# 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.senpiper.com/alarm-builder/setting-up-an-alarm/add-new-alarm/defining-the-communication-type/send-an-sms.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.