> 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/advanced-console/platform/how-to-check-if-thing-is-connected/checking-thing-connection-via-sms.md).

# Checking Thing Connection via SMS

{% hint style="warning" %}
Before using SMS to check Thing connectivity, please make sure that your Monogoto account supports incoming SMS functionality and that incoming SMS are enabled for your Thing.
{% endhint %}

Testing SIM card connection to a network via the help of the SMS messages from the portal if one of the most commonly used methods, since it is very reliable, fast and easy procedure.

There are 2 main ways to send SMS message from the Monogoto portal to your Thing:

### Incoming SMS from the self-service console to the device

1\.      Click **Things** from the sidebar menu.

2\.      Find a Thing that you wish to send SMS to and to press on Thing name to open it’s Thing Menu.

3\.      Click **Send SMS to Thing**.

4\.      Enter a name in the **From** field.

5\.      Type a **Message**.

6\.      Click **Send**.

![](/files/mfN4QmTarUs0e9z3BQI8)

{% hint style="info" %}
Please note that some iot devices due to security reasons require you to define whitelist of phone numbers that can send SMS to your iot devices. Therefore, when you want to be able to send SMS to your iot device we would advise you to do the following:

1. Check if your iot device requires you to have a number whitelisted in order for the iot device to accept the SMS. If it does, then please think of a number that you would like to be shown when sending SMS to your iot device.
2. When sending the SMS from portal, please in **FROM** field enter a phone number that you have entered in your iot device whitelist.
3. When entering phone number in **FROM** field, please enter it with country code, without the + or 00 symbols. For example +4420123456789 should be entered as **4420123456789**.
   {% endhint %}

#### SMS status check via the self-service console:

1\.      Click **Things** from the sidebar menu.

2\.      Find a Thing that you wish to check and open it’s Thing Menu.

3\.      Scroll down to **Events**, they show SIM logs.

4\.      In **Events**, please check the logs for SMS events.

![](/files/-MT162IowKJIXzRxn9PZ)

{% hint style="info" %}
**Success** = SMS message reached recipient successfully.\
**Failure** = SMS message failed to reach recipient, due to some reason. Usually the reason should be stated in the same Event.
{% endhint %}

###

### Incoming SMS from the API to the device:

To send an SMS from the portal to a single Thing, please use following request:

```
curl -X POST "https://console.monogoto.io/thing/ThingId_ICCID_<<<_THING_ICCID_>>>/sms" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer <<<_TOKEN_HERE_>>>" -d "{ \"Message\": \"<<<_SMS_CONTENT_>>>\", \"From\": \"<<<_SENDER_NAME_>>>\"}"
```

{% hint style="info" %}
Please note that the above shown command needs to be replaced with information: \
\&#xNAN;**<<<\_THING\_ICCID\_>>>** - replace with your Monogoto thing ICCID number\
\&#xNAN;**<<<\_TOKEN\_HERE\_>>>** - replace with your token\
\&#xNAN;**<<<\_SMS\_CONTENT\_>>>** - replace with your SMS message content\
\&#xNAN;**<<<\_SENDER\_NAME\_>>>** - replace with sender name you wish recipient to see
{% endhint %}

Example of request:

```
curl -X POST "https://console.monogoto.io/thing/ThingId_ICCID_8912372646888991/sms" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Bearer eyJhb6IkpXVCJ9.eyJSb2xlIjoiVXN4lclByb2ZpbGVJZF9kZGM2MThhNC0wNTI1LTQ2MmUtYWN3NzhhMGQxYmbSI6Im4zgFkbWluIiwiQ3VzdG9tsbCwiVXNlcklkIjoiVklkXzg5Yj5Y2OGEyUtNDQThhLTEzZjA0MzJhZDE3YyINTAzgZmUtZGI51My00ZjRiLTktN2U5Yjc0ZWU1ZThlIiwiaWNzM3MjI5L2MDY3NTE2Mjl9.99aSLzP7kTgK6TZGW-xalrMu0GkW6viunt3XxbNng" -d "{ \"Message\": \"Hello\", \"From\": \"console\"}"
```

Expected result (showing Thing ID and SMS ID):

```
ThingId_ICCID_8912372646888991_1606995009188_0.4954212857733442
```

#### SMS status check via the self-service console:

1\.      Click **Things** from the sidebar menu.

2\.      Find a Thing that you wish to check and open it’s Thing Menu.

3\.      Scroll down to **Events**, they show SIM logs.

4\.      In **Events**, please check the logs for SMS events.

![](/files/-MT162IowKJIXzRxn9PZ)

{% hint style="info" %}
**Success** = SMS message reached recipient successfully.\
**Failure** = SMS message failed to reach recipient, due to some reason. Usually the reason should be stated in the same Event.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/advanced-console/platform/how-to-check-if-thing-is-connected/checking-thing-connection-via-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.