> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattone.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Shelly: relay per apertura citofono e porta da remoto

> Panoramica dell'integrazione Shelly in Mattone: come funziona il relay per il self check-in remoto e quando usarlo rispetto ad altri dispositivi.

Shelly è un dispositivo relay che apre citofoni e porte da remoto, è la soluzione smart lock più semplice disponibile in Mattone per il self check-in automatizzato. Non richiede hub aggiuntivi e si connette direttamente al WiFi dell'immobile, comunicando con la piattaforma tramite il cloud Shelly.

<Info>
  **Consigliato di default (baseline collaudata da Cosmica).** Shelly è lo **standard** che raccomandiamo per le nuove installazioni: è semplice e affidabile, **un device = una riga** nella mappa, si aggiunge **senza deploy** e non richiede hub intermedi. Le alternative, [SwitchBot](/integrazioni/switchbot/panoramica) (quando lo studente ha già quel brand) o altre marche (Tuya/Aqara/Yale, **caso per caso** e possibile **upsell a pagamento**), si valutano solo quando Shelly non è praticabile.
</Info>

## Quando si usa Shelly

Shelly è la scelta ideale per gli studenti che hanno già un citofono elettrico o una serratura elettrica sulla porta d'ingresso. Rispetto a SwitchBot, la configurazione è più rapida perché non è necessario alcun hub intermedio: il device Shelly si installa direttamente sul circuito elettrico del citofono o della porta e si connette al WiFi dell'appartamento.

<CardGroup cols={2}>
  <Card title="Collegamento" icon="link" href="/integrazioni/shelly/collegamento">
    Guida passo per passo per registrare un device Shelly nella piattaforma Mattone.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/integrazioni/shelly/troubleshooting">
    Risolvi i problemi più comuni: device offline, token non valido, apertura fallita.
  </Card>
</CardGroup>

## Prerequisiti

Prima di procedere con il collegamento, verifica che siano soddisfatti tutti i seguenti requisiti:

* **Device Shelly installato** fisicamente sulla porta o sul citofono dell'immobile
* **Account Shelly Cloud** creato dallo studente (su [cloud.shelly.it](https://cloud.shelly.it) o app Shelly Smart Control)
* **Device connesso al WiFi** dell'immobile e visibile come online nell'app Shelly Cloud

<Note>
  Shelly usa il cloud Shelly come intermediario, il device deve essere online e connesso al cloud per funzionare da remoto. Se il WiFi dell'immobile cade o il device perde corrente, l'apertura remota non è possibile finché la connessione non viene ripristinata.
</Note>

## Fonti ufficiali

* **Shelly, documentazione tecnica**: [https://shelly-api-docs.shelly.cloud/](https://shelly-api-docs.shelly.cloud/) · **Cloud Control API**: [https://shelly-api-docs.shelly.cloud/cloud-control-api/](https://shelly-api-docs.shelly.cloud/cloud-control-api/)