Notifications

Notifications are composed of a number of options:

  • The event that occurred to cause the notification (i.e. a status post)
  • A filter for that event (i.e. text with a status post)
  • A filter for members and devices (i.e. only trigger the notification for specific devices)
  • How often the notification should repeat. (i.e. only repeat once an hour, ignoring re-triggers in between)
  • The action to take

Available Notifications

Real-time notifications can be sent when one of the following occurs:

  • A status message is posted to the timeline containing certain text is posted.
  • An Alert is raised
  • A device is has stopped reporting
  • A device has resumed reporting
  • A device posts a measurement out of range
  • An export has been created

Filters

Filters vary with the event causing the notification.

Status Post

You can filter on text contained with the stat post.
For Example:
Set the Message Contains option to 'Window opened' to trigger the notification if your device publishes a status post such as "Window opened whilst air conditioning is running".

Alert

You may filter on the alert level and if the alert is for you ("My Alerts Only") or for alerts raised for all members.

Device Stopped Reporting

No filter options are available for this notification

Device Resumed Reporting

No filter options are available for this notification

Device Measurement Out Of Range

You can filter based on:

  • The out of range field being tagged (e.g. the field is tagged "Critical")
  • The field name (e.g. "WaterLevel")
  • If this value is above the fields designated Acceptable Range
  • If this value is above the fields designated Working Range
  • If this value is below the fields designated Working Range
  • If this value is below the fields designated Acceptable Range
Field names are those set when the measurement is published and not the more user friendly labels.
Tags, acceptable and working ranges are set on the field by editing the device.

Export Created

You can filter export notifications for only those with a specific tag applied.

Member / Device Filter

You can also specify that the notification should only occur when the event is caused by a specific member, device or set of devices.

Repeat Notifications

You may prefer not to receive a notification every time an event occurs (for example, a field value out of range may happen very frequently).
Retrigger options are:

  • Trigger Every Time - The notification is triggered every time the event occurs
  • Trigger Once Until Reset - The notification will trigger once only until it is reset
  • Trigger Once Per Member/Device Until Reset - The notification will trigger for each event once per device or member
You can manually reset the event notification when it has triggered, or set it to auto-reset after a predefined time period.

Note that notifications are rate limited within a 10 minute window. If the notification triggers limit is exceeded the notification is suspended and then requires being re-enabled. If this is likely you should not use the Trigger Every Time option. The rate limiting is designed so you don't get flooded with emails, sms messages or phone calls. If you need a higher rate limit please get in touch.

Actions:

Notifications can be sent using:

  • Email (Note that you need to have verified your email address)
  • SMS (You need to have verified your phone number)
  • Raising an Alert
  • Call a function on a Particle device (via a ParticleBot)
  • Setting light levels/colors with a LIFX light
  • Publishing a message to a MQTT topic.
  • Publishing a message onto the timeline