Adicionar uma notificação por e-mail

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 5 min. de leitura
  • Crie notificações em App Engine Studio (AES) para criar e-mails automatizados para eventos usando modelos ou mensagens personalizadas.

    Antes de Iniciar

    Você pode executar esta tarefa se for um administrador ou desenvolvedor da aplicação. A permissão de desenvolvedor necessária é Todos os tipos de arquivo. Para obter mais informações sobre como ser um desenvolvedor de uma aplicação, consulte Desenvolvimento delegado no App Engine Studio.

    Função necessária: desenvolvedor ou administrador permitido

    Por Que e Quando Desempenhar Esta Tarefa

    As notificações por e-mail permitem que você envie e-mails para os usuários selecionados sobre atividades no sistema, como atualizações de incidentes ou solicitações de mudança.
    Nota:
    No momento, não é possível criar outros tipos de notificações automáticas, como mensagens SMS.

    Criar uma notificação por e-mail envolve especificar quando enviá-la, quem a recebe e o que ela contém.

    Se o administrador tiver criado um modelo de e-mail no Now Platform, você poderá usá-lo como está ou substituir seu conteúdo. Para obter mais informações sobre modelos de e-mail, consulte Modelosde e-mail.

    Procedimento

    1. Navegar até Todos > App Engine > App Engine Studio.
    2. Na página Meus aplicativos, abra seu aplicativo.
    3. Em sua aplicação, na seção Lógica e automação, selecione Adicionar.
    4. Selecione o cartão para E- mail.
      Figura 1. Adicionar notificação por e-mail
      Selecione para adicionar uma notificação por e-mail
    5. No formulário, preencha os campos das configurações básicas.
      Tabela 1. Adicionar configurações básicas do formulário de notificação
      Campo Descrição
      Nome Nome da notificação por e-mail. Nomes descritivos ajudam a identificar a finalidade da notificação por e-mail. Por exemplo, Incidente aberto e não atribuído.
      Descrição resumida Uma breve explicação da finalidade da notificação.
    6. Na seção Configurações do gatilho de notificação do formulário, preencha os campos.
      Tabela 2. Adicionar formulário de notificação Configurações do gatilho de notificação
      Campo Descrição
      Enviar notificação por e-mail Situação em que uma notificação é enviada, como depois que algo acontece ou quando uma tabela é modificada. Estas são as opções:
      • Quando um registro for criado ou atualizado
      • Somente quando um registro é criado
      • Somente quando um registro é atualizado
      • Quando acionado por meio da ação de fluxo
      • Quando o evento for disparado

      Este campo é definido automaticamente como Quando um registro é criado ou atualizado.

      Depois de criar uma notificação por e-mail com uma ação de fluxo como gatilho, você especifica a notificação ao criar um fluxo em Flow Designer. Para obter mais informações, consulte Etapa de notificação.

      Tabela A tabela de banco de dados que hospeda os registros aos quais vincular o gatilho de notificação. Por exemplo, a tabela Incidente [incidente].
      Se você definir o campo Enviar notificação por e-mail como um dos seguintes valores, a tabela será necessária:
      • Quando um registro for criado ou atualizado
      • Somente quando um registro é criado
      • Somente quando um registro é atualizado
      Você pode selecionar entre duas seções: Tabelas que já estão disponíveis na sua aplicação e todas as tabelas fora do escopo da aplicação.
      Nome do evento Evento que aciona a notificação. Este campo é exibido somente quando Quando o evento é acionado é selecionado no campo Enviar notificação por e-mail.

      Se o mesmo gatilho gerar várias notificações, o sistema enviará apenas uma notificação. O sistema considera todas as outras notificações, mesmo que tenham um assunto e corpo diferentes, como duplicatas. A regra de negócio Ignorar duplicados controla esta funcionalidade.

    7. Torne o gatilho condicional usando o construtor de condição.

      Defina os conjuntos de condições e os valores que devem ser atendidos para o gatilho de notificação. Para obter mais informações, consulte Construtor de condição.

      Nota:
      Se você especificar que o gatilho de notificação é uma ação de fluxo, o construtor de condição não estará disponível.
    8. Na seção Destinatários do formulário, especifique quem receberá a notificação.
      Você pode:
      • Pesquise usuários ou grupos.
      • Defina destinatários dinâmicos selecionando Adicionar, o que requer que você especifique uma tabela nos detalhes do gatilho de notificação.
      Tabela 3. Adicionar configurações de destinatários do formulário de notificação
      Campo Descrição
      Usuários e grupos dos campos da tabela Usuários e grupos dinâmicos que recebem o e-mail com base na tabela. Por exemplo, se uma notificação usar a tabela Incidente [incidente], você poderá selecionar o campo Aberto por para enviar a notificação aos usuários ou grupos que abriram o incidente. Para alguns campos, você também pode selecionar valores contidos por um campo de referência, como Aberto por > Gerente.
      Selecione o botão Adicionar para pesquisar usuários e grupos dinâmicos com base em campos da tabela especificada.
      Nota:
      Se você não especificar uma tabela, o botão Adicionar não ficará disponível.
      Pessoas e grupos Endereços estáticos para usuários e grupos que recebem a notificação por e-mail. Você também pode pesquisar usuários e grupos.

      Especificar destinatário por campo de tabela

    9. Na seção Conteúdo do e-mail do formulário, selecione um modelo ou escreva o conteúdo original.
      Tabela 4. Adicionar formulário de notificação Configurações de conteúdo de e-mail
      Campo Descrição
      Modelo de e-mail Modelo de e-mail predefinido que você pode usar para aplicar o conteúdo existente, que você pode substituir. Você pode selecionar somente modelos que tenham o seguinte:
      • A mesma tabela que a notificação
      • Nenhuma tabela especificada

      Se você usar um modelo e não o substituir, quando o administrador atualizar o modelo, o conteúdo da notificação por e-mail também será atualizado automaticamente.

      Substituir modelo Opção para substituir o conteúdo do modelo de e-mail selecionado.

      Se você usar um modelo de e-mail, todas as imagens do modelo ainda pertencerão ao modelo, independentemente de você substituí-lo. As imagens na notificação são atualizadas automaticamente quando os administradores atualizam o modelo.

      Se você substituir um modelo de e-mail e alterar o modelo selecionado, o sistema removerá as substituições e as substituirá pelo conteúdo do novo modelo.

      Assunto Linha de assunto do e-mail.

      Para tornar o assunto dinâmico, use o campo Variáveis de e-mail ao lado da mensagem de e-mail para gerar sintaxe de variável no corpo da mensagem. Em seguida, você pode copiar e colar a sintaxe da variável na linha de assunto.

      Se estiver vazio, o sistema usará o valor de Assunto do modelo de e-mail. Se você inserir um valor neste campo, ele substituirá o modelo.

      Mensagem de e-mail Conteúdo da mensagem de notificação por e-mail, que pode incluir variáveis.

      Você pode formatar o conteúdo da mensagem de e-mail usando os ícones do editor de rich text.

      Se estiver vazio, o sistema usará o valor de Mensagem do modelo de e-mail. Se você inserir um valor neste campo, ele substituirá o valor do modelo.

      Adicionar variáveis Variáveis dinâmicas, ou valores, derivados de campos na tabela especificada.
      Nota:
      Você deve especificar uma tabela para que o botão Adicionar variáveis seja exibido.

      Selecione variáveis no campo Variáveis de e- mail e use a seta para movê-las para a mensagem de e-mail.

      Use variáveis para incluir valores de um registro na tabela, como uma descrição resumida do incidente ou comentários e anotações de trabalho. Variáveis são campos disponíveis da tabela especificada.

    10. Selecione Criar
      A notificação é salva e você pode visualizá-la.
    11. Exiba como a notificação por e-mail aparece selecionando Visualização.

      Verifique a visualização exibida. Para ver como uma notificação é renderizada, selecione o ícone de pesquisa na visualização e selecione o registro que deseja visualizar.

      Pesquise para visualizar a notificação por e-mail de um registro específico

    Resultado

    Quando você cria uma notificação em AES, a notificação é salva somente na aplicação que você está criando.