Rocket.Chat

Příprava

Připravte adresu serveru Rocket.Chat, uživatele nebo webhook a kanál, do kterého se mají zprávy posílat. Doporučené je použít servisní účet s omezenými právy jen pro notifikace.

Před přidáním integrace si připravte názvy místností, zařízení a účel použití. Pokud jde o zařízení, které něco fyzicky ovládá, nejdřív ověřte ruční ovládání mimo automatizace.

Nastavení v RichPear Home

Integrace se nastavuje ručně v konfiguraci oznámení. Po změně konfigurace načtěte nastavení, pošlete testovací zprávu a ověřte, že se zobrazuje ve správném kanálu a pod očekávaným jménem.

Tahle integrace vyžaduje ruční konfiguraci. Po úpravě konfigurace vždy proveďte kontrolu nastavení a až potom restart nebo znovunačtení příslušné části systému.

Integrace obsahuje také volby. Po prvním přidání proto otevřete detail integrace a projděte dostupné možnosti, zejména intervaly, režimy a povolené entity.

Entity a funkce

Základní použití je služba oznámení, kterou volají automatizace, skripty nebo ruční akce. Text zprávy může obsahovat stav entity, čas, název zařízení a krátký popis problému.

Podle typu integrace očekávejte hlavně tyto entity nebo funkce: entity podle konkrétního nastavení integrace. Skutečný seznam závisí na modelu zařízení, oprávnění účtu a dostupnosti služby.

Každou důležitou entitu pojmenujte podle skutečné místnosti nebo účelu. Pomůže to při pozdějším ladění automatizací i při běžném používání dashboardu.

Provoz a automatizace

Pro běžný provoz oddělte kritická upozornění od informačních zpráv. U opakujících se stavů přidejte omezení četnosti, aby chat nezaplnily stejné zprávy při dlouhém výpadku senzoru.

Hodnoty sledujte alespoň jeden běžný provozní cyklus, aby bylo jasné, jak rychle se mění a kdy mohou být dočasně nedostupné.

U akcí, které ovlivňují zařízení, nejdřív proveďte ruční test. Do automatizace přidejte podmínku dostupnosti entity a rozumnou prodlevu, aby krátký výpadek nezpůsobil chybnou reakci.

Řešení potíží

Pokud zprávy nechodí, ověřte URL serveru, přístupové údaje, název kanálu a případné omezení na straně Rocket.Chat. U veřejného serveru používejte HTTPS a nesdílejte token v automatizacích.

Při potížích postupujte od nejjednodušší kontroly: zařízení nebo služba, síť, přístupové údaje, potom až automatizace.

Pokud integrace používá účet nebo vzdálenou službu, ověřte také stav účtu a limity služby. Pokud používá lokální komunikaci, začněte IP adresou, portem, dosahem a firewallem.

Kontrola po nasazení

Po nastavení integrace Rocket.Chat sledujte alespoň jeden běžný provozní cyklus. U cloudových služeb počítejte se zpožděním, u lokálních zařízení ověřte chování po restartu routeru, zařízení i RichPear Home.

Do automatizací vkládejte jen hodnoty, které jste viděli v reálném provozu. Důležité akce doplňte podmínkou dostupnosti entity, režimem domácnosti a ruční možností zásahu.

Před předáním běžným uživatelům ověřte názvy entit, práva uživatelů a chování při nedostupnosti služby. U zařízení, která něco fyzicky spínají nebo řídí, ponechte dostupné i ruční ovládání mimo RichPear Home.