Zum Inhalt springen

Meldequellen einrichten: Störungen direkt aus der Anlage

Wie Anlagen, Gebäudeleittechnik, Home Assistant oder Cumulocity Störungen direkt an BetriebsOffice melden, mit Reaktionszeit aus dem Vertrag und Notdiensteinsatz.

Kapitel: Wartung, Service und Prüfungen Aktualisiert: 3 Min. Lesezeit

Meldet eine Heizung, eine Wärmepumpe oder eine Lüftungsanlage selbst eine Störung, muss niemand mehr anrufen. Eine Meldequelle ist eine eigene Adresse, an die Ihre Anlage, die Gebäudeleittechnik oder eine IoT-Plattform die Störung schickt. BetriebsOffice findet die Anlage, nimmt die Reaktionszeit aus dem Vertrag und legt die Störung an, auf Wunsch sofort mit Notdiensteinsatz auf der Plantafel. Vorwarnung und Eskalation laufen wie bei einer telefonisch angenommenen Störung.

Schritt für Schritt: Meldequelle anlegen

  1. Öffnen Sie Einstellungen › Meldequellen.
  2. Geben Sie einen Namen ein, etwa "Heizzentrale Schulzentrum", und wählen Sie die Vorlage: Webhook (eigenes JSON), Cumulocity IoT, Home Assistant oder E-Mail.
  3. Klicken Sie auf Meldequelle anlegen.
  4. Kopieren Sie die angezeigte Adresse mit Token. Sie ist nur jetzt sichtbar; tragen Sie sie in Ihrer Anlage oder Plattform ein.
  5. Probieren Sie es aus: Testmeldung senden wertet eine Beispielmeldung aus, ohne etwas anzulegen. Alarm simulieren legt eine echte Störung an, so wie sie aus der Anlage käme.

Die Anlage erkennt BetriebsOffice über die Seriennummer (Vorgabe), die Anlagen-ID oder den QR-Code. Ist sie unbekannt, entsteht die Störung trotzdem, aber ohne Einsatz; in der Beschreibung steht dann "Anlage nicht gefunden".

Beispiel: Home Assistant

Tragen Sie in der configuration.yaml einen rest_command mit der Adresse der Meldequelle ein und rufen Sie ihn in einer Automation auf, wenn der Störungssensor anschlägt:

rest_command:
  betriebsoffice_stoerung:
    url: "https://api.betriebsoffice.de/v1/faults/fsrc_…"
    method: POST
    content_type: "application/json"
    payload: >-
      {"asset": "SN-12345", "severity": "critical", "message": "Heizung meldet Störung",
       "entity_id": "{{ trigger.entity_id }}", "status": "{{ trigger.to_state.state }}",
       "timestamp": "{{ now().isoformat() }}"}

automation:
  - alias: "Heizungsstörung an BetriebsOffice"
    triggers:
      - trigger: state
        entity_id: binary_sensor.heizung_stoerung
    actions:
      - action: rest_command.betriebsoffice_stoerung

Steht der Sensor wieder auf off, sendet dieselbe Automation "status": "off". BetriebsOffice hebt die Störung dann auf, solange noch niemand eingeteilt ist; sonst wird es in der Störung vermerkt.

Cumulocity und E-Mail

  • Cumulocity IoT: Leiten Sie Alarme an die Adresse weiter, etwa über eine Smart Rule. Gelesen werden Stufe, Status, Text, Zeitpunkt, Alarmtyp und der Name des Geräts als Seriennummer. Die Stufe WARNING wird ignoriert, CLEARED hebt die Störung auf.
  • E-Mail: Leiten Sie Störungsmails Ihrer Anlage über Ihren Mailanbieter als Webhook an die Adresse weiter. Die Seriennummer steht im Text als "Seriennummer: …", das Wort "aufgehoben" im Betreff hebt die Störung auf.

Sicherheit und Verhalten

  • Signatur verlangen: Dann braucht jede Meldung zusätzlich eine Signatur (HMAC-SHA256 des Inhalts im Header X-Signature). Den Schlüssel zeigt BetriebsOffice einmal an.
  • Token erneuern: Das alte Token gilt sofort nicht mehr.
  • Fenster für Wiederholungen (Minuten): Meldet die Anlage dieselbe Störung mehrfach, zählt BetriebsOffice nur hoch, statt neue Störungen anzulegen.
  • Höchstens Meldungen je Minute: schützt vor Anlagen, die in einer Schleife senden.
  • Sofort als Notdiensteinsatz in die Plantafel: legt mit der Störung den Einsatz mit Reaktionsfrist an.
  • Unter Zuordnung der Felder passen Sie an, wo in Ihrer Meldung Anlage, Dringlichkeit, Text und Zeitpunkt stehen.

Jede Meldung steht unter Letzte Meldungen und in der Störung unter Meldung der Anlage, mit den gesendeten Daten ohne Geheimnisse.

Weiterlesen

Kostenlos testen

Bereit für den Wechsel?

Testen Sie BetriebsOffice 30 Tage mit Ihren eigenen Daten oder lassen Sie sich in 30 Minuten zeigen, wie Ihr Betrieb damit läuft.