DIVERA 24/7
Webhook für neue Alarme eintragen, Gruppen zu Einheiten oder Alarmgruppen zuordnen. Zusatzmodul ab Professional.
Schnittstellen
Schnittstellen: DIVERA 24/7, Alamos FE2, API und Webhooks
Alarme aus DIVERA 24/7 und Alamos FE2 kommen über die Schnittstellen von leitstelle.live als Auftrag, Einsatz oder Gruppenalarm in der Leitstelle an. Eigene Systeme binden Sie über eine Eingangs-API an und erhalten Ereignisse als signierte Webhooks. Stichworte und Gruppen ordnen Sie selbst zu.
Was Schnittstellen kann
Alamos FE2
Ausgang für HTTP-Anfragen in FE2 anlegen, Stichworte und Schleifen zuordnen. Zusatzmodul ab Professional.
Eingangs-API
Eigene Systeme legen Aufträge und Einsätze über einen Zugang an, je Stichwort mit eigenem Ziel. Ab Professional.
Webhooks
Einsätze, Aufträge und Statusänderungen signiert an eigene Systeme melden. Ab Professional.
Testaufruf
Prüft ein Beispiel gegen die Zuordnung und zeigt das Ziel, ohne etwas anzulegen.
Protokoll
Jeder Aufruf steht mit Zeit und Ergebnis im Protokoll, personenbezogene Inhalte sind unkenntlich.
So binden Sie ein anderes System an
Zugang anlegen
Im Portal wählen Sie die Art des Zugangs und vergeben nur die Rechte, die das andere System braucht. Der Schlüssel erscheint genau einmal.
Im anderen System eintragen
In FE2 legen Sie einen Ausgang für HTTP-Anfragen an, in DIVERA 24/7 einen Webhook für neue Alarme, bei eigenen Systemen den Aufruf der API.
Zuordnen
Stichworte des anderen Systems führen zu Ihrem Stichwort und Ziel: Auftrag, neuer Einsatz oder Gruppenalarm. Gruppen führen zu Ihren Einheiten oder Alarmgruppen.
Prüfen
Der Testaufruf zeigt, was erkannt und was angelegt würde, ohne etwas anzulegen.
Betreiben
In der Leitstelle erscheint die Meldung „Extern eingegangen“ mit Quelle, Stichwort und Adresse. Das Protokoll zeigt jeden Aufruf.
So funktioniert es
Alarme übernehmen: DIVERA 24/7 und Alamos FE2
Mit dem Zusatzmodul Schnittstellen FE2/DIVERA kommt ein Alarm als Auftrag, Einsatz oder Gruppenalarm an und trägt die Marke „über Alamos FE2“ oder „über DIVERA 24/7“. Ohne weitere Einstellung entsteht ein Auftrag im zuletzt aktiven Einsatz. Das Modul ist ab Professional buchbar und in Enterprise enthalten.
Die Anbindungen arbeiten in eine Richtung: Sie übernehmen Alarme, schreiben aber keine Status und keine Rückmeldungen in das andere System zurück. Änderungen am Alarm pflegt danach die Leitstelle. Kommt dieselbe Alarm-Nummer erneut, legt leitstelle.live nichts doppelt an.
Eigene Systeme anbinden: Eingangs-API und Webhooks
Ab Professional dürfen eigene Zugänge Aufträge und Einsätze anlegen. Das andere System sendet Stichwort, Adresse und Text. Standardmäßig legt die Schnittstelle nur an und die Leitstelle disponiert. Eingeschaltet alarmiert „Automatisch disponieren“ nach der AAO, und zwar nur per Push.
In die andere Richtung melden signierte Webhooks angelegte und beendete Einsätze, angelegte und geschlossene Aufträge sowie Statusänderungen an eigene Systeme.
- Webhooks enthalten keine Meldungstexte, Melder- oder Kontaktdaten
- Koordinaten, Adresse und Namen senden Sie nur mit, wenn Sie das je Zugang einschalten
- Die Signatur nutzt HMAC-SHA256, fehlgeschlagene Zustellungen werden bis zu viermal wiederholt
Weitere Wege und Kontrolle
Alarmierungen anderer Leitstellen liest der Alarm-Mail-Parser aus Alarmmails: Stichwort, Ort und Einsatznummer markieren Sie einmal, danach wird bei jeder Mail mit geprüftem Absender ein Einsatz vorgeschlagen oder angelegt. Gruppenalarme lassen sich über eine eigene Schnittstelle auslösen. Individuelle Schnittstellen sind in Enterprise nach Absprache möglich.
Das Protokoll zeigt die letzten 200 Aufrufe je Zugang aus 30 Tagen, Namen, Telefonnummern und Freitexte sind dort unkenntlich. Ein Widerruf sperrt den Schlüssel sofort.
Was noch dazugehört
- Rechte je Zugang: nur das freigeben, was das andere System braucht
- Schlüssel wird genau einmal angezeigt und lässt sich sofort widerrufen
- Keine doppelten Aufträge bei gleicher Alarm-Nummer
- Marke am Auftrag zeigt die Herkunft, etwa „über Alamos FE2“
- Alarm-Mail-Parser für Alarmmails mit geprüftem Absender (ab Professional)
- Gruppenalarm von außen auslösen, Rückmeldungen per Webhook
Praxisbeispiel: Alarm aus DIVERA 24/7 wird zum Gruppenalarm
Ein neutraler Ablauf für eine Organisation, die ihre Alarme schon in einem anderen System erhält.
- Die Organisation legt einen Zugang der Art DIVERA 24/7 an und trägt Adresse und Schlüssel in DIVERA als Webhook für neue Alarme ein.
- Unter „Eingang: Gruppen“ ordnet sie die Gruppe der Schnelleinsatzgruppe der passenden Alarmgruppe zu, das Stichwort dem Ziel Gruppenalarm.
- Der Testaufruf mit dem Beispiel zeigt die erkannten Felder und das Ziel, ohne etwas anzulegen.
- Bei einem echten Alarm entsteht der Gruppenalarm, die Leitstelle sieht „Extern eingegangen“ mit der Marke „über DIVERA 24/7“.
- Das Protokoll hält den Aufruf fest. Eine spätere Änderung mit derselben Alarm-Id legt nichts neu an, die Leitstelle pflegt sie bei Bedarf selbst.
Häufige Fragen
Gibt es eine Schnittstelle zu DIVERA 24/7 und Alamos FE2?
Ja. Das Zusatzmodul Schnittstellen FE2/DIVERA übernimmt Alarme aus beiden Systemen als Auftrag, Einsatz oder Gruppenalarm. Es ist ab Professional buchbar und in Enterprise enthalten.
Werden Status oder Rückmeldungen an FE2 oder DIVERA zurückgemeldet?
Nein. Die fertigen Anbindungen übernehmen Alarme aus dem anderen System. Änderungen pflegt danach die Leitstelle. Ereignisse an eigene Systeme geben Sie über Webhooks weiter.
Wird automatisch alarmiert?
Standardmäßig wird der Auftrag nur angelegt und die Leitstelle disponiert. Mit „Automatisch disponieren“ alarmiert leitstelle.live die Einheiten nach der AAO oder der Gruppenzuordnung, und zwar nur per Push. SMS und Anruf bleiben der Leitstelle überlassen.
Können Alarme doppelt ankommen?
Kommt dieselbe Alarm-Nummer erneut, legt leitstelle.live nichts doppelt an. Ohne Alarm-Nummer gilt bei FE2 nur ein exakt gleicher Inhalt als Doppel.
Lässt sich eine Kreisleitstelle anbinden?
Das hängt davon ab, was die Leitstelle anbieten kann. Möglich sind die Eingangs-API mit Stichwort, Adresse und Text oder der Alarm-Mail-Parser für Alarmmails mit geprüftem Absender. Beides ist ab Professional enthalten. Individuelle Schnittstellen sind in Enterprise nach Absprache möglich.