SendGrid

Příprava

Připravte API klíč ze SendGrid, ověřeného odesílatele a cílové adresy. API klíč uložte bezpečně a nepoužívejte osobní účet tam, kde stačí servisní přístup.

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 notifikací. Po načtení konfigurace pošlete testovací e-mail a ověřte odesílatele, předmět a doručení.

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.

Po prvním přidání otevřete detail integrace a projděte dostupné volby. Zaměřte se na intervaly, povolené entity, režimy a limity služby.

Entity a funkce

Základní funkcí je služba oznámení pro automatizace a skripty. Zpráva může obsahovat stav entity, čas, název zařízení a stručný popis problému.

Podle typu integrace očekávejte hlavně tyto entity nebo funkce: notifikace. 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

U e-mailů omezte četnost, aby výpadek senzoru neposlal desítky stejných zpráv. Kritická upozornění kombinujte s dalším kanálem, pokud e-mail nestačí.

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íží

Když e-mail nedorazí, ověřte API klíč, ověřeného odesílatele, limity SendGrid a spam složku. U citlivých dat neposílejte do e-mailu zbytečné detaily.

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 SendGrid 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.