Kommunikation

Der Menüpunkt Kommunikation ermöglich es, Informationen auf verschiednenen Wegen außerhalb des Vogelschlagmelders zu verbreiten. Dabei gibt es einerseits die Möglichkeit, über neu eingegangene Meldungen per E-Mail oder Matrix-Chat zu informieren. Zudem kann an dieser Stelle ein API-Key für die Nutzung der API generiert werden, um z. B. die Daten des Vogelschlagmelders in einer eigenen App oder Webseite zu nutzen.

E-Mail-Benachrichtigungen

Es ist möglich, für jede Meldung im Vogelschlagmelder eine E-Mail an eine oder mehrere E-Mail-Adressen zu versenden. Alle SMTP Einstellungen können über Umgebungsbvariablen des Docker-Containers oder über die Adminoberfläche unter Kommunikation eingestellt werden. Es ist nur möglich die SMTP Einstellungen über die Adminoberfläche zu ändern, wenn die Umgebungsvariable ALLOW_SMTP_OVERRIDE auf true gesetzt ist. Dies ist standardmäßig nicht erlaubt, um die Sicherheit zu gewährleisten.

Element/Matrix Chat-Integration

Es ist möglich, Benachrichtigungen über neu eingegangene Meldungen im Vogelschlagmelder auch über den Element/Matrix-Chat zu versenden. Alle Einstellungen können über die Adminoberfläche unter Kommunikation vorgenommen werden. Für die Konfiguration benötigt man die Homeserver-URL, also die Adresse des Matrix-Servers, auf dem der Chat läuft. Zudem benötigt man von diesem Server einen Access-Token, um Nachrichten über den Chat zu versenden.

Im folgenden wird beschrieben, wie der Access-Token für die Nutzung des NABU-Chats generiert werden kann. Da der NABU-Chat (chat.nabu-netz.de) auf einem Element-Server läuft, kann diese Anleitung auch für andere Element-Server genutzt werden.

1. Melde dich im NABU-Chat an (chat.nabu-netz.de) und gehe in die Einstellungen (Zahnradsymbol unten links). Klicke dann auf „Alle Einstellungen“.

2. Klicke dann auf der linken Seite auf „Hilfe & Info“ und scrolle nach unten bis zum Punkt Erweitert. Klicke dort auf „Zugriffstoken“ um die Einstellungen zum Erstellen eines Access-Tokens zu öffnen.

3. Kopiere den Access-Token und füge ihn in der Adminoberfläche des Vogelschlagmelders unter Kommunikation ein. Achte darauf, dass du den Access-Token sicher aufbewahrst, da er für die Authentifizierung im Matrix-Chat benötigt wird. Gebe diesen Token nicht an Dritte weiter, da diese sonst Nachrichten in deinem Namen versenden könnten. Speichere die Einstellungen, um die Konfiguration abzuschließen.

4. Nun hat der Vogelschlagmelder die Berechtigung, Nachrichten über den Matrix-Chat zu versenden. Es ist ratsam für die Meldungen eine eigene Gruppe im Matrix-Chat zu erstellen, um die Meldungen von anderen Nachrichten zu trennen. Alle Personen, welche die Meldungen erhalten sollen, müssen in dieser Gruppe sein. In der Adminoberfläche des Vogelschlagmelders kann dann die Gruppe gesucht und ausgewählt werden, an die die Meldungen gesendet werden sollen. Speichere die Einstellungen, um die Konfiguration abzuschließen. Um zu testen, ob die Konfiguration erfolgreich war, kann eine Testnachricht an die ausgewählte Gruppe gesendet werden.