> ## 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.

# Avvisi quando una porta Shelly va offline

> Per tutti gli studenti con Shelly: quando un dispositivo smette di rispondere, l'avviso arriva sul loro Slack. Come funziona e come si collega.

Se un dispositivo Shelly perde corrente o WiFi, l'assistente non può più aprire quella porta, e di solito lo scopre l'ospite davanti al portone. Per questo, **per tutti gli studenti con Shelly**, l'avviso arriva sul loro Slack. È la procedura di base, non un'opzione.

## Come funziona

* Ogni **10 minuti** la piattaforma controlla tutti i dispositivi di ogni studente, passando dallo stesso ponte che usa l'assistente.
* L'avviso parte alla **seconda lettura offline di fila** (circa 20 minuti): i dispositivi che cadono per un minuto non fanno rumore.
* Quando il dispositivo torna, arriva un secondo messaggio **«di nuovo online»** con la durata del disservizio.
* Un dispositivo **non verificato** (chiave Shelly scaduta, cloud Shelly che non risponde) **non** è offline: allo studente non arriva niente, lo gestisce il team (vedi [Troubleshooting](/integrazioni/shelly/troubleshooting)).
* Se Slack non accetta il messaggio, al giro dopo si riprova: un avviso conta come dato solo quando Slack l'ha ricevuto.
* **Ogni mattina, dopo le 9**, arriva anche il **riepilogo di tutti i dispositivi** con lo stato (online, offline, non verificati): una volta al giorno, sullo stesso canale Slack. È la risposta a chi chiede «voglio vedere su Slack l'elenco completo delle mie porte».

Esempio di messaggio:

```text theme={null}
🔴 Shelly offline — Casa Uno
Non risponde da circa 20 minuti: finché non torna online l'assistente non può aprire questa porta.
Controlla che il dispositivo abbia corrente e WiFi.
```

Esempio di riepilogo del mattino:

```text theme={null}
📋 Shelly — stato di tutti i dispositivi (11/09/2026)
🟢 Online (5): Casa Uno, Casa Due, Casa Tre, Casa Quattro, Casa Cinque
🔴 Offline (1): Casa Sei
```

## Come si collega

<Steps>
  <Step title="Lo studente sceglie il canale">
    Il canale Slack dove già arrivano le escalation dell'assistente: gli avvisi delle porte vanno lì, dove qualcuno guarda.
  </Step>

  <Step title="Lo studente crea il link (Incoming Webhook)">
    Su [api.slack.com/apps](https://api.slack.com/apps) → **Create New App** → **From scratch** → nome (es. «Avvisi porte») e workspace → **Incoming Webhooks** → attiva → **Add New Webhook to Workspace** → sceglie il canale → copia il link, che inizia con `https://hooks.slack.com/services/`.
  </Step>

  <Step title="Lo manda al team dal canale sicuro">
    Il link è una chiave: chi ce l'ha può scrivere in quel canale. Mai in chat ordinaria o in documenti condivisi.
  </Step>

  <Step title="Il team lo inserisce collegando Shelly">
    È il campo **«Slack per gli avvisi offline»** della card Shelly in piattaforma, obbligatorio. Vedi [Collegamento](/integrazioni/shelly/collegamento).
  </Step>

  <Step title="Verifica">
    Al salvataggio arriva nel canale il messaggio di prova **«✅ Avvisi Shelly collegati»**. Se non arriva, il collegamento risulta con l'errore «Slack non ha accettato il messaggio di prova»: il link è sbagliato o l'app è stata rimossa dal canale.
  </Step>
</Steps>

<Note>
  **WhatsApp**: opzionale, in preparazione. Oggi gli avvisi arrivano solo su Slack. Se uno studente li vuole anche su WhatsApp, segnalalo al team.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.