Crie um modelo de cliente de e-mail

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 11 min. de leitura

    • Crie um modelo diferente para cada tabela que usa o cliente de e-mail para preencher previamente os dados de destinatários e conteúdo de e-mail.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    O cliente de e-mail usa o seu próprio modelos de e-mail para definir valores padrão para campos. Use as seções a seguir no formulário Modelo de cliente de e-mail para criar um modelo de cliente:
    • Conteúdo: O corpo da mensagem.
    • Destinatários: Os endereços de e-mail dos usuários que recebem a mensagem de e-mail. Os endereços de e-mail são exibidos nos campos Para, Cc e Cco da mensagem.
    • Configuração do remetente: O método usado para gerar o remetente do e-mail (do endereço de e-mail) da mensagem.

    Procedimento

    1. Navegar até Tudo > Cliente de e-mail > Modelos de cliente de e-mail.
    2. Selecione Novo.
    3. No formulário, preencha os campos.
      Tabela 1. Modelo de cliente de e-mail
      Campo Descrição
      Nome Nome exclusivo do modelo.
      Tabela A tabela à qual o modelo se aplica. Habilite o cliente de e-mail para a mesma tabela.
      Condições As condições que determinam quando este modelo de cliente é usado. Use o construtor de condições para identificar o registro de destino que deve corresponder antes que este modelo seja aplicado ao cliente de e-mail.
      Nota:
      As condições são usadas somente para aplicar um modelo padrão após o carregamento inicial. As condições não são usadas ao carregar um modelo de e-mail personalizado de uma barra lateral do espaço.
      Aplicação O tipo de aplicação com escopo.
      Ordem de Execução Um número que indica a ordem na qual as condições do modelo são avaliadas. O modelo com a ordem de execução mais baixa é considerado.
      Incluir anexo de e-mail Opção para incluir anexos de e-mail para replyall-received , resposta recebida , enviado , resposta enviada , replyall-set . recebido modelos de resposta.
      Nota:
      Esta opção é aplicável somente para e-mail de resposta em um espaço configurável.
    4. Em Conteúdo preencha os campos.
      Tabela 2. Guia Conteúdo
      Campo Ação
      Assunto Insira uma descrição do e-mail.
      Nota:
      . Assunto o campo no cliente de e-mail permite uma contagem de caracteres maior do que a configuração padrão para Assunto Campo na tabela E-mail [sys_email]. Se o texto do assunto do cliente estiver sendo truncado, aumente Tamanho máximo valor para Assunto Campo na tabela E-mail.
      Tipo de conteúdo Selecione o formato do conteúdo do corpo da mensagem: HTML ou texto sem formatação .
      HTML do corpo

      Se você selecionou HTML para Tipo de conteúdo , Insira o conteúdo do corpo da mensagem usando a barra de ferramentas do editor de HTML para formatar o HTML.

      Para fazer referência a valores de campo, selecione variáveis na lista Variáveis ou digite manualmente as referências de variáveis usando a sintaxe (table_name.variable_name) . Para fazer referência ao usuário que inicia o cliente de e-mail, insira a variável (current_user) .
      Nota:
      As quebras de linha não aparecem para campos de várias linhas, como descrição e comentários no modelo de cliente de e-mail.

      Você pode chamar um script de e-mail usando mail_script:nome do script em HTML do corpo campo.
      Corpo do texto

      Se você selecionou texto sem formatação para Tipo de conteúdo , insira qualquer texto ou script de e-mail que você deseja que apareça no corpo da mensagem.

      Você pode inserir um script de e-mail no Texto do corpo usando a seguinte sintaxe:
      <mail_script> [code] </mail_script>
    5. Em Destinatários preencha os campos.
      Tabela 3. Guia Destinatários
      Campo Ação
      Para Insira uma lista separada por vírgulas de nomes de campo que contenham endereços de e-mail do usuário ou apenas endereços de e-mail. Para fazer referência a um endereço de e-mail usando um script, crie uma inclusão de script e chame a inclusão de script no Para campo. Seu script deve começar com javascript: prefixo. O script deve retornar endereços de e-mail em uma cadeia de caracteres separada por vírgulas.
      Cc

      Insira uma lista separada por vírgulas de nomes de campo que contenham endereços de e-mail do usuário ou apenas endereços de e-mail. Para fazer referência a um endereço de e-mail usando um script, crie uma inclusão de script e chame a inclusão de script no CC campo. Seu script deve começar com javascript: prefixo. O script deve retornar endereços de e-mail em uma cadeia de caracteres separada por vírgulas.

      Este campo não pode ter os mesmos endereços que Para campo.
      Cco

      Insira uma lista separada por vírgulas de nomes de campo que contenham endereços de e-mail do usuário ou endereços de e-mail específicos. Para fazer referência a um endereço de e-mail usando um script, crie uma inclusão de script e chame a inclusão de script no Cco campo. Seu script deve começar com javascript: prefixo. O script deve retornar endereços de e-mail em uma cadeia de caracteres separada por vírgulas.

      Este campo não pode ter os mesmos endereços que Para ou CC campos.
    6. Em Configuração do remetente , selecione Do Tipo de geração Método para determinar como o remetente (endereço do remetente) na mensagem do cliente de e-mail é gerado.
      TipoDescrição
      Nenhum(a) O endereço do remetente não é gerado na mensagem do cliente de e-mail.
      Conta de e-mail SMTP Use o endereço De da conta de e-mail SMTP da instância como remetente.
      Selecionar da lista Escolha em uma lista de endereços de origem permitidos definidos na tabela Endereço do remetente do cliente de e-mail [sys_email_client_from_address].
      Script Execute uma consulta GlideRecord na tabela Endereço do remetente do cliente de e-mail [sys_email_client_from_address].
      Por exemplo, o script a seguir define o endereço De com base no local do solicitante do incidente:
      (function (fromAddressQuery, targetRecord) {
    // targetRecord is incident for this template
    var location = targetRecord.caller_id.country;

    if (location == 'us')
        fromAddressQuery.addQuery('email_address', 'servicedesk.us@example.com');
    else if (location == 'japan')
        fromAddressQuery.addQuery('email_address', 'servicedesk.jp@example.com');
    else if (location == 'uk')
        fromAddressQuery.addQuery('email_address', 'servicedesk.uk@example.com');

})(fromAddressQuery, targetRecord);
      Texto Insira o endereço de e-mail do remetente a ser usado no cliente.
      Endereços de e-mail do usuário Para integrar caixas de correio corporativas pessoais de usuários ou agentes com ServiceNow para enviar e receber e-mails.
      Nota:
      Isso requer um plug-in, consulte
      Use este método somente se quiser um endereço De diferente do definido em sua conta de e-mail SMTP.
      Nota:

      O endereço de e-mail do remetente não aparece no cliente de e-mail, a menos que você configure um cliente de e-mail para exibir o endereço do remetente. Para obter mais informações sobre como gerenciar o comportamento de um cliente de e-mail, consulte Configurações do cliente de e-mail.

      Se o domínio do endereço de origem não for o domínio do servidor da conta de e-mail SMTP, o proprietário do endereço de domínio de origem deverá configurar o registro SPF para o domínio. O proprietário muda as configurações do domínio para permitir que a instância envie um e-mail como se desse domínio. Para obter mais informações sobre como usar registros SPF, consulte ServiceNow KB0535456 .

    7. Selecione Enviar.
      O modelo é adicionado à tabela Modelos de cliente de e-mail [sys_email_client_template].

    Aplique um modelo de cliente de e-mail

    Depois de criar um modelo de cliente de e-mail, você pode aplicá-lo a um e-mail.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    As etapas a seguir são implementadas somente após a criação de um modelo de cliente de e-mail

    Procedimento

    1. Clique no ícone de reticências (...) na parte superior do modelo para aplicar o modelo a um e-mail.
    2. Selecione E-mail .
    3. Preencha os campos para compor um e-mail.
      Consulte Crie um modelo de cliente de e-mail para obter detalhes do campo.
      Nota:
      O corpo do e-mail é preenchido com os detalhes do registro do incidente. Se você modificar um ou mais campos no registro de incidente e não forem salvos, as mudanças não salvas ainda serão refletidas no corpo do e-mail.
      Nota:
      2000 caracteres é o limite total para todas as mudanças no registro do incidente. Se algumas de suas mudanças não forem refletidas e ficarem truncadas no corpo do e-mail, isso ocorre porque o limite total de mudanças é superior a 2000 caracteres.

    Crie um modelo de resposta de cliente de e-mail

    Agora você pode criar modelos de resposta de cliente de e-mail personalizados que oferecem suporte a condições.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    O modelo de cliente de e-mail é aplicado automaticamente no cliente de e-mail com base na tabela especificada, nas condições e na ordem de execução.

    Procedimento

    1. Navegar até Tudo > Cliente de e-mail > Modelos de cliente de e-mail.
      As seguintes opções para Modelo de resposta - Recebido e. Modelo de resposta - Enviado aparecer.
    2. Clique em uma das opções disponíveis para criar um modelo para essa opção selecionada.
    3. Preencha os campos na parte superior do formulário Modelo de cliente de e-mail.
      Campo Descrição
      Nome Nome do modelo preenchido automaticamente com base na opção de modelo selecionada.
      Nota:
      Esse é um campo somente leitura.
      Tabela Nome da tabela preenchido automaticamente.
      Nota:
      Este é um campo somente leitura porque, para modelos de resposta, o nome da tabela é sempre sys_email.
      Condições As condições que determinam quando este modelo de resposta do cliente é usado. Use o construtor de condições para identificar o registro de destino que deve corresponder antes que este modelo seja aplicado.
      Nota:
      Se as condições não forem verdadeiras, o cliente de e-mail obterá o modelo padrão.

      Selecione o nome da tabela de destino nas condições às quais o modelo se aplica. Habilite o modelo de resposta para a mesma tabela.

      Imagem mostrando a tabela de destino
      Aplicação O tipo de aplicação com escopo.
      Ordem de Execução Um número que indica a ordem na qual as condições do modelo são avaliadas.
    4. Preencha os campos em Conteúdo .
      Campo Descrição
      Assunto Insira uma descrição do e-mail.
      Nota:
      . Assunto o campo no cliente de e-mail permite uma contagem de caracteres maior do que a configuração padrão para Assunto Campo na tabela E-mail [sys_email]. Se o texto do assunto do cliente estiver sendo truncado, aumente Tamanho máximo valor para Assunto Campo na tabela E-mail.
      Tipo de conteúdo Selecione o formato do conteúdo do corpo da mensagem: HTML ou texto sem formatação.
      HTML do corpo

      Se você selecionou HTML para Tipo de conteúdo , Insira o conteúdo do corpo da mensagem usando a barra de ferramentas do editor de HTML para formatar o HTML.

      Para fazer referência a valores de campo, selecione variáveis na lista Variáveis ou digite manualmente as referências de variáveis usando a sintaxe (table_name.variable_name) . Para fazer referência ao usuário que inicia o cliente de e-mail, insira a variável (current_user) .
      Nota:
      As quebras de linha não aparecem para campos de várias linhas, como descrição e comentários no modelo de cliente de e-mail.

      Você pode chamar um script de e-mail usando mail_script:nome do script em HTML do corpo campo.
      Corpo do texto

      Se você selecionou texto sem formatação para Tipo de conteúdo , insira qualquer texto ou script de e-mail que você deseja que apareça no corpo da mensagem.

      Você pode inserir um script de e-mail no Texto do corpo usando a seguinte sintaxe:
      <mail_script> [code] </mail_script>
    5. Preencha os campos em Destinatários .
      Campo Descrição
      Para Insira uma lista separada por vírgulas de nomes de campo que contenham endereços de e-mail do usuário ou endereços de e-mail específicos. Para fazer referência a um endereço de e-mail usando um script, crie uma inclusão de script e chame a inclusão de script no Para campo. Seu script deve começar com javascript: prefixo. O script deve retornar endereços de e-mail em uma cadeia de caracteres separada por vírgulas.
      Cc

      Insira uma lista separada por vírgulas de nomes de campo que contenham endereços de e-mail do usuário ou endereços de e-mail específicos. Para fazer referência a um endereço de e-mail usando um script, crie uma inclusão de script e chame a inclusão de script no CC campo. Seu script deve começar com javascript: prefixo. O script deve retornar endereços de e-mail em uma cadeia de caracteres separada por vírgulas.

      Este campo não pode ter os mesmos endereços que Para campo.
      Cco

      Insira uma lista separada por vírgulas de nomes de campo que contenham endereços de e-mail do usuário ou endereços de e-mail específicos. Para fazer referência a um endereço de e-mail usando um script, crie uma inclusão de script e chame a inclusão de script no Cco campo. Seu script deve começar com javascript: prefixo. O script deve retornar endereços de e-mail em uma cadeia de caracteres separada por vírgulas.

      Este campo não pode ter os mesmos endereços que Para ou CC campos.
    6. Em Configuração do remetente , selecione Do Tipo de geração Para determinar como o remetente (endereço do remetente) na mensagem do cliente de e-mail é gerado.
      Use este campo somente se quiser um endereço De diferente do definido em sua conta de e-mail SMTP.
      • Nenhum: O endereço do remetente não é gerado na mensagem do cliente de e-mail.
      • Conta de e-mail SMTP: Use o endereço De da conta de e-mail SMTP da instância como remetente.
      • Selecionar da lista: Escolha em uma lista de endereços de origem permitidos definidos na tabela Endereço do remetente do cliente de e-mail [sys_email_client_from_address].
      • Script: Execute uma consulta GlideRecord na tabela Endereço do remetente do cliente de e-mail [sys_email_client_from_address].
        Por exemplo, o script a seguir define o endereço De com base no local do solicitante do incidente:
        (function (fromAddressQuery, targetRecord) {
    // targetRecord is incident for this template
    var location = targetRecord.caller_id.country;

    if (location == 'us')
        fromAddressQuery.addQuery('email_address', 'servicedesk.us@example.com');
    else if (location == 'japan')
        fromAddressQuery.addQuery('email_address', 'servicedesk.jp@example.com');
    else if (location == 'uk')
        fromAddressQuery.addQuery('email_address', 'servicedesk.uk@example.com');

})(fromAddressQuery, targetRecord);
      • Texto: Insira o endereço de e-mail do remetente a ser usado no cliente.
      Nota:
      O endereço de e-mail do remetente não aparece no cliente de e-mail, a menos que você configure o cliente de e-mail para exibir o endereço do remetente. Para obter mais informações sobre como gerenciar o comportamento do cliente de e-mail, consulte Configurações do cliente de e-mail.

      Se o domínio do endereço de origem não for o domínio do servidor da conta de e-mail SMTP, o proprietário do domínio de origem deverá configurar o registro SPF para o domínio. O proprietário muda as configurações do domínio para permitir que a instância envie e-mails como se desse domínio. Para obter detalhes sobre como usar registros SPF, consulte ServiceNow KB0535456 .

    7. Clique em Enviar.