Zum Hauptinhalt springen
Was this helpful?

Smart-Home-Automatisierung

PrimeCal-Automatisierungen können auf zwei Arten über den Kalender hinaus in Ihr Smart Home hineinreichen: durch direkten Aufruf der REST-API eines Geräts und durch bedarfsgesteuertes Instanziieren einer Routine-Vorlage über einen beliebigen Auslöser. Beides baut auf vorhandenen Automatisierungsbausteinen auf – es gibt kein separates „Smart Home“-Modul zu konfigurieren.

Die REST-API eines Smart-Home-Geräts aufrufen​

Die Aktion Call Webhook sendet bereits eine HTTP-Anfrage an eine von Ihnen konfigurierte URL. Sie unterstützt jetzt eine konfigurierbare HTTP-Methode und vollwertige Authentifizierung – genau das, was die meisten lokalen Smart-Home-REST-APIs (Home Assistant, Shelly und Ähnliches) erwarten.

Die Anfrage konfigurieren​

Im Aktions-Builder bietet die Aktion Call Webhook:

  • Method – GET, POST, PUT, PATCH oder DELETE (Standard POST, wenn nicht gesetzt, zur Kompatibilität mit Regeln, die gespeichert wurden, bevor dieses Feld existierte).
  • Auth type – none, bearer, basic oder header:
    • bearer sendet Authorization: Bearer <token>.
    • basic sendet Authorization: Basic <base64(user:pass)> – geben Sie das Token bereits im Format user:pass an.
    • header sendet das Token unter einem von Ihnen angegebenen benutzerdefinierten Header-Namen (nützlich für APIs, die z. B. X-API-Key erwarten).
  • Ein paar gängige Voreinstellungen (Home Assistant REST-Befehl, Shelly-Relais umschalten, generischer Bearer-Token-Endpunkt) füllen sinnvolle Standardwerte für Methode und Authentifizierung vor, damit Sie sich diese nicht merken müssen.

Action-Builder-Stack im PrimeCal-Automatisierungsmodal

Beispiel: Waschmaschine zum geplanten Start einschalten​

Die Lates haben eine Aufgabe „Start laundry“ innerhalb einer Routine-Vorlage. Wenn diese Aufgabe ihre geplante Startzeit erreicht, soll PrimeCal ihre Home-Assistant-Instanz aufrufen und die smarte Steckdose der Waschmaschine einschalten.

Beispiel-actionConfig für die Webhook-Aktion:

{
  "url": "https://homeassistant.local:8123/api/services/switch/turn_on",
  "method": "POST",
  "authType": "bearer",
  "authToken": "YOUR_HOME_ASSISTANT_LONG_LIVED_TOKEN",
  "customPayload": { "entity_id": "switch.washing_machine" }
}

Der Auslöser für diese Regel ist task.scheduled_start – er feuert, wenn eine Aufgabe (in diesem Fall eine aus einem Routine-Eintrag instanziierte Aufgabe) ihre geplante Startzeit erreicht. Dieser Auslöser ist noch nicht in der Auslöserauswahl des Regel-Builders verfügbar, daher wird eine solche Regel derzeit direkt über die Automatisierung API (oder von einem MCP-verbundenen Agenten) erstellt und nicht über das UI-Dropdown.

Tokens aus geteilten Regeln heraushalten

Auth-Tokens werden als Teil der Aktionskonfiguration gespeichert. Behandeln Sie eine geklonte oder geteilte Automatisierungsregel genauso wie ein geteiltes Zugangsdatum – rotieren Sie das Token, falls die Regel jemals exportiert oder an einen Ort kopiert wird, den Sie nicht kontrollieren.

Eine Routine über einen beliebigen Auslöser starten​

Die Aktion instantiate_routine lässt jeden Auslöser – einen Webhook, eine geplante Zeit, das Erstellen eines Ereignisses, den Statuswechsel einer Aufgabe oder das Erreichen der geplanten Startzeit einer Aufgabe – eine Routine-Vorlage sofort starten, genau so, als hätten Sie darauf Start now geklickt. Was eine Routine-Vorlage ist und welche anderen zwei Wege es zum Starten gibt, erfahren Sie unter Routinen und Vorlagen.

Beispiel: Ein smarter Wecker löst die Morgenroutine aus​

Der smarte Wecker der Lates kann beim Klingeln einen Webhook per POST senden. Statt jeden Morgen manuell PrimeCal zu öffnen und bei der „Morgenroutine“ auf Start now zu klicken, verbinden sie den Wecker mit einer Regel, die sie automatisch startet.

Beispiel-actionConfig für die Aktion instantiate_routine:

{
  "routineTemplateId": 42
}

Regelaufbau:

  1. Auslöser: webhook.incoming – die Integration des smarten Weckers sendet beim Klingeln einen POST an die Webhook-URL der Regel. Wie Sie diese URL finden und ansprechen, erfahren Sie unter Webhooks.
  2. Aktion: instantiate_routine mit routineTemplateId, gesetzt auf die geklonte „Morgenroutine“-Vorlage der Lates.

Die Aktion verwendet dieselbe Besitzprüfung wie die manuelle Schaltfläche Start now – eine Regel kann nur eine Routine-Vorlage instanziieren, die ihr Besitzer bereits sehen kann (eigene Vorlagen, über die Personengruppe geteilte Vorlagen oder aktive System-Vorlagen), niemals eine beliebige Vorlagen-ID, die jemand anderem gehört.

Wie task.scheduled_start ist auch der Aktionstyp instantiate_routine noch nicht im Dropdown der Aktionsauswahl verfügbar. Erstellen oder bearbeiten Sie eine Regel über die Automatisierung API, um ihn zu verwenden – zum Beispiel mit PUT /api/automation/rules/:id und einem actions-Array, das { "actionType": "instantiate_routine", "actionConfig": { "routineTemplateId": 42 } } enthält.

Siehe auch​

Letzte Aktualisierung: 2026-07-05 | PrimeCal v1.3.44