Automatizace

Webhook trigger

Umožňuje spustit automatizaci externím HTTP požadavkem na unikátní webhook ID.

Doména
webhook
Typ
HTTP spouštěč automatizace
Kategorie
automation

Role v RichPear Home

Zdroj funkce

Integrace doplní zařízení, systémovou službu nebo stavební blok pro další části chytré domácnosti.

Správa

Po přidání vždy zkontrolujte vzniklé entity, oprávnění a pojmenování tak, aby byly srozumitelné i později.

Automatizace

Pravidla stavte nad stabilními stavy a u citlivých scénářů přidejte ověřovací podmínky.

UI

Webhook v automatizacích

Webhooky se obvykle používají jako spouštěče automatizací nebo pro napojení externích služeb.
01

Kdy použít Webhook trigger

Webhook se hodí pro napojení služeb, tlačítek, vlastních skriptů nebo systémů, které umí zavolat URL při události.

Praktické pravidlo

Nejdřív ověřte základní funkci ručně a teprve potom ji zapojujte do automatizací.

02

Jak začít s nastavením

V automatizaci vytvořte webhook trigger a vygenerujte dlouhé náhodné ID. URL sdílejte jen se službou, která ji má volat.

Běžná lokální adresa je http://rphome.local:8123. Pokud nefunguje, použijte http://IP-ADRESA:8123.

Kontrola

Po uložení nastavení otevřete seznam zařízení a entit a ověřte, že názvy odpovídají reálné domácnosti.

03

Bezpečnost URL

Webhook ID je prakticky tajný klíč. Nepoužívejte krátké čitelné názvy a nevkládejte URL do veřejných logů nebo dokumentace.

Doporučení

Udržujte jednoduché názvy, dokumentujte výjimky a po větší změně proveďte krátký test.

04

Napojení na automatizace

V požadavku můžete předat data a podle nich větvit akce. U veřejně dosažitelných webhooků přidejte kontrolu obsahu nebo další podmínky.

Bezpečnější vzor

Technickou entitu použijte jako vstup, rozhodnutí potvrďte podmínkami a výsledek si nechte zapsat do historie.

Řešení problémů

Když integrace nefunguje podle očekávání

Integrace nejde přidat

Zkontrolujte oprávnění administrátora, dostupnost zařízení nebo služby a případné požadované přihlašovací údaje.

Stav se neaktualizuje

Pokud webhook nereaguje, ověřte metodu požadavku, správnou URL, dostupnost RichPear Home z dané sítě a zda automatizace není vypnutá.

Automatizace reaguje špatně

Ověřte entity v nástrojích pro vývojáře a přidejte zpoždění nebo další podmínky, pokud stav krátce kolísá.