Integrace RichPear Home

Matrix

Matrix umožní posílat zprávy do Matrix místností, reagovat na zprávy a používat příkazy z chatu jako události pro automatizace.

Doména
matrix
Kategorie
hub, notifications
Komunikace
cloud-push
Kvalita
legacy
01

Příprava

Připravte Matrix účet pro bota, přístupové údaje, server a místnosti, kam má bot psát. Servisní účet je lepší než osobní účet běžného uživatele.

Před konfigurací si určete povolené místnosti a příkazy. Chatový bot by neměl reagovat na libovolné zprávy v otevřených místnostech.

Lokální adresa

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

02

Nastavení

Nakonfigurujte Matrix integraci a připojte ji k vybraným místnostem. Po spuštění ověřte, že bot umí poslat zprávu a že události z příkazů přicházejí do RichPear Home.

Při testu použijte samostatnou místnost, aby se omylem neposílaly provozní zprávy celé skupině.

Po přidání vždy zkontrolujte vytvořená zařízení, entity, oblasti a oprávnění uživatelů. Teprve potom integraci zapojte do automatizací.
03

Notifikace

Integrace posílá textové zprávy a podle konfigurace také další formáty. Hodí se pro servisní zprávy, alarmy nebo sdílené domácí informace.

Pro důležité zprávy používejte krátký text a jednoznačné názvy místností. Dlouhé technické výpisy patří spíš do logu.

04

Příkazy

Matrix zprávy mohou vyvolat událost v RichPear Home, pokud odpovídají nastavenému příkazu. Tím lze spouštět automatizace z chatu.

Každý příkaz omezte na důvěryhodnou místnost a uživatele, pokud to vaše konfigurace umožňuje. Neautorizované ovládání domu přes chat je vysoké riziko.

05

Obrázky a vlákna

Integrace podporuje posílání obrázků v notifikaci a odpovědi ve vláknech podle možností klienta a serveru.

Obrázky mohou obsahovat citlivé informace. Neposílejte snímky kamer do místností, kde nejsou všichni příjemci oprávnění.

06

Akce

Dostupné akce umožňují poslat zprávu nebo reagovat na zprávu. Při volání z automatizací vždy nastavte správnou místnost a jasný obsah.

U opakovaných alarmů nastavte potlačení duplicit, jinak chat rychle zaplaví stejné zprávy.

07

Provoz

Matrix server může být vlastní nebo externí. Sledujte dostupnost serveru, stav bota a případnou změnu přístupového tokenu.

Po změně místnosti nebo pozvání bota znovu otestujte odesílání i příjem příkazů.

08

Kontrola po nasazení

Po prvním dni provozu projděte historii entit integrace Matrix. Sledujte, zda se hodnoty aktualizují podle typu komunikace cloud-push a zda se v logu neopakují stejné chyby, odpojení nebo odmítnuté požadavky.

Pokud integrace ovládá reálné zařízení, cloudový účet, placenou službu nebo ruční konfiguraci, nechte správcům jasný postup pro vypnutí automatizace a návrat k ručnímu ovládání. Zapište si také místo, kde se spravuje token, API klíč, IP adresa, párování nebo konfigurační soubor.