A Glofox az ABC Fitness felhőalapú foglalási platformja, így nincs mit bekötni: a TapHome Core a teremfoglalásokat a Glofox REST API-ból olvassa HTTPS-en keresztül. A stúdió oldalán a beállítás három részből áll — Glofox API-hozzáférés a stúdió számára, minden bérelt terem foglalható létesítményként (facility) beállítva, valamint a stúdió Branch ID-ja és időzónája. A sablont ezután termenként egyszer kell importálni.
A képernyőképek egy Glofox Sandbox tesztlokációról (ABC Fitness Developer Portal és Glofox dashboard, 2026. október), valamint a szimulált foglalásokkal működő teszt vezérlőegységhez csatlakoztatott TapHome alkalmazásból származnak.
Konfiguráció
1. Glofox API-hozzáférés igénylése
A stúdió superadminja regisztrál az ABC Fitness Developer Portal oldalon (Account Type Customer), és a Request Integrator gombra kattint:
- Environment: Live (a Sandbox csak egy demóadatokkal működő tesztlokáció).
- Namespace: a stúdió Glofox namespace-e.
- Intended Use Case: például „TapHome building automation reads facility bookings to prepare rooms (heating, lights, audio) before each booking. Read-only.”
Az ABC Fitness átnézi a Live kérelmeket, és e-mailben válaszol. Az API-kulcsot (API key) és az API tokent ezután a Request credentials gombbal igényled, és a portálon megadott e-mail-címre érkeznek. A hozzáféréssel kapcsolatos kérdések: [email protected].

Az API-kulcs és az API token hozzáférést ad a stúdió Glofox-adataihoz. A Glofox azt kéri, hogy csak backend integrációkban használd őket, kliensoldali alkalmazásokban soha; a TapHome-ban kizárólag a sablon importparamétereibe valók.
2. Minden terem legyen foglalható létesítmény
Először kapcsold be a Settings → Booking → Facility Rental beállítást; a létesítmények alábbi kapcsolói csak ezután jelennek meg. Ezután a Manage → Facilities felsorolja a termeket. Minden terem, amelyet az edzők bérelnek, olyan létesítmény (facility) legyen, amelynél be van kapcsolva a Bookable, van idősáv-ütemezése (Schedule fül), és a Price / Eligibility alatt engedélyezve van a Drop In Clients vagy a Clients (a 0-s ár is megfelel). Ezek nélkül az edző foglalása a „Membership not allowed” üzenettel végződik.


3. A Branch ID és a stúdió időzónájának megkeresése
Az API-kulccsal és a tokennel egyetlen kérés visszaadja a stúdió lokációját, annak azonosítóját és időzónáját:
| |
A data[]._id a BranchId, a data[].address.timezone_id a stúdió időzónája (például Europe/Bratislava). Szűrő nélkül a kérés minden lokációt visszaad azokban a namespace-ekben, amelyeket az integráció olvashat, ezért több stúdió esetén annak a stúdiónak a bejegyzését válaszd, amelynek termeit a modulok figyelik.
A TapHome Core szkriptórájának a stúdió időzónájában kell járnia: Core 2025.2-n ez a vezérlőegység rendszer-időzónája, újabb Core-on a TapHome helyszín időzónája.
4. A sablon importálása termenként egyszer
A TapHome alkalmazásban nyisd meg a Packet parser interfészt (ha a vezérlőegységen még nincs, előbb add hozzá), majd válaszd a Hozzáadás a sablonból → Hozzáadás fájlból lehetőséget, és jelöld ki a letöltött sablont. Töltsd ki az ApiKey, ApiToken, BranchId, LeadMinutes paramétereket és a terem FacilityId azonosítóját.
A terem nevét írd az Eszköznév előre definiálva mezőbe, és zárd le egy elválasztóval, például Jógaterem - . Az előtag pontosan úgy kapcsolódik az eszköznevekhez, ahogy beírtad, így elválasztó nélkül az eszköz neve „JógateremBooked now” lesz. A Zóna a terem három eszközét a terem zónájába helyezi.

Ha a Facility ID-t még nem ismered, írj be bármilyen szöveget. Az első lekérdezés után a modul hibát jelez, amely felsorolja a telephely (branch) összes létesítményét az azonosítójukkal együtt (Eszközök → Hibák és figyelmeztetések → a modul):

Másold be a megfelelő azonosítót a modul FacilityId változójába (vagy importáld újra), és ismételd meg minden teremnél.
5. Ellenőrzés a Glofox naptárában
Egy terem foglalásai a Glofox Calendar nézetében jelennek meg (Facilities szűrő). 10:00 és 11:00 közötti foglalás és 60-as LeadMinutes esetén a terem értékei:
| Időpont | Booked now | Minutes to next booking | Prepare room |
|---|---|---|---|
| 8:30 | Free | 90 | Idle |
| 9:00 | Free | 60 | Prepare |
| 10:30 | Booked | következő foglalás vagy 1440 | Prepare |
| 11:00 | Free | következő foglalás vagy 1440 | Idle |
A percek a lekérdezéstől számított egész percek, így egy érték eggyel eltérhet a táblázattól.

A TapHome alkalmazásban minden terem a saját modulja alatt mutatja a három értéket:

Smart rule-ok
A Prepare room (terem előkészítése) a terem smart rule-jainak feltétele: fűtési vagy hűtési alapjel, világítási és audiójelenet, amíg Prepare állapotban van, és minden kikapcsol, amikor visszatér Idle állapotba. A Booked now (most foglalt) foglaltságkijelzőkhöz illik; a Minutes to next booking (percek a következő foglalásig) segítségével egy smart rule a lassú fűtési rendszert a LeadMinutes értéknél korábban is elindíthatja.
