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

Configure o conteúdo da mensagem de notificação por push e selecione qual aplicativo para celular receberá 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 Deep Linking para celular.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Preencha o formulário Conteúdo da mensagem por push para:

• Nomeie a notificação
• Selecione o aplicativo para celular para o qual a notificação será enviada
• Como opção, personalize a aparência da mensagem de notificação
• Determine 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 mapeia para um Status , Identificador e Descrição em JSON objeto no script de conteúdo da mensagem de notificação por push.

Os 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é Tudo > Notificação do Sistema > Envio por Push > Inserir conteúdo de mensagem.
2. Selecione Novo.
3. No formulário Conteúdo da mensagem por push, preencha os seguintes campos:

   Tabela 1. Formulário de conteúdo da mensagem 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. Usar ServiceNow Mobile Aplicação para Mobile Agent. Usar ServiceNow Solicitar aplicação para App 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. JSON o objeto deve retornar um link e um Link a chave 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 JSON objeto com o apropriado Link e um valor de link profundo correspondente.
4. Opcional: Adicione campos adicionais ao conteúdo da notificação, como um slot de texto.

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

   1. Instancie 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 um Tabela , Sys_ID e um Coluna .

      Nota:

      . Tabela e. Sys_ID os valores devem vir diretamente do registro atual usando GetTableName() e. sys_id.current.sys_id . . Coluna o valor 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 original JSON objeto como outro objeto.

      Os aplicativos para celular escutam o opcional Layout chave, que é um objeto que contém os campos adicionais desejados. Em Layout associe cada campo adicional ao Status , Identificador ou Descrição chaves. 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.

   

   Em Geração de mensagem por push bloco de script, adicione o código de exemplo a seguir no json seção:

   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:

   • . msg_titlevariável chamada Atualizações do sistema! é o nome do título da notificação que se aplica a ambos 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 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.

   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:

   . priorityo parâmetro está definido como alto para despertar Android dispositivos, se um dispositivo estiver no modo de suspensão. Este parâmetro ajuda a entregar 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 Configure uma mensagem de notificação por push.