# Benachrichtigung

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/benachrichtigung/

_Benötigt Symcon >= 5.1_

Dieses Modul ermöglicht eine mehrstufige Benachrichtigung, wobei die Stufe sich nach einer definierten Zeit erhöht und bei einer Quittierung zurückgesetzt wird. Beim Erreichen einer neuen Stufe können verschiedene Aktionen ausgeführt werden.

### Funktionsumfang
- Starten einer mehrstufigen Benachrichtigungskette durch eine Variable
- Auf jeder Stufe können individuell Aktionen festgesetzt werden:
    - Skripte ausführen
    - Push-Nachrichten, E-Mails oder SMS verschicken
    - Telefonanruf mit Ansage durchfügen (sofern "Telefonansage" Modul installiert)
    - Durchsage über Lautsprecher durchführen (sofern "Durchsage" Modul installiert)
    - Nachricht über Telegram versenden (sofern "TelegramBot" Modul installiert)
    - Nach bestimmter Zeit auf nächste Stufe erhöhen
- Quittierung über beigefügtes Skript oder Push-Nachricht beendet Benachrichtigungen
- Einzelne Stufen können bei Bedarf deaktiviert werden

### Software-Installation
Über den [Modul Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das Modul Benachrichtigung installieren.

### Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" kann das 'Benachrichtigung'-Modul mithilfe des Schnellfilters gefunden werden.
    - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](/service/dokumentation/konzepte/instanzen/#Instanz_hinzufügen)
- Bei 'Auslöser' eine Variable auswählen
    - Nimmt diese Variable einen Wert an, der nicht neutral ist (false bei Boolean, 0 bei Integer und Float, '' bei String), wird die Benachrichtigungskette auf Stufe 1 gestartet
- Der Liste Benachrichtigungsstufen beliebig viele Stufen hinzufügen und konfigurieren
    - Dauer definiert die Zeit bis die nächste Stufe aktiviert wird
    - Aktionen werden beim Erreichen einer Stufe ausgeführt
    - Aktiv definiert, ob die Stufe ausgeführt werden soll. Nicht aktive Stufen werden übersprungen
    - 'Status' beinhaltet Fehlermeldungen, falls bei der Konfiguration der Stufe etwas nicht korrekt ist, ansonsten "OK"

#### Aktionen einrichten
Jede Aktion besitzt Parameter für den Aktionstyp, ein Empfängerobjekt, eine Empfängeradresse, einen Titel, eine Nachricht und eine Nachrichtvariable. Die "Aktion" definiert was aufgerufen werden soll. (z.B. Ein Skript oder eine Email versendet)
Dabei werden weitere Informationen wie "Titel" und "Nachricht" an das eingestellte "Empfängerobjekt" geschickt. Der Inhalt der Nachricht wird definiert durch den Text im Konfigurationsfeld "Nachricht". Dieser wird mit dem Text in der "Nachrichtenvariable" verkettet.
Für generische Nachrichten steht der Inhalt der Nachrichtenvariable als '{variable}' zur Verfügung. Ebenso können durch '\n' Zeilenumbrüche eingefügt werden. Die Empfängeradresse hat je nach Aktion eine andere Funktionalität.

#### Skript
Das als Empfängerobjekt ausgewählte Skript wird ausgeführt. Während dieses Aufrufs können folgende Systemvariablen verwendet werden:

| Systemvariable            | Beschreibung                                   |
| ------------------------- | ---------------------------------------------- |
| $_IPS['RECIPIENT']        | Der Inhalt des Tabellenfeldes Empfängeradresse |
| $_IPS['TITLE']            | Der Inhalt des Tabellenfeldes Titel            |
| $_IPS['MESSAGE']          | Der Inhalt des Tabellenfeldes Nachricht        |
| $_IPS['MESSAGE_VARIABLE'] | Die ID der Nachrichtenvariablen                |

#### Push
Eine Pushnachricht wird an alle Geräte des gewählten Webfronts geschickt. Diese Nachricht verlinkt das Quittierungsskript. Durch Tippen auf die Pushnachricht kann also die Benachrichtigung quittiert werden. Die Empfängeradresse hat bei diesem Aktionstyp keinen Effekt. Die Nachricht hat eine Maximallänge von 256 Zeichen.

#### E-Mail (SMTP)
Eine E-Mail wird über die gewählte SMTP-Instanz verschickt. Ist eine Empfängeradresse angegeben, so wird die E-Mail an diese Adresse verschickt. Ist keine Empfängeradresse angegeben, so wird die E-Mail an den angegebenen Empfänger der SMTP-Instanz geschickt. Wenn die Option 'Erweiterte Antwort' aktiviert ist kann mit dem Stichwort '{actions}' ein Block mit Links eingefügt werden, über welche die verfügbaren Aktionen ausgeführt werden können.

#### SMS
Eine SMS wird über die gewählte SMS-Instanz an die in der Empfängeradresse angegebene Telefonnummer geschickt. Wenn die Option 'Erweiterte Antwort' aktiviert ist kann mit dem Stichwort '{actions}' ein Link eingefügt werden, über den die verfügbaren Aktionen ausgeführt werden können. Ist eine Nachricht länger als 160 Zeichen (Begrenzung durch SMS), wird diese auf bis zu 2 weitere SMS aufgeteilt (maximal 459 Zeichen).

#### Telefonansage (nur verfügbar, wenn das Modul [Telefonansage](phone-announcement.md) installiert ist)

Die in der Empfängeradresse angegebene Telefonnummer wird angerufen und der Titel sowie die Nachricht vorgelesen. Wenn die Option 'Erweiterte Antwort' aktiviert ist kann mit den Tasten 0-9 die Dazugehörige Aktion ausgeführt werden. Wenn gewünscht können mit dem Stichwort '{actions}' die verfügbaren Aktionen in die Nachricht eingebunden werden.

#### Durchsage (nur verfügbar, wenn das Modul [Durchsage](announcement.md) installiert ist)

Der Titel und die Nachricht werden mithilfe der ausgewählten Instanz vorgelesen. Die Empfängeradresse hat bei diesem Aktionstyp keinen Effekt.

#### Telegram (nur verfügbar, wenn das Modul [TelegramBot](telegrambot.md) installiert ist)

Der Titel und die Nachricht werden mithilfe der ausgewählten Instanz an den Empfänger gesendet. Die Empfängeradresse kann entweder der Name oder die UserID vom Telegram Empfänger sein. Sofern die Empfängeradresse leer gelassen wird, werden alle Empfänger, die im Telegram Bot hinterlegt sind, benachrichtigt.

#### Erweiterte Antwort
Wenn erweiterte Antwort aktiviert ist, können verschiedene Aktionen in der entsprechenden Liste definiert werden. Um festzulegen was bei einer Aktion zusätzlich ausgeführt wird kann ein ausgelöstes Ereignis erstellt werden. Als auslösende Variable wird die Variable 'Antwortaktion' und als Auslöser 'Bei bestimmtem Wert' gewählt. Als Wert kann nun die gewünschte Aktion ausgewählt werden.

### Statusvariablen

| Statusvariable         | Beschreibung                                                                                                     |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Antwortaktion          | Kann über die Visualisierung angeklickt oder per Befehl aufgerufen werden um die Benachrichtigung zurückzusetzen |
| Benachrichtigung aktiv | Steuert ob das Benachrichtigungsmodul aktiv ist oder nicht                                                       |
| Benachrichtigungsstufe | Beinhaltet die aktuelle Benachrichtigungsstufe                                                                   |

### Visualisierung
- Über die Visualisierung kann "Antwortaktion" ausgeführt werden um die Benachrichtigung zu reseten.
- Über die Visualisierung kann über "Benachrichtigung aktiv" die Benachrichtigung An/Aus geschaltet werden.
- Die aktuelle Benachrichtigungsstufe wird angezeigt.

## BN_IncreaseLevel

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/benachrichtigung/bn-increaselevel/

`bool BN_IncreaseLevel(int $InstanzID)`

_Benötigt Symcon >= 5.1_

Erhöht die Stufe und führt die Aktion aus

**Parameter**

- `$InstanzID` (int): ID der Instanz

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID der Instanz

**Beispiel**

```text
BN_IncreaseLevel(12345);
```

## BN_Reset

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/benachrichtigung/bn-reset/

`bool BN_Reset(int $InstanzID)`

_Benötigt Symcon >= 5.1_

Setzt die Benachrichtigungsstufe zurück und deaktiviert die Kette

**Parameter**

- `$InstanzID` (int): ID der Instanz

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__

ID der Instanz

**Beispiel**

```text
BN_Reset(12345);
```

## BN_SetNotifyLevel

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/benachrichtigungen/benachrichtigung/bn-setnotifylevel/

`bool BN_SetNotifyLevel(int $InstanzID, int $Level)`

_Benötigt Symcon >= 5.1_

Setzt die Benachichtigung auf eine vorgegebene Stufe

**Parameter**

- `$InstanzID` (int): ID der Instanz
- `$Level` (int): Stufe des Benachrichtigungsmoduls

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Stufe des Benachrichtigungsmoduls

**Beispiel**

```text
BN_SetNotifyLevel(12345, 2);
```