Automatizálási integrációk

A DinkyTask automatizálási kapcsolatai családi webhookon, Automation API-n és Home Assistant integráción keresztül érhetők el. A DinkyTask marad a forrásrendszer, az automatizációk pedig a DinkyTask állapotaira és eseményeire reagálnak.

Mi működik ma

A családi webhook és az Automation API elérhető, aktív próbaidővel vagy prémium előfizetéssel. A Home Assistanthez készült blueprint szintén kész: egyetlen importtal kapsz egy működő automatizálást, egyéni bővítmény telepítése nélkül.

A Home Assistant bővítmény (HACS integráció) fejlesztés alatt áll. Az alább leírt entityk és HA események ahhoz tartoznak, és még nem érhetők el. Addig a blueprint az ajánlott út.

Home Assistant blueprint

A blueprint a HA beépített webhook triggerére épül, így bármelyik Home Assistant telepítésen működik. Te adod meg, mi történjen az egyes DinkyTask eseményeknél — például kapcsoljon zöldre egy lámpa, ha a napi terv teljesült.

  1. Importáld a blueprintet a Home Assistantba — vagy másold be kézzel ezt a linket: https://dinkytask.com/home-assistant/dinkytask-family-webhook-blueprint.yaml
  2. Adj meg egy hosszú, véletlenszerű webhook ID-t. A HA ebből képzi a nyilvános URL-t: https://A-TE-HA-CIMED/api/webhook/AZ-ID
  3. Állítsd be, mi történjen az egyes eseményeknél (terv indult, teljesült, bukott, lejárt, beküldés vár jóváhagyásra, jóváhagyva, elutasítva).
  4. Ugyanezt a webhook URL-t add meg a DinkyTaskban: Profil → Haladó beállítások.

A blueprint a családi webhookot használja, tehát az ott leírt eseményekre és payloadra épül.

Kapcsolódási módok

  • Családi webhook: egy családhoz egy cél URL állítható be, és a DinkyTask erre küldi a támogatott terv- és beküldés-eseményeket.
  • Automation API: aktív próbaidő vagy prémium előfizetés mellett elérhető tokenes API, amely aktuális családi/gyermek/terv állapotot és eseményfolyamot ad vissza.
  • Home Assistant blueprint: egyetlen importtal működő automatizálás, a HA beépített webhook triggerére építve. Elérhető.
  • Home Assistant bővítmény: az Automation API-t használná, Home Assistant entityket hozna létre, és DinkyTask eseményeket küldene a HA event busra. Fejlesztés alatt.

Home Assistant entityk

A lenti entityk a fejlesztés alatt álló Home Assistant bővítményhez tartoznak, és még nem elérhetők.

A Home Assistant integráció stabil családi és gyermekenkénti entityket hoz létre.

  • sensor.dinkytask_family — családi kapcsolat és snapshot állapot.
  • sensor.dinkytask_pending_reviews — szülői jóváhagyásra váró beküldések száma.
  • binary_sensor.dinkytask_review_needed — bekapcsol, ha van legalább egy review-ra váró beküldés.
  • sensor.dinkytask_<gyermek>_today — gyermekenkénti napi összesítő.

Gyermekenkénti napi attribútumok

A gyermek today szenzora tartalmazza a napi tervek állapotát és az automatizáláshoz használható automation_key értékeket.

  • 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 és plans rövid tervlistával.

Home Assistant események

Az integráció az Automation API eseményfolyamából Home Assistant eventeket hoz létre. A DinkyTask pontokat aláhúzásra cseréli, és dinkytask_ előtagot ad hozzá.

  • plan.completed → dinkytask_plan_completed
  • submission.pending_review → dinkytask_submission_pending_review
  • A payload tartalmazhatja többek között a child_name, plan_title és automation_key mezőket.

A webhookok pontos payloadját és működését a Webhookok oldalon találod.