# 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.

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:

```yaml
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.

---

Quelle: https://betriebsoffice.de/handbuch/wartung/meldequellen
Stand: 2026-11-14
Anbieter: BetriebsOffice ist ein Angebot von Wigandt Technology (https://wigandt.tech).
