Integrare Nuki Smart Lock con Shangrilux
Configura le serrature Nuki tramite Nuki Web API e webhook per l'accesso automatico degli ospiti.
Nota: Compatibile con Nuki Smart Lock 2.0, 3.0, 3.0 Pro e Ultra. Richiede Nuki Bridge o connettività Wi-Fi integrata (modelli Pro/Ultra).
Prerequisiti
- Nuki Smart Lock installato sulla porta (versione 2.0 o superiore)
- Nuki Bridge (se il modello non ha Wi-Fi integrato)
- Account Nuki Web gratuito su web.nuki.io
- Accesso al pannello admin Shangrilux con piano Professional o Elite
Configurazione Nuki Web API
Crea un token API su Nuki Web
Accedi a web.nuki.io → Account → API → Genera token. Seleziona i permessi: "smartlock.readwrite" e "notification.readwrite". Copia il token generato (verrà mostrato una sola volta).
Recupera l'ID della serratura
Nella dashboard Nuki Web, entra nella serratura → Impostazioni → Info avanzate. Copia il "Smartlock ID" numerico (es. 4823749512).
Configura l'integrazione in Shangrilux
Vai su Shangrilux Admin → Impostazioni → Integrazioni Smart Home → Aggiungi dispositivo → Seleziona "Nuki". Inserisci il token API e lo Smartlock ID. Shangrilux verificherà la connessione.
Configura il Webhook Nuki
In Nuki Web → Impostazioni Account → Webhook, aggiungi l'URL: https://app.shangrilux.com/api/webhook/nuki?slug=IL-TUO-SLUG Seleziona gli eventi: "lock", "unlock", "unlatch", "lock_failure". Salva.
Mappa la serratura alla proprietà
In Shangrilux Admin → Proprietà → Dispositivi, seleziona la serratura Nuki e associala alla porta principale (o camera specifica). Imposta il comportamento: apertura automatica al check-in, blocco automatico al check-out.
Configura il codice di accesso temporaneo
Shangrilux genera automaticamente un Access Code temporaneo per ogni prenotazione confermata e lo invia a Nuki tramite API. Il codice scade automaticamente al check-out.
Payload Webhook Ricevuto da Nuki
{
"nukiId": 4823749512,
"deviceType": 0,
"trigger": 2,
"state": {
"mode": 2,
"state": 1,
"stateName": "locked",
"batteryCritical": false,
"timestamp": "2026-03-30T14:30:00+01:00"
},
"authId": 1234567
}Verifica del Funzionamento
- In Shangrilux Admin → Integrazioni, il badge Nuki deve mostrare "Connessa" in verde
- Crea una prenotazione di test con check-in imminente: la serratura deve ricevere un codice PIN temporaneo
- Verifica in Nuki Web → Registro accessi che l'apertura sia registrata con il nome dell'ospite
- Simula il check-out: verifica che il codice venga revocato automaticamente
Risoluzione Problemi
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Badge "Non connessa" | Token API scaduto o revocato | Rigenera il token su Nuki Web e aggiorna in Shangrilux |
| Webhook non ricevuto | URL webhook errato o firewall | Verifica l'URL e testa con Nuki Web → Test Webhook |
| Codice PIN non inviato | Nuki Bridge offline | Riavvia il Bridge e controlla la connessione Wi-Fi |
| Serratura non risponde | Batterie scariche | Sostituisci le batterie (Nuki invia allarme battery critical) |
Consiglio: Usa l'opzione "Auto Unlock" di Nuki per aprire automaticamente la porta al check-in rilevando il telefono dell'ospite tramite Bluetooth. Richiede che l'ospite installi l'app Nuki.