Home Assistant, Make, ...

Automatizace představuje klíčový přístup efektivního využívání dat při jejich dalším zpracování, realizaci navazujících činností či vyhodnocování. Podobně je tomu i u automatizace na základě dat z rezervačního systému. Díky odpovídající automatizaci je možné provádět opakující se a rutinní činnosti v rámci automaticky řízených procesů, které reagují na konkrétní události. Výsledkem je celkově větší efektivita provozu, menší chybovost a lepší zákaznický zážitek.

Systém reenio umožňuje přístup k datům tak, aby je bylo možné dále využívat jako součást automatizovaných scénářů, a to s využitím dalších specializovaných nástrojů nebo specifického vývoje. Díky těmto možnostem tak mohou události, jako je vytvoření rezervace nebo její začátek, sloužit jako spouštěče následných akcí, ať už se jedná o interní procesy, komunikaci se zákazníky nebo integraci s dalšími systémy a službami. Klíčovými stavebními kameny nezbytnými pro realizaci automatizací jsou v tomto ohledu Vlastní zprávy (specificky webhooky) a možnost využívání API.

Automatizace s využitím dat a událostí z rezervačního systému může být přínosná například pro ovládání světel u jednotlivých sportovišť, zapnutí klimatizace v zasedací místnosti, předehřátí sauny, aktivace nabíjecí stanice pro elektromobil, předávání dat do CRM, analýza dat, ...

Home Assistant

Home Assistant je open-source platforma nejen pro chytrou domácnost, která slouží k centrálnímu řízení a automatizaci různých zařízení a technologií. Umožňuje propojit osvětlení, topení, senzory, zabezpečení i další systémy různých výrobců a s různými technologiemi přístupu do jednoho celku a řídit je na základě událostí, stavů senzorů, času nebo externích dat. Platforma Home Assistant je vždy provozována lokálně, tj. jako přímá součást infrastruktury v domácnosti či budově (nejedná se o cloudovou službu). Lze ji provozovat na různých zařízeních, od plnohodnotného PC či serveru, až po instalace využívající hardware typu Raspberry Pi či ideálně přímo na specializovaných zařízeních Home Assistant Green a Yellow.

Zásadní výhodou platformy Home Assistant je lokální, centralizovaná a flexibilní automatizace chytrých zařízení, která umožňuje propojit téměř jakékoliv zařízení napříč výrobci, způsoby komunikace a protokoly do jednoho systému a spouštět automatizace bez přímé závislosti na cloudu.

  • Lokální zpracování dat – citlivá data zůstávají v lokální infrastruktuře, což zvyšuje to soukromí a bezpečnost.
  • Obrovská flexibilita – podpora tisíců integrací, různé protokoly (Zigbee, Z-Wave, Wi-Fi, Bluetooth, Matter, MQTT, atd.) nebo možnost napojení na cloudové služby (Philips Hue, Somfy, Samsung, atd.).
  • Pokročilé automatizace – pravidla lze definovat podle času, stavu zařízení, událostí, geolokace nebo kombinací podmínek, a to i komplexně pomocí pokročilého skriptování.
  • Rozšiřitelnost a open‑source – rozsáhlá komunita neustále přidává nové funkce, doplňky a integrace a poskytuje znalosti a návody.

Nastavení webhooku pro automatizaci

Propojení rezervačního systému reenio a platformy Home Assistant je postaveno na událostech, které vznikají v rezervačním systému a pomocí webhooku jsou notifikovány do externího systému. Home Assistant tedy musí "poslouchat" na předem specifikovaných URL adresách a na základě příchozí HTTP zprávy je pak schopen spustit automatizaci apod. S ohledem na to, že z důvodu bezpečnosti musí vždy externí systém při přijetí webhooku odpověděť konkrétním způsobem, není možné na straně HA využít standardní řešení pomocí přímých webhooků jednotlivých automatizací, ale je potřeba využít rozšíření Node-RED.

  1. Předpokladem pro fungující integraci je samozřejmě nakonfigurovaný a fungující HA schopný ovládat potřebná zařízení vč. odpovídajících automatizací.

  2. Pro instalaci Node-RED rozšíření zvolte nabídku Settings - Add-ons - Add-on Store a najděte "Node-RED". Tento doplněk nainstalujte.

  3. Po úspěšné instalaci zapněte nastavení "Start on boot" a "Watchdog" a doplněk spusťte. Pokud je vše v pořádku, bude možné spustit webové rozhraní Node-RED pomocí tlačítka "Open Web UI".

  4. V prostředí Node-RED je následně možné vytvářet různé scénáře, které budou realizovat potřebné automatizace. Pro přijetí webhooku a reakci na něj je potřeba vytvořit vstupní uzly typu "http in", "http response" a "action". Konkrétní podoba vytvořeného schématu a nastavení jednotlivých uzlů je uvedeno na obrázku.

  1. Následně je potřeba vytvořit vlastní zprávu typu webhook přímo v administraci rezervačního systému, kdy se použije URL odpovídající přímému přístupu k vytvořenému uzlu v Home Assistant Node-RED scénáři. V rámci uvedeného příkladu to bude URL v podobě http://IP_ADRESA:1880/endpoint/reservation-start-court-1. Další nastavení ohledně vyvolání webhooku, přiřazení do skupin, propojení s termíny atd., je již standardní v rámci používání vlastních zpráv jako takových.

Aby bylo možné takovouto automatizaci realizovat, je nutné zajistit, aby URL pro webhook (URL směřující do Node-RED subsystému) byla přístupná z internetu. To může vyžadovat veřejnou IP adresu a konfiguraci firewallů, využití proxy, nastavení zabezpečení příp. další specializovaná nastavení či IT řešení! Bez přístupné URL adresy není možné propojení cloudového rezervačního systému a lokálně provozovaného Home Assistenta zajistit.

Tímto je vytvořena automatizace, kdy rezervační systém na základě definované události a nastavených pravidel vyvolá komunikaci na dané URL a tím se na straně Home Assistant spustí odpovídající automatizace. Tento příklad ilustruje velmi základní podobu návrhu, kde pro každé konkrétní spuštění scénáře na straně HA je vytvořeno jedno specifické URL (pomocí "http in" uzlu) a pro další scénáře je potřeba opakovaně vytvářet další obdobné konstrukce. Samozřejmě celý návrh automatizace může být výrazně složitější, kde se budou zohledňovat dodatečné URL parametry, nějaká forma autorizace nebo následně komunikovat s plnohodnotným API rezervačního systému pro získání dalších dat potřebných k realizaci dalších kroků scénáře. Možnosti a způsoby řešení jsou v tomto ohledu neomezené.

Make

Platforma Make (dříve Integromat) je původně česká cloudová automatizační platforma, která umožňuje propojovat různé aplikace a systémy bez nutnosti programování a složitých konfigurací. Slouží k automatizaci procesů, při kterých jsou klíčová data, která se sdílí a přenášejí mezi jednotlivými nástroji a systémy. Hlavní charakteristikou platformy Make je vizuální tvorba automatizací pomocí tzv. scénářů. Uživatel definuje spouštěče (např. vytvoření nové rezervace), následné akce (uložení dat, odeslání e-mailu, aktualizace kalendáře) a podmínky, za kterých se jednotlivé kroky provádějí. Make podporuje stovky hotových integrací a zároveň umožňuje napojení vlastních systémů pomocí API a webhooků, což lze efektivně využít právě při propojení s rezervačním systémem reenio.

Z pohledu propojení s rezervačním systéme přináší Make výrazné výhody zejména v oblasti efektivity a spolehlivosti. Automatizace eliminuje ruční přepisování dat, snižuje chybovost a zajišťuje okamžitou reakci na změny v rezervacích (potvrzení, změny, storna), a to nad rámec standardních funkcionalit poskytovaných přímo rezervačním systémem. Data z rezervačního systému tak mohou být automaticky propojeny s kalendáři, jazykovými modely AI, CRM nebo interními databázemi, což zjednodušuje provoz, šetří čas a zlepšuje celkovou efektivitu podnikání.

Obzvláště zajímavé možnosti integrace pak tvoří napojení na systémy podporující ovládání různých zařízení, typicky Home Assistant, jak je popsáno výše. Platforma Make umožňuje přímé napojení na služby Home Assistanta, a to velmi jednoduše a bez nutnosti složité konfigurace či instalace rozšíření na straně HA.

Předpokladem pro napojení lokálně provozovaného Home Assistanta je věřejně přístupná zabezpečená URL na webové rozhraní HA. Zabezpečení musí být zajištěno validním certifikátem (Let's Encrypt, Cloudflare, apod.). Dále už je potřeba pouze API klíč vygenerovaný v administraci HA. Další předpoklady související s konfigurací komunikačních portů, firewallů, konkrétních URL, atd. nejsou v tomto případě potřeba.

Nastavení automatizace s HA

Jako ukázka propojení rezervačního systému s platformou Make je uveden stejný scénář, jako u integrace přímo s Home Assistantem, tj. jednoduché spuštění automatizace pro rozsvícení konkrétního světla. I v případě platformy Make je klíčové využití webhooku pro aktivaci scénáře a zaslání notifikace o vzniklé rezervaci.

  1. Předpokladem je aktivní účet a možnost pracovat ve webovém prostředí Make. V případě vývoje a testování, ale i provozu malých automatizací může být dostačující bezplatná verze systému.

  2. Prvním krokem v prostředí Make je založení nového scénáře a vytvoření modulu Webhooks (Custom webhook). V rámci jeho nastavení je potřeba vytvořit URL pro samotný webhook. Tímto krokem vznikne URL v podobě např. https://hook.eu1.make.com/abc, která bude následně použita pro volání ze strany rezervačního systému. Takto vytvořené webhook URL si můžete zkontrolovat, nastavovat a analyzovat v nabídce "Webhooks".

  3. Další nezbytný prvek je modul nazvaný Webhooks (Webhook response), který zajistí požadovanou odpověď v případě obdržení požadavku/notifikace ze strany rezervačního systému.

  4. Posledním modulem pro tuto jednoduchou automatizaci je modul Home Assistant. Ten vyžaduje vytvoření propojení na URL běžící instalace HA a nastavení bezpečnostního tokenu. Po nastavení a ověření připojení je pak v rámci tohoto typu modulu možné nastavovat činnosti/příkazy směřované na ovládání HA, např. spuštění konkrétní automatizace podle entity_id. Celkové schéma scénáře a nastavení jednotlivých modulů je uvedeno na obrázku.

  1. Následně je potřeba vytvořit vlastní zprávu typu webhook přímo v administraci rezervačního systému, kdy se použije URL webhooku na straně Make. Další nastavení ohledně vyvolání webhooku, přiřazení do skupin, propojení s termíny atd., je již standardní v rámci používání vlastních zpráv jako takových.

Tento scénář je opravdu minimální ukázkou automatizace a integrace v prostředí Make. V rámci této platformy je možné například pracovat přímo s API a získat detailní informace o konkrétní rezervaci a podle toho rozhodovat o tom, jaká automatizace na HA bude spuštěna apod. Vše je jen otázkou komplexnosti automatizace a rozsahu zpracování a předávání dat.