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 IntegrationAnbindung in der Spalte Ausgänge trägt in der Anzeige den Zusatz „(Rückmeldungen dorthin)", damit sie nicht mit DIVERA24/dem Eingang verwechselt wird.

DIVERA als Eingang einrichten

Konfiguration öffnen, in der linken Spalte auf + Eingang klicken. Unter Art der Anbindung den Eintrag DIVERA 24/7 wählen. Erscheint er nicht, ist er für Ihren Mandanten noch nicht freigeschaltet; das Herzstückerledigt jedesder Mandanten.Betreiber. DiesesEinen KapitelNamen beschreibtvergeben, detailliert, wieden Sie dieim bidirektionaleStörfall Schnittstellewiedererkennen. einrichtenAnbindung undanlegen betreiben.klicken.

Was

Den istneuen DIVERA24/7?Eingang anklicken. Unter Konfiguration (Empfang) steht der Schalter Einsatz-Webhook annehmen. Er muss gesetzt sein. Änderungen mit Speichern übernehmen. Die Eingangs-Adresse unter Webhook-Adresse für den Absender notieren. Sie brauchen sie im nächsten Abschnitt.

Der Schalter DIVERA24/7Einsatz-Webhook annehmen ist eine cloudbasiertehäufige Einsatzleit-Stolperfalle bei der Fehlersuche: Steht er auf aus, nimmt die Plattform den Aufruf von DIVERA weiterhin an und Alarmierungssoftwarebestätigt derihn diveraauch, GmbH.erzeugt Leitstellendaraus nutzenaber DIVERA,kein umEreignis. EinsatzaufträgeIn zuDIVERA erstellensieht unddann Einsatzkräftealles zurichtig alarmieren.aus, Die Software ist in Deutschlandwährend bei vielen Feuerwehren, Rettungsdiensten und anderen BOS-OrganisationenIhnen im Einsatz.

Wie arbeiten DIVERA und der Broker zusammen?

Die Kopplung funktioniert in beide Richtungen.

Inbound (DIVERA → Broker)

DIVERA sendet bei jedem neuen Einsatz einen WebhookEingang (HTTPnichts POST mit JSON-Payload) an eine URL, die Sie in DIVERA konfigurieren. Der Broker empfängt diesen Webhook, speichert ihn in der Datenbank (alarm_divera_inbound) und leitet den Alarm an die passenden Pager weiter – basierend auf den divera_rics-Einstellungen Ihrer Pager.

Outbound (Broker → DIVERA)

Wenn ein Pager eine Status-Rückmeldung sendet (beispielsweise „Ich komme"), übersetzt der Broker diese in einen HTTPS-Aufruf an die DIVERA-API. DIVERA kennt dann den Status der alarmierten Kraft und zeigt ihn in der Leitstellen-Übersicht an.

DIVERA-Auth-Key hinterlegen

Bevor Outbound funktionieren kann, müssen Sie Ihren DIVERA-Auth-Key im Broker eintragen.

Auth-Key in DIVERA besorgen

Loggen Sie sich in DIVERA ein. Gehen Sie zu Verwaltung → Schnittstellen → API-Schlüssel (oder ähnlich, je nach DIVERA-Version). Erstellen Sie einen neuen API-Schlüssel. Der Schlüssel ist eine lange Zeichenkette, etwa:

if185u4vdGQrmY3GCNF1rj7Nb4ned8c8xiMPIMNi8Pt1trKXEtxw8K9QZ98LIjUB

Kopieren Sie ihn in die Zwischenablage.

Auth-Key im Broker eintragen

In der Broker-GUI: Einstellungen → Button Alarmdienste verwalten. Im geöffneten Modal sehen Sie ein Feld DIVERA24/7 Auth-Key. Fügen Sie den Schlüssel ein. Nach Klick auf Speichern wird der Schlüssel verschlüsselt in der Datenbank abgelegt.

Der Key wird zweifach gespeichert – in tenants.divera_authkey und in system_config unter dem Schlüssel divera_auth_key mit Ihrer tenant_id. Der Broker-Code bevorzugt beim Zugriff zuerst tenants.divera_authkey. Diese Redundanz ist historisch gewachsen und wird in einer zukünftigen Version konsolidiert.

Weitere Alarmdienste-Einstellungen

Im gleichen Modal stehen Toggles für verschiedene Funktionen:

DIVERA24/7 Inbound
Aktiviert die Verarbeitung eingehender Webhooks. Wenn deaktiviert, werden die Webhooks zwar in alarm_divera_inbound gespeichert, aber keine Pager werden alarmiert. Nützlich zum Testen/Pausieren.

DIVERA24/7 Outbound
Aktiviert das Senden von Status-Rückmeldungen (KOMME und weitere) an DIVERA.

Mandown an DIVERA24/7 senden
Wenn ein Pager seine Mandown-Taste drückt (cmd 0A), wird automatisch ein Alarm in DIVERA erzeugt. Achtung: Das erstellt einen echten Einsatz in DIVERA!

Notrufe an DIVERA24/7 senden
Analog: Bei Notruf-Taste (cmd 08) wird ein Einsatz erzeugt.

Tear-Off Alarme weiterleiten
Bei Abreißen des Pagers von der Halterung (cmd 0B) wird ein Einsatz erzeugt.

Die drei letzten Funktionen sind standardmäßig deaktiviert. Aktivieren Sie sie nur, wenn Ihre DIVERA-Konfiguration und Ihre Organisation damit umgehen kann.

Webhook-URL in DIVERA eintragen

Jetzt muss DIVERA wissen, wohin es seine Alarme senden soll.erscheint.

Die URL konstruierenEingangs-Adresse

DerDie BrokerAdresse akzeptiertfür WebhooksDIVERA auf zwei äquivalenten URLs:

Variante A (Subdomain-basiert):lautet:

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

DerDie Mandantgenaue wirdAdresse aussteht im Fenster der SubdomainAnbindung; 10001kopieren abgeleitet.Sie sie dort, statt sie abzutippen.

Die Angabe der Instanz am Ende der Adresse ist optional. Der PfadEingang endetfunktioniert mit /webhook/divera/und (mitohne. oderSie steckt bereits in der Adresse Ihres Mandanten, deshalb zeigt die Oberfläche die kurze Form ohne trailingZusatz. slash)Ä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.

VarianteWozu Bdas (Pfad-basiert):

Skript

https://pager.dexa.gmbh/webhook/divera/10001da 

ist:

DerDIVERA Mandantübergibt wirdmit dem Skript den Einsatz genau in der Form, die die Plattform erwartet. Es sammelt aus dem Pfad-SegmentEinsatz 10001die abgeleitet.Kennung, Einfacherden einzutragen,Titel, weilden 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 SubdomainEmpfänger involviertableiten ist.lassen.

BeideSo Variantenrichten funktionierenSie identisch.es Auchein:

broker.dexa.gmbh

stattDas pager.dexa.gmbhLUA-Script (Beta) bei DIVERA per Support-Anfrage freischalten lassen. Ohne diese Freischaltung ist erlaubt.der

Den WebhookMenüpunkt in DIVERA konfigurieren

nicht

vorhanden.

In DIVERA:DIVERA öffnen: VerwaltungEinstellungen → Schnittstellen → AlarmierungDatenübergabe → WebhookLUA-Script (ausgehend)Beta) oder ähnlich. Legen Sie eine neue Schnittstelle an:

Name: beispielsweise „BOS Data Broker". Als Event URL:Benachrichtigung (alarm:notify) siehe obenwählen. HTTP-Methode:Als POSTURL-Parameter Content-Type:Ihre application/jsonEingangs-Adresse Trigger: Neuer Einsatz (und gegebenenfalls Updates)

Aktivieren Sie die Schnittstelle. DIVERA sollte bei der Aktivierung eine Test-Anfrage senden – Sie sehen diese dann in Ihren Log-Tabs (System oder DIVERA).

Webhook-Payload von DIVERA

DIVERA sendet pro Einsatz ein JSON-Objekt mit allen relevanten Daten. Die wichtigsten Felder:

{
  "id": 32375472,
  "foreign_id": "SFH-20260422-153000-001",
  "title": "Rauchmelder ALARM",
  "text": "Rauchsensor hat Rauch erkannt: HLF20-1 RM1",
  "address": "Haferlandweg 18, 48157 Münster",
  "lat": 51.991,
  "lng": 7.651,
  "pager": ["1366481A", "1369114A"],
  "cluster_id": 12345,
  "priority": true,
  "created_at": "2026-04-22T10:11:01+02:00"
}

Das Feld pager ist für die Broker-Logik am wichtigsten – es enthält die RICs, die DIVERA für diesen Einsatz an Pager adressieren möchte.eintragen. Der BrokerKnopf gleicht diese RICs mit den divera_rics seiner Pager ab und findet so die Zieldevices.

Der Inbound-Fluss im Detail

Wenn ein DIVERA-Webhook eingeht, läuft intern folgende Kette ab:

Nginxkopieren nimmtdirekt diedaneben HTTPS-Anfrage auf Port 443 entgegen und leitetlegt sie an iotwebui:8082 weiter. iotwebui ruft den Handler handleDiveraWebhook auf. Dieser ermittelt den Mandanten (aus Subdomain oder URL-Pfad) und fügt einen Eintrag in die Tabelle alarm_divera_inbound ein.Zwischenablage. Ein PostgreSQL-Trigger löst ein NOTIFY alarm_inbound_new aus. Der Dienst alarm-processor hat auf diesen Kanal gelauscht. Er liest den Eintrag, parst divera_rawSkript und ermitteltEingabeparameter füraus jededer RICOberfläche imkopieren pager-Array die passenden Pager des Mandanten. Für jeden Treffer-Pager erzeugt er einen Eintragund in tcp_outboundDIVERA mit Status queued. Der PostgreSQL-Trigger notify_alarm_queued löst aus. Der Dienst iotserver hat auf alarm_queued gelauscht. Er greift den Eintrag auf und dispatcht ihn – entweder per TCP-Frame oder MQTT-Publish. Nach erfolgreichem Versand (TCP-Ack oder MQTT-Broker-Ack) wird tcp_outbound.status auf sent gesetzt. Gelingt der Versand nicht: Status wird retry_pending, nächster Versuch in 60 Sekunden. Nach 60 erfolglosen Versuchen endgültig failed.einsetzen.

Im Mandanten-GUIAbschnitt könnensteht Sieaußerdem diesenein FlussVerweis live verfolgen – unter Alarme fürauf die eingegangenenDokumentation DIVERA-Nachrichten,von unter Gesendete Alarme für die ausgelieferten Pager-Nachrichten.DIVERA.

DerDIVERA Outbound-Flussals imAusgang Detaileinrichten

WennDer einAusgang Pagerwird einegebraucht, Status-Rückmeldungdamit sendet:Rückmeldungen Ihrer Einsatzkräfte in DIVERA sichtbar werden.

1. PagerKonfiguration sendetöffnen, TCP-Framein <STX>24752000751011#80###<ETX>der (fürrechten „KOMME") oder MQTT-PublishSpalte auf p/u/24752000751011/ka+ mitAusgang {"type":"80"}.klicken.
2. Unter iotserverArt der Anbindung empfängtden dieEintrag Nachricht,DIVERA persistiert24/7 sie in tcp_inbound.wählen.
3. Der PostgreSQL-Trigger löst NOTIFY tcp_inbound_new aus.

Der DienstEinen divera-outbound-processorNamen hat auf diesen Kanal gelauscht. Er prüft: ist das eine Status-Rückmeldung (cmd 02, 80, 82, 84)? Und ist DIVERA-Outbound für den Mandanten aktiv? Und gibt es einen Auth-Key? Wenn ja: Er sucht in tcp_outbound nach dem letzten DIVERA-Alarm (alarm_id IS NOT NULL) für diesen Pager. Er sendet einen HTTPS-POST an https://app.divera247.com/api/setstatus?accesskey=<KEY> mit Payload:

{"person":"24752000751011","Status":{"key":2,"alarm":true,"alarm_id":32375472}}

key ist dabei der Status-Code: 1=EMPFANGEN, 2=KOMME, 3=KOMME SPÄTER, 4=KOMME NICHT.vergeben. Die AntwortPflichtfelder vonausfüllen: DIVERA

DIVERA-Instanz: die Kennung Ihrer DIVERA-Instanz. Access-Key: der Zugangsschlüssel aus DIVERA. Er wird inverschlüsselt system_logsgespeichert mitund Categorydanach DIVERA24/7nie outboundwieder protokolliert.angezeigt. Zum Ändern tragen Sie einfach einen neuen ein; das Feld bleibt sonst leer und behält den gespeicherten Wert. Anbindung anlegen klicken. 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.

Test

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 IntegrationGeräte

Nachwerden vollständigerin KonfigurationDIVERA empfehleneingetragen

wir folgendenTest:Notruf

an StellenDIVERA Siemelden sicher, dass ein PagerNotruf onlinevom istGerät (Status grün). Erstellen Sieerzeugt 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

In DIVERA einen Testeinsatz auslösen, der ein registriertes Gerät anspricht. Betrieb → Eingang öffnen. Die Meldung muss dort stehen, mit RIC,Ihrer DIVERA-Anbindung als Quelle. Details klicken und den Weg der auchMeldung ansehen: Angenommen, Verteilt, Zugestellt und bestätigt. Am Gerät auf KOMME drücken. Betrieb → Versand öffnen. Die Zustellung sollte auf Empfangen stehen und in dender divera_ricsSpalte desRückmeldung Test-PagersKOMME eingetragen ist. Der Pager sollte innerhalb von 2–5 Sekunden vibrieren. Drücken Sie auf dem Pager „KOMME".zeigen. In DIVERA solltenachsehen, derob Statusdie „IchRückmeldung komme"angekommen für den Pager-Nutzer erscheinen. Im Broker-GUI unter Logs finden Sie alle dazugehörigen Einträge.ist.

Fehlersuche: es kommt nichts an

Funktioniert ein Schritt nicht, nutzenArbeiten Sie dievon Logs-Seite zur Diagnose. Filtern Sievorn nach hinten. Der erste Schritt, der alarm_idnicht desstimmt, Test-Einsatzes, um nurist die relevanten Einträge zu sehen.Ursache.

DIVERA-Instance-Mapping

Im Eingang steht überhaupt nichts

FallsDann Ihrhat Mandantdie mehrerePlattform DIVERA-Instanzennichts nutzt (beispielsweise eine Haupt-DIVERA und eine Test-Instanz), können Sie unterschiedliche instance-Namen konfigurieren. Die URL wäre dann:

https://pager.dexa.gmbh/webhook/divera/<instance-name>

Das instance-Feld wird in alarm_divera_inbound.instance gespeichert und hilft beim Unterscheiden der Quellen.

Fehlerbilder

HTTP 403 „Nicht autorisiert" im DIVERA-Outbound-Log
Der Auth-Key ist falsch, abgelaufenbekommen oder hatnichts nichtdaraus die erforderlichen API-Rechte in DIVERA.erzeugt. Prüfen Sie: Stimmt der Key in den Mandant-Einstellungen mit dem in DIVERA überein?

Webhook geht rein, aber Pager bekommt nichts

• Ist der Pager online (Dashboard prüfen)?

Hat der Pager die richtige RICSteht in divera_rics? Sendet DIVERA die richtige RICAdresse 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 pager-ArrayEingang desunter Webhooks?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 AlarmBetrieb → Protokoll.

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

Sie ist inangekommen alarm_divera_inbound,und gespeichert, aber keines Eintragwurde inniemand tcp_outboundalarmiert. 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 DienstAccess-Key alarm-processornoch gestartet?gültig? systemctlEin statusabgelaufener alarm-processoroder (nurzurückgezogener Super-Admin)Schlüssel führt dazu, dass DIVERA die Meldung zurückweist. Tragen Sie in diesem Fall einen neuen Schlüssel ein und speichern Sie. IstSteht DIVERA-Inbounddie deaktiviertZustellung (Toggleim inVersand Einstellungen)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.

Diese und weitere Probleme werden im Kapitel Betrieb & Troubleshooting vertieft.