# DIVERA24/7-Integration
Stand 29.09.2026, v1.0. Wichtigste Änderungen gegenüber der Fassung vom 12.08.: Die DIVERA-Anbindung gehört zur Grundausstattung jedes Mandanten (nicht anlegen, nicht löschen); der Schalter „Einsatz-Webhook annehmen“ ist weggefallen; die Konfiguration steht auf dem Reiter DIVERA 24/7 unter Konfiguration statt in einem Fenster; Notruf und Abriss haben eigene Alarmgruppen; die Gruppen-Zuordnung an DIVERA wurde repariert.
DIVERA 24/7 ist in beide Richtungen angebunden: DIVERA übergibt Einsätze an die Plattform (**Eingang**), und die Plattform meldet Rückmeldungen, Notrufe und Abrisse an DIVERA zurück (**Ausgang**). Beides ist **eine** Anbindung, die in der Zusammenfassung links als Eingang und rechts als „(Rückmeldungen dorthin)“ erscheint. Eingang und Ausgang lassen sich unabhängig nutzen.
## Wo die Einstellungen stehen
**Konfiguration → Reiter DIVERA 24/7.** Die Seite hat oben eine Umschaltung **Empfang / Versand**; darunter stehen die Karten der jeweiligen Richtung. Die Anbindung ist bei jedem Mandanten bereits vorhanden — es gibt nichts anzulegen. Ihr Name ist fest, sie lässt sich nicht löschen, nur ein- oder ausschalten.
## Empfang: Einsätze aus DIVERA annehmen
**Ob** Einsätze angenommen werden, entscheidet allein der Schalter **AN/AUS der Anbindung** unten auf der Seite. Den früheren zweiten Schalter „Einsatz-Webhook annehmen“ gibt es nicht mehr.
### Die Eingangs-Adresse
```
https://.broker.dexa.gmbh/webhook/divera/
```
Sie steht auf der Seite im aufklappbaren Abschnitt **Webhook-Adresse für den Absender** mit Kopierknopf. Die Angabe der Instanz am Ende ist optional; ältere Einträge in DIVERA mit der langen Form funktionieren weiter. Einen Endpunkt-Token gibt es für DIVERA nicht — die Adresse ist fest, und die Plattform nimmt Aufrufe nur von den DIVERA-Servern an (Absenderprüfung).
### Das LUA-Script
Aufklappbarer Abschnitt **Einrichtung in DIVERA: LUA-Script (Beta)** mit Skript, Eingabeparametern und den Einrichtungsschritten, jeweils mit Kopierknopf. Das Skript stellt aus dem Einsatz die Liste der anzusprechenden Geräte zusammen — **unsere 14-stelligen Seriennummern**. Genau diese Liste entscheidet, wer alarmiert wird.
1. LUA-Script (Beta) bei DIVERA per Support-Anfrage freischalten lassen.
2. In DIVERA: **Einstellungen → Schnittstellen → Datenübergabe → LUA-Script (Beta)**.
3. Event **Benachrichtigung (alarm:notify)**.
4. URL-Parameter: die Eingangs-Adresse.
5. Skript und Eingabeparameter einsetzen.
**Wer alarmiert wird, entscheidet DIVERA.** Die Verbindung DIVERA → Pager führt deshalb keine eigene Empfängerliste; sie zeigt „Die Pager, die DIVERA im Einsatz nennt“. Sie müssen die Geräte lediglich unter Konfiguration → Pager angelegt haben. Nennt DIVERA Nummern, die bei Ihnen nicht existieren (etwa DIVERA-interne Pager-IDs statt unserer Seriennummern), wird niemand alarmiert und die Meldung trägt im Eingang **ohne Ziel**.
## Versand: Rückmeldungen an DIVERA
Drei Karten:
**Zugang.** **DIVERA-Instanz** (Kennung Ihrer Instanz) und **Access-Key**. Der Schlüssel wird verschlüsselt gespeichert; das **Auge** neben dem Feld zeigt den gespeicherten Wert zur Kontrolle. Die **API-Basis-URL** ist sichtbar, aber fest.
**Melden.** Drei Schalter: **Rückmeldungen** (Quittungen und Statusmeldungen der Geräte → DIVERA-Status 1–4), **Notrufe**, **Abrisse**. Notruf und Abriss erzeugen echte Vorgänge in DIVERA — erst einschalten, wenn geklärt ist, wer darauf reagiert.
**Gruppen.** Je eingeschaltetem Schalter das zugehörige Feld: **Alarmgruppe für Rückmeldungen**, **Alarmgruppe für Notruf**, **Alarmgruppe für Abriss** (fällt auf die Notruf-Gruppe zurück, wenn leer). Die Felder erscheinen nur, wenn der Schalter darüber an ist. Zulässig sind DIVERA-Gruppen-**IDs** (Zahlen) oder Gruppen**namen**; die Plattform kennzeichnet Namen gegenüber DIVERA korrekt (`mapping = title`). Bis zum 18.09.2026 fehlte diese Kennzeichnung — DIVERA nahm die Meldung an, ordnete die Gruppe aber nicht zu.
Dann **Speichern** und im Zustandsfeld **Verbindung testen**: prüft Erreichbarkeit und Zugangsdaten, löst keinen Alarm aus. Danach sollte dort **bereit** stehen.
## Die Verdrahtung
„Bereit“ heißt erreichbar, nicht verdrahtet. Unter **Zustand → Verdrahtet mit** stehen die Verbindungen dieser Anbindung. Fehlt eine, zeigt die Seite **Ohne Alarmweg** mit dem Knopf **Alarmweg anlegen**. Bei der Migration aus v0.9 wurden je Mandant drei Wege angelegt: DIVERA → Pager (Alarm), Pager → DIVERA (Rückmeldungen), Pager → DIVERA (Notfall). Das **Schaubild dieser Anbindung** am Ende der Seite zeigt dieselben Wege als Bild.
## Prüfen, ob es läuft
1. In DIVERA einen Testeinsatz auslösen, der ein angelegtes Gerät nennt.
2. **Betrieb → Eingang**: Meldung mit Quelle DIVERA, Kette Angenommen → Verteilt → Zugestellt.
3. Am Gerät **KOMME** drücken.
4. **Betrieb → Versand**: Zustellung auf **Empfangen**, Rückmeldung **KOMME**.
5. In DIVERA: Rückmeldung angekommen.
## Fehlersuche
### Im Eingang steht nichts
- **Absenderprüfung.** DIVERA sendet von mehreren Servern. Fehlt einer in der Liste der Plattform, kommt der Alarm **je nach sendendem Server** an oder nicht — und DIVERA wiederholt ihn nicht. Genau das war am 22./23.09.2026 der Fall. Melden Sie „kommt manchmal nicht an“ dem Betreiber; er gleicht die Liste mit der offiziellen DIVERA-Seite ab.
- Adresse in DIVERA zeichengenau mit **Webhook-Adresse für den Absender** vergleichen.
- LUA-Script freigeschaltet, eingetragen, Event **alarm:notify**?
- Anbindung auf **AN**?
### Die Meldung trägt „ohne Ziel“
- Nennt DIVERA unsere Seriennummern? DIVERA-interne Pager-IDs kennt die Plattform nicht.
- Sind die Geräte unter Konfiguration → Pager angelegt?
- Gibt es die Verbindung DIVERA → Pager, und steht sie auf AN? (Zustand → Verdrahtet mit)
### Die Meldung trägt „Duplikat“
DIVERA hat denselben Einsatz zweimal übergeben. Bewusst nicht erneut alarmiert.
### Zustellungen entstehen, kommen aber nicht am Gerät an
Liegt nicht mehr an DIVERA. **Betrieb → Versand**, Zustand lesen; Bedeutungen auf der Seite *Eingang, Versand und Protokoll*. Ein nicht verbundenes Gerät bekommt den Alarm sofort bei seiner nächsten Anmeldung, bis zu eine Stunde lang.
### In DIVERA fehlen die Rückmeldungen
- Zustand des Ausgangs **bereit**? Sonst **Verbindung testen** und die Begründung lesen.
- Schalter **Rückmeldungen** unter *Melden* an?
- Access-Key gültig? Abgelaufene Schlüssel führen zu 401/403 im Fehlertext der Zustellung.
- Gruppe eingetragen und passt sie zu einer Gruppe in DIVERA (ID oder exakter Name)?
- Zustellung **Zurückgehalten**? Grund im Detail unter **Warum nicht zugestellt**.