Automatizzare Tapparelle e Tende con Somfy TaHoma
Integra i motori Somfy con Shangrilux tramite TaHoma API per automazione di tapparelle, tende e schermature.
Nota: Compatibile con TaHoma Box, Connexoon, e TaHoma Switch. La TaHoma Local API (senza cloud) richiede firmware recente e permette integrazione diretta senza dipendenze cloud.
Prerequisiti
- Box TaHoma o Connexoon configurato con i motori Somfy
- Account Somfy registrato su somfy.com
- API Developer access (richiedi su developer.somfy.com)
- Token OAuth2 Somfy Cloud API
Configurazione Somfy Cloud API
Registra un'applicazione OAuth2
Vai su developer.somfy.com → My Apps → Create App. Imposta Redirect URI: https://app.shangrilux.com/api/oauth/somfy/callback. Ottieni Consumer Key e Consumer Secret.
Autorizza l'accesso all'account TaHoma
Shangrilux genererà il link di autorizzazione OAuth2. L'utente clicca, si autentifica su Somfy, autorizza Shangrilux e viene reindirizzato. Shangrilux salva il token.
Scopri i dispositivi
GET https://api.somfy.com/api/v1/site/{siteId}/setup → ritorna lista di tutti i dispositivi Somfy registrati nel TaHoma.
Configura la TaHoma Local API (opzionale)
Per evitare dipendenza dal cloud Somfy, usa la Local API:
# Login TaHoma Local API
curl -X POST http://192.168.1.200:8080/enduser-mobile-web/1/enduserAPI/login \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "userId=tua@email.it&userPassword=tua-password"
# Risposta: { "success": true, "roles": {...} }
# Cookie JSESSIONID viene impostato per le richieste successiveEsegui comandi sui dispositivi
Invia comandi ai motori tapparelle:
// POST /enduser-mobile-web/1/enduserAPI/exec/apply
{
"label": "Check-in Camera 201 - Alza tapparelle",
"actions": [
{
"deviceURL": "io://1234-5678-9012/12345678",
"commands": [
{ "name": "setPosition", "parameters": [100] }
]
}
]
}Automazioni Raccomandate per Hospitality
- Check-in (ore 14:00+): apri tapparelle al 100% per dare senso di ariosità
- Check-out: abbassa tapparelle al 50% per privacy durante le pulizie
- Notte: chiudi automaticamente alle 22:00 se non già chiuse dall'ospite
- Meteo (integrazione): chiudi automaticamente in caso di vento forte (>60 km/h) tramite sensore Somfy Sunis
Consiglio: Usa i "Scenarios" TaHoma per raggruppare più comandi (tapparelle + luci + clima) in un'unica azione atomica. Riduci il numero di chiamate API e migliora la sincronizzazione.