Defining Actions
Actions are initiated based on specific conditions and can execute a variety of tasks. The first step in configuring an Action is to specify the desired action. Below are the different types of actions available:
Push Notification to myself
Push Notifications to Run Users
Send notifications to designated Run Users within your Run. You must specify the particular Run User you wish to notify. For notifying multiple users, please refer to our documentation on notifications using analysis.
Send Email
Sends an email to a specified address when certain conditions are met. You can specify one or multiple recipients by separating email addresses with a semicolon (;).
Send Email using SMTP
An email will be sent via SMTP when a specific condition is met. This action allows you to send emails via external providers. To configure this action, you need to create a Secret of type SMTP to authorize TagoIO to connect to your email provider and send emails, you will need to supply the server address, port number, username, and password. This information is usually provided by your email hosting service. Learn here how to create this secret: Secrets.
Send Email with SendGrid
Send Message to AWS SQS
This action sends messages to Amazon SQS when triggered. It requires authentication via Secrets. You will need to provide the region, queue URL, and access key id and secret access key. Learn how to create this secret here: Secrets.
Send SMS
Sends SMS messages when certain conditions are met. You can specify one or multiple recipients by separating phone numbers with a semicolon (;). You need to include the country code with each phone number. If a country code is not provided, the system will automatically assume the USA code (+1).
In the message field, you can use variables to dynamically include information in your text. For more details on how to use message variables, refer to the section "Message Variables" at the end of this page.
Send SMS with Twilio
Send WhatsApp message with Twilio
Check out our SDK to integrate WhatsApp messages functionality with Twilio into your Analysis code: TwilioWhatsapp | TagoIO SDK for JavaScript and TypeScriptRun Analysis Script
Actions have the power to initiate scripts that run in the Analysis. This is a very powerful feature, as you can define exactly when your code will run.
Learn more about Running Analysis via Action.
Publish to TagoIO MQTT Broker
This action can publish to an MQTT topic defined by the developer. This means that every time your trigger criteria are met, TagoIO will publish data to that predefined MQTT topic, this is very useful if you need to forward data to devices and/or applications.
Post data to HTTP End-Point
This action can post data directly to an endpoint defined by you. When the action is initiated, it will POST the JSON data received (as defined by the variable in the Trigger) to the configured HTTP endpoint address.
You can use payload fields in the HTTP endpoint, like the example above but with a variable (
https://myapi.io/endpoint/$VALUE$), or even in the HTTP Headers like in the example below:
The TagoIO-Retries header is managed by the TagoIO API and sent in every Post request for this Action type, and indicates the number of attempts to post the data to your endpoint.
It will try to post the data 10 times, and if it’s unsuccessful (any response from your endpoint other than HTTP 20X status codes) it will require a fallback device to be configured to store the data in TagoIO so you can retrieve it later without losing your data in case your endpoint fails to receive it.
To set up a fallback device, enable it in the bottom part of the HTTP Post action settings and put the token for the device you intend to hold the data.
After 10 unsuccessful attempts, the data will be sent to the fallback device with some information added to the metadata in the _http_* properties (original values in metadata will be kept), like shown below:
Insert to Device's data storage
This option is only available if your Action is of the type MQTT Topic. This action will insert the data directly into the device's data storage.
Message Variables
In some action types, the message body can be as simple as a text like Hi, your car is over the speed limit or you can specify fields in the message to personalize it with real-time data from your devices.
You can use most of the payload fields from our API:
| $VARIABLE$ | Variable name |
| $VALUE$ | Variable value |
| $UNIT$ | Unit of your variable |
| $TIME$ | Time the variable was received |
| $LOCATION$ | Location value |
| $DEVICE$ | Device ID |
| $DEVICE.NAME$ | Name of your device |
| $ACTION.STATE$ | Current state of your Action: locked or unlocked |
- Hi, your device reached $VALUE$ $UNIT$ at the coordinates $LOCATION$ at $TIME$.
- Hi, your device reached 73 mph at the coordinates 43.05334,-86.45340.
- $TIME$: Warning, device with ID $DEVICE$ is $VARIABLE$° $UNIT$.
- 2021-01-02T22:51:48.005Z: Warning, device with ID 547e353d7dbf3af122c0257d is 90° F.
Related Articles
Actions
Actions is a very powerful feature that gives you total control over your devices based on events determined by you. With Actions you can: Send an SMS based on certain conditions; Send an Email based on certain conditions; Run scripts using Analysis; ...Secrets
Secrets are encrypted environment variables that can be used to store sensitive information, such as passwords and API keys. You set a key and a value for your secret: the key serves as the name of the secret, while the value contains your sensitive ...SMS Service
Each time an SMS message is successfully sent by an Action or Analysis function, it is counted as one SMS unit sent. The service limit defined inside each Profile determines the maximum number of SMS that can be sent during a one month period (based ...Connecting your MQTT Broker to TagoIO
TagoIO supports MQTT connections through our MQTT Relay command-line tool. This software acts as a bridge between your MQTT Broker and the TagoIO platform, facilitating seamless integration and data flow. Developed in Rust, the TagoIO MQTT Relay is ...MQTT - Process data, Publish it and Subscribe to a topic
Starting on June 1st, TagoIO will no longer provide MQTT broker to Free accounts. Read more In this tutorial, you will learn how to process data, publish to a topic, and subscribe to it. We will be using the MQTTX client throughout this tutorial. ...