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.

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-Integration: nutzt die Automatisierungs-API, erstellt Home-Assistant-Entitäten und löst DinkyTask-Ereignisse auf dem HA-Ereignisbus aus.

Home-Assistant-Entitäten

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.