DIVERA24/7-Integration

DIVERA24/7-Integration

DIVERA 24/7 lässt sich in beide Richtungen anbinden. Beides wird auf der Seite Konfiguration eingerichtet, und beides ist voneinander unabhängig: Sie können nur Einsätze entgegennehmen, nur Rückmeldungen zurückmelden oder beides.

Richtung	Was passiert	Wo es angelegt wird
DIVERA als Eingang	DIVERA übergibt einen Einsatz an die Plattform, die daraus die Alarmierung erzeugt	Spalte Eingänge
DIVERA als Ausgang	die Plattform meldet Rückmeldungen, Notrufe und weitere Ereignisse an DIVERA zurück	Spalte Ausgänge

Beide Anbindungen sind eigene Elemente auf der Seite Konfiguration. Die Anbindung in der Spalte Ausgänge trägt in der Anzeige den Zusatz „(Rückmeldungen dorthin)", damit sie nicht mit dem Eingang verwechselt wird.

DIVERA als Eingang einrichten

1. Konfiguration öffnen, in der linken Spalte auf + Eingang klicken.
2. Unter Art der Anbindung den Eintrag DIVERA 24/7 wählen. Erscheint er nicht, ist er für Ihren Mandanten noch nicht freigeschaltet; das erledigt der Betreiber.
3. Einen Namen vergeben, den Sie im Störfall wiedererkennen.
4. Anbindung anlegen klicken.
5. Den neuen Eingang anklicken. Unter Konfiguration (Empfang) steht der Schalter Einsatz-Webhook annehmen. Er muss gesetzt sein. Änderungen mit Speichern übernehmen.
6. Die Eingangs-Adresse unter Webhook-Adresse für den Absender notieren. Sie brauchen sie im nächsten Abschnitt.

Der Schalter Einsatz-Webhook annehmen ist eine häufige Stolperfalle bei der Fehlersuche: Steht er auf aus, nimmt die Plattform den Aufruf von DIVERA weiterhin an und bestätigt ihn auch, erzeugt daraus aber kein Ereignis. In DIVERA sieht dann alles richtig aus, während bei Ihnen im Eingang nichts erscheint.

Die Eingangs-Adresse

Die Adresse für DIVERA lautet:

https://<Mandantennummer>.broker.dexa.gmbh/webhook/divera/

Die genaue Adresse steht im Fenster der Anbindung; kopieren Sie sie dort, statt sie abzutippen.

Die Angabe der Instanz am Ende der Adresse ist optional. Der Eingang funktioniert mit und ohne. Sie steckt bereits in der Adresse Ihres Mandanten, deshalb zeigt die Oberfläche die kurze Form ohne Zusatz. Ältere Einträge in DIVERA, die die lange Form mit der Instanz am Ende benutzen, funktionieren unverändert weiter und müssen nicht umgestellt werden.

Anders als bei einem allgemeinen Webhook-Eingang gibt es für DIVERA keinen eigenen Endpunkt-Token. Die Adresse ist fest und für Ihren Mandanten eindeutig.

Das Beispiel-LUA-Skript in der Oberfläche

Im Fenster des DIVERA-Eingangs finden Sie den aufklappbaren Abschnitt Einrichtung in DIVERA: LUA-Script (Beta). Darin steht alles, was Sie auf der DIVERA-Seite eintragen müssen: das fertige Skript, die zugehörige Parameterdefinition und die vier Einrichtungsschritte. Beide Textfelder haben einen Knopf kopieren.

Wozu das Skript da ist: DIVERA übergibt mit dem Skript den Einsatz genau in der Form, die die Plattform erwartet. Es sammelt aus dem Einsatz die Kennung, den Titel, den Text, die Adresse und die Fremd-ID ein und stellt daraus die Liste der anzusprechenden Geräte zusammen. Genau diese Liste entscheidet später, wer alarmiert wird. Ohne das Skript kommt entweder nichts an oder es kommt etwas an, aus dem sich keine Empfänger ableiten lassen.

So richten Sie es ein:

1. Das LUA-Script (Beta) bei DIVERA per Support-Anfrage freischalten lassen. Ohne diese Freischaltung ist der Menüpunkt in DIVERA nicht vorhanden.
2. In DIVERA öffnen: Einstellungen → Schnittstellen → Datenübergabe → LUA-Script (Beta).
3. Als Event Benachrichtigung (alarm:notify) wählen.
4. Als URL-Parameter Ihre Eingangs-Adresse eintragen. Der Knopf kopieren direkt daneben legt sie in die Zwischenablage.
5. Skript und Eingabeparameter aus der Oberfläche kopieren und in DIVERA einsetzen.

Im Abschnitt steht außerdem ein Verweis auf die Dokumentation von DIVERA.

DIVERA als Ausgang einrichten

Der Ausgang wird gebraucht, damit Rückmeldungen Ihrer Einsatzkräfte in DIVERA sichtbar werden.

1. Konfiguration öffnen, in der rechten Spalte auf + Ausgang klicken.
2. Unter Art der Anbindung den Eintrag DIVERA 24/7 wählen.
3. Einen Namen vergeben.
4. Die Pflichtfelder ausfüllen:
   • DIVERA-Instanz: die Kennung Ihrer DIVERA-Instanz.
   • Access-Key: der Zugangsschlüssel aus DIVERA. Er wird verschlüsselt gespeichert und danach nie wieder angezeigt. Zum Ändern tragen Sie einfach einen neuen ein; das Feld bleibt sonst leer und behält den gespeicherten Wert.
5. Anbindung anlegen klicken.
6. Den neuen Ausgang anklicken und im Zustandsfeld auf Verbindung testen klicken. Der Test prüft Erreichbarkeit und Zugangsdaten und löst keinen Alarm aus. Danach sollte das Zustandswort bereit lauten.

Was Sie an DIVERA melden lassen

Unter Konfiguration (Versand) entscheiden Sie, was zurückgemeldet wird. Prüfen Sie diese Schalter, bevor Sie die Verbindung auf AN setzen.

Schalter	Wirkung
Rückmeldungen an DIVERA melden	Quittungen und Statusmeldungen der Geräte werden in DIVERA eingetragen
Notruf an DIVERA melden	ein Notruf vom Gerät erzeugt in DIVERA einen Vorgang
Mandown an DIVERA melden	ein Mandown-Ereignis erzeugt in DIVERA einen Vorgang
Abriss-Alarm an DIVERA melden	ein Abriss des Geräts von der Halterung erzeugt in DIVERA einen Vorgang
Rückmeldung ohne Alarmbezug unterdrücken	eine Rückmeldung, die sich keinem Alarm zuordnen lässt, wird gar nicht gesendet
DIVERA-Gruppen für Notruf	Gruppennamen, kommagetrennt, die bei Notruf und Abriss mitgeschickt werden. Leer heißt: ohne Gruppenangabe
DIVERA-Gruppen für Mandown	dasselbe für Mandown

Die drei Schalter für Notruf, Mandown und Abriss erzeugen echte Vorgänge in DIVERA. Schalten Sie sie erst ein, wenn in Ihrer Organisation geklärt ist, wer darauf reagiert.

Es gibt zusätzlich das Feld API-Basis-URL. Lassen Sie es unverändert; es ist nur für Test- und Sonderinstanzen gedacht.

Die Verdrahtung

Anbindungen allein alarmieren nicht. In der mittleren Spalte muss eine Verbindung stehen und auf AN sein.

Für den Weg von DIVERA zu Ihren Funkmeldeempfängern gilt eine Besonderheit: Die Empfänger legen Sie hier nicht selbst fest. Öffnen Sie die Verbindung, steht unter Alarmierte Empfänger der Hinweis, dass es die Geräte sind, die DIVERA im Einsatz benennt. Wer alarmiert wird, entscheidet also DIVERA über die Gerätekennungen im Einsatz. Sie müssen die Geräte lediglich unter Betrieb → Pager registriert haben.

Öffnen Sie die Verbindung, weist die Oberfläche außerdem darauf hin, dass die Weiterleitungs-Schalter und Gruppen dieser DIVERA-Verbindung im Ausgang unter Konfiguration (Versand) stehen und nicht an der Verbindung selbst.

Prüfen, ob es läuft

1. In DIVERA einen Testeinsatz auslösen, der ein registriertes Gerät anspricht.
2. Betrieb → Eingang öffnen. Die Meldung muss dort stehen, mit Ihrer DIVERA-Anbindung als Quelle.
3. Details klicken und den Weg der Meldung ansehen: Angenommen, Verteilt, Zugestellt und bestätigt.
4. Am Gerät auf KOMME drücken.
5. Betrieb → Versand öffnen. Die Zustellung sollte auf Empfangen stehen und in der Spalte Rückmeldung KOMME zeigen.
6. In DIVERA nachsehen, ob die Rückmeldung angekommen ist.

Fehlersuche: es kommt nichts an

Arbeiten Sie von vorn nach hinten. Der erste Schritt, der nicht stimmt, ist die Ursache.

Im Eingang steht überhaupt nichts

Dann hat die Plattform nichts bekommen oder nichts daraus erzeugt. Prüfen Sie:

• Steht in DIVERA die richtige Adresse als URL-Parameter? Vergleichen Sie zeichengenau mit der Angabe unter Webhook-Adresse für den Absender.
• Ist das LUA-Script (Beta) in DIVERA freigeschaltet, eingetragen und auf das Event Benachrichtigung (alarm:notify) gesetzt?
• Steht im Eingang unter Konfiguration (Empfang) der Schalter Einsatz-Webhook annehmen auf ein? Steht er auf aus, bestätigt die Plattform den Aufruf, erzeugt aber nichts. In DIVERA sieht das nach Erfolg aus.
• Zeigt der Eingang das Zustandswort Fehler? Die Begründung steht direkt darunter.

Bleibt es unklar, hilft Betrieb → Protokoll.

Die Meldung steht im Eingang, trägt aber das Merkmal „ohne Ziel"

Sie ist angekommen und gespeichert, aber es wurde niemand alarmiert. Auf Konfiguration prüfen:

• Gibt es eine Verbindung von diesem Eingang? Im Fenster des Eingangs steht das unter Verdrahtet mit.
• Steht diese Verbindung auf AN?
• Sind die Geräte, die DIVERA im Einsatz benennt, bei Ihnen unter Betrieb → Pager registriert? Eine Gerätekennung, die die Plattform nicht kennt, kann niemanden alarmieren.

Die Meldung trägt das Merkmal „Duplikat"

Dann hat DIVERA denselben Einsatz ein zweites Mal übergeben. Die Meldung wurde angenommen, aber bewusst nicht noch einmal alarmiert. Das ist kein Fehler, sondern verhindert Doppelalarmierungen. Der erste Durchlauf desselben Einsatzes ist der maßgebliche.

Zustellungen entstehen, kommen aber nicht an

Jetzt liegt es nicht mehr an DIVERA. Öffnen Sie Betrieb → Versand und sehen Sie sich den Zustand an; die Bedeutungen und die weitere Vorgehensweise stehen auf der Seite zu Eingang, Versand und Protokoll.

In DIVERA fehlen die Rückmeldungen

• Existiert überhaupt ein DIVERA-Ausgang, und steht sein Zustand auf bereit? Sonst Verbindung testen klicken und die Begründung lesen.
• Ist unter Konfiguration (Versand) der Schalter Rückmeldungen an DIVERA melden gesetzt?
• Ist der Access-Key noch gültig? Ein abgelaufener oder zurückgezogener Schlüssel führt dazu, dass DIVERA die Meldung zurückweist. Tragen Sie in diesem Fall einen neuen Schlüssel ein und speichern Sie.
• Steht die Zustellung im Versand auf Zurückgehalten? Dann steht im Detail unter Warum nicht zugestellt der Grund, etwa dass die Rückmeldung keinem Alarm zugeordnet werden konnte und der Schalter Rückmeldung ohne Alarmbezug unterdrücken gesetzt ist.