# Niveles de prioridad y alertas críticas

Cada mensaje de Pocket Alert tiene un nivel de prioridad que decide cuánto se nota: en silencio en la bandeja, como un banner normal o como una alerta crítica que despierta el dispositivo aunque el interruptor de silencio esté activado y en No molestar.

## Los cinco niveles

| Nivel | Alias | Comportamiento |
|-------|-------|----------------|
| `silent` | `min`, `-2` | Se entrega solo a la bandeja: sin sonido ni vibración |
| `low` | `-1` | Discreta, sin interrumpir |
| `default` | `normal`, `0` (o se omite) | Banner y sonido estándar |
| `high` | `1` | Sensible al tiempo: atraviesa Concentración y el resumen programado |
| `critical` | `max`, `urgent`, `2` | Despierta el dispositivo aunque el interruptor de silencio esté activado y en No molestar |

Las dos formas funcionan en todas partes: envía `"level": "critical"` o `"level": 2`. En la API [Crear mensaje](https://info.pocketalert.app/api/messages/create.md) el campo también se acepta como `priority`; los webhooks solo leen `level`.

## Qué hace cada nivel en el dispositivo

**iOS** asigna los niveles a los niveles de interrupción de APNs: `passive`, `active`, `time-sensitive` y `critical`. Una alerta `critical` usa el derecho de alertas críticas de Apple, que reproduce el sonido con su propio volumen incluso con el timbre apagado y No molestar activado. iOS pide un permiso aparte, **Alertas críticas**; si está desactivado en **Configuración → Notificaciones → Pocket Alert**, los mensajes `critical` llegan como `time-sensitive`.

**Android** asigna cada nivel a un canal de notificaciones distinto. `critical` usa un canal de alta importancia que omite No molestar y una intent de pantalla completa, así que la alerta ocupa la pantalla en lugar de esperar en el panel de notificaciones.

Como cada nivel es un canal de Android independiente, los usuarios pueden silenciar tus notificaciones rutinarias en la configuración del sistema y dejar activas las críticas.

## Dónde puedes configurarlo

La prioridad se resuelve en este orden; gana la primera coincidencia:

1. **Por mensaje**: el campo `level` en [Crear mensaje](https://info.pocketalert.app/api/messages/create.md), el selector de prioridad del panel o un campo `level` de primer nivel en un payload enviado a un webhook.
2. **Por webhook**: un nivel predeterminado en el webhook, para los mensajes que llegan por él, de modo que un payload entrante se traduzca directamente a una gravedad.
3. **Por aplicación**: un nivel predeterminado en la aplicación, aplicado a todos los mensajes que no definen el suyo.
4. **Alternativa**: `default`.

Este orden es lo que hace útil un único webhook tanto para eventos rutinarios como urgentes: configura el webhook en `high` y deja que cada llamada lo suba de nivel cuando algo se rompe de verdad.

## Límites del plan

> **Warning: Critical es una función de pago**
>
> En los planes gratuitos, `critical` se degrada automáticamente a `high` en lugar de rechazarse: la alerta llega igualmente, solo que no pasa por encima de No molestar. Todos los demás niveles funcionan en todos los planes.

Un nombre de nivel desconocido o un entero fuera de `-2`..`2` devuelve `400`.

## Filtrar por prioridad en la app

El feed de la app móvil usa los mismos niveles. Toca el icono de filtro para seleccionar uno o varios niveles, acotar a un rango de fechas u ordenar todo el feed por gravedad en lugar de por hora. Es útil cuando vuelves al teléfono con cuarenta notificaciones y quieres ver solo las dos que importaban.

## Elegir un nivel

Una regla práctica que mantiene tus notificaciones fiables:

- **`critical`**: alguien debe actuar ya, a cualquier hora. Producción caída, brecha de seguridad, congelador por encima de la temperatura.
- **`high`**: requiere atención en la próxima hora. Despliegue fallido, pago rechazado, cola que se acumula.
- **`default`**: conviene saberlo hoy. Compilación terminada, nuevo registro, formulario enviado.
- **`low`** / **`silent`**: registro en tu teléfono. Tarea cron terminada a tiempo, copia de seguridad nocturna completada.

El objetivo de los niveles no es hacer que cada alerta suene más fuerte. Es que las fuertes signifiquen algo.

## Relacionado

- [Crear mensaje](https://info.pocketalert.app/api/messages/create.md): el campo `level` y la referencia completa de la petición
- [Botones de acción](https://info.pocketalert.app/features/action-buttons.md): actúa sobre la alerta sin abrir la app
- [Envío programado](https://info.pocketalert.app/features/scheduled-delivery.md): envía ahora, entrega más tarde
