# Avvisi che superano attraverso la modalità silenziosa e Non disturbare.

> Dai a ogni notifica push una priorità: silenziosa, bassa, predefinita, alta o critica. Gli avvisi critici superano Non disturbare su Android e bucano le modalità Full immersion di iPhone. Un solo campo level nell'API.

<!-- source: https://pocketalert.app/it/use-cases/critical-alerts -->

Ultimo aggiornamento: 2026-10-25

Pocket Alert assegna a ogni notifica push un livello di priorità, da silent a critical. Su Android, un avviso critico aggira Non disturbare e la modalità silenziosa; su iPhone supera Full immersion come notifica con priorità temporale. Lo imposti con un unico campo nella chiamata API.

## Tre passaggi per avvisi che ti svegliano

1. **Scegli un livello** — silent per i riepiloghi, high per gli avvisi, critical per gli incidenti che non possono aspettare il mattino.
2. **Invia il messaggio** — Aggiungi "level":"critical" alla chiamata API, al payload del webhook, oppure imposta un predefinito sull'applicazione.
3. **Passa attraverso** — Android supera Non disturbare e mostra la notifica a schermo intero. iPhone supera Full immersion. Silent resta silenziosa.

## Livelli di priorità che seguono l'incidente

Un avviso di monitoraggio alle 3 di notte e un report di backup giornaliero non dovrebbero suonare allo stesso modo. Pocket Alert assegna a ogni messaggio un livello di priorità, da silent a critical.

- **Cinque livelli, un solo campo** — silent, low, default, high, critical: un unico campo level su qualsiasi messaggio, nell'API, in un payload webhook o tramite MCP.
- **Supera Non disturbare su Android** — Su Android, gli avvisi critici vengono pubblicati su un canale dedicato che aggira Non disturbare e può mostrarsi a schermo intero.
- **Passa Full immersion su iPhone** — I messaggi high e critical arrivano su iPhone come notifiche con priorità temporale, quindi superano le modalità Full immersion.
- **Silenziosa quando deve esserlo** — Il livello -2 viene consegnato senza suono né vibrazione. Conferme di successo e riepiloghi restano in cronologia senza svegliare nessuno.
- **Predefiniti per app e webhook** — Imposta default_level una volta per applicazione o webhook. Ogni messaggio lo eredita; qualsiasi messaggio può sostituirlo.
- **Feed che dà priorità** — L'app mobile filtra e ordina il feed per priorità, così gli incidenti critici non finiscono sommersi dal rumore di routine.

## Invia il tuo primo avviso critico

### 1. Scegli il livello

Ogni messaggio accetta un campo `level` (o `priority`):

```
level: silent (-2) · low (-1) · default (0) · high (1) · critical (2)
```

Funzionano anche gli alias: `min`, `normal`, `urgent`, `max`. I valori non validi ricevono un `400` pulito dall'API, quindi un errore di battitura non fallisce mai in silenzio.

### 2. Invialo

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Primary DB down","message":"Postgres is not responding on db-1","level":"critical"}'
```

Lo stesso campo funziona in un payload webhook: aggiungi `"level": "critical"` al JSON che qualsiasi servizio invia al tuo URL webhook di Pocket Alert, e nello strumento MCP `create_message`.

### 3. Lascia silenziose le cose tranquille

```
pg_dump mydb | gzip > backup.sql.gz && \
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Backup finished' -F 'message=Nightly dump completed' -F 'level=silent'
```

I messaggi silent finiscono nella cronologia senza suono. Il telefono fa rumore solo quando il livello lo prevede.

### Come si risolvono i livelli

Livello esplicito del messaggio → `default_level` del webhook → `default_level` dell'applicazione → default. Imposta il predefinito una volta sul webhook che riceve gli avvisi di monitoraggio, e tutto ciò che inoltra arriverà come `high` senza toccare il mittente.

### Configurazione unica sul telefono

Su Android, consenti l'accesso a Non disturbare quando l'app lo chiede (Impostazioni → Solo critici), così gli avvisi critici possono superarlo. Su iPhone, consenti le notifiche: Pocket Alert consegna i messaggi high e critical come notifiche con priorità temporale, che superano le modalità Full immersion. Il suono critico completo di iOS — quello che ignora l'interruttore della suoneria — è in arrivo man mano che Apple concede l'entitlement.

## FAQ

### Una notifica push può aggirare la modalità silenziosa e Non disturbare?

Su Android, sì. Invia un messaggio con level: critical e viene pubblicato su un canale di notifica dedicato che aggira Non disturbare e mostra la notifica a schermo intero: concedi all'app l'accesso a Non disturbare una sola volta in Impostazioni. Su iPhone, i messaggi critici arrivano come notifiche con priorità temporale, che superano le modalità Full immersion; il suono critico completo che ignora l'interruttore della suoneria è in arrivo, man mano che Apple concede l'entitlement.

### Quali livelli di priorità supporta Pocket Alert?

Cinque: silent (-2), low (-1), default (0), high (1) e critical (2). L'API accetta sia il nome sia il numero, e funzionano anche gli alias comuni: min, normal, urgent e max. Invialo come level o priority; sono accettati entrambi.

### Posso impostare un livello predefinito per applicazione o per webhook?

Imposta default_level su un'applicazione o un webhook e ogni messaggio inoltrato attraverso di essi eredita quel livello. Un livello esplicito nel messaggio ha sempre la precedenza. Se non è impostato nulla, il messaggio viene inviato come default.

### Gli avvisi critici funzionano con il piano gratuito?

La consegna critica è una funzione a pagamento. Con il piano gratuito, un messaggio critico viene consegnato con priorità alta: arriva comunque istantaneamente e resta in cima al tuo feed, semplicemente non ignora Non disturbare.

### Un messaggio silenzioso va perso?

No. Un messaggio silenzioso (level -2) salta completamente suono e vibrazione e finisce in silenzio nel centro notifiche e nella cronologia dei messaggi. Usalo per conferme di successo, riepiloghi e tutto ciò che vuoi registrare senza una vibrazione.
