# Notifications

Email notifications alert designated recipients when air quality thresholds are exceeded, enabling proactive response to elevated PM levels.

## Accessing Notifications

Navigate to `/sites/[id]/notifications` or click "Notifications" in the site sidebar.

## Concept

Notification rules define:

* **Trigger device**: AirWatch sensor to monitor
* **PM10 threshold**: Level that triggers alert
* **Recipients**: Email addresses to notify
* **Hysteresis**: Prevents notification spam

## Notification Components

### Trigger Device

AirWatch sensor that triggers notifications:

* AirWatch 3.0
* AirWatch LTE Europe
* AirWatch LTE America

### PM10 Threshold

The PM10 value (in µg/m³) that triggers notification:

* Alert sent when threshold exceeded
* Configurable per rule

### Recipients

Email addresses to receive alerts:

* Multiple recipients supported
* Valid email format required
* Both internal and external addresses

### Hysteresis

Time delay before re-triggering:

* Prevents repeated notifications
* Configurable duration
* Value must drop and rise again to re-trigger

## Creating Notifications

### Add Notification Modal

{% stepper %}
{% step %}

### Select Create Notification Rule

Click "Create Notification Rule" to open the modal.
{% endstep %}

{% step %}

### Choose Trigger Device

Select the trigger AirWatch device for the rule.
{% endstep %}

{% step %}

### Set Threshold

Set the PM10 threshold that will trigger the alert.
{% endstep %}

{% step %}

### Add Recipients

Add recipient email addresses (see Recipient Management).
{% endstep %}

{% step %}

### Configure Hysteresis (optional)

Set hysteresis duration to prevent repeated alerts.
{% endstep %}

{% step %}

### Save Notification

Save the notification rule to activate it.
{% endstep %}
{% endstepper %}

### Recipient Management

Add recipients:

* Enter email address
* Click "Add"
* Repeat for multiple

Remove recipients:

* Click remove button next to email
* Confirm removal

## Notification Cards

Each notification displays as a collapsible card.

### Card Header

* Notification name
* Trigger device name
* Enable/Disable toggle
* Edit/Delete buttons

### Card Content

* Trigger device with current PM10
* Threshold value
* Recipient list
* Notification status

## Managing Notifications

### Enable/Disable

Toggle notifications on/off:

* Disabled rules don't send emails
* Useful for maintenance periods
* Quick pause capability

### Edit Notification

Modify existing notifications:

* Change threshold
* Update recipients
* Adjust hysteresis

### Delete Notification

Remove notifications:

* Confirmation required
* Cannot be undone

## Email Content

### Alert Email Contains

* Site name
* Trigger device name and location
* Current PM10 value
* Threshold that was exceeded
* Timestamp
* Link to dashboard (if configured)

### Language

Email templates available in:

* English
* German

Based on system configuration.

## Notification Behavior

### Trigger Condition

{% stepper %}
{% step %}

### Condition: Threshold Crossing

PM10 exceeds the configured threshold.
{% endstep %}

{% step %}

### Condition: Hysteresis

Hysteresis period has passed (if applicable).
{% endstep %}

{% step %}

### Condition: Rule Enabled

The notification rule is enabled.
{% endstep %}
{% endstepper %}

### Hysteresis Logic

Prevents spam. Steps for how hysteresis works:

{% stepper %}
{% step %}

### Initial Alert

Alert sent when PM10 crosses the threshold.
{% endstep %}

{% step %}

### Start Timer

A hysteresis timer starts after the alert.
{% endstep %}

{% step %}

### Suppress Alerts

No new alerts sent during the timer period.
{% endstep %}

{% step %}

### Require Reset

PM10 must drop below the threshold to reset state.
{% endstep %}

{% step %}

### Restart Timer on Drop

Timer resets when the value drops below the threshold.
{% endstep %}

{% step %}

### Next Alert

A new alert is sent only on the next threshold crossing after reset.
{% endstep %}
{% endstepper %}

### Example

Threshold: 100 µg/m³, Hysteresis: 30 minutes

| Time  | PM10 | Action                     |
| ----- | ---- | -------------------------- |
| 09:00 | 110  | Alert sent                 |
| 09:05 | 120  | No alert (hysteresis)      |
| 09:15 | 90   | No alert (below threshold) |
| 09:20 | 105  | Alert sent (new crossing)  |

## Live Status

Notification cards show:

* Current PM10 from trigger
* Whether threshold exceeded
* Active alert state

## Best Practices

### Threshold Selection

* Set above normal fluctuations
* Consider background levels
* Test before production use

### Recipient Selection

* Include relevant personnel
* Consider shift supervisors
* Avoid notification fatigue

### Hysteresis Settings

* Too short = notification spam
* Too long = missed alerts
* 15-30 minutes typical

## Empty State

If no notifications exist:

* Message indicating no rules
* "Create Rule" button

## Permissions

Creating/editing notifications requires:

* Member or Admin role
* Access to trigger devices
* Active licenses

## Related Documentation

* [Automation Rules](broken://pages/cdce5e0fc1d3faed280c813b56d173ecb9dcaa33) - Automatic device control
* [Schedulers](broken://pages/6a965e1dbdaf8fbac4d277148e35412c62efbcad) - Time-based control
* [Air Quality](file:///6726661/monitoring/air-quality/overview.md) - PM monitoring


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kemperconnect.de/automation/notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.