Merge pull request #2248 from arduino/karlsoderby/device-notification

[PXCT-66] Device Status Notification

Author: karlsoderby

content/arduino-cloud/03.cloud-interface/04.triggers/triggers.md

@@ -7,6 +7,8 @@ tags: [Arduino Cloud, Triggers, Cloud Notification]
 
 Triggers react to certain conditions inside your Arduino Cloud Thing, such as a boolean being true, or a string being assigned a value. As soon as a set condition is met a notification gets triggered and sent to you. This is useful when you monitor data and you need to know about any change as soon as it happens. This could be anything from different values in environmental monitoring or security-related information such as movement detection.
 
+Triggers can also be used to detect **device status**, where you can configure to send an email / push notification whenever a device goes online/offline.
+
 Triggers can be set up for any of your existing projects, and are found in the [cloud home section](https://cloud.arduino.cc/home/).
 
 ## Hardware & Software Needed
@@ -16,8 +18,6 @@ Triggers can be set up for any of your existing projects, and are found in the [
 
 ***In this tutorial, we use the [Nano 33 IoT](https://store.arduino.cc/products/arduino-nano-33-iot). This is not a requirement, you can use any Arduino Cloud-compatible board for this tutorial.***
 
-## Setup & Configuration
-
 ## Limitations
 
 Currently, the only variables supported by the trigger feature are:

content/arduino-cloud/06.features/14.device-status/assets/shared-spaces.png

@@ -0,0 +1,39 @@
+---
+title: Device Status
+description: Set up push notifications / email triggers whenever a device goes online/offline.
+author: Karl Söderby
+tags: [Arduino Cloud, Device Status]
+---
+
+Keeping track of your devices is important, and using by using [triggers](https://docs.arduino.cc/arduino-cloud/cloud-interface/triggers/), you can automate push notifications regarding your device status.
+
+You can have triggers for:
+- When a device goes online
+- When a device goes offline
+
+You can modify the trigger to:
+- Trigger immediately when the device status changes
+- Trigger after an X amount of minutes/hours after the device status has changed
+
+## Requirements
+
+- [Arduino Cloud account](https://app.arduino.cc/)
+- Thing / Device set up.
+
+## Setup
+
+1. Navigate to the [Arduino Cloud - Triggers](https://app.arduino.cc/triggers)
+2. Create a trigger by clicking the **"+ Trigger"** button in the top right corner.
+3. Select **"Device Status"** as a trigger.
+4. Choose the device you want to track.
+5. Select whether you want to get a notification if it is online/offline (or both).
+6. Select the time for notification (immediately or specific time e.g. 1 hour).
+7. Choose the action (email of push notification on phone).
+
+![Device status notification setup.](assets/shared-spaces.png)
+
+## Usage
+
+Depending on the setup, your notifications will trigger when the device status change, either sending you an email or a push notification\*.
+
+***\*Read the article about [push notifications](/arduino-cloud/iot-remote-app/push-notifications/) for more information.***