Configurar código para alertas críticos

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Você pode transformar uma notificação por push em um alerta crítico com a adição de algum código JSON. Código JSON diferente é usado para iOS e. Android sistemas operacionais e para ITSM unidade de negócios.

    Ao criar notificações de alerta crítico, você precisa da estrutura de código de uma mensagem de notificação por push, bem como do código JSON necessário que define a notificação como um alerta crítico. Você adiciona este código na área de conteúdo da mensagem por push. Para obter mais informações, consulte Alertas críticos para dispositivos móveis.

    Importante:

    Em Android plataforma, quando um usuário recebe um alerta crítico em determinados tipos de telefone, ele pode experimentar o seguinte comportamento de dispositivo:

    Dispositivos OnePlus com modo de toque controlado por hardware:
    Em dispositivos como o OnePlus, em que o modo de toque é controlado por um comutador físico, o aplicativo pode não ser capaz de substituir o volume do som de notificação se o dispositivo estiver definido para o modo silencioso ou vibratório.
    Comportamento do modo Não perturbe do dispositivo OnePlus ou OPPO:
    Em determinados dispositivos, como OPPO e OnePlus, se o modo Não perturbe (DND) estiver habilitado, a configuração DND poderá ser temporariamente desativada até que o som de notificação crítica termine de ser reproduzido.
    Ativado Android alertas críticos de clientes, versão 20.0.0 e posterior, não funcionam no seguinte:
    • . Android Recurso de Espaço privado que foi introduzido em Android15.
    • Android Dispositivos gerenciados pelo software de Gestão de dispositivos móveis (MDM). Por exemplo, Microsoft Intune.

    JSON de alerta crítico a ser ativado Android sistemas operacionais

    O código a seguir deve ser adicionado ao código JSON porque ele é ativado Android dispositivos a serem ativados para que um alerta crítico possa ser acionado.
    Nota:
    Porque os usuários usam ambos iOS e. Android dispositivos você deve adicionar este código. A entrada JSON no código é um valor de nome de dicionário retornado do script.
     
    
    json["sncGoogleKeys"] = { 
              "android": { 
                  "priority": "high" 
              }, 
              "priority": "high" 
          }; 
    

    JSON de alerta crítico para todos os sistemas operacionais

    O JSON a seguir deve ser adicionado para que uma notificação se comporte como um alerta crítico.

    var json = {};
    json["aps"] = { 
    "sound": {
              "critical": 1, 
              "name": "NotificationAlert-1.caf", 
              "volume": 1.0 
    }
          };
    
    Os parâmetros no código JSON de amostra são os seguintes:
    • . criticalo parâmetro define a notificação como um alerta crítico. 1 significa que o alerta crítico está ativo, 0 significa que o alerta crítico está inativo.
    • . nameo parâmetro é o nome do tom que é ativado quando um alerta crítico é enviado. Alguns tons de alertas críticos são listados na tabela. Para obter uma lista completa, consulte Configurar sons para notificações por push.
      Valores de nome de arquivo aceitos Ritmo do tom
      NotificationAlert-2.caf Dramático
      NotificationAlert-2-Short.caf Dramático
      NotificationAlert-9.caf Poderoso, dramático
      NotificationAlert-9-Short.caf Poderoso, dramático
      NotificationAlert-10.caf Suspensivo, dramático
      NotificationAlert-10-Short.caf Suspensivo, dramático
      Nota:
      Se for um nameo valor não está definido, o sistema usa o toque padrão da aplicação. Se uma aplicação não tiver um toque definido, o sistema usará o toque padrão do dispositivo.
    • . volumeo parâmetro define o volume do som de alerta crítico. O intervalo é de 0,1 mais silencioso para 1,0 mais alto.

    Bloco de código JSON de exemplo para alerta crítico

    A seguir está um bloco de exemplo completo de código JSON que você deve adicionar e configurar para ativar um alerta crítico Android e. iOS dispositivos.

    json["sncGoogleKeys"] = { 
              "android": { 
                  "priority": "high" 
              }, 
              "priority": "high" 
          }; 
      
    json["aps"]["sound"] = { 
              "critical": 1, 
              "name": "NotificationAlert-1.caf", 
              "volume": 1.0 
          };

    IT Service Management ( ITSM Inclusão de script CriticalPushPayloader

    . Conteúdo da mensagem por push a área pode conter código configurado anteriormente, incluindo a inclusão de script CriticalPushPayLoadBuilder , criado pelo ITSM unidade de negócios. Em caso afirmativo, nenhuma configuração adicional será necessária para alertas críticos. Inclusões de script são lógicas de script reutilizáveis do lado do servidor que definem uma função ou classe.  CriticalPushPayLoadBuilder é uma inclusão de script que contém funções para oferecer suporte a alertas críticos. A chamada das inclusões de script é semelhante a esta: PushPayloadBuilder (atual, json, atributos).buildJSON()
    Nota:
    Se você precisar mudar os valores de Volume ou Nome ou mudar o alerta de crítico para não crítico, você precisa acessar os parâmetros de função que a inclusão de script está obtendo como entradas.

    Mudar o valor da inclusão de script de alerta crítico afeta todos ITSM implementações da inclusão de script. Da mesma forma, um ITSM o upgrade do plug-in pode substituir suas mudanças na inclusão de script.