Smart Lock·Facile 8 minAggiornato: 30 marzo 2026

Integrare Tedee Pro e Tedee GO con Shangrilux

Collega le serrature Tedee tramite API REST e Bridge Tedee per apertura remota e codici temporanei.

Nota: Compatibile con Tedee Pro e Tedee GO. Richiede Bridge Tedee per la connettività cloud. Tedee GO supporta Bluetooth Low Energy direttamente.

Prerequisiti

Serratura Tedee Pro o GO installata e configurata nell'app Tedee
Bridge Tedee connesso alla rete Wi-Fi (per Tedee Pro)
Account Tedee con email verificata
API key Tedee (disponibile su api.tedee.com)

Configurazione

Ottieni le credenziali API Tedee

Accedi a api.tedee.com/swagger → Autentica con il tuo account → POST /api/v1.32/account/token. In alternativa, usa il portale Tedee My Account → Integrations → Generate API Key.

bash

curl -X POST https://api.tedee.com/api/v1.32/account/token \
  -H "Content-Type: application/json" \
  -d '{"email":"tua@email.it","password":"tua-password"}'
# Risposta: { "result": { "token": "eyJhbGci..." } }

Recupera l'ID del dispositivo

GET https://api.tedee.com/api/v1.32/my/lock → copia il campo "id" dalla risposta JSON per ogni serratura.

Configura in Shangrilux

Admin → Integrazioni → Tedee → inserisci il bearer token e il Device ID. Shangrilux effettuerà un test di connessione.

Configura il webhook callback

In Tedee My Account → Webhooks → Add: URL = https://app.shangrilux.com/api/webhook/tedee?slug=IL-TUO-SLUG. Seleziona eventi: LockStatusChanged, Battery.

Gestione PIN temporanei

Shangrilux invia automaticamente un PIN 6 cifre a Tedee per ogni prenotazione confermata tramite POST /api/v1.32/my/lock/{id}/pin. Il PIN scade alla data di check-out.

Payload Stato Serratura

json

{
  "deviceId": 98765,
  "deviceType": 2,
  "state": 6,
  "stateName": "Unlocked",
  "isCharging": false,
  "batteryLevel": 82,
  "timestamp": "2026-03-30T10:15:00Z"
}

Risoluzione Problemi

Token scaduto: i token Tedee hanno validità 24h, Shangrilux li rinnova automaticamente con il refresh token
Bridge offline: verifica la connessione Wi-Fi del Bridge Tedee (LED arancione = problema di rete)
PIN non accettato: assicurati che il keypad esterno sia abilitato nelle impostazioni Tedee

#tedee#api#smart-lock#webhook