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.

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 integráció: az Automation API-t használja, Home Assistant entityket hoz létre, és DinkyTask eseményeket küld a HA event busra.

Home Assistant entityk

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.