Adicionar uma notificação por e-mail

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: admin ou delegado_developer

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 seu administrador criou um modelo de e-mail no Now Platform, você pode usá-lo como está ou substituir seu conteúdo. Para obter mais informações sobre modelos de e-mail, consulte Modelos de e-mail. Verifique também com o administrador se ele está usando layouts de e-mail para controlar o cabeçalho, o corpo e o rodapé. Para obter mais informações sobre layouts de e-mail, consulte Email layouts.

Procedimento

1. Navegar até Tudo > App Engine > App Engine Studio.
2. Na página Meus apps, abra sua aplicação.
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

   

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 de ação de fluxo Quando o evento é 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 Workflow Studio. Para obter mais informações, consulte Etapa de notificação.
   Tabela	A tabela de banco de dados que hospeda os registros aos quais o gatilho de notificação será vinculado. Por exemplo, a tabela Incidente [incidente]. Se você definir o campo Enviar notificação por e-mail com 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 aparece somente quando Quando o evento é disparado é 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 assunto e corpo diferentes, como duplicatas. A regra de negócio Ignorar duplicatas controla essa funcionalidade.

7. Torne o gatilho condicional usando o Construtor de condições.

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

   Nota:

   Se você especificar que o gatilho de notificação é uma ação de fluxo, o construtor de condições 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 estará 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.

   

9. Na seção Conteúdo de e-mail do formulário, selecione um modelo ou grave 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 a 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 na tabela especificada.

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

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

    

Resultado

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

• Modificar uma notificação por e-mail
  Edite uma notificação por e-mail criada para um app em App Engine Studio (AES) para alterá-la. Por exemplo, modifique quando enviar a notificação por e-mail, quem a recebe e o que ela contém.