Níveis de prioridade e alertas críticos
Toda mensagem do Pocket Alert tem um nível de prioridade que define o quanto ela chama atenção: silenciosa na bandeja, como um banner normal ou como um alerta crítico que acorda o dispositivo mesmo com a chave de silêncio e o Não perturbe ativados.
Os cinco níveis
| Nível | Aliases | Comportamento |
|---|---|---|
silent | min, -2 | Entregue só na bandeja — sem som, sem vibração |
low | -1 | Discreta, sem interromper |
default | normal, 0 (ou omitido) | Banner padrão + som |
high | 1 | Sensível ao tempo — fura o Foco e o resumo agendado |
critical | max, urgent, 2 | Acorda o dispositivo mesmo com a chave de silêncio e o Não perturbe |
As duas formas funcionam em todos os lugares: envie "level": "critical" ou "level": 2. Na API Create Message, o campo também é aceito como priority; os webhooks leem apenas level.
O que cada nível faz no dispositivo
iOS mapeia os níveis para os níveis de interrupção do APNs — passive, active, time-sensitive e critical. Um alerta critical usa a permissão de alerta crítico da Apple, que toca o som no próprio volume mesmo com o toque desligado e o Não perturbe ativado. O iOS pede uma permissão separada, Alertas críticos; se ela estiver desativada em Configurações → Notificações → Pocket Alert, as mensagens critical chegam como time-sensitive.
Android mapeia os níveis para canais de notificação separados. critical usa um canal de alta importância com bypass do Não perturbe e intent de tela cheia, então o alerta toma a tela em vez de ficar esperando no painel de notificações.
Como cada nível é um canal separado no Android, os usuários podem silenciar suas notificações de rotina nas configurações do sistema e manter as críticas ativas.
Onde você pode definir
A prioridade é resolvida nesta ordem, e vence a primeira correspondência:
- Por mensagem — o campo
levelem Create Message, o seletor de prioridade no painel ou um campolevelno topo do payload enviado a um webhook. - Por webhook — um nível padrão no webhook, para as mensagens que chegam por ele, assim um payload de entrada já é mapeado para a severidade.
- Por aplicativo — um nível padrão no aplicativo, aplicado a toda mensagem que não define o seu próprio.
- Padrão de fallback —
default.
Essa ordem é o que torna um único webhook útil tanto para eventos de rotina quanto para eventos urgentes: defina o webhook como high e deixe chamadas individuais elevarem o nível quando algo realmente quebrar.
Limites do plano
Crítico é um recurso pago
Nos planos gratuitos, critical é automaticamente rebaixado para high em vez de ser rejeitado — o alerta ainda chega, só não passa por cima do Não perturbe. Todos os outros níveis funcionam em todos os planos.
Um nome de nível desconhecido ou um inteiro fora de -2..2 retorna 400.
Filtrando por prioridade no app
O feed do celular usa os mesmos níveis. Toque no ícone de filtro para selecionar um ou mais níveis, restringir a um intervalo de datas ou ordenar todo o feed por severidade em vez de por horário — útil quando você volta ao celular com quarenta notificações e quer apenas as duas que importavam.
Escolhendo um nível
Uma regra prática que mantém as notificações confiáveis:
critical— alguém precisa agir agora, a qualquer hora. Produção fora do ar, violação de segurança, freezer acima da temperatura.high— precisa de atenção na próxima hora. Deploy com falha, pagamento recusado, fila crescendo.default— vale saber hoje. Build concluído, novo cadastro, formulário enviado.low/silent— registro no seu celular. Tarefa cron concluída no horário, backup noturno finalizado.
O objetivo dos níveis não é deixar todo alerta mais barulhento. É fazer com que os barulhentos signifiquem alguma coisa.
Relacionados
- Create Message — o campo
levele a referência completa da requisição - Botões de ação — aja sobre o alerta sem abrir o aplicativo
- Envio agendado — envie agora, entregue depois