Zum Hauptinhalt springen
War diese Seite hilfreich?

Trigger-Referenz

Alle gültigen triggerType-Werte, die beim Erstellen von Automatisierungsregeln in PrimeCal verfügbar sind.

Trigger-Typen​

Enum-WertWire-StringBeschreibungtriggerConfig erforderlich
EVENT_CREATEDevent.createdLöst aus, wenn ein neuer Termin in einem der Kalender des Benutzers erstellt wird.Keine
EVENT_UPDATEDevent.updatedLöst aus, wenn ein bestehender Termin geändert wird.Keine
EVENT_DELETEDevent.deletedLöst aus, wenn ein Termin gelöscht wird.Keine
EVENT_STARTS_INevent.starts_inLöst X Minuten vor Terminbeginn aus.{ minutesBefore: Zahl }
EVENT_ENDS_INevent.ends_inLöst X Minuten vor Terminende aus.{ minutesBefore: Zahl }
RELATIVE_TIME_TO_EVENTrelative_time_to_eventLöst zu einem Zeitpunkt relativ zu Terminbeginn oder -ende aus (positiver oder negativer Versatz).{ offsetMinutes: Zahl, anchor: 'start' | 'end' }
CALENDAR_IMPORTEDcalendar.importedLöst aus, wenn ein externer Kalender-Sync-Import abgeschlossen ist.Keine
SCHEDULED_TIMEscheduled.timeLöst nach einem Cron-Zeitplan aus, unabhängig von einem bestimmten Termin.{ cronExpression: Zeichenkette }
WEBHOOK_INCOMINGwebhook.incomingLöst aus, wenn eine POST-Anfrage an die eindeutige Webhook-URL der Regel eingeht.Keine
TASK_STATUS_CHANGEDtask.status_changedLöst aus, wenn sich das status-Feld einer Aufgabe ändert (z. B. todo → done). Im Regel-Builder der Oberfläche noch nicht auswählbar — erstelle Regeln damit über die Automatisierungs-API.Keine
TASK_SCHEDULED_STARTtask.scheduled_startLöst aus, wenn eine Aufgabe ihre geplante Startzeit erreicht, einschließlich aus einer Routinenvorlage instanziierter Aufgaben. Ebenfalls derzeit nur über API.Keine
NOTIFICATION_DISPATCHEDnotification.dispatchedLöst aus, wann immer eine Benachrichtigung an den Regelbesitzer gesendet wird, über beliebige Kanäle — z. B. eine event.reminder-Push-Benachrichtigung, ein reservation.due-Alarm, oder die send_notification-Aktion einer anderen Regel.Keine

Hinweise​

  • event.starts_in / event.ends_in: Der Scheduler pollt mit einer Auflösung von 1 Minute. minutesBefore-Werte unter 1 sind unzuverlässig.

  • scheduled.time: cronExpression muss ein gültiger 5-Felder-Cron-Ausdruck sein (Minute Stunde Tag Monat Wochentag). Der Scheduler wertet berechtigte Cron-Ausdrücke jede Minute aus.

  • webhook.incoming: Jeder Regel mit diesem Trigger-Typ wird ein eindeutiges webhookToken (64-stellig, hexadezimal) zugewiesen. Das Token ist in der Regel-Detailansicht zugänglich und kann über POST /api/automation/rules/:id/webhook/regenerate neu generiert werden.

  • relative_time_to_event: Eingeführt für feinere Zeitversätze, die von event.starts_in/event.ends_in nicht abgedeckt werden. Verwendet offsetMinutes (negativ = vorher, positiv = nachher).

  • task.status_changed / task.scheduled_start: Vom Backend erkannte Trigger-Typen, die noch nicht im Trigger-Picker des Regel-Builders verfügbar sind. task.scheduled_start treibt das Muster "eine Routinenaufgabe löst zu ihrer geplanten Zeit einen Smart-Home-REST-Aufruf aus" — siehe Smart-Home-Automatisierung.

  • notification.dispatched: Die Umkehrung der send_notification-Aktion — statt dass eine Regel eine Benachrichtigung sendet, kann eine Regel auf eine gesendete reagieren (aus beliebiger Quelle: dem Erinnerungsplaner, einer anderen Automatisierungsregel, einem Reservierungsalarm usw.). Verwende die Bedingungsfelder notification.type und notification.channel (siehe Bedingungs-Referenz), um einzugrenzen, auf welche Benachrichtigungen eine Regel reagiert. Damit kann eine Benachrichtigung ein externes System steuern, statt nur den Benutzer zu benachrichtigen — zum Beispiel kann eine 5-Minuten-event.reminder-In-App-Benachrichtigung eine Webhook-Aktion auslösen, die eine Smart-Home-Szene "Besprechungsmodus" aktiviert:

    {
      "triggerType": "notification.dispatched",
      "conditionLogic": "AND",
      "conditions": [
        { "field": "notification.type", "operator": "equals", "value": "event.reminder" },
        { "field": "notification.channel", "operator": "contains", "value": "inapp" },
        { "field": "notification.data.minutesBefore", "operator": "equals", "value": "5" }
      ],
      "actions": [
        { "type": "webhook", "config": { "url": "https://smarthome.local/api/scene/meeting-mode" } }
      ]
    }

    Da dieser Trigger vom gemeinsam genutzten DomainEventBus ausgelöst wird und nicht von einem direkten Service-Aufruf, funktioniert er für jeden Benachrichtigungs-eventType im Katalog (siehe Notifications-API) — nicht nur für Terminerinnerungen.

Plan-Anforderung​

Automatisierungs-Endpunkte erfordern einen PrimeCal-Plan, der die Automatisierungsfunktion enthält. Siehe Pläne und Preise für Plandetails.