Integrace RichPear Home

Mastodon

Mastodon integrace umí publikovat příspěvky, číst statistiky účtu a pracovat s vybranými akcemi účtu. Hodí se pro automatizované stavové příspěvky nebo přehled účtu ve vlastním dashboardu.

Doména
mastodon
Kategorie
notifications, senzory
Komunikace
cloud-polling
Kvalita
gold
01

Příprava

Připravte Mastodon instanci, účet a přístup pro aplikaci. Publikování příspěvků plánujte opatrně, protože automatizace mluví veřejně nebo poloveřejně jménem účtu.

Rozmyslete si, jestli má integrace jen číst statistiky, nebo také publikovat a upravovat profil. Tomu přizpůsobte oprávnění tokenu.

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í

V Nastavení -> Zařízení a služby přidejte Mastodon a projděte průvodce autorizací. Po přidání zkontrolujte senzory a dostupné akce.

Otestujte nejdřív čtení účtu. Publikování příspěvku zkoušejte s jasným testovacím textem a jen na účtu, kde je to přijatelné.

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

Senzory

Integrace může zpřístupnit statistiky účtu, například počty sledujících nebo další dostupné údaje. Ty se hodí pro dashboard a dlouhodobé sledování.

Senzory neobnovujte příliš agresivně. Sociální platforma má limity a data nepotřebují sekundovou přesnost.

04

Akce účtu

Dostupné akce zahrnují načtení účtu, ztlumení a odtlumení účtu, publikování příspěvku a úpravu profilu podle oprávnění.

Akce měnící veřejný obsah dávejte jen do automatizací s jasnými podmínkami a ochranou proti opakování.

05

Příklady použití

Praktické je publikovat lokální meteorologickou stanici, stav komunitního projektu nebo servisní upozornění. Text držte stručný a srozumitelný i bez kontextu dashboardu.

Nepublikujte privátní údaje o domácnosti, přítomnosti osob, zámcích nebo bezpečnostních stavech.

06

Limity

Mastodon instance se mohou lišit pravidly, limity a dostupnými funkcemi. Pokud akce selže, zkontrolujte oprávnění tokenu a pravidla konkrétní instance.

Při migraci účtu nebo změně instance znovu vytvořte autorizaci a projděte navázané automatizace.

07

Odebrání

Při odpojení integrace zrušte i token v Mastodon účtu. Tím zabráníte tomu, aby staré oprávnění zůstalo aktivní mimo RichPear Home.

Po odebrání zkontrolujte automatizace, které publikovaly nebo četly data z účtu.

08

Kontrola po nasazení

Po prvním dni provozu projděte historii entit integrace Mastodon. Sledujte, zda se hodnoty aktualizují podle typu komunikace cloud-polling 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.