--- sourceDocument: Yokohama Administração da Now Platform sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-administration Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Administração da Now Platform ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Crie um modelo de cliente de e-mail # Crie um modelo de cliente de e-mail {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://servicenow-prod.fluidtopics.net/oQHZ1im4GXZOIAuD3mc07Q "Os modelos de e-mail permitem que os administradores criem conteúdo reutilizável para a linha de assunto e o corpo da mensagem das notificações por 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. {#t_CreateAnEmailClientTemplate__ul_fsm_2hk_xfb} ## Procedimento 1. Navegar até TudoCliente de e-mailModelos de cliente de e-mail. 2. Selecione Novo. 3. No formulário, preencha os campos. {#t_CreateAnEmailClientTemplate__table_dpp_vtl_xfb__entry__2} | 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. | | Aplicação | O tipo de aplicação com escopo. | | Ordem de execução | Um número que indica a ordem em que 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 e. recebido modelos de resposta. Nota: Esta opção é aplicável somente para e-mail de resposta em um espaço configurável. | [Tabela 1. Modelo de cliente de e-mail] {#t_CreateAnEmailClientTemplate__table_dpp_vtl_xfb} 4. Em Conteúdo preencha os campos. {#t_CreateAnEmailClientTemplate__table_f5h_lsl_qq__entry__2} | 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 Comprimento 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 simples . | | 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 referenciar valores de campo, selecione variáveis na lista Variáveis ou digite manualmente 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 simples para Tipo de conteúdo insira qualquer script de texto ou 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: [code] | [Tabela 2. Guia Conteúdo] {#t_CreateAnEmailClientTemplate__table_f5h_lsl_qq} 5. Em Destinatários preencha os campos. {#t_CreateAnEmailClientTemplate__table_ybt_fcm_xfb__entry__2} | Campo | Ação | |-|-| | à(s) | 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, em seguida, 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, em seguida, 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, em seguida, 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. | [Tabela 3. Guia Destinatários] {#t_CreateAnEmailClientTemplate__table_ybt_fcm_xfb} 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. Use este método somente se você quiser um endereço de origem 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 origem 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 de 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 origem com base no local do chamador 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. {#t_CreateAnEmailClientTemplate__ul_tjn_b3m_xfb} 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](https://servicenow-prod.fluidtopics.net/6gVg7tq4wv81j0V9OkDFkw "Use as configurações do cliente de e-mail para gerenciar o comportamento do seu cliente de e-mail. Cada configuração consiste em diferentes controles de e-mail para definir destinatários de e-mail e endereços de e-mail permitidos."). 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 de 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](https://support.servicenow.com/kb_view.do?sysparm_article=KB0535456). 7. Selecione Enviar. O modelo é adicionado à tabela Modelos de cliente de e-mail \[sys_email_client_template\]. {#t_CreateAnEmailClientTemplate__steps_gzv_vvn_45b} **Tópicos relacionados** * [Inclusões de script](https://www.servicenow.com/docs/access?context=c_ScriptIncludes&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US) ## Aplique um modelo de cliente de e-mail {#ariaid-title2} 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 redigir um e-mail. Consulte [Crie um modelo de cliente de e-mail](https://servicenow-prod.fluidtopics.net/5BdVruyakmjIPM34YX2SIw#t_CreateAnEmailClientTemplate "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.")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 de todas as mudanças no registro de 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 do cliente de e-mail {#ariaid-title3} 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é TudoCliente de e-mailModelos 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. {#noti-email-client-response-template__table_dpp_vtl_xfb__entry__2} | 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. | | 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. | [ ] {#noti-email-client-response-template__table_dpp_vtl_xfb} 4. Preencha os campos em Conteúdo . {#noti-email-client-response-template__table_f5h_lsl_qq__entry__2} | 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 Comprimento 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 simples. | | 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 referenciar valores de campo, selecione variáveis na lista Variáveis ou digite manualmente 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: [code] | [ ] {#noti-email-client-response-template__table_f5h_lsl_qq} 5. Preencha os campos em Destinatários . {#noti-email-client-response-template__table_ybt_fcm_xfb__entry__2} | Campo | Descrição | |-|-| | à(s) | 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, em seguida, 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, em seguida, 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, em seguida, 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. | [ ] {#noti-email-client-response-template__table_ybt_fcm_xfb} 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 origem diferente do definido na 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 origem 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 de 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 origem com base no local do chamador 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. {#noti-email-client-response-template__ul_tjn_b3m_xfb} 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](https://servicenow-prod.fluidtopics.net/6gVg7tq4wv81j0V9OkDFkw "Use as configurações do cliente de e-mail para gerenciar o comportamento do seu cliente de e-mail. Cada configuração consiste em diferentes controles de e-mail para definir destinatários de e-mail e endereços de e-mail permitidos."). 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 de 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](https://support.servicenow.com/kb_view.do?sysparm_article=KB0535456). 7. Clique em Enviar.