Webhooky přes Richpear Cloud

Nechte vnější služby spouštět vaše automatizace pomocí veřejné webhookové URL — bez vystavení celé domácnosti do internetu.

Webhook je veřejná internetová adresa (URL), na kterou může jiná aplikace nebo služba poslat požadavek. Jakmile na ni požadavek dorazí, Richpear Home spustí navázanou automatizaci. Typicky se používá k propojení s online službami, externími tlačítky, zkratkami na telefonu nebo systémy třetích stran.

Proč přes Richpear Cloud

Bez Richpear Cloud byste museli zpřístupnit domácnost do internetu a otevírat porty. Cloudové webhooky vystaví jen jednu konkrétní adresu pro daný spouštěč, zbytek systému zůstává skrytý.

Vytvoření webhooku

Otevřete Nastavení → Automatizace a scény a vytvořte novou automatizaci.
Jako spouštěč zvolte Webhook. Systém vygeneruje jedinečný identifikátor (ID).
Zapněte volbu pro veřejnou cloudovou URL. Vznikne adresa ve tvaru:

https://hooks.richpear.cz/AbCdEf123456_jedinecne-id

Tuto adresu vložte do externí služby, která má automatizaci spouštět.

Použití v automatizaci

Příklad: po zavolání webhooku se zapne osvětlení v obýváku.

alias: Webhook — rozsviť obývák
trigger:
  - platform: webhook
    webhook_id: jedinecne-id
    allowed_methods:
      - POST
    local_only: false
action:
  - service: light.turn_on
    target:
      entity_id: light.obyvak

local_only

Aby byl webhook dostupný z internetu přes Richpear Cloud, musí mít local_only: false. Pokud chcete spouštět jen z domácí sítě, ponechte local_only: true.

Předání dat

Do webhooku lze poslat data jako JSON nebo formulářová pole. V automatizaci je pak najdete v proměnné trigger a využijete pomocí šablon:

action:
  - service: notify.mobile_app
    data:
      message: "Spuštěno: {{ trigger.json.zprava }}"

Bezpečnost

ID webhooku je dlouhý, náhodný řetězec — slouží jako tajný klíč. Nesdílejte adresu veřejně.
Omezte povolené metody (např. jen POST) pomocí allowed_methods.
Pokud máte podezření, že adresa unikla, webhook smažte a vytvořte nový s jiným ID.
Webhook nikdy nevrací data ze systému — slouží pouze jako vstupní spouštěč.

Související: Vzdálený přístup · Šablony