Vai al contenuto

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 ​

LivelloAliasComportamento
silentmin, -2Consegnato solo nella tendina — nessun suono, nessuna vibrazione
low-1Silenzioso, senza interruzioni
defaultnormal, 0 (o omesso)Banner standard + suono
high1Sensibile al tempo — supera Full immersion e il riepilogo programmato
criticalmax, urgent, 2Sveglia 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:

  1. Per messaggio — il campo level in Create Message, 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 ​

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 ​

Documentazione di Pocket Alert