# 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.