Configurar conteúdo da mensagem

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Crie uma mensagem na tabela Conteúdo da mensagem [messaging_content] que você pode usar em várias notificações. As mensagens podem ser informativas ou podem solicitar uma ação de um usuário individual do Slack ou do Teams. Por exemplo, a mensagem de solicitação de aprovação inclui os botões Aprovar e Rejeitar para executar a ação associada em ServiceNow.

    Antes de Iniciar

    Função necessária: admin ou message_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Para permitir que os usuários realizem ações no Slack ou no Teams, use o tipo de mensagem Botões e defina o comportamento com script. Somente usuários que vincularam suas contas do Slack ou do Teams à conta ServiceNow podem realizar ações em ServiceNow na aplicação de terceiros.

    Procedimento

    1. Navegar até Todos > Notificação do Sistema > Conteúdo da mensagem.
    2. Abra um registro de notificação existente ou clique em Novo para criar um novo registro.
    3. Preencha ou modifique os campos conforme apropriado.
      Tabela 1. Campos de conteúdo de mensagens
      Campo Descrição
      Nome Insira um nome exclusivo para a mensagem.
      Tipo Selecione um tipo de mensagem.
      • Simples: envie uma mensagem informativa para uma equipe inteira ou para o canal do Slack.
      • Botões: envie uma mensagem para um usuário individual no Slack ou no Teams e defina o comportamento desejado no campo Script. Associe botões na mensagem a ações em ServiceNow. Use a solicitação de aprovação como exemplo.
      Tabela de destino Para usar o conteúdo do registro em sua mensagem, selecione a tabela apropriada.
      Nota:
      Não há suporte para notificações em execução na tabela Tarefa [task]. Em vez disso, use uma tabela estendida da tarefa.
      Campos Selecione quais campos da tabela Destino aparecem em uma mensagem simples. Alterar a ordem dos campos muda a ordem de exibição na notificação.
      Cabeçalho da mensagem Insira o texto a ser exibido na parte superior da mensagem.
      Mensagem Insira o conteúdo da mensagem. Use variáveis de notificação para incluir informações dinâmicas em sua mensagem. Por exemplo, use Incidente ${number} para incluir o número do incidente na mensagem.

      Para obter as variáveis disponíveis, consulte Variáveis de notificação.

      Botões

      Selecione ou crie botões para usar no formulário. Depois de selecionar ou criar um botão, você deve definir o comportamento do botão no campo Script.

      Visível somente quando Botões é selecionado no campo Tipo

      Script

      Este campo só fica visível quando Botões é selecionado no campo Tipo.

      Insira um script para definir o que acontece na sua instância quando um usuário seleciona um botão no Slack ou no Microsoft Teams. Use o método action.get para retornar o nome do botão selecionado pelo usuário.

      if (actions.get('button') == 'Approve') {
      		target.state = 'approved';
      		target.update();
      	}

      Neste exemplo, o script é executado condicionalmente quando o botão "Aprovar" é selecionado.

      Use o método sn_notification.Messaging.send para enviar informações para a janela de mensagens.

      var content = new GlideRecord("messaging_content");
      content.get("1bb10839572213007f004758ef94f9c4"));
      sn_notification.Messaging.send(application, userId, content, target);

      Neste exemplo, o script armazena um registro de conteúdo da mensagem na variável de conteúdo. Em seguida, ele publica uma mensagem desse registro de conteúdo da mensagem.

      Aplicação Selecione o escopo da aplicação para esta notificação.
    4. Clique em Enviar

    Exemplo

    Este exemplo mostra a saída de uma mensagem no Microsoft Teams. Esta mensagem é do tipo botões, que mostra botões e executa ações com script com base na seleção do usuário. Nesse caso, o script usa o método sn_notification.Messaging.sendpara exibir a mudança no estado do registro.

    Mensagem de tipo de botões

    O que Fazer Depois

    Use a mensagem em uma notificação. Para obter mais informações sobre como criar notificações, consulte Criar uma notificação de mensagens.