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 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:
- Per messaggio — il campo
levelin Create Message, il selettore di priorità nella dashboard, oppure un campoleveldi primo livello nel payload inviato a un webhook. - 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à.
- Per applicazione — un livello predefinito sull'applicazione, applicato a ogni messaggio che non ne imposta uno proprio.
- 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
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 — il campo
levele il riferimento completo della richiesta - Pulsanti di azione — agisci sull'avviso senza aprire l'app
- Invio programmato — invia ora, consegna dopo