← Alle Hilfethemen
🔗

Webhooks – Hilfe & FAQ

Verbinde Alarm-Apps wie DIVERA 24/7, Alarm Dispatcher oder Alexa (Voice Monkey) – sowie Smart Home und eigene Dienste.

📱

Alarm-Apps

Alexa-Ansagen, DIVERA, Alarm Dispatcher und mehr – mit vorkonfigurierten Vorlagen in der Webhook-Verwaltung.

Echtzeit-Auslösung

Bei jedem passenden Alarm sendet Lausitz Einsatz Info einen HTTP-Request an deine konfigurierte URL.

🔒

Signierte Anfragen

Jeder POST-Request wird mit HMAC-Signatur versehen, damit du die Herkunft verifizieren kannst.

🔌 Apps & Dienste anschließen

Lausitz Einsatz Info sendet bei passenden Einsätzen einen HTTP-Request an deine Ziel-URL. So verbindest du gängige Alarm-Apps und Smart-Home-Dienste:

🔊

Alexa mit Voice Monkey (API v2)

Voice Monkey empfängt einen GET-Request und lässt deinen Echo den Text ansagen. Lausitz Einsatz Info baut die URL bei jedem passenden Einsatz automatisch zusammen – Platzhalter wie {STICHWORT} werden ersetzt.

  1. Voice-Monkey-Account anlegen, Skill aktivieren und einen Speaker in der Konsole erstellen (z. B. kevins-ecoshow).
  2. Deinen API-Token aus der Voice-Monkey-Konsole kopieren.
  3. Bei Meine Webhooks die Vorlage Alexa / Voice Monkey wählen – oder manuell eintragen:
  4. Methode: GET · URL:
    https://api-v2.voicemonkey.io/announcement?token=DEIN_TOKEN&device=DEIN_DEVICE&text=Einsatz {STICHWORT} in {ORT}, {STRASSE}
  5. DEIN_TOKEN und DEIN_DEVICE durch deine Werte ersetzen. Den Text nach text= frei anpassen – Platzhalter aus der Sidebar einfügbar.
  6. Wachen-Filter setzen, Webhook speichern und mit Test senden prüfen. Erfolg sieht so aus: {"success":true,"message":"Request received."}

Voice Monkey API v2 nutzt GET mit Query-Parametern (token, device, text). Für Alexa-Routinen statt Ansagen die Vorlage Alexa Routine mit /trigger verwenden. Voice Monkey ist ein unabhängiger Drittanbieter.

Externe Dokumentation →

📟

DIVERA 24/7

DIVERA kann Alarmierungen per API empfangen. Mit einem Webhook sendest du passende Einsätze von Lausitz Einsatz Info an den DIVERA-Endpunkt deiner Einheit – z. B. als Ergänzung für Tests oder parallele Information.

  1. API-Zugang in DIVERA besorgen: Verwaltung → Einstellungen → Schnittstellen (Accesskey der Einheit oder persönlicher API-Key mit Berechtigung).
  2. Vorlage DIVERA 24/7 bei Meine Webhooks wählen.
  3. DEIN_DIVERA_API_KEY in der URL eintragen und JSON-Vorlage bei Bedarf anpassen (Felder: title, text, address).
  4. Filter auf deine Wache setzen, Webhook testen und in DIVERA prüfen, ob der Einsatz ankommt.

Offizielle Leitstellen-Alarmierung läuft weiter über DIVERA selbst. Diese Anbindung überträgt Einsätze aus dem Lausitz-Einsatz-Info-Monitoring – nicht Ersatz für die dienstliche Alarmkette.

Externe Dokumentation →

🚨

Alarm Dispatcher

Alarm Dispatcher kann eingehende HTTP-Requests (Webhooks) mit JSON-Daten verarbeiten. Deine Organisation erhält dafür eine Ziel-URL – Lausitz Einsatz Info sendet dorthin bei passenden Filtern.

  1. Webhook-URL und erwartetes JSON-Format bei deinem Alarm-Dispatcher-Administrator oder in der Schnittstellen-Dokumentation erfragen.
  2. Vorlage Alarm Dispatcher wählen und die URL anpassen.
  3. JSON-Vorlage an das von Alarm Dispatcher geforderte Format anpassen (Platzhalter wie {STICHWORT}, {ORT}, {WACHEN}).
  4. Test senden und in den Webhook-Logs den HTTP-Status prüfen.

Für Anbindungen ans Leitsystem nutzen Organisationen oft Alarm Dispatcher Connect. Die Webhook-Funktion hier richtet sich an die vom System bereitgestellte Empfangs-URL.

Externe Dokumentation →

🏠

Home Assistant

Mit dem Webhook-Trigger von Home Assistant kannst du bei Einsätzen Automationen starten – Licht, Benachrichtigung, Schalter usw.

  1. In Home Assistant eine Automation mit Trigger Webhook anlegen und die Webhook-ID kopieren.
  2. Vorlage Home Assistant wählen – URL: https://DEINE-INSTANZ/api/webhook/DEIN_WEBHOOK_ID.
  3. Datenformat Standard (JSON) nutzen – der komplette Einsatz steckt im JSON-Body.
  4. In der Automation auf trigger.json oder die Felder unter alarm zugreifen.

Externe Dokumentation →

🚀 So richtest du es ein

1

Registrieren & E-Mail bestätigen

Webhooks sind ein Konto-Feature. Zum Anlegen von Webhooks muss deine E-Mail-Adresse bestätigt sein.

2

Webhook anlegen

Unter Meine Webhooks erstellst du einen neuen Webhook mit Name, HTTPS-URL und optionalen Filtern.

3

Filter konfigurieren

Wähle Wachen, Fahrzeuge, Landkreise oder Orte – oder aktiviere „Alle Alarme". Bis zu 20 Filter pro Webhook.

4

Testen & empfangen

Nutze die Test-Funktion im Webhook-Editor und prüfe die Logs, ob dein Dienst die Anfrage korrekt verarbeitet.

❓ Häufige Fragen

Kann ich Alarm-Apps wie DIVERA oder Alexa anschließen?

Ja. Unter Meine Webhooks findest du vorkonfigurierte Vorlagen für Voice Monkey (Alexa), DIVERA 24/7, Alarm Dispatcher und Home Assistant. Ausführliche Schritt-für-Schritt-Anleitungen stehen oben unter „Apps & Dienste anschließen".

Was sind Webhooks bei Lausitz Einsatz Info?

Webhooks senden bei passenden Einsätzen automatisch eine HTTP-Anfrage (GET oder POST) an eine von dir hinterlegte URL. So kannst du z. B. Home Assistant, Node-RED, eigene Server oder Chat-Bots in Echtzeit informieren – ohne die Seite ständig abfragen zu müssen.

Wie viele Webhooks kann ich anlegen?

Pro Nutzer sind maximal 5 Webhooks möglich. Jeder Webhook kann eigene Filter, URLs und Einstellungen haben.

Brauche ich eine bestätigte E-Mail?

Ja. Zum Anlegen und Betreiben von Webhooks muss deine E-Mail-Adresse bestätigt sein. Das findest du in deinem Profil unter E-Mail-Verifizierung.

Welche Filter gibt es?

Du kannst Webhooks nach folgenden Kriterien filtern:

  • Wachen – z. B. nur Einsätze deiner Feuerwehr
  • Fahrzeuge – z. B. ein bestimmtes Löschfahrzeug
  • Landkreise – regional eingrenzen
  • Alarm-Ort – Freitext, z. B. ein Ort oder Stadtteil

Alternativ kannst du Alle Alarme aktivieren und jeden Einsatz empfangen.

Was bedeutet „Einer reicht" vs. „Alle müssen passen"?
Einer reicht (OR) Der Webhook wird ausgelöst, sobald mindestens ein Filter zum Einsatz passt.
Alle müssen passen (AND) Alle gesetzten Filter müssen gleichzeitig zutreffen – z. B. bestimmte Wache und bestimmter Landkreis.
Welches Datenformat wird gesendet?

Du hast zwei Optionen:

  • GET (z. B. Voice Monkey v2): Alles in der URL – Methode auf GET stellen, Platzhalter direkt in der URL verwenden.
  • Standard (JSON): POST mit strukturierten Einsatzdaten – für Home Assistant u. a.
  • Eigene Vorlage: POST-Body selbst definieren mit Platzhaltern wie {STICHWORT}, {ORT}.
Wie verifiziere ich die Signatur?

Bei POST-Requests mit JSON oder Vorlage senden wir zusätzliche Header:

  • X-Einsatzinfo-Signature – HMAC-SHA256-Signatur (sha256=…)
  • X-Einsatzinfo-Timestamp – Unix-Zeitstempel der Anfrage
  • X-Einsatzinfo-Webhook-Id – ID deines Webhooks

Die Signatur wird aus Zeitstempel + "." + Request-Body mit deinem Webhook-Schlüssel berechnet. Den Schlüssel findest du in der Webhook-Bearbeitung unter „Webhook-Schlüssel".

Was sind Nachalarmierungen?

Manche Einsätze werden nachträglich ergänzt (z. B. weitere Fahrzeuge). Wenn die Option Bei Nachalarmierung auslösen aktiv ist, wird dein Webhook auch bei solchen Aktualisierungen erneut getriggert – sofern die Filter weiterhin passen.

Wie teste ich meinen Webhook?

Im Webhook-Editor gibt es eine Test-Funktion, die eine Beispiel-Anfrage an deine URL sendet. In den Logs siehst du Statuscode, Antwortzeit und eventuelle Fehler – pro Webhook oder gesammelt.

Was ist der Unterschied zu Meine Wachen?
🏢 Meine Wachen Persönliche, gefilterte Ansicht auf der Website + optionaler Browser-Push. Bis zu 3 feste Wachen.
🔗 Webhooks Technische HTTP-Schnittstelle für externe Systeme. Bis zu 5 Webhooks mit bis zu 20 Filtern – ideal für Automatisierung.
Muss die URL HTTPS sein?

Ja. Aus Sicherheitsgründen sind nur HTTPS-URLs erlaubt. Lokale Testservices brauchen ein gültiges Zertifikat oder einen Tunnel (z. B. ngrok, Cloudflare Tunnel).

Kostet die Webhook-Funktion etwas?

Nein. Webhooks sind für registrierte Nutzer kostenlos.

Webhook einrichten?

Verbinde Lausitz Einsatz Info mit deinen eigenen Diensten und Automatisierungen.

Weitere Hilfethemen

Menü
📱 Telegram 💬 WhatsApp
👤 Anmelden Registrieren
Impressum Datenschutz