Automatisierung & Webhooks

Stand: 25. Juli 2026

Widgee spricht schlichtes HTTP – in beide Richtungen. Damit lässt es sich mit jedem Automatisierungswerkzeug verbinden: n8n, Make, Zapier, Home Assistant, GitHub Actions oder einem einzeiligen curl-Skript.

Zwei Richtungen, die sich beliebig kombinieren lassen:

Richtung	Was passiert	Stand
Holen	Widgee ruft deinen Endpunkt auf und zeigt die Antwort im Widget	verfügbar
Auslösen	Ein Tipp aufs Widget startet deinen Workflow	verfügbar
Melden (Push)	Dein Workflow schiebt eine Änderung sofort aufs Gerät	bald

1. Daten ins Widget holen

Lege in Widgee unter Daten › Web / API eine Anfrage an. Konfigurierbar sind Methode, URL, Header, Body, Authentifizierung (Basic, Bearer, API-Key) und das Aktualisierungs-Intervall. Aus der JSON-Antwort wählst du per Pfad die Felder aus, die du anzeigen willst.

Rezept: n8n

Neuen Workflow anlegen, Node Webhook hinzufügen, Methode GET.
Daten sammeln (beliebige Nodes) und mit Respond to Webhook als JSON zurückgeben.
Die Produktions-URL in Widgee als Anfrage eintragen und die Felder zuordnen.

Eine Antwort kann zum Beispiel so aussehen:

{
  "serverOnline": true,
  "uptime": "99,9 %",
  "offeneTickets": 3
}

Im Widget bindest du dann serverOnline, uptime und offeneTickets an Komponenten – und baust darauf Zustände wie {serverOnline} == false auf.

Widgee holt die Daten in deinem Intervall. Wie oft ein Widget tatsächlich aktualisiert, entscheidet iOS – für Statusanzeigen sind 15 bis 30 Minuten ein guter Wert. Zugangsdaten liegen im Schlüsselbund des Geräts und werden beim Teilen eines Widgets nie mitgegeben.

2. Workflow per Widget-Tipp starten

Jede Komponente kann als Aktion Webhook auslösen oder eine HTTP-Anfrage ausführen. Damit wird ein Widget zur Fernbedienung: Garagentor öffnen, Deployment starten, Anwesenheit melden.

Rezept: n8n

Node Webhook mit Methode POST anlegen.
Die URL in Widgee als Aktion hinterlegen (optional mit Body und Bearer-Token).
Im Anschluss beliebige Nodes – der Tipp im Widget startet den gesamten Ablauf.

Beides lässt sich verketten: Ein Ablauf kann erst den Webhook auslösen, dann eine Variable setzen und zuletzt das Widget aktualisieren.

3. Sofort melden (Push)

Statt auf das nächste Abrufintervall zu warten, kann dein Workflow Widgee direkt anstoßen. Die App holt sich dann neue Daten und zeichnet die Widgets neu – ohne dass du sie öffnest.

Einrichten

In Widgee unter Daten › Sofort aktualisieren die Mitteilungen erlauben.
Den angezeigten Push-Schlüssel kopieren.
Im Workflow einen HTTP-Request an den Push-Endpunkt anhängen:

POST /notify
Content-Type: application/json

{
  "key": "<dein Push-Schlüssel>",
  "widgetId": "optional – nur dieses Widget"
}

Behandle den Schlüssel wie ein Passwort – wer ihn kennt, kann dein Gerät anstoßen. Trage ihn nicht in Workflow-Vorlagen ein, die du öffentlich teilst.

Rezept: n8n

Am Ende deines Workflows einen HTTP Request-Node anhängen: Methode POST, JSON-Body wie oben.
Den Push-Schlüssel nicht direkt eintragen, sondern als n8n-Credential bzw. Umgebungsvariable hinterlegen – so bleibt er beim Exportieren des Workflows draußen.
Fertig. Widgee aktualisiert daraufhin seine Datenquellen und zeichnet die Widgets neu.

Antworten, auf die dein Workflow reagieren sollte

Code	Bedeutung	Was tun
`204`	angenommen	nichts
`400`	Schlüssel fehlt oder ist falsch aufgebaut	Body prüfen
`401`	Schlüssel unbekannt oder falsch	Schlüssel neu aus der App kopieren
`410`	Gerät nicht mehr erreichbar (App entfernt)	Workflow abschalten
`429`	Rate-Limit erreicht	`Retry-After` abwarten – meist eine Schleife im Workflow
`502`	Push konnte nicht zugestellt werden	später erneut versuchen

Grenzen: 60 Anstöße pro Stunde und Schlüssel. Die App selbst verwirft zusätzlich Anstöße, die weniger als 20 Sekunden auseinanderliegen – schicke also lieber eine Nachricht bei einer echten Änderung als im Sekundentakt.

Was iOS dabei zulässt

Stille Hintergrund-Pushes werden auf wenige pro Stunde gedrosselt. Für „Server ausgefallen" reicht das; für einen Kursticker nicht.
Soll etwas garantiert sofort sichtbar sein, ist eine sichtbare Mitteilung der zuverlässige Weg.
Auch mit Push gilt weiterhin das Aktualisierungs-Budget von WidgetKit.

Hinweis: Der Push-Endpunkt ist eingerichtet, aber noch nicht öffentlich freigeschaltet. Die genaue Adresse steht hier, sobald er erreichbar ist. Bis dahin sind das Abrufintervall und Kurzbefehle die verlässlichen Wege.

4. Warum kein eigener Dienst pro Anbieter?

Widgee integriert bewusst kein einzelnes Werkzeug fest, sondern spricht nur HTTP. Das hat zwei Gründe: Deine Zugangsdaten bleiben dort, wo sie hingehören – auf deinem Gerät und in deinem eigenen Automatisierungs- Werkzeug. Und du bist an nichts gebunden: Was HTTP kann, funktioniert mit Widgee.

→ Was du mit Widgee bauen kannst
→ Berechnungen & Formeln