Configurar conteúdo da mensagem de notificação por push

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura

    • Configure o conteúdo da mensagem de notificação por push e selecione qual aplicativo para celular recebe notificações. Você pode configurar notificações de alerta críticas, personalizar a aparência da mensagem e determinar o link profundo usado quando os usuários tocam na notificação.

    Antes de Iniciar

    Para configurar o conteúdo da mensagem de notificação por push, você deve gerar um link profundo usando o gerador de link profundo para celular. Para obter mais informações, consulte Link profundo para dispositivos móveis.

    Função necessária: admin

    Por Que e Quando Desempenhar Esta Tarefa

    Preencha o formulário de conteúdo da mensagem de envio por push para:

    • Nomeie a notificação
    • Selecione o aplicativo para celular para o qual a notificação será enviada
    • Opcionalmente, personalize a aparência da mensagem de notificação
    • Determinar o link profundo usado quando os usuários tocam na notificação
    O conteúdo da mensagem de notificação por push oferece suporte a até três campos adicionais. Se esses campos forem usados como slots de texto opcionais, os slots poderão exibir campos do registro de origem.
    Nota:
    Os slots de texto são fixos no aplicativo para celular, portanto, você não pode mudar sua localização ou tamanho. Cada slot é mapeado para um Status, Identificadore Descrição no objeto JSON no script de conteúdo da mensagem de notificação por push.

    Estilos de IU para celular também estão disponíveis para campos adicionais. Para obter mais informações sobre estilo, consulte Estilos de IU para celular.

    Procedimento

    1. Navegar até Todos > Notificação do Sistema > Envio por Push > Conteúdo da mensagem por push.
    2. Selecione Novo.
    3. No formulário de conteúdo da mensagem de envio por push, preencha os seguintes campos:
      Tabela 1. Formulário de conteúdo da mensagem de envio por push
      Campo Descrição
      Nome Valor da cadeia de caracteres para este registro.
      Nota:
      Este nome não está visível na notificação, é apenas uma referência para uso durante a configuração.
      Aplicativo de push Faz referência ao aplicativo para celular para o qual você deseja enviar uma notificação.
      • Use a aplicação ServiceNow Mobile para Mobile Agent.
      • Use ServiceNow Solicitar aplicação para Aplicativo Now Mobile.
      Geração de mensagem por push O bloco de script que contém o link de notificação. No bloco de script, o objeto JSON deve retornar um link e uma chave de link deve existir. A chave deve ter um valor de link profundo correspondente gerado por meio do gerador de link profundo para celular.
      Este exemplo mostra o formulário preenchido e um objeto JSON com a chave de link apropriada e um valor de link profundo correspondente. Inserir formulário de conteúdo da mensagem com todos os campos preenchidos e um link profundo de exemplo indicado pela chave de link.
    4. Opcional: Adicione campos adicionais ao conteúdo da notificação, como um slot de texto.

      No bloco de script Geração de mensagem por push, crie um objeto de campo de layout para cada campo.

      1. Instancia um objeto de layout de notificação. 
        var layoutGen = new global.NotificationLayoutFieldGenerator();
      2. Use o script de layout de notificação e inclua o escopo da aplicação global para gerar campos de layout.
        Para saber mais sobre inclusões de script, consulte Inclusões de script.
        Nota:
        Não modifique a inclusão de script do gerador de layout de notificação.
      3. Crie o campo de layout.
        Cada campo de layout requer uma Tabela, Sys_Ide uma Coluna.
        Nota:
        Os valores de Tabela e Sys_Id devem vir diretamente do registro atual usando current.getTableName() e current.sys_id. O valor de Coluna deve existir para a tabela desejada e corresponder exatamente ao nome da coluna do dicionário.
        var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority");
      4. Passe os campos de layout para o objeto JSON original como outro objeto.

        Os aplicativos para celular ouvem a chave de layout opcional, que é um objeto que contém os campos adicionais desejados. No objeto Layout, associe cada campo adicional às chaves de Status, Identificadorou Descrição. O exemplo a seguir está disponível como referência.

        (function buildJSON( /*GlideRecord*/ current, /*String*/ message, /*Object*/ attributes) { 

    var layoutGen = new global.NotificationLayoutFieldGenerator(); 
    var text_01 = layoutGen.layoutField(current.getTableName(), current.sys_id, "priority"); 
    var text_02 = layoutGen.layoutField(current.getTableName(), current.sys_id, "state"); 
    var text_03 = layoutGen.layoutField(current.getTableName(), current.sys_id, "short_description"); 

    var deepLinkGenerator = new global.MobileDeepLinkGenerator("Request"); 
    var link = deepLinkGenerator.getFormScreenLink("b71040b1533a33007bc2ddeeff7b1221", current.getTableName(), current.getValue("sys_id")); 

    var json = { 

        "Link": link, 

        "Layout": { 

            "Status": text_01, 

            "Identifier": text_02, 

            "Description": text_03 

        } 

    }; 

    return json;

})(current, message, attributes);
    5. Opcional: Adicione um título de notificação personalizado.
      Se você não adicionar um título de notificação personalizado, a notificação exibirá o nome do aplicativo para celular padrão.
      Imagem que mostra a diferença entre um título de mensagem de notificação padrão que exibe o nome do aplicativo para celular e um título personalizado que descreve a notificação.

      No bloco de script Geração de mensagem por push, adicione o seguinte código de exemplo na seção json :

      var json= {};
var msg_title  = "System updates!";
json= {
  "android_title" : msg_title,
  "aps": {
    "alert": {
      "title": msg_title,
    }
  }
      Os elementos no código JSON de amostra são os seguintes:
      • A variável msg_title chamada Atualizações do sistema! é o nome do título da notificação que se aplica a iOS e Android.
      • O nójson["android_title"] é a variável para Android.
      • O nó json["aps"]["alert"]["title"] é a variável para iOS.
    6. Adicione o código a seguir para ativar Android dispositivos para ativar, para que as notificações possam ser acionadas.

      Como os usuários usam dispositivos iOS e Android, você deve adicionar este código. A entrada JSON no código é um valor de nome de dicionário retornado do script.

      Android campos específicos que controlam a entrega de mensagens são compatíveis com sncGoogleKeys. Para obter mais informações, consulte Protocolo HTTP do Firebase Cloud Messaging.
      Nota:
      O parâmetro priority será definido como alto para ativar dispositivos Android, se um dispositivo estiver no modo de espera. Este parâmetro ajuda a fornecer alertas críticos aos usuários finais.
      json["sncGoogleKeys"] = {
    "priority": "high",
    "android": {
      "priority": "high"
    }
}
    7. Selecione Atualizar.

    Resultado

    Você criou um registro de conteúdo de mensagem de notificação por push que contém um link profundo.

    O que Fazer Depois

    Depois de configurar o conteúdo da mensagem de notificação por push, ele deve ser emparelhado com um registro de mensagem de notificação por push. Para obter mais informações sobre como configurar uma mensagem de notificação por push, consulte Configurar uma mensagem de notificação por push.