# Niveaux de priorité et alertes critiques

Chaque message Pocket Alert porte un niveau de priorité qui détermine son impact : discret dans la barre de notifications, sous forme de bannière normale, ou sous forme d’alerte critique qui réveille l’appareil malgré le interrupteur silencieux et le mode Ne pas déranger.

## Les cinq niveaux

| Niveau | Alias | Comportement |
|-------|---------|----------|
| `silent` | `min`, `-2` | Livré uniquement dans la barre de notifications — ni son, ni vibration |
| `low` | `-1` | Discret, sans interruption |
| `default` | `normal`, `0` (ou omis) | Bannière standard + son |
| `high` | `1` | Sensible au temps — passe outre la Concentration et le récapitulatif programmé |
| `critical` | `max`, `urgent`, `2` | Réveille l’appareil malgré le interrupteur silencieux et le mode Ne pas déranger |

Les deux écritures fonctionnent partout : envoyez `"level": "critical"` ou `"level": 2`. Sur l’API [Create Message](https://info.pocketalert.app/api/messages/create.md), le champ est aussi accepté sous le nom `priority` ; les webhooks ne lisent que `level`.

## Ce que fait chaque niveau sur l’appareil

**iOS** associe les niveaux aux niveaux d’interruption APNs : `passive`, `active`, `time-sensitive` et `critical`. Une alerte `critical` utilise le droit d’alerte critique d’Apple, qui joue le son à son propre volume même lorsque la sonnerie est coupée et que le mode Ne pas déranger est activé. iOS demande une autorisation distincte **Alertes critiques** ; si elle est désactivée dans **Réglages → Notifications → Pocket Alert**, les messages `critical` arrivent en `time-sensitive`.

**Android** associe les niveaux à des canaux de notification distincts. `critical` utilise un canal à importance élevée qui contourne le mode Ne pas déranger et une intention plein écran, de sorte que l’alerte occupe l’écran au lieu d’attendre dans le volet.

Comme chaque niveau correspond à un canal Android distinct, les utilisateurs peuvent couper vos notifications de routine dans les paramètres système tout en gardant les notifications critiques actives.

## Où le définir

La priorité est déterminée dans l’ordre suivant ; la première correspondance l’emporte :

1. **Par message** — le champ `level` dans [Create Message](https://info.pocketalert.app/api/messages/create.md), le sélecteur de priorité du tableau de bord, ou un champ `level` au premier niveau d’une charge utile envoyée à un webhook.
2. **Par webhook** — un niveau par défaut défini sur le webhook, pour les messages reçus par son intermédiaire, afin qu’une charge utile entrante soit directement associée à une gravité.
3. **Par application** — un niveau par défaut défini sur l’application, appliqué à chaque message qui ne définit pas le sien.
4. **Repli** — `default`.

Cet ordre permet d’utiliser un même webhook pour les événements courants comme pour les événements urgents : réglez le webhook sur `high`, et laissez chaque appel remplacer ce niveau à la hausse lorsqu’un incident se produit réellement.

## Limites selon l’offre

> **Warning: Critical est une fonctionnalité payante**
>
> Sur les offres gratuites, `critical` est automatiquement rétrogradé en `high` au lieu d’être rejeté : l’alerte arrive quand même, mais elle ne passe pas outre le mode Ne pas déranger. Tous les autres niveaux fonctionnent sur toutes les offres.

Un nom de niveau inconnu ou un entier en dehors de `-2`..`2` renvoie `400`.

## Filtrer par priorité dans l’application

Le fil de l’application mobile utilise les mêmes niveaux. Appuyez sur l’icône de filtre pour sélectionner un ou plusieurs niveaux, restreindre à une plage de dates, ou trier l’ensemble du fil par gravité plutôt que par heure — pratique lorsque vous retrouvez un téléphone avec quarante notifications et que vous voulez les deux qui comptaient.

## Choisir un niveau

Une règle simple qui garde des notifications fiables :

- **`critical`** — quelqu’un doit agir immédiatement, à toute heure. Production à l’arrêt, faille de sécurité, congélateur au-dessus de la température limite.
- **`high`** — nécessite une intervention dans l’heure. Déploiement échoué, paiement refusé, file d’attente qui s’allonge.
- **`default`** — à savoir aujourd’hui. Build terminé, nouvelle inscription, formulaire soumis.
- **`low`** / **`silent`** — journalisation sur votre téléphone. Tâche cron terminée à l’heure prévue, sauvegarde nocturne achevée.

Le but des niveaux n’est pas de rendre chaque alerte plus bruyante. C’est de faire en sorte que les alertes bruyantes aient un sens.

## Voir aussi

- [Create Message](https://info.pocketalert.app/api/messages/create.md) — le champ `level` et la référence complète de la requête
- [Boutons d’action](https://info.pocketalert.app/features/action-buttons.md) — agir sur l’alerte sans ouvrir l’application
- [Envoi programmé](https://info.pocketalert.app/features/scheduled-delivery.md) — envoyer maintenant, livrer plus tard
