Zum Hauptinhalt springen
War diese Seite hilfreich?

Automatisierungsrezepte

Vier kopierbare Ausgangspunkte für die Aktion Webhook aufrufen — jeder mit Ziel, Voraussetzungen, Schritten und einer sofort anpassbaren Konfiguration. Wie die Aktion Webhook aufrufen allgemein funktioniert, steht unter Smart-Home-Automatisierung; für die andere, eingehende Seite (ein externes System löst eine PrimeCal-Regel aus) siehe Webhooks.

Jede Anfrage von Webhook aufrufen sendet einen JSON-Body

Die ausgehende Webhook-Aktion von PrimeCal sendet immer Content-Type: application/json mit einem JSON-kodierten Body — es gibt keine Möglichkeit, auf Formular-Kodierung umzustellen. Jedes der folgenden Rezepte ruft entweder eine API auf, die nativ JSON spricht, oder läuft über einen Vermittlungsdienst für ein Ziel, das kein JSON spricht.

1. Home Assistant: Ein Gerät einschalten​

Ziel: PrimeCal ruft einen Home-Assistant-REST-Befehl oder -Webhook auf, wenn ein Termin oder eine Aufgabe beginnt.

Voraussetzung: Deine Home-Assistant-Instanz muss über HTTPS aus dem Internet erreichbar sein (eine nur lokale Adresse wie homeassistant.local wird abgelehnt — siehe Smart-Home-Automatisierung, warum, und wie du sie mit Home Assistant Cloud oder einem eigenen Reverse-Proxy erreichbar machst). Du brauchst ein langlebiges Zugriffstoken von Home Assistant.

Schritte:

  1. Erstelle oder öffne eine Automatisierungsregel mit einem passenden Trigger (event.starts_in, task.scheduled_start, oder webhook.incoming, falls der Trigger von Home Assistant selbst kommt).
  2. Füge eine Aktion Webhook aufrufen hinzu.
  3. Fülle die untenstehende Konfiguration mit deiner eigenen Instanz-URL, deinem Token und der Entitäts-ID aus.
  4. Speichern — eine Webhook-Aktion ist eine sensible Aktion, die Regel benötigt daher eine Genehmigung, bevor sie wirklich ausgeführt wird (siehe Automatisierungsregeln erstellen für den Genehmigungsschritt).
{
  "url": "https://<your-instance>.ui.nabu.casa/api/webhook/<webhook-id>",
  "method": "POST",
  "authType": "bearer",
  "authToken": "YOUR_HOME_ASSISTANT_LONG_LIVED_TOKEN",
  "customPayload": { "entity_id": "switch.washing_machine" }
}

Grenzen: Eine Aktion sendet eine Anfrage — verkette mehrere Webhook-aufrufen-Aktionen in derselben Regel, um mehr als eine Entität zu steuern.

Die andere Richtung: Wenn Home Assistant stattdessen PrimeCal aufrufen soll (damit der webhook.incoming-Auslöser von PrimeCal feuert, oder Home Assistant einfach auf etwas reagieren soll, das PrimeCal ihm sendet), laden Sie das PrimeCal-Webhook-Action-Blueprint herunter und importieren Sie es in Home Assistant — siehe Smart-Home-Automatisierung für die Importschritte. Es gibt Ihnen einen Webhook-Endpunkt auf der Home-Assistant-Seite und lässt Sie eine beliebige Aktion auswählen, die ausgeführt wird, wobei die von PrimeCal gesendeten Daten als Template-Variable verfügbar sind.

2. Slack: Eine Nachricht posten​

Ziel: PrimeCal postet eine Slack-Nachricht, wenn ein Termin erstellt wird, sich der Status einer Aufgabe ändert, oder ein anderer Trigger ausgelöst wird.

Voraussetzung: eine Incoming-Webhook-URL für den Slack-Kanal, in den du posten möchtest (Slack-Workspace-Einstellungen → Apps → Incoming Webhooks → Zu Slack hinzufügen). Das ist eine einzelne URL mit bereits eingebettetem Kanal — kein Bot-Token, kein OAuth.

Schritte:

  1. Erstelle oder öffne eine Regel mit dem gewünschten Trigger (z. B. event.created).
  2. Füge eine Aktion Webhook aufrufen hinzu.
  3. Füge deine Incoming-Webhook-URL als url ein, lasse authType auf none (die URL selbst ist das Geheimnis) und setze ein customPayload mit einem text-Feld. Smart Values funktionieren innerhalb des Texts.
{
  "url": "https://hooks.slack.com/services/T000/B000/XXXXXXXXXXXXXXXXXXXXXXXX",
  "method": "POST",
  "authType": "none",
  "customPayload": { "text": "Neuer Termin: {{event.title}} am {{event.startTime}}" }
}

Grenzen: Eine Incoming-Webhook-URL postet nur in den Kanal, für den sie erstellt wurde — erstelle einen separaten Webhook (und eine separate Aktion oder Regel) für jeden Kanal, den du erreichen möchtest.

3. SMS-Erinnerung über Vonage​

Ziel: eine SMS-Erinnerung mit konfigurierbarem Vorlauf vor dem Beginn eines Termins senden.

Voraussetzung: ein Vonage-Konto mit aktivierter Messages API, eine Anwendungs-ID und ein privater Schlüssel, die gegen ein kurzlebiges JWT eingetauscht werden (die Messages-API-Referenz von Vonage beschreibt, wie man eines erzeugt), sowie eine genehmigte Absender-ID oder Nummer für dein Land.

Warum Vonages Messages API, nicht Twilio oder Vonages ältere SMS-API

Twilios REST-API und Vonages klassische SMS-API (rest.nexmo.com/sms/json) erwarten beide application/x-www-form-urlencoded, was die Aktion Webhook aufrufen nicht senden kann. Vonages neuere Messages API (api.nexmo.com/v1/messages) akzeptiert einen JSON-Body mit Bearer-Authentifizierung — deshalb funktioniert nur sie direkt aus dieser Aktion, ohne Vermittlungsdienst.

{
  "url": "https://api.nexmo.com/v1/messages",
  "method": "POST",
  "authType": "bearer",
  "authToken": "YOUR_SHORT_LIVED_JWT",
  "customPayload": {
    "message_type": "text",
    "text": "Erinnerung: {{event.title}} beginnt um {{event.startTime}}",
    "to": "YOUR_RECIPIENT_NUMBER",
    "from": "YOUR_SENDER_ID",
    "channel": "sms"
  }
}

Grenzen: Ein Vonage-Messages-API-JWT ist kurzlebig (typischerweise unter einer Stunde) — eine Regel, die dauerhaft funktionieren soll, braucht auf deiner Seite einen Prozess, der das JWT erneuert und den authToken der Regel aktualisiert; PrimeCal verwaltet das nicht für dich.

4. Wandtablet oder Kiosk: Gerät koppeln und einen Bildschirm wählen​

Ziel: ein Tablet, einen Raspberry Pi oder den Browser eines Smart-TVs in einen dauerhaft eingeschalteten Kiosk-Modus versetzen, der einen aus einer von PrimeCals Systemvorlagen gebauten Bildschirm zeigt.

Schritte:

  1. Koppel das Gerät — siehe Ein Gerät koppeln für den vollständigen Ablauf mit dem 8-stelligen Code.
  2. Öffne Bildschirme in der Hauptnavigation, gehe zum Tab Vorlagen, und klicke auf Auf einen Bildschirm anwenden bei einer der drei heute verfügbaren Systemvorlagen — Familien-Wandtafel, Team-Standup-Board oder Fokus heute — oder baue dein eigenes Layout aus Gadgets.
  3. Weise diesen Bildschirm dem gekoppelten Gerät zu.

Das Gerät fragt danach laufend den Inhalt seines zugewiesenen Bildschirms bei PrimeCal ab und zeigt ihn nur an, ohne eigene Benutzersitzung — siehe Ein Gerät koppeln und Vorlagen und Teilen für Details zu Vorlagen, Eigentümerschaft und Teilen.

Siehe auch​

  • Smart-Home-Automatisierung — wie die Aktion Webhook aufrufen funktioniert und welche Sicherheitsregeln gelten
  • Webhooks — die andere, eingehende Seite: ein externes System löst eine Regel aus
  • Ein Gerät koppeln — der vollständige Kiosk-Kopplungsablauf