# Livelli di priorità e avvisi critici

Ogni messaggio di Pocket Alert ha un livello di priorità che ne determina l'intensità: silenzioso nella tendina, come banner normale oppure come avviso critico che sveglia il dispositivo anche con l'interruttore silenzioso e Non disturbare attivi.

## I cinque livelli

| Livello | Alias | Comportamento |
|-------|---------|----------|
| `silent` | `min`, `-2` | Consegnato solo nella tendina — nessun suono, nessuna vibrazione |
| `low` | `-1` | Silenzioso, senza interruzioni |
| `default` | `normal`, `0` (o omesso) | Banner standard + suono |
| `high` | `1` | Sensibile al tempo — supera Full immersion e il riepilogo programmato |
| `critical` | `max`, `urgent`, `2` | Sveglia il dispositivo anche con l'interruttore silenzioso e Non disturbare |

Entrambe le notazioni funzionano ovunque: invia `"level": "critical"` oppure `"level": 2`. Nell'API [Create Message](https://info.pocketalert.app/api/messages/create.md) il campo è accettato anche come `priority`; i webhook leggono solo `level`.

## Cosa fa ogni livello sul dispositivo

**iOS** associa i livelli ai livelli di interruzione APNs — `passive`, `active`, `time-sensitive` e `critical`. Un avviso `critical` usa il diritto di avviso critico di Apple, che riproduce il suono al proprio volume anche quando la suoneria è disattivata e Non disturbare è attivo. iOS chiede un permesso separato **Avvisi critici**; se è disattivato in **Impostazioni → Notifiche → Pocket Alert**, i messaggi `critical` arrivano come `time-sensitive`.

**Android** associa i livelli a canali di notifica separati. `critical` usa un canale ad alta importanza con bypass di Non disturbare e un intent a schermo intero, così l'avviso occupa lo schermo invece di restare in attesa nella tendina.

Poiché ogni livello è un canale Android separato, gli utenti possono silenziare le tue notifiche di routine dalle impostazioni di sistema lasciando attivi quelle critiche.

## Dove impostarlo

La priorità viene risolta in quest'ordine; vince la prima corrispondenza:

1. **Per messaggio** — il campo `level` in [Create Message](https://info.pocketalert.app/api/messages/create.md), il selettore di priorità nella dashboard, oppure un campo `level` di primo livello nel payload inviato a un webhook.
2. **Per webhook** — un livello predefinito sul webhook, per i messaggi che arrivano tramite esso, così un payload in entrata viene mappato direttamente a una gravità.
3. **Per applicazione** — un livello predefinito sull'applicazione, applicato a ogni messaggio che non ne imposta uno proprio.
4. **Valore di riserva** — `default`.

Questo ordine è ciò che rende un singolo webhook utile sia per eventi di routine sia per quelli urgenti: imposta il webhook su `high` e lascia che le singole chiamate lo aumentino quando qualcosa si rompe davvero.

## Limiti del piano

> **Warning: Critical è una funzione a pagamento**
>
> Nei piani gratuiti, `critical` viene automaticamente declassato a `high` invece di essere rifiutato — l'avviso arriva comunque, ma non supera Non disturbare. Tutti gli altri livelli funzionano su ogni piano.

Un nome di livello sconosciuto o un intero fuori dall'intervallo `-2`..`2` restituisce `400`.

## Filtrare per priorità nell'app

Il feed dell'app mobile legge gli stessi livelli. Tocca l'icona del filtro per selezionare uno o più livelli, restringere l'intervallo di date oppure ordinare l'intero feed per gravità invece che per orario — utile quando torni al telefono con quaranta notifiche e vuoi trovare le due che contano.

## Scegliere un livello

Una regola pratica che mantiene le notifiche affidabili:

- **`critical`** — qualcuno deve intervenire subito, a qualsiasi ora. Produzione down, violazione della sicurezza, congelatore sopra la temperatura.
- **`high`** — richiede attenzione entro l'ora. Deploy fallito, pagamento rifiutato, coda in accumulo.
- **`default`** — utile sapere oggi. Build completata, nuova registrazione, form inviato.
- **`low`** / **`silent`** — log sul telefono. Cron completato in orario, backup notturno terminato.

Lo scopo dei livelli non è far suonare più forte ogni avviso. È far sì che quelli rumorosi abbiano un significato.

## Correlati

- [Create Message](https://info.pocketalert.app/api/messages/create.md) — il campo `level` e il riferimento completo della richiesta
- [Pulsanti di azione](https://info.pocketalert.app/features/action-buttons.md) — agisci sull'avviso senza aprire l'app
- [Invio programmato](https://info.pocketalert.app/features/scheduled-delivery.md) — invia ora, consegna dopo
