Integrace RichPear Home
Mailgun
Mailgun propojí e-mailové notifikace a webhooky Mailgunu s RichPear Home. Hodí se pro provozní e-maily, automatizační upozornění a zpracování událostí doručených přes Mailgun.
- Doména
mailgun- Kategorie
- notifications
- Komunikace
- cloud-push
- Kvalita
- Není uvedeno
Příprava
Připravte doménu nebo sandbox v Mailgunu, API klíč a údaje pro odesílání. Pokud chcete přijímat webhooky, musí být veřejná externí URL RichPear Home správně nastavená a dosažitelná z internetu.
Webhook URL vygenerovanou integrací vložte do Mailgunu přesně tak, jak ji systém zobrazí. U e-mailových notifikací si dopředu určete odesílatele, příjemce a pravidla, kdy se zprávy posílají.
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.
Nastavení
V nastavení integrace nakonfigurujte Mailgun webhook a podle potřeby doplňte ruční konfiguraci pro notifikační službu. Po změně konfigurace proveďte kontrolu a restart, pokud je vyžadovaný.
Odešlete testovací e-mail nebo testovací webhook a sledujte logy. Teprve po úspěšném testu zapojte Mailgun do alarmů, servisních hlášení nebo automatizací.
Webhooky
Webhooky slouží pro příchozí události z Mailgunu. RichPear Home musí mít externí adresu, kterou Mailgun z internetu skutečně otevře.
Používejte HTTPS a neveřejte webhook adresu v dashboardech nebo dokumentech pro běžné uživatele.
Notifikace
Notifikační část posílá e-maily přes Mailgun. Je vhodná pro méně urgentní zprávy, servisní reporty nebo potvrzení událostí.
U urgentních stavů kombinujte e-mail ještě s lokální notifikací, protože e-mailová doručitelnost závisí na externí službě.
Automatizace
Před nasazením nastavte omezení proti opakovanému posílání. Chybná automatizace může během chvíle vytvořit mnoho e-mailů.
Do zpráv nedávejte hesla, tokeny ani citlivé údaje. Pro diagnostiku posílejte jen stručný popis a odkaz na interní dashboard.
Provoz
Sledujte limity Mailgun tarifu, odmítnuté zprávy a reputaci domény. Pro produkční odesílání je důležité mít správně nastavené DNS záznamy.
Při změně domény, API klíče nebo sandboxu znovu otestujte jak odesílání, tak příjem webhooků.
Kontrola
Po prvním dni provozu projděte historii automatizací a doručení zpráv. Zkontrolujte, zda se neposílají duplicitní upozornění a zda e-maily chodí správným lidem.
Pokud Mailgun přestane odpovídat, automatizace by neměly blokovat lokální provoz domu.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace Mailgun. 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.