Skip to main content
Se lo studente ha una smart lock su uno o più appartamenti, configura l’apertura remota via link in modo che Conduit possa inviare all’ospite un link di accesso direttamente in chat. Se lo studente non ha nessuna smart lock, salta questo step e passa direttamente allo Step 5 · Stripe. Verifica il campo smart_lock nel DB Apartments (Step 1) per sapere quali appartamenti richiedono questa configurazione.
Testa sempre un’apertura reale durante l’onboarding, non segnare questo step come completato senza aver visto la porta aprirsi fisicamente (o aver ricevuto conferma dallo studente che la porta si è aperta) e senza aver letto i log dell’evento.

​
Quale device? Cosa consigliamo

Best practice Mattone, cosa raccomandiamo.
  • Consigliato di default (baseline collaudata da Cosmica): Shelly. È un relay che apre citofono/porta. È lo standard perché è semplice e affidabile: un device = una riga nella mappa, si connette direttamente al WiFi (nessun hub intermedio) e si aggiunge senza deploy. Per una nuova installazione, parti da qui.
  • Alternativa già gestita: SwitchBot Smart Lock. La usiamo quando lo studente ha già quel brand installato. Richiede alcuni requisiti in più (Hub Mini su WiFi 2.4GHz stabile, LED blu fisso, account owner, firma HMAC lato integrazione).
  • Altre marche (Tuya / Aqara / Yale / …): caso per caso. Non sono incluse di default: le valutiamo su richiesta e l’integrazione custom può essere un upsell a pagamento (servizio in più). Non prometterle allo studente senza aver verificato la fattibilità con il team.
I device supportati “pronti” sono due, con requisiti e procedure di configurazione differenti:

Shelly (relay), consigliato

La scelta di default. Ideale per citofoni e porte con relè. È la configurazione più semplice: richiede solo il Cloud token dell’account Shelly, nessun hub, si aggiunge senza deploy. Standard per le nuove installazioni.

SwitchBot Smart Lock, alternativa

Serratura elettronica standalone. Richiede Hub Mini su WiFi 2.4GHz e l’account owner SwitchBot. Scegli questa opzione solo se lo studente ha già installato un SwitchBot.
Marche diverse da Shelly/SwitchBot (Tuya, Aqara, Yale, ecc.) non sono supportate di default: sono valutate caso per caso e l’integrazione può essere un upsell a pagamento. In tutti i casi, il campo smart_lock nel DB Apartments deve riflettere il device reale (Shelly, SwitchBot o Nessuna).
SwitchBot: usa SEMPRE l’account owner, non member. L’account member non ha il permesso di sblocco remoto e la configurazione sembrerà funzionare ma fallirà al momento del test reale.

​
Step (per entrambi i device)

1

Raccogli le credenziali del device

A seconda del device presente nell’appartamento, chiedi allo studente tramite canale sicuro:Shelly:
  • Cloud token dell’account Shelly associato al device
SwitchBot:
  • Owner token (dall’app SwitchBot → Profilo → Sviluppatore)
  • Device ID della serratura (dall’app SwitchBot → dettaglio device)
Verifica che le credenziali provengano dall’account owner, non da un account secondario o member.
2

Registra il device nel tool

Nella piattaforma Mattone, apri il pannello del tool smart lock per lo studente e inserisci le credenziali raccolte. Associa il device all’appartamento corretto usando il listing_id del DB Apartments.Salva la configurazione, le credenziali vengono cifrate nel Vault.
3

Esegui un test di apertura reale e leggi i log

Dalla piattaforma, genera un link di apertura di test e usalo (o chiedi allo studente di usarlo sul posto). Verifica che la porta si apra fisicamente.Dopo il test, apri immediatamente il pannello log e verifica che l’evento di apertura sia registrato correttamente con:
  • Timestamp corretto
  • listing_id corretto (non di un altro appartamento)
  • Esito success
Se il log mostra errori o l’appartamento nel log non è quello atteso, non procedere, consulta la guida di troubleshooting del device (Shelly o SwitchBot).
Step completato? Procedi con → Step 5 · Stripe
▷ Prompt Claude Code: Smart check-in · incolla in Claude Code:

Shelly, collegamento

1 entry nel registro + push

SwitchBot, collegamento

Token owner + Device ID