Glofox è una piattaforma di prenotazione cloud di ABC Fitness, quindi non c’è nulla da cablare: l’unità di controllo Core di TapHome legge le prenotazioni delle sale dalla REST API di Glofox tramite HTTPS. La configurazione lato studio ha tre parti: l’accesso all’API Glofox per lo studio, ogni sala in affitto configurata come facility prenotabile, e il Branch ID e il fuso orario dello studio. Il modello si importa poi una volta per ogni sala.
Gli screenshot provengono da una location di test Glofox Sandbox (ABC Fitness Developer Portal e dashboard Glofox, ottobre 2026) e dall’app TapHome collegata a un’unità di controllo di test con prenotazioni simulate.
Configurazione
1. Richiedi l’accesso all’API Glofox
Il superadmin dello studio si registra nell’ABC Fitness Developer Portal (Account Type Customer) e fa clic su Request Integrator:
- Environment: Live (Sandbox è solo una location di test con dati demo).
- Namespace: il namespace Glofox dello studio.
- Intended Use Case: ad esempio “TapHome building automation reads facility bookings to prepare rooms (heating, lights, audio) before each booking. Read-only.”
ABC Fitness esamina le richieste Live e risponde via e-mail. La chiave API e il token API si richiedono poi con Request credentials e arrivano all’indirizzo e-mail del portale. Domande sull’accesso: [email protected].

La chiave API e il token API danno accesso ai dati Glofox dello studio. Glofox chiede di usarli solo in integrazioni backend, mai in applicazioni lato client; in TapHome vanno inseriti solo nei parametri di importazione del modello.
2. Rendi ogni sala una facility prenotabile
Per prima cosa attiva Settings → Booking → Facility Rental; solo dopo compaiono gli interruttori delle facility descritti sotto. Poi Manage → Facilities elenca le sale. Ogni sala che i trainer affittano deve essere una facility con Bookable attivo, un calendario di slot (scheda Schedule) e, in Price / Eligibility, Drop In Clients o Clients consentiti (un prezzo pari a 0 va bene). Senza queste impostazioni la prenotazione del trainer termina con “Membership not allowed”.


3. Trova il Branch ID e il fuso orario dello studio
Con la chiave API e il token, una sola richiesta restituisce la location dello studio, il suo ID e il suo fuso orario:
| |
data[]._id è il BranchId, data[].address.timezone_id il fuso orario dello studio (ad esempio Europe/Rome). Senza filtro la richiesta restituisce tutte le location nei namespace che l’integrazione può leggere, quindi con più studi scegli la voce dello studio di cui i moduli controllano le sale.
L’orologio degli script dell’unità di controllo Core deve essere nel fuso orario dello studio: su Core 2025.2 è il fuso orario di sistema dell’unità di controllo, sulle versioni più recenti di Core il fuso orario del luogo (location) TapHome.
4. Importa il modello una volta per ogni sala
Nell’app TapHome apri l’interfaccia Packet Parser (se l’unità di controllo non ne ha una, aggiungila prima), poi Aggiungi dal modello → Aggiungi da file e scegli il modello scaricato. Compila ApiKey, ApiToken, BranchId, LeadMinutes e il FacilityId della sala.
Inserisci il nome della sala in Prefisso del nome del dispositivo e terminalo con un separatore, ad esempio Sala yoga - . Il prefisso viene unito ai nomi dei dispositivi esattamente come lo digiti, quindi senza separatore un dispositivo si chiama “Sala yogaBooked now”. Zona colloca i tre dispositivi della sala nella zona della sala.

Se non conosci ancora il Facility ID, inserisci un testo qualsiasi. Dopo la prima interrogazione il modulo segnala un errore che elenca tutte le facility della sede con il loro ID (Dispositivi → Errori e avvisi → il modulo):

Copia l’ID corretto nella variabile FacilityId del modulo (oppure importa di nuovo il modello) e ripeti per ogni sala.
5. Verifica con il calendario Glofox
Le prenotazioni di una sala compaiono nel Calendar di Glofox (filtro Facilities). Con una prenotazione dalle 10:00 alle 11:00 e LeadMinutes 60, i valori della sala sono:
| Ora | Booked now | Minutes to next booking | Prepare room |
|---|---|---|---|
| 8:30 | Free | 90 | Idle |
| 9:00 | Free | 60 | Prepare |
| 10:30 | Booked | prossima prenotazione o 1440 | Prepare |
| 11:00 | Free | prossima prenotazione o 1440 | Idle |
I minuti sono minuti interi contati dall’interrogazione, quindi un valore può differire di uno dalla tabella.

Nell’app TapHome ogni sala mostra i tre valori sotto il proprio modulo:

Smart rule
Prepare room (preparazione della sala) è la condizione delle smart rule della sala: setpoint di riscaldamento o raffrescamento, luci e scena audio finché è Prepare, tutto spento quando torna a Idle. Booked now (sala prenotata ora) è adatto ai display di occupazione; Minutes to next booking (minuti alla prossima prenotazione) permette a una smart rule di avviare un impianto di riscaldamento lento con più anticipo di LeadMinutes.
