akenza.io
Search…
How to send SMS notifications
In this tutorial you will learn 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.
Find out more about how to use the device simulator here.
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.
The following steps are explained in more detail:

1. Create an HTTP Data Flow

Go to Data Flows on the menu and select Create Data Flow.
Select HTTP as a device connector. 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.
Device simulator data flow

2. Create an HTTP Device

Proceed further to Asset Inventory and select Create Device.
Enter a device name and optionally a device description, tags or custom fields. Assign your created Data Flow to your device. Generate a device ID and save your HTTP device. Your device will be now displayed on the Asset Inventory Overview Page.
Create new 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 selecting 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 field Condition 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 SMS output connector 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. 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 output connector output
Once your SMS connector is filled out, select Save connector. Make sure, that you connect your SMS connector to the comparison block.
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. 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.
Copy link
On this page
1. Create an HTTP Data Flow
2. Create an HTTP Device
3. Create a rule
4. Test your rule alert by using the device simulator