# 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](https://info.pocketalert.app/api/messages/create.md), 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](https://info.pocketalert.app/api/messages/create.md), 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

> **Warning: 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](https://info.pocketalert.app/api/messages/create.md) — o campo `level` e a referência completa da requisição
- [Botões de ação](https://info.pocketalert.app/features/action-buttons.md) — aja sobre o alerta sem abrir o aplicativo
- [Envio agendado](https://info.pocketalert.app/features/scheduled-delivery.md) — envie agora, entregue depois
