Navegar na documentação

Urgências e sons

A urgência de um ouvinte define como o alerta chega ao celular: qual som toca, se vibra e se atravessa o Não Perturbe. São cinco perfis, e cada plataforma os entrega do seu jeito.

Os cinco perfis

Ao criar ou editar um ouvinte, o seletor Som e urgência oferece Sirene, Crítico, Padrão e Silencioso. O quinto perfil, Informativo, só aparece como Som da resolução: é um tom suave para boa notícia, e o servidor não o aceita como som do alerta principal.

PerfilAndroidiOSQuando usar
SireneCanal Sirene (fura o Não Perturbe), importância máxima, som de sirene e vibração longa. Pode virar uma ligação em tela cheia que insiste até você parar.Pode chegar como Alerta Crítico: toca no volume máximo mesmo no silencioso e em qualquer Foco. Depende da permissão de Alertas Críticos e da configuração do servidor.Só para o que exige ação imediata a qualquer hora. Restrita à severidade Desastre.
CríticoCanal Crítico (fura o Não Perturbe), importância alta, som de alerta crítico.Nível sensível ao tempo, que atravessa os modos Foco, com som de alerta crítico.Incidentes graves que precisam de resposta rápida, sem o susto da sirene.
PadrãoCanal Alertas, importância alta, som de atenção. Não fura o Não Perturbe.Notificação comum com som de atenção.O dia a dia: avisa sem interromper o descanso.
InformativoCanal Informativo (resoluções), importância normal, som suave.Notificação passiva com som suave, nunca fura o silencioso.Aviso de que o alerta foi resolvido.
SilenciosoCanal Silencioso (só registra): sem som, sem vibração.Notificação passiva, sem som.Registrar na central de notificações sem tocar.
Por que "pode". Furar o Não Perturbe no Android exige que o app tenha o acesso a Não Perturbe concedido. No iOS, o Alerta Crítico da Sirene depende de você permitir Alertas Críticos e de o servidor estar configurado para enviá-los; sem isso, a Sirene chega como alerta sensível ao tempo, e o som de cada perfil pode ser o padrão do sistema em vez do som próprio.

Android: canais e Não Perturbe

O app cria um canal de notificação por perfil. O Android congela som e vibração no momento em que o canal nasce; a urgência do ouvinte escolhe qual canal usar, e você pode ajustar cada canal nas configurações do aparelho. Para os canais Sirene e Crítico atravessarem o Não Perturbe, o app pede uma vez o acesso a Não Perturbe com o aviso Alertas no Não Perturbe e o botão Ativar, que abre a tela certa do sistema. Veja Android: canais, bateria e tela cheia.

iOS: sons e Alertas Críticos

No iPhone não há canais: cada push traz o nível de interrupção e o som. Só a Sirene usa Alertas Críticos, e para escolhê-la o app pede essa permissão; se ela for negada, aparece Permissão necessária com o atalho Abrir Ajustes, e o perfil não é ativado. Veja iOS: sons, Foco e alertas críticos.

Ouvir e Testar

Cada perfil tem o botão Ouvir, que toca o som no volume atual. O card da Sirene troca Ouvir por Testar, porque a sirene não é só um som. Depois de confirmar Testar a sirene? com Tocar teste:

  • No iOS, o servidor envia um Alerta Crítico real de teste para este aparelho, a 50% do volume, avisando que o incidente real toca no máximo. Exige a permissão de Alertas Críticos e respeita um intervalo de 30 segundos entre testes.
  • No Android, a demonstração é local: abre o alarme em tela cheia com a sirene em volume reduzido por cerca de doze segundos, sem push e sem furar nada.
POST/api/v1/devices/siren-test

Avisos extras: recorrência e resolução

Todo ouvinte toca no primeiro disparo. Os dois interruptores abaixo do seletor de urgência acrescentam eventos:

EventoQuando aconteceOpçãoSom usado
Primeiro disparoO incidente apareceSempre ligadoUrgência do ouvinte
RecorrênciaO mesmo problema volta depois de resolvidoAvisar em recorrênciasUrgência do ouvinte, com o mesmo título de um alerta novo
ResoluçãoO incidente deixa de estar ativoAvisar quando resolverSom da resolução (Informativo por padrão; título Resolvido e o host)
Resolução com som de resolução. O padrão Informativo existe para você saber que o problema fechou sem levantar da cadeira. Escolher Sirene como som da resolução também é possível, mas exige a mesma confirmação da Sirene.

Validade do push

Um alerta Padrão, Informativo ou Silencioso que não puder ser entregue em uma hora (aparelho desligado, sem rede) é descartado, para você não receber uma enxurrada de alertas velhos ao religar. Sirene e Crítico esperam até quatro horas. Se um incidente de severidade menor que Desastre chegar a um ouvinte Sirene, o servidor o entrega como Crítico.

Veja também