Integrace RichPear Home
Telegram bot
Telegram bot posílá a přijímá zprávy přes Telegram bota. Používá se pro upozornění, jednoduché příkazy a potvrzovací tok u důležitých domácích událostí.
- Doména
telegram_bot- Kategorie
- oznámení
- Komunikace
- cloudová služba
- Nastavení
- průvodce v nastavení
- Kvalita
- gold
Co integrace přidá
Telegram bot posílá a přijímá zprávy přes Telegram bota. Používá se pro upozornění, jednoduché příkazy a potvrzovací tok u důležitých domácích událostí.
V RichPear Home počítejte hlavně s oblastmi: entity podle konkrétní funkce. Skutečný rozsah se řídí konkrétním účtem, zařízením, firmwarem a oprávněním.
Kontrolní témata
- Introduction - Telegram bot platforms
- Předpoklady
- Nastavení
- Volby
- Allowlisting chat IDs via Subentries
- Notifiers
- Notification actions
Příprava před přidáním
Připravte token bota a seznam chatů, kam smí RichPear Home psát. Token držte jako citlivý údaj a nepoužívejte stejného bota pro nesouvisející projekty.
RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.
Nastavení v RichPear Home
Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Telegram bot a projděte zobrazený průvodce. Pokud se zařízení nebo služba objeví automaticky mezi objevenými položkami, otevřete ji odtud a doplňte požadované údaje.
Po uložení počkejte na první načtení dat. Některé entity se vytvoří hned, jiné až po prvním dotazu, objevení zařízení nebo po restartu služby.
Údaje ke kontrole
API klíč, token, uživatelské jméno a heslo, OAuth, YAML, port, IP adresa nebo host, webhook. Chyba v těchto údajích se obvykle projeví prázdným seznamem entit nebo opakovanou chybou v logu.
Kontrola entit a funkcí
Nejdřív otestujte jednoduchou zprávu do soukromého chatu. Teprve potom přidejte skupiny, tlačítka nebo automatizace s odpovědí uživatele.
Otevřete detail integrace, projděte zařízení a přiřaďte jim oblasti. U senzorů sledujte jednotku a historii, u ovládacích entit ručně vyzkoušejte bezpečný stav.
Použití v automatizacích
U oznámení omezte opakování a jasně pojmenujte zdroj události. Kritické zprávy posílejte do kanálu, kde je někdo opravdu uvidí, běžné provozní zprávy nechte v méně rušivém kanálu.
Začněte jednoduchou automatizací, která jen pošle oznámení nebo zapíše stav. Po ověření přidejte podmínky a až nakonec akce, které mění stav zařízení nebo volají službu.
Provoz a údržba
U cloudové služby pravidelně kontrolujte platnost tokenů a přístup účtu. Po změně hesla nebo oprávnění počítejte s tím, že integrace může potřebovat nové přihlášení.
Po změně účtu, tokenu, firmware, sítě nebo konfigurace zkontrolujte také dashboardy a automatizace, protože mohou používat původní entity nebo očekávat starý rozsah hodnot.
Řešení problémů
Když integrace nefunguje podle očekávání, ověřte adresu, port a firewall; zkontrolujte účet, token a dostupnost služby; zkontrolujte syntaxi konfigurace a restart. Potom otevřete Nastavení → Systém → Logy a hledejte chyby podle názvu integrace telegram_bot.
Při opakovaných chybách integraci hned neodstraňujte. Nejdřív ověřte přístupové údaje, dostupnost služby a čas poslední aktualizace. Odebrání a nové přidání má smysl až po vyloučení těchto příčin.