Checking Thing Connection via SMS

In this section you may learn how you may check if your Monogoto SIM card (Thing) is connected to a network using an SMS message.

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.

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.

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 [phone] should be entered as 4420123456789.

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.

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.

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_>>>\"}"

Please note that the above shown command needs to be replaced with information: <<<_THING_ICCID_>>> - replace with your Monogoto thing ICCID number <<<_TOKEN_HERE_>>> - replace with your token <<<_SMS_CONTENT_>>> - replace with your SMS message content <<<_SENDER_NAME_>>> - replace with sender name you wish recipient to see

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.

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.