# SMS

Simbase SIM cards can be used to send SMS messages to and from our SMS short code (+55555). By default, all our SIM cards are protected against inbound and outbound SMS messages; only SMS messages to and from our server are allowed.

{% hint style="warning" %}
To be able to send SMS messages to numbers other than 55555, you need to have a phone number (MSISDN) assigned to the SIM card. More information can be found on our [FAQ page.](/faq.md)
{% endhint %}

{% @mermaid/diagram content="graph LR
A\[Device] <-->|SMS| B{{"Server (+55555)"}}
B <--> C\[Platform]
B --> |HTTPS| D\[Webhooks]
B <--> |REST| E\[API]" %}

There are three ways to interact via SMS with your device.

1. [Platform](#1.-platform-sms)
2. [Webhooks](#id-2.-webhooks)
3. [API](#id-3.-api)
4. [How SMS works with your SIM profile.](#id-4.-how-sms-works-with-your-sim-profile)

## 1. Platform SMS

Simbase SIM cards come with a handy feature to make sending SMS commands much easier. Instead of having to use your phone to send an SMS to your SIM card, you can do it via the Simbase dashboard. There are two options to send an SMS from the dashboard to your SIMs.

1. [Send an SMS to a SIM.](#send-an-sms-to-a-sim)
2. [Send SMS in bulk to multiple SIMs.](#h_01ft898eqc5121wb5yqqjpnmzr)

### Send an SMS to a SIM

The quickest way to send an SMS to your SIM is directly from the SIM overview. Use filters, tags, or the search field to find the SIM you would like to send the SMS. Then follow the steps below.

{% @supademo/embed demoId="cmbs18cxkcxhpsn1r09n7f4f4" url="<https://app.supademo.com/demo/cmbs18cxkcxhpsn1r09n7f4f4>" %}

1. Log into your [Simbase dashboard](http://dashboard.simbase.com/).
2. Navigate to '**SIM cards**' which can be located on the left side of the dashboard.
3. Navigate and click on the menu, located on the right side of the SIM overview table.
4. Select '**Send'** under the SMS tab in the dropdown that appears.
5. A pop-up will appear with a text field.
6. Enter your SMS message and click '**Send**'

An alternative method, particularly useful when anticipating a response from the device, involves sending the SMS through the SIM card details page. To start the process and view the SMS response, please follow the below steps:&#x20;

1. Log into your [Simbase dashboard](http://dashboard.simbase.com/).
2. Navigate to '**SIM cards**' which can be located on the left side of the dashboard.
3. Select the SIM card you wish to send SMS from.
4. Select the '**SMS**' tab and an SMS inbox will appear.
5. Enter your SMS message and click the envelope icon
6. See the sent SMS appear in the inbox.

&#x20;

### Send SMS in bulk to multiple SIMs. <a href="#h_01ft898eqc5121wb5yqqjpnmzr" id="h_01ft898eqc5121wb5yqqjpnmzr"></a>

The quickest way to send SMS commands in bulk is by selecting the SIM cards directly in the SIM overview. Use filters, tags, or search to find all SIMs you would like to send the SMS to. Then follow these steps too.

{% @supademo/embed demoId="cmbs1gfr1cxjbsn1rpyumhfoc" url="<https://app.supademo.com/demo/cmbs1gfr1cxjbsn1rpyumhfoc>" %}

1. Log into your [Simbase dashboard](http://dashboard.simbase.com/).
2. Navigate to '**SIM cards**' which can be located on the left side of the dashboard.
3. Filter, search, or use tags to select all SIMs you want to SMS.
4. Select all SIMs at once using the check box at the top of the overview.
5. Select '**Send SMS'** in the action bar that appears upon selecting the items
6. *optionally deselect any SIM that you don't want to include in the bulk SMS.*
7. A pop-up will appear with a text field.
8. Enter your SMS message and click '**Send**'
9. All selected SIMs will receive the same message.

## 2. Webhooks

If you set up a webhook endpoint for SMS messages in our platform, our server calls your endpoint, the moment it receives a message from your device. The message will have the following format:

```json
{
  "event": "sms",
  "iccid": "8910300000001234567",
  "timestamp": "2022-11-22 09:43:17",
  "message": "test SMS message",
  "deviceName": "Demo device"
}
```

Learn more on how to set up webhooks [here](/webhooks.md).

## 3. API

Our API supports sending and reading SMS messages that were sent to our servers. Please see the [API documentation](https://developer.simbase.com/#tag/sms/POST/simcards/{iccid}/sms) for detailed instructions

## 4. How SMS works with your SIM profile.&#x20;

Simbase uses multiple SIM profiles designed to meet different customer needs. SMS behavior may vary depending on the SIM profile in use.

{% hint style="info" %}
For the below SIM profiles, SMS is **only supported between the device and the platform**. These SIMs do not come with MSISDNs(phone numbers) assigned and cannot receive or send SMS messages from/to other external phone numbers. For an additional fee and a 1 year commitment, we can add MSISDNs to these SIMs. For more info, contact support.&#x20;

<img src="https://support.simbase.com/~gitbook/image?url=https%3A%2F%2F2653492456-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYV3zfJTXLR73Umqnex88%252Fuploads%252F4dJBN1F1gLvDgv99q5ZL%252Fimage.png%3Falt%3Dmedia%26token%3D877520cd-8cfb-495b-a1d1-d2b290e7cc8a&#x26;width=40&#x26;dpr=3&#x26;quality=100&#x26;sign=e25236a2&#x26;sv=2" alt="" data-size="line"> **Black**

<img src="https://support.simbase.com/~gitbook/image?url=https%3A%2F%2F2653492456-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYV3zfJTXLR73Umqnex88%252Fuploads%252F1HvcgE3AD7TwleIHxjYp%252Fimage.png%3Falt%3Dmedia%26token%3D70258e4d-40d9-4388-81d7-c4303934e757&#x26;width=40&#x26;dpr=3&#x26;quality=100&#x26;sign=9999d745&#x26;sv=2" alt="" data-size="line"> **Red**

<img src="https://support.simbase.com/~gitbook/image?url=https%3A%2F%2F2653492456-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYV3zfJTXLR73Umqnex88%252Fuploads%252FBrd1dfKl089ttdGowcYs%252Fimage.png%3Falt%3Dmedia%26token%3Df742026c-5c28-4496-99d2-cb1a56c55045&#x26;width=40&#x26;dpr=3&#x26;quality=100&#x26;sign=f0e32258&#x26;sv=2" alt="" data-size="line"> **Green**

These SIMs can also be recognized based on the ICCID format: **89103\*\*\*\***.
{% endhint %}

{% hint style="info" %}
If you are using one of the SIM profiles listed below, please note that each **already includes an assigned MSISDN (phone number)**. These numbers can typically receive SMS messages from external senders, provided the originating carrier supports delivery to them. However, they are not able to send replies back to external numbers. Any SMS messages sent from the device itself will instead be captured and displayed in the Simbase dashboard.\
\ <img src="https://support.simbase.com/~gitbook/image?url=https%3A%2F%2F2653492456-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYV3zfJTXLR73Umqnex88%252Fuploads%252FzCuo8XiheFTvAYOwJdo6%252Fimage.png%3Falt%3Dmedia%26token%3Db8acab7f-4b0e-4628-81b1-4b6f32056a1d&#x26;width=40&#x26;dpr=3&#x26;quality=100&#x26;sign=f0d8621&#x26;sv=2" alt="" data-size="line"> **Blue**

<img src="https://support.simbase.com/~gitbook/image?url=https%3A%2F%2F2653492456-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYV3zfJTXLR73Umqnex88%252Fuploads%252F4PgJDHv3uVu7VGhZToYR%252Fimage.png%3Falt%3Dmedia%26token%3Dbb214dab-ee4b-4834-92ef-b9e8533f69a6&#x26;width=40&#x26;dpr=3&#x26;quality=100&#x26;sign=6b405f46&#x26;sv=2" alt="" data-size="line"> **Yellow**

<img src="https://support.simbase.com/~gitbook/image?url=https%3A%2F%2F2653492456-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYV3zfJTXLR73Umqnex88%252Fuploads%252Fv0EVzHnNwnhimUqS7PnR%252Fimage.png%3Falt%3Dmedia%26token%3D3de06422-fc5a-45d3-9bb8-a0502a5fe6d3&#x26;width=40&#x26;dpr=3&#x26;quality=100&#x26;sign=f8b48388&#x26;sv=2" alt="" data-size="line"> **Cyan**

<img src="https://support.simbase.com/~gitbook/image?url=https%3A%2F%2F2653492456-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FYV3zfJTXLR73Umqnex88%252Fuploads%252FqDQZMr5kqKYDp7QrKz3A%252Fimage.png%3Falt%3Dmedia%26token%3D42f837de-085d-4336-a6a5-e28f2d0f6948&#x26;width=40&#x26;dpr=3&#x26;quality=100&#x26;sign=5fca2532&#x26;sv=2" alt="" data-size="line"> **Purple**

These SIMs can also be recognized based on the ICCID format: **8944\*\*\*\*.**
{% endhint %}


---

# 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://support.simbase.com/platform/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.