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

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 links diretos para celular. Para obter mais informações, consulte Link profundo para dispositivos móveis.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Preencha o formulário Inserir Conteúdo da Mensagem para:

• Atribua um nome à notificação
• Selecione o aplicativo para celular para o qual a notificação é 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 dentro do objeto JSON no script de conteúdo da mensagem de notificação por push.

Os estilos da IU para celular também estão disponíveis para campos adicionais. Para obter mais informações sobre estilo, consulte Estilos da 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 Inserir Conteúdo da Mensagem, preencha os seguintes campos:

   Tabela 1. Inserir formulário de conteúdo de mensagem

   Campo	Descrição
   Nome	Valor de 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 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 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 Link apropriada e um valor de link profundo correspondente.
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. Instanciar 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 escutam a chave Layout opcional, que é um objeto que contém os campos adicionais desejados. No objeto Layout, associe cada campo adicional às chaves 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.

   

   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 a serem ativados, 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 é definido como alto para ativar dispositivos Android, se um dispositivo estiver no modo de espera. 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 Configurar uma mensagem de notificação por push.