Hallo zusammen,
ich möchte euch meine neue externe FF-Agent-Integration für Gladys Assistant vorstellen. Damit lassen sich FF-Agent-Alarmierungen in Gladys empfangen, im Dashboard anzeigen und als Auslöser für Szenen verwenden. Außerdem könnt ihr direkt aus Gladys eine Zusage oder Absage an FF-Agent senden.
Die Integration ist öffentlich verfügbar und wurde bereits produktiv getestet.
Was kann die Integration?
Die Integration verbindet zwei Bereiche miteinander:
- Eingehende Alarmierungen: FF-Agent meldet einen Alarm an Gladys. Dieser erscheint im Dashboard und kann Szenen auslösen.
- Persönliche Rückmeldungen: Über das Widget oder eine Szenenaktion könnt ihr FF-Agent mitteilen, ob ihr zusagt oder absagt.
Die Oberfläche und Dokumentation stehen auf Deutsch, Englisch und Französisch zur Verfügung.
Wofür kann man das nutzen?
Der wichtigste Anwendungsfall ist, die eigene Wohnung bei einer Alarmierung sinnvoll reagieren zu lassen. Beispielsweise könnt ihr mit einer Gladys-Szene:
- nachts das Licht im Schlafzimmer, Flur oder Eingangsbereich einschalten;
- eine zusätzliche Benachrichtigung oder einen Hinweis über bereits eingerichtete Gladys-Funktionen ausgeben;
- ausgewählte Geräte einschalten oder eine vorhandene Szene starten;
- den Alarm auf einem Wandtablet im Gladys-Dashboard anzeigen.
Welche Geräte und Aktionen ihr dabei verwendet, hängt natürlich von eurer Gladys-Installation ab. Die Integration liefert den Alarmauslöser; die gewünschte Reaktion legt ihr selbst in euren Szenen fest.
Auch Rückmeldungen lassen sich in Szenen einbinden, beispielsweise für einen bewusst betätigten Taster. Eine automatische Zu- oder Absage ist für die Nutzung nicht erforderlich.
Das Dashboard-Widget
Das Widget zeigt, ob ein lokal empfangener Alarm offen ist. Bei einem Alarm erscheinen die Empfangszeit und zwei Buttons:
- Zusagen
- Absagen
Die Rückmeldung wird unmittelbar beim Klick gesendet, ohne zusätzliche Bestätigungsabfrage.
Nach einer erfolgreich übertragenen Zusage bleibt die grüne Anzeige stehen, bis ihr „Einsatz beenden“ auswählt. Dieser Button beendet ausschließlich die lokale Anzeige in Gladys – er sendet keine weitere Anfrage und beendet keinen Einsatz in FF-Agent.
Nach einer erfolgreich übertragenen Absage wechselt das Widget direkt zurück in den Ruhezustand. Die letzte gesendete Entscheidung und ihre Uhrzeit bleiben sichtbar, also „Zusage gesendet“ oder „Absage gesendet“. Die Zeiten erscheinen in der lokalen Zeitzone eures Browsers.
Ein neu eingehender Alarm öffnet die Alarmanzeige erneut. Alarmzustand und letzte Rückmeldung werden nur im Arbeitsspeicher gehalten und gehen bei einem Neustart der Integration verloren.
Wie funktioniert der Alarmempfang?
Für eingehende Alarmierungen verwendet die Integration einen Webhook über Gladys Plus:
- FF-Agent sendet bei einer Alarmierung einen HTTP-POST an die persönliche Webhook-URL.
- Gladys Plus leitet das Signal an eure Gladys-Instanz weiter.
- Die Integration aktualisiert das Widget und löst den Szenentrigger „Einsatz eingegangen“ aus.
Bewusst ohne Einsatzdetails
Die Integration verarbeitet ausschließlich das Alarmsignal. Der Inhalt des Webhooks wird ignoriert. Es werden keine Einsatzstichwörter, Adressen, Einsatz-IDs oder anderen Einsatzdetails daraus gespeichert oder an Szenen weitergegeben.
Der Szenentrigger enthält lediglich den lokal erzeugten Empfangszeitpunkt. Filter nach Einsatzart oder ähnliche Auswertungen gibt es deshalb bewusst nicht.
Wie funktionieren Zu- und Absagen?
Rückmeldungen verwenden die persönlichen FF-Agent-Weblinks aus:
FF-Agent → Persönliches Profil → „Weblinks für Einsatzmeldung“
In Gladys hinterlegt ihr daraus nur eure Rückmelde-UUID, nicht den vollständigen Link.
Für Zusagen könnt ihr eine Standard-Anreiseart auswählen:
- Auto
- Fahrrad
- Zu Fuß
Die übermittelten Koordinaten stammen aus dem ausgewählten Gladys-Haus. Es handelt sich also nicht um eine Live-Ortung eures Smartphones. Bei einer Zusage über eine Szenenaktion lässt sich die Anreiseart optional für diesen einzelnen Aufruf überschreiben.
Absagen benötigen nur die Rückmelde-UUID. Für keine der beiden Rückmeldungen muss eine Einsatz-ID eingegeben werden.
Testen und wichtige Hinweise
Über „Einsatz simulieren“ lässt sich das Widget auch ohne eingehenden FF-Agent-Webhook ausprobieren.
Wichtig: Eine Simulation ist kein geschützter Testmodus. Sie löst denselben Szenentrigger aus wie ein echter Alarm. Die Rückmeldebuttons und eingebundene Zu-/Absageaktionen senden auch dabei echte Anfragen an FF-Agent. Prüft deshalb vor einem Test eure Szenen.
Ich freue mich über Rückmeldungen, Erfahrungen und Verbesserungsvorschläge – insbesondere von anderen FF-Agent-Nutzern, die ihre Alarmierung mit Gladys und ihrem Smart Home verbinden möchten.