Glofox to chmurowa platforma rezerwacji firmy ABC Fitness, więc nie ma tu nic do podłączania: TapHome Core odczytuje rezerwacje sal z Glofox REST API przez HTTPS. Konfiguracja po stronie studia składa się z trzech części — dostępu do Glofox API dla studia, każdej wynajmowanej sali ustawionej jako facility do rezerwacji oraz Branch ID i strefy czasowej studia. Następnie importujesz szablon raz dla każdej sali.
Zrzuty ekranu pochodzą z testowej lokalizacji Glofox Sandbox (ABC Fitness Developer Portal i dashboard Glofox, październik 2026) oraz z aplikacji TapHome połączonej z testową jednostką sterującą z symulowanymi rezerwacjami.
Konfiguracja
1. Poproś o dostęp do Glofox API
Superadmin studia rejestruje się w ABC Fitness Developer Portal (Account Type Customer) i klika Request Integrator:
- Environment: Live (Sandbox to tylko testowa lokalizacja z danymi demonstracyjnymi).
- Namespace: namespace Glofox studia.
- Intended Use Case: na przykład “TapHome building automation reads facility bookings to prepare rooms (heating, lights, audio) before each booking. Read-only.”
ABC Fitness weryfikuje wnioski o dostęp Live i odpowiada e-mailem. Klucz API i token API zamawia się następnie przyciskiem Request credentials; przychodzą na adres e-mail konta w portalu. Pytania dotyczące dostępu: [email protected].

Klucz API i token API dają dostęp do danych studia w Glofox. Glofox prosi, aby używać ich tylko w integracjach po stronie serwera, nigdy w aplikacjach klienckich; w TapHome należą wyłącznie do parametrów importu szablonu.
2. Ustaw każdą salę jako facility do rezerwacji
Najpierw włącz Settings → Booking → Facility Rental; dopiero potem pojawią się opisane niżej przełączniki facilities. Następnie Manage → Facilities wyświetla listę sal. Każda sala wynajmowana przez trenerów musi być facility z włączonym Bookable, harmonogramem slotów (karta Schedule) i dozwolonymi Drop In Clients lub Clients w sekcji Price / Eligibility (cena 0 jest w porządku). Bez tego rezerwacja trenera kończy się komunikatem „Membership not allowed”.


3. Znajdź Branch ID i strefę czasową studia
Z kluczem API i tokenem API jedno zapytanie zwraca lokalizację studia, jej ID i strefę czasową:
| |
data[]._id to BranchId, data[].address.timezone_id to strefa czasowa studia (na przykład Europe/Bratislava). Bez filtra zapytanie zwraca wszystkie lokalizacje w namespace’ach, które integracja może odczytywać, więc przy kilku studiach wybierz wpis studia, którego sale obserwują moduły.
Zegar skryptów TapHome Core musi działać w strefie czasowej studia: w Core 2025.2 jest to systemowa strefa czasowa jednostki sterującej, w nowszych wersjach Core strefa czasowa lokalizacji TapHome.
4. Zaimportuj szablon raz dla każdej sali
W aplikacji TapHome otwórz interfejs Packet Parser (najpierw go dodaj, jeśli jednostka sterująca go nie ma), potem Dodaj z szablonu → Dodaj z pliku i wybierz pobrany szablon. Wypełnij ApiKey, ApiToken, BranchId, LeadMinutes i FacilityId sali.
W polu Prefiks nazwy urządzenia wpisz nazwę sali i zakończ ją separatorem, na przykład Sala jogi - . Prefiks jest łączony z nazwami urządzeń dokładnie tak, jak go wpiszesz, więc bez separatora urządzenie nazywa się „Sala jogiBooked now”. Strefa przypisuje trzy urządzenia sali do strefy tej sali.

Jeśli nie znasz jeszcze Facility ID, wpisz dowolny tekst. Po pierwszym odpytaniu moduł zgłasza błąd z listą wszystkich facilities lokalizacji wraz z ich ID (Urządzenia → Błędy i ostrzeżenia → moduł):

Skopiuj właściwe ID do zmiennej FacilityId modułu (albo zaimportuj szablon ponownie) i powtórz to dla każdej sali.
5. Porównaj z kalendarzem Glofox
Rezerwacje sali pojawiają się w Calendar Glofox (filtr Facilities). Przy rezerwacji od 10:00 do 11:00 i LeadMinutes 60 sala ma takie wartości:
| Godzina | Booked now | Minutes to next booking | Prepare room |
|---|---|---|---|
| 8:30 | Free | 90 | Idle |
| 9:00 | Free | 60 | Prepare |
| 10:30 | Booked | następna rezerwacja lub 1440 | Prepare |
| 11:00 | Free | następna rezerwacja lub 1440 | Idle |
Minuty to pełne minuty liczone od odpytania, więc wartość może różnić się od tabeli o jeden.

W aplikacji TapHome każda sala pokazuje trzy wartości pod swoim modułem:

Smart rules
Prepare room jest warunkiem smart rules sali: wartość zadana ogrzewania lub chłodzenia oraz scena oświetlenia i audio, dopóki ma wartość Prepare, i wyłączenie wszystkiego, gdy wróci do Idle. Booked now nadaje się do wyświetlaczy zajętości; Minutes to next booking pozwala smart rule uruchomić wolno reagujące ogrzewanie wcześniej niż LeadMinutes.
