Automatisierungs-Integrationen

DinkyTask-Automatisierungsverbindungen sind über Familien-Webhooks, die Automatisierungs-API und die Home-Assistant-Integration verfügbar. DinkyTask bleibt die zentrale Datenquelle und Automatisierungen reagieren auf den DinkyTask-Status und -Ereignisse.

Was heute funktioniert

Der Familien-Webhook und die Automation API sind mit aktiver Testphase oder Premium-Abo verfügbar. Auch ein Blueprint für Home Assistant ist fertig: Ein Import genügt für eine funktionierende Automatisierung, ohne eine eigene Komponente zu installieren.

Das Home-Assistant-Add-on (HACS-Integration) befindet sich noch in Entwicklung. Die unten beschriebenen Entitäten und HA-Ereignisse gehören dazu und sind noch nicht verfügbar. Bis dahin ist der Blueprint der empfohlene Weg.

Home Assistant Blueprint

Der Blueprint nutzt den eingebauten Webhook-Trigger von Home Assistant und funktioniert daher in jeder Home-Assistant-Installation. Du legst fest, was bei welchem DinkyTask-Ereignis passiert — zum Beispiel, dass eine Lampe im Flur grün wird, wenn der Tagesplan erledigt ist.

Blueprint in Home Assistant importieren — oder diesen Link selbst einfügen: https://dinkytask.com/home-assistant/dinkytask-family-webhook-blueprint.yaml
Wähle eine lange, zufällige Webhook-ID. Home Assistant bildet daraus die öffentliche URL: https://DEIN-HA-HOST/api/webhook/DIESE-ID
Lege die Aktionen für jedes Ereignis fest (Plan gestartet, abgeschlossen, fehlgeschlagen, abgelaufen; Einreichung wartet auf Freigabe, freigegeben, abgelehnt).
Trage dieselbe Webhook-URL in DinkyTask unter Profil → Erweiterte Einstellungen ein.

Der Blueprint läuft über den Familien-Webhook und folgt damit den dort beschriebenen Ereignissen und Payloads.

Verbindungsoptionen

Familien-Webhook: jede Familie kann eine Ziel-URL konfigurieren, und DinkyTask sendet unterstützte Plan- und Abgabeereignisse an diesen Endpunkt.
Automatisierungs-API: tokenbasierte API, verfügbar mit einem aktiven Test- oder Premium-Abonnement. Sie gibt den aktuellen Familien-/Kind-/Planstatus und einen Ereignis-Feed zurück.
Home Assistant Blueprint: eine funktionierende Automatisierung durch einen einzigen Import, basierend auf dem eingebauten Webhook-Trigger von Home Assistant. Jetzt verfügbar.
Home-Assistant-Add-on: nutzt künftig die Automatisierungs-API, erstellt Home-Assistant-Entitäten und löst DinkyTask-Ereignisse auf dem HA-Event-Bus aus. In Entwicklung.

Home-Assistant-Entitäten

Die folgenden Entitäten gehören zum Home-Assistant-Add-on, das sich noch in Entwicklung befindet und noch nicht verfügbar ist.

Die Home-Assistant-Integration erstellt stabile Familien- und Kind-Entitäten.

sensor.dinkytask_family — Familienverbindungs- und Snapshot-Status.
sensor.dinkytask_pending_reviews — Anzahl der Abgaben, die auf elterliche Überprüfung warten.
binary_sensor.dinkytask_review_needed — wird eingeschaltet, wenn mindestens eine Abgabe eine Überprüfung benötigt.
sensor.dinkytask_<child>_today — tägliche Zusammenfassung pro Kind.

Kind-Tagesattribute

Der today-Sensor des Kindes enthält den aktuellen Tagesplanstatus und die automation_key-Werte für das Automatisierungs-Routing.

plan_count, plans_active, plans_completed, plans_pending_review
progress, required_completed, required_total, pending_review_count
current_automation_key, active_automation_key, completed_automation_key, pending_review_automation_key
automation_keys, active_automation_keys, completed_automation_keys, pending_review_automation_keys
current_plan und plans mit kompakten Plan-Metadaten.

Home-Assistant-Ereignisse

Die Integration wandelt Automatisierungs-API-Ereignisse in Home-Assistant-Ereignisse um. DinkyTask-Punkte werden durch Unterstriche ersetzt und der Ereignisname erhält ein dinkytask_-Präfix.

plan.completed → dinkytask_plan_completed
submission.pending_review → dinkytask_submission_pending_review
Die Nutzlast kann Felder wie child_name, plan_title und automation_key enthalten.

Das genaue Webhook-Verhalten und die Nutzlaststruktur sind auf der Webhooks-Seite dokumentiert.