akenza.io
Search…
How to send SMS notifications
In this tutorial, you will learn how to set up a rule to send SMS notifications to one or multiple recipients. We make use of the device simulator as a test device, to test your rule set up right away.
For a successful setup, the following steps are explained in this tutorial in more detail. It is assumed, that you already have created an organization and a workspace.

1. Create an HTTP Data Flow

Go to Data Flows on the menu and select "Create Data Flow".
Select HTTP as a device connector and give a name. Select the Device Simulator as a Device Type. Proceed with the selection of the Akenza DB and save your Data Flow. Your Data Flow will be now displayed on the Data Flow Overview Page.
HTTP Data Flow

2. Create an HTTP Device

Proceed further to Asset Inventory on the menu and select "Create Device".
Enter a device name and optionally a device description. Assign your created Data Flow (in this example "HTTP DF Simulator") to your device and click on "Proceed". Save your HTTP device after you have generated a device ID. Your device will be now displayed on the Asset Inventory Overview Page.
Create a new HTTP device

3. Create a Rule

Proceed now to Rules and select "Create Rule".
Select as a Rule Input your created HTTP device. Add a logic connector to your rule by opening the akenza Logic Block "Comparison". Connect the pulse animated dots from your device to the comparison block. All available data sources from your device will appear on the dropdown of "Data source 1". In this example, we have the following available data sources:
  • Occupancy
  • Temperature
  • CO2
In this tutorial, we choose "temperature" as a data source, as we want to receive an alert via SMS if a temperature threshold is reached.
In the "Condition field 1" of your comparison block, you are free to choose the individual condition of your rule. In this example, we want to trigger an alert, if the temperature is bigger than 25 degrees.
Proceed now with adding the action connector "SMS" to your rule.
Rule setup
All SMS connectors which were already created in your organization are displayed as available SMS connectors. In this tutorial, we create a new SMS connector. Choose "New SMS connector" and type in your specific information.
  • Connector name (free text)
  • Recipient (one or multiple)
  • SMS Text
  • Add payload data to your text by using such a syntax: {{myPropertyName}}
By adding payload data to your SMS text, you will get informed about the actual measured value of your device. Use also the preview function, to preview your SMS content before you set it live.
SMS connector template
Once your SMS connector is filled out, select "Save connector". Make sure, that you connect your SMS connector to the comparison block. Proceed by selecting "Save Rule" and choose an appropriate name for your rule.
Your SMS rule is now saved and displayed on the Rule Overview Page.

4. Test your Rule Alert by using the device simulator

To test your rule alert, you now can send test data from the device simulator to your HTTP device. By selecting a temperature value above the set 25 degrees on your rule, you will receive an SMS to the chosen recipient number as the rule will get triggered.
To send test data from the device simulator to your HTTP device, you need to copy the Uplink URL from your HTTP device. Go to Asset Inventory, select your HTTP device, and open "API-Configuration".
Copy the Uplink URL and insert this URL on the Uplink URL field on the device simulator.
API-Configuration
In this example, we choose a temperature value of 31 degrees, that the rule gets triggered. Proceed by selecting "Send Message". Check if you receive the SMS on your mobile.
Congratulations, you have successfully created an SMS alert by using the device simulator.
Last modified 22d ago