–Schnittstellen

Melder an Florivio anbinden

Diese Seite ist für den Techniker, der den Melder einrichtet. Das kann eine Brandmelde- oder Einbruchmeldeanlage sein, ein Pegelmelder, ein vernetzter Rauchmelder oder eine Störmeldung aus der Gebäudetechnik. Der Melder schickt seine Meldung an Florivio, und Florivio gibt sie an die Feuerwehr weiter. Unten steht, was der Melder je Weg können muss und was du einträgst.

Wege vergleichen Frage stellen
Verfügbar

So kommt die Wehr zu ihrem Eingang

Webhook und E-Mail sind verfügbar. Die Feuerwehr meldet sich bei uns, und wir richten den Eingang gemeinsam mit ihr ein. Die Adresse, die du im Melder einträgst, bekommst du danach von der Wehr.

Was die Feuerwehr vorher erledigt

  1. Sie legt in Florivio einen Alarm-Eingang an, gibt ihm einen Namen wie „Pegel Dorfbach“ oder „Brandmeldeanlage Gerätehaus“ und wählt den Weg.
  2. Sie legt fest, ob aus einer Meldung automatisch ein Einsatz in der Einsatzdokumentation entsteht. Das lässt sich je Eingang abwählen, etwa für reine Störmeldungen.
  3. Mit dem Add-on Zusatzalarmierung legt sie außerdem fest, wer die Meldung als Push bekommt und ob sie als Info oder als Alarm ankommt.
  4. Florivio erzeugt die Adresse für den Eingang. Die Wehr gibt sie dir, und nur dir.

Ist die Adresse an die falsche Stelle geraten, erneuert die Wehr sie in Florivio, und du trägst die neue im Melder ein.

Welcher Weg passt zum Melder?

Kann der Melder eine Internetadresse aufrufen, nimm den Webhook. Er braucht kein Postfach und meldet dem Melder direkt zurück, ob die Meldung angekommen ist. Die E-Mail ist für Melder gedacht, die nur Mails verschicken können.

Merkmal Webhook E-Mail SMS
Stand Verfügbar Verfügbar Vorgesehen, noch nicht umgesetzt
Der Melder muss können Eine Internetadresse per HTTPS aufrufen (GET oder POST) Eine E-Mail über ein eigenes Postfach versenden –
Du trägst ein Die Adresse aus Florivio, alternativ Adresse plus Token als Bearer-Header Die Empfängeradresse aus Florivio –
Titel und Text JSON, Formular, Parameter in der Adresse oder reiner Text Betreff wird Titel, Mailtext wird Meldung –
Absender Wer Adresse oder Token kennt, kann senden Nur Absender, die die Wehr beim Eingang einträgt –
Rückmeldung an den Melder HTTP-Statuscode, Wiederholung bei 429 und 503 Florivio lehnt die Mail bei falscher Adresse oder abgeschaltetem Eingang ab; eine Rückmeldung hängt vom Mailserver des Melders ab –
Verfügbar

Webhook

Der Melder ruft per HTTPS die Adresse auf, die Florivio für den Eingang erzeugt; ihr letzter Teil ist der Token. Trag die Adresse so ein, wie sie in Florivio steht. Kann der Melder nur „Adresse aufrufen“, reicht ein GET. Kann sie Kopfzeilen setzen, schick den Token lieber per POST als Authorization: Bearer an dieselbe Adresse ohne den Token am Ende, dann steht er in keiner Adresszeile.

Titel und Text

Beide Felder sind freiwillig; Florivio liest sie aus JSON, aus einem Formular (application/x-www-form-urlencoded) oder bei GET aus den Parametern der Adresse. Für die Feldnamen gibt es mehrere Schreibweisen, damit du nehmen kannst, was der Melder vorgibt. Schickt sie etwas anderes als JSON oder Formular, wird der ganze Rumpf zum Text. Lange Titel und Texte kürzt Florivio.

FeldErlaubte Namen
Titeltitel, title, subject, betreff, stichwort
Texttext, message, body, nachricht, meldung

Beispiel: POST mit JSON

POST <Adresse aus Florivio>
Content-Type: application/json

{
  "titel": "Brandalarm",
  "text": "Melder 12, 1. OG, Schulungsraum"
}

Beispiel: Token im Header, mit Idempotency-Key

Wiederholt der Melder eine Meldung, weil sie keine Antwort bekommen hat, schick denselben Idempotency-Key mit. Dann verarbeitet Florivio die Meldung nur einmal. 

POST <Adresse aus Florivio, ohne den Token am Ende>
Authorization: Bearer <token>
Content-Type: application/json
Idempotency-Key: 2026-11-07-0815-melder12

{
  "titel": "Einbruchalarm",
  "text": "Zone 3, Hintereingang"
}

Beispiel: nur Adresse aufrufen

GET <Adresse aus Florivio>?titel=Störung&text=Netzausfall%20Zentrale

Antworten

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"status":"ok","ergebnis":"zugestellt"}
200
Angenommen. Das gilt auch für eine Wiederholung derselben Meldung; im Feld ergebnis steht, was Florivio damit gemacht hat.
403
Adresse oder Token falsch oder Eingang ausgeschaltet. Erneut senden hilft nicht.
413
Anfrage zu groß. Schick nur Titel und Text.
429
Zu viele Aufrufe. Später erneut senden.
503
Fehler bei uns. Später erneut senden.
Verfügbar

E-Mail

Der Melder verschickt eine Mail über sein Postfach an eine eigene Empfängeradresse, die Florivio für den Eingang erzeugt. Der Betreff wird zum Titel, der Mailtext zur Meldung. Anhänge übernimmt Florivio nicht, Bilder oder Protokolldateien kommen also nicht bei der Mannschaft an.

  • Der Melder braucht eine feste Absenderadresse. Die Wehr trägt sie beim Eingang ein, als Adresse oder als ganze Domain wie @example.de. Mails anderer Absender stellt Florivio nicht zu.
  • Florivio prüft, ob die Mail wirklich von diesem Absender kommt. Dafür muss das Postfach des Melders seine Mails mit DKIM signieren; ob es das tut, hängt vom Mailanbieter und dessen Einstellungen ab.
  • Schickt der Melder dieselbe Mail ein zweites Mal, verarbeitet Florivio sie nur einmal.

Beispiel-Mail

Von:     melder@example.de
An:      <Adresse aus Florivio>
Betreff: Brandalarm

Melder 12, 1. OG, Schulungsraum

Ist die Empfängeradresse falsch oder der Eingang ausgeschaltet, lehnt Florivio die Mail ab. Ob der Melder davon eine Unzustellbarkeitsmeldung bekommt, hängt von seinem Mailserver ab.

Vorgesehen

SMS

Ein Eingang per SMS ist vorgesehen, aber noch nicht umgesetzt; Format und Rufnummer stehen deshalb noch nicht fest. Kann der Melder weder einen Webhook noch eine Mail schicken, schreib uns, welches Gerät verbaut ist. Wir schauen uns die Schnittstelle an.

Was bei der Feuerwehr ankommt

Jede Meldung steht im Protokoll des Eingangs. Hat die Wehr es so eingestellt, legt Florivio daraus einen Einsatz in der Einsatzdokumentation an. Mit dem Add-on Zusatzalarmierung schickt Florivio die Meldung außerdem als Push in die Florivio-App, an genau die Mitglieder, die die Wehr für den Eingang ausgewählt hat. Im Push steht der Name des Eingangs zusammen mit Titel und Text deiner Meldung. Ob er als Info oder als Alarm ankommt, legt die Wehr fest:

Info

Ein Push ohne Alarmton und ohne Rückmeldung, etwa für eine Störmeldung.

Alarm

Ein Push mit Alarmton, auf den die Mitglieder mit den Rückmeldungen ihrer Wehr antworten, etwa „Komme“.

Die Meldung ersetzt nicht die Alarmierung durch die Leitstelle. Kommen viele Meldungen kurz hintereinander, fasst Florivio sie zu einem Sammel-Push zusammen; im Protokoll der Wehr steht jede einzelne. Dort sieht die Wehr auch, ob deine Probeauslösung angekommen ist.

Fragen zur Anbindung

Schreib uns über das Kontaktformular und nenn die Feuerwehr, für die du den Melder einrichtest, und das Gerät, um das es geht. Adresse oder Token gehören nicht in die Nachricht. Ist die Wehr schon Kundin, kann sie auch ihren gewohnten Supportweg nutzen.

Alle anderen Anbindungen von Florivio stehen auf der Seite Schnittstellen, die Alarmierung aufs Smartphone unter Zusatzalarmierung.