Ir para o conteúdo

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ívelAliasesComportamento
silentmin, -2Entregue só na bandeja — sem som, sem vibração
low-1Discreta, sem interromper
defaultnormal, 0 (ou omitido)Banner padrão + som
high1Sensível ao tempo — fura o Foco e o resumo agendado
criticalmax, urgent, 2Acorda 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:

  1. Por mensagem — o campo level em Create Message, o seletor de prioridade no painel ou um campo level no topo do payload enviado a um webhook.
  2. 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.
  3. Por aplicativo — um nível padrão no aplicativo, aplicado a toda mensagem que não define o seu próprio.
  4. 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 ​

Documentação do Pocket Alert