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 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:
- Por mensaje: el campo
levelen Crear mensaje, el selector de prioridad del panel o un campolevelde primer nivel en un payload enviado a un webhook. - 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.
- Por aplicación: un nivel predeterminado en la aplicación, aplicado a todos los mensajes que no definen el suyo.
- 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
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: el campo
levely la referencia completa de la petición - Botones de acción: actúa sobre la alerta sin abrir la app
- Envío programado: envía ahora, entrega más tarde