---
title: Divera 24/7
description: Über Divera alarmieren, Fahrzeugstatus austauschen, Rückmeldungen sehen und fremde Alarme als Alarmeingang annehmen.
---

Die Anbindung vom Typ **Divera 24/7** verbindet Lagewerk mit einer Divera-Einheit:

- **Alarmieren:** Technische Aufgaben lösen einen Divera-Alarm aus, an die ganze Einheit, an
  Gruppen oder an einzelne Fahrzeuge. Weitere Auslösungen im selben Einsatz aktualisieren den
  Alarm, auf Wunsch wird er beendet.
- **Rückmeldungen:** Wie viele Empfänger den Alarm gelesen haben und wie viele „Komme“,
  „Komme nicht“ usw. gemeldet haben, steht an der Alarm-Aufgabe im Einsatz.
- **Fahrzeugstatus:** Statuswechsel in Lagewerk gehen an Divera, in Divera gesetzte Status kommen
  nach Lagewerk. Kann Lagewerk einen abgerufenen Status kurzzeitig nicht speichern, übernimmt es
  ihn beim nächsten Abruf.
- **Fremde Alarme:** Wird in Divera alarmiert, ruft Divera Lagewerk auf; der Alarm erscheint als
  [Alarmeingang](/anwender/einsaetze/alarmeingaenge) in der Einsatzliste.

## Einrichten

Unter **Verwaltung → Anbindungen** eine Anbindung vom Typ **Divera 24/7** anlegen. Dafür brauchen
Sie das Recht **Anbindungen verwalten**.

| Feld | Bedeutung |
|---|---|
| Server-Adresse | Leer lassen für die Divera-Cloud. Ein Divera-Server im eigenen Netz muss in `EGRESS_ALLOWED_NETS` freigegeben sein (siehe [Installation](/administration/installation)). |
| Empfangs-Adresse | Wird nach dem Anlegen angezeigt (`https://<Ihre Domain>/api/v1/webhook/divera/<ID>`), mit Knopf **Kopieren**. |
| Abruf alle (Sekunden) | Wie oft Lagewerk Fahrzeugstatus und Rückmeldungen abholt, 10–600, Standard 30. |
| Rückmeldungen offener Alarme abrufen | Standard eingeschaltet. |
| Erlaubte Absender des Webhooks | Optional: IP-Adressen oder Netze (CIDR), durch Komma getrennt. Leer = jeder mit gültigem Token. |
| API-Schlüssel | Pflicht. Persönlicher Schlüssel eines Benutzers mit Alarmierungsrecht oder Schlüssel eines Systembenutzers. |
| Webhook-Token | Frei wählbares Geheimnis für eingehende Alarme. Leer = keine eingehenden Alarme. |
| Kennungs-Regel | Leitet die Divera-Fahrzeug-ID eines Fahrzeugs ab, wenn am Gerät keine gepflegt ist. |
| Aktiviert | Nur aktivierte Anbindungen alarmieren, senden und rufen ab. |

![Formular einer Divera-Anbindung mit Empfangs-Adresse, Abruf, Webhook-Absendern und Zugangsdaten](/blume-assets/content/inhalt/administration/bilder/divera-anbindung.png)

:::caution[Alarme beenden]
Zum Beenden eines Alarms verlangt Divera einen Schlüssel, der Alarme bearbeiten darf. Ein
persönlicher Schlüssel ohne dieses Recht kann alarmieren, das Beenden schlägt dann mit einem
Hinweis an der Aufgabe fehl. Lagewerk beendet einen Alarm, ohne seinen Inhalt zu ändern.
:::

Wird einem Einsatz mit offenem Divera-Alarm ein weiteres Fahrzeug zugeteilt, nimmt Lagewerk es in
diesen Alarm auf; Titel, Text und Sonderrechte bleiben. Geht der offene Alarm schon an die ganze
Einheit oder an Gruppen, bleibt er unverändert, und die Aufgabe nennt das als Hinweis.

:::note[Kostenlose Divera-Version]
Die kostenlose Version von Divera übernimmt von einem Alarm nur den Titel (in Divera „Stichwort“): Text, Einsatzort,
Einsatznummer und Fahrzeuge fehlen, ein Fahrzeug-Alarm erreicht also die ganze Einheit. Sie
erlaubt nur eine Alarmierung je fünf Minuten; Lagewerk versucht es dann weiter, bis der Alarm
durchgeht. Alarme beenden kann sie nicht. Fahrzeugstatus und Rückmeldungen funktionieren.
:::

### Fahrzeuge zuordnen

Divera kennt Fahrzeuge unter einer Zahl, der **Divera-Fahrzeug-ID**. Sie steht in Divera unter
**Verwaltung → Fahrzeuge** beim Bearbeiten eines Fahrzeugs in der Adresszeile
(`…/vehicle/update.html?id=117568`). Tragen Sie sie am
Einsatzmittel bei einem Gerät vom Typ **Alarmierungs-App** als Kennung **Divera-Fahrzeug-ID** ein
(siehe [Geräte und Kennungen](/administration/anbindungen#geräte-und-kennungen)). Ohne diese
Kennung kann Lagewerk das Fahrzeug bei Divera weder alarmieren noch seinen Status senden; ein
von Divera gemeldeter Status eines unbekannten Fahrzeugs erscheint unter **Unbekannte Kennungen**.

### Fremde Alarme empfangen

1. Webhook-Token in der Anbindung setzen und speichern.
2. Die **Empfangs-Adresse** kopieren und `?token=` mit dem Webhook-Token anhängen.
3. In Divera unter **Verwaltung → Schnittstellen → Datenübergabe → Webhooks** einen Webhook mit
   dieser Adresse anlegen, Format **POST** mit `application/json`.

Lagewerk muss dafür aus dem Internet erreichbar sein; geben Sie nach außen nur den Pfad
`/api/v1/webhook/divera/` frei.

Alarme, die Lagewerk selbst ausgelöst hat, erkennt Lagewerk und legt dafür keinen Alarmeingang an.
Einen fremden Alarm übernehmen Sie wie jeden Alarmeingang; Titel und Text bilden zusammen das
Meldebild („Titel · Text“), Einsatzort und Koordinaten sind vorbelegt. Spätere Meldungen desselben Alarms aktualisieren den Eingang bzw. den
übernommenen Einsatz, ein in Divera geschlossener Alarm archiviert den offenen Eingang. Ob ein
Alarm geschlossen ist, fragt Lagewerk mit dem API-Schlüssel der Anbindung bei Divera nach; ist
Divera dabei nicht erreichbar, bleibt der Eingang offen und lässt sich von Hand archivieren.

## Alarmieren aus Aufgaben

In einer technischen [Aufgabenvorlage](/administration/anbindungen#funktionen-und-ziele) die
Funktion **Alarmieren** wählen. Das **Ziel** bestimmt, wer alarmiert wird:

| Ziel | Wer wird alarmiert |
|---|---|
| Anbindung direkt (die Divera-Anbindung) | Die ganze Einheit oder, mit Empfänger **gruppen**, die gewählte Gruppe. |
| Gerät des Einsatzmittels (Alarmierungs-App) | Nur das Divera-Fahrzeug dieses Einsatzmittels. |

| Angabe | Bedeutung |
|---|---|
| Text | Meldung des Alarms. Leer = Meldebild und Einsatzort. |
| Sonderrechte | Divera-Alarm mit Priorität. |
| Offenen Alarm beenden | Schließt den offenen Alarm dieses Einsatzes, statt zu alarmieren. |
| Titel | Leer = Meldebild. Divera kürzt auf 50 Zeichen. |
| Empfänger, Gruppe | Nur beim Ziel „Anbindung direkt“: **alle** oder **gruppen** mit Auswahl der Gruppe. |
| Push-Benachrichtigung senden | Standard eingeschaltet. |

Einsatzort, Koordinaten, Objekt und Bemerkung des Einsatzes gehen immer mit. Solange der Alarm
offen ist, aktualisiert jede weitere Auslösung im selben Einsatz ihn. Ein Fahrzeug-Alarm nimmt
weitere Fahrzeuge dazu, etwa wenn eine Vorlage mit Auslöser **Zuteilung** für jedes zugeteilte
Fahrzeug alarmiert; ein Alarm an Einheit oder Gruppe bleibt dabei unverändert.

Eine Vorlage mit **Offenen Alarm beenden** und Auslöser **Einsatzabschluss** schließt den Alarm
mit dem Einsatz. Gibt es keinen offenen Alarm, ist die Aufgabe ohne Wirkung erledigt.

## Fahrzeugstatus

- **Nach Divera:** Jeder Statuswechsel eines Fahrzeugs mit Divera-Fahrzeug-ID geht an Divera,
  gleich ob er im Statustableau oder über eine andere Anbindung entstand.
- **Von Divera:** Lagewerk holt im eingestellten Abstand die Status der Divera-Fahrzeuge und
  übernimmt neuere wie einen Klick im Statustableau. Beim ersten Abruf merkt sich Lagewerk nur den
  Stand, damit keine alten Status nachgespielt werden.
- Meldet Divera den Status, den das Fahrzeug schon hat, etwa nach einem Wechsel aus Lagewerk,
  ändert sich nichts.
- Hat Divera zu viele Anfragen gemeldet, wartet Lagewerk mit dem nächsten Abruf länger.
