# Alertas que furam pelo modo silencioso e pelo Não perturbe.

> Dê uma prioridade a cada push: silencioso, baixa, padrão, alta ou crítica. Alertas críticos ignoram o Não perturbe no Android e furam os modos de Foco do iPhone. Um único campo de nível na API.

<!-- source: https://pocketalert.app/pt/use-cases/critical-alerts -->

Última atualização: 2026-10-25

O Pocket Alert dá a cada notificação push um nível de prioridade, de silencioso a crítico. No Android, um alerta crítico ignora o Não perturbe e o modo silencioso; no iPhone, ele atravessa o Foco como uma notificação sensível ao tempo. Você define isso com um único campo na chamada da API.

## Três passos para alertas que te acordam

1. **Escolha um nível** — silent para resumos, high para avisos, critical para incidentes que não podem esperar até de manhã.
2. **Envie a mensagem** — Adicione "level":"critical" na chamada da API, no payload do webhook, ou defina um padrão no aplicativo.
3. **Ela atravessa** — O Android ignora o Não perturbe e mostra tela cheia. O iPhone atravessa o Foco. Silenciosa continua silenciosa.

## Níveis de prioridade que combinam com o incidente

Um alerta de monitoramento às 3 da manhã e um relatório diário de backup não deveriam soar igual. O Pocket Alert dá a cada mensagem um nível de prioridade, de silencioso a crítico.

- **Cinco níveis, um campo** — silent, low, default, high, critical — um único campo de nível em qualquer mensagem, na API, em um payload de webhook ou no MCP.
- **Fura o Não perturbe no Android** — Alertas críticos no Android são publicados em um canal dedicado que ignora o Não perturbe e pode aparecer em tela cheia.
- **Atravessa o Foco no iPhone** — Mensagens high e critical chegam como notificações sensíveis ao tempo no iPhone, então furam os modos Foco.
- **Silenciosa quando deve ser** — O nível -2 entrega sem som ou vibração. Avisos de sucesso e resumos ficam registrados sem acordar ninguém.
- **Padrões por app e webhook** — Defina default_level uma vez por aplicativo ou webhook. Toda mensagem herda o nível; qualquer mensagem pode substituí-lo.
- **Feed com prioridade primeiro** — O aplicativo mobile filtra e ordena o feed por prioridade, então incidentes críticos nunca se perdem no ruído do dia a dia.

## Envie seu primeiro alerta crítico

### 1. Escolha o nível

Toda mensagem aceita um campo `level` (ou `priority`):

```
level: silent (-2) · low (-1) · default (0) · high (1) · critical (2)
```

Os apelidos também funcionam: `min`, `normal`, `urgent`, `max`. Valores inválidos recebem um `400` claro da API, então um erro de digitação nunca falha em silêncio.

### 2. Envie

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Primary DB down","message":"Postgres is not responding on db-1","level":"critical"}'
```

O mesmo campo funciona em um payload de webhook — adicione `"level": "critical"` ao JSON que qualquer serviço envia para a URL do seu webhook do Pocket Alert — e na ferramenta MCP `create_message`.

### 3. Deixe as coisas tranquilas em silêncio

```
pg_dump mydb | gzip > backup.sql.gz && \
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Backup finished' -F 'message=Nightly dump completed' -F 'level=silent'
```

Mensagens silenciosas vão para o seu histórico sem som. Seu celular só faz barulho quando o nível indica que deveria.

### Como os níveis são resolvidos

Nível explícito da mensagem → `default_level` do webhook → `default_level` do aplicativo → default. Defina o padrão uma vez em um webhook que recebe alertas de monitoramento, e tudo o que ele encaminhar chegará como `high`, sem alterar o remetente.

### Configuração única no celular

No Android, permita o acesso ao Não perturbe quando o app pedir (Configurações → Somente críticas) para que alertas críticos possam furar o bloqueio. No iPhone, permita notificações: o Pocket Alert entrega mensagens high e critical como sensíveis ao tempo, que atravessam os modos Foco. O som de alerta crítico completo do iOS — aquele que ignora a chave de silêncio — está sendo liberado conforme a Apple concede a permissão.

## Perguntas frequentes

### Uma notificação push consegue ignorar o modo silencioso e o Não perturbe?

No Android, sim. Envie uma mensagem com level: critical e ela é publicada em um canal de notificação dedicado, que ignora o Não perturbe e aparece em tela cheia. Basta conceder ao aplicativo acesso ao Não perturbe uma vez, em Configurações. No iPhone, mensagens críticas chegam como notificações sensíveis ao tempo, que furam os modos Foco. O som de alerta crítico completo, que ignora a chave de silêncio, está sendo liberado conforme a Apple concede a permissão.

### Quais níveis de prioridade o Pocket Alert suporta?

Cinco: silent (-2), low (-1), default (0), high (1) e critical (2). A API aceita o nome ou o número, e os apelidos comuns também funcionam: min, normal, urgent e max. Envie no campo level ou priority; os dois são aceitos.

### Posso definir um nível padrão por aplicativo ou por webhook?

Defina default_level em um aplicativo ou em um webhook e toda mensagem roteada por ele herda esse nível. Um nível explícito na própria mensagem sempre prevalece. Se nada estiver definido em lugar nenhum, a mensagem é enviada como default.

### Alertas críticos funcionam no plano gratuito?

A entrega crítica é um recurso pago. No plano gratuito, uma mensagem crítica é entregue com prioridade alta: ela continua chegando instantaneamente e fica no topo do seu feed, só não ignora o Não perturbe.

### Uma mensagem silenciosa se perde?

Não. Uma mensagem silenciosa (nível -2) não tem som nem vibração e aparece discretamente na bandeja de notificações e no seu histórico de mensagens. Use para avisos de sucesso, resumos e qualquer coisa que você queira registrada sem uma vibração.
