Nível de programação: iniciante
Duração: 10 minutos
Tipo de projeto: automação com um menu personalizado
Prefere aprender com vídeos?
O canal Google Workspace Developers inclui vídeos com dicas, sugestões e os recursos mais recentes.
|
Objetivos
- Entenda o que a solução faz.
- Entenda o que os serviços do Apps Script fazem no solução.
- Configure o script.
- Execute o script.
Sobre esta solução
Preencher automaticamente um modelo de e-mail com dados das Planilhas Google. A e-mails são enviados da sua conta do Gmail para que você possa responder a as respostas dos destinatários.
Importante: esta amostra de mala direta está sujeita aos limites de e-mail descritos em Cotas para serviços do Google.
Como funciona
Você cria um modelo de rascunho do Gmail com marcadores de posição que e correspondem aos dados em uma planilha do Planilhas. O cabeçalho de cada coluna em uma planilha representa uma tag de marcador. O script envia as informações cada marcador de posição da planilha para o local tag de marcador de posição no rascunho de e-mail.
Serviços do Apps Script
Esta solução usa os seguintes serviços:
- Serviço do Gmail: recebe, lê
e envia o rascunho que você quer enviar aos destinatários.
- Se o e-mail incluir caracteres Unicode, como emojis, use o Serviço de e-mail. Saiba como atualizar o código para incluir caracteres Unicode no e-mail.
- Serviço de planilha: preenche o e-mail. espaços reservados com as informações personalizadas para para cada um dos destinatários.
Pré-requisitos
Para usar este exemplo, você precisa dos seguintes pré-requisitos:
- Uma Conta do Google (as contas do Google Workspace podem precisam da aprovação do administrador).
- Um navegador da Web com acesso à Internet.
Configurar o script
Criar o projeto do Apps Script
- Clique no botão a seguir para copiar
Exemplo de planilha mala direta do Gmail/Planilhas Google.
O projeto do Apps Script para este
solução está anexada à planilha.
Fazer uma cópia - Na planilha copiada, atualize a coluna Destinatários com o e-mail endereços que você quer usar na mala direta.
- (Opcional) Adicione, edite ou remova colunas para personalizar os dados que você quer incluir no seu modelo de e-mail.
Se você alterar o nome do Destinatário ou do E-mail Enviado, é preciso atualizar o código correspondente na projeto do Apps Script. Você pode abrir o Apps Script projeto da planilha, Clique em Extensões >. Apps Script.
Criar um modelo de e-mail
- Na sua conta do Gmail, crie um rascunho de e-mail. Para incluir dados
do
planilha em seu e-mail, use espaços reservados que correspondam aos nomes das colunas
entre chaves, como
{{First name}}
.- Se você formatar o texto no e-mail, também será preciso formatar o marcador de posição os colchetes.
- Os marcadores diferenciam maiúsculas de minúsculas e precisam corresponder exatamente aos cabeçalhos das colunas.
- Copie a linha de assunto do rascunho do e-mail.
Executar o script
- Na planilha, clique em Mesclagem de e-mails >. Enviar e-mails. Talvez seja necessário atualizar a página para esse menu personalizado. aparecer.
Quando solicitado, autorize o script. Se a tela de permissão OAuth exibir o aviso Este app não foi verificado, continue selecionando Avançado > Acesse {Project Name} (não seguro).
Clique em Mesclagem de e-mails > Enviar e-mails de novo.
Cole a linha de assunto do modelo de e-mail e clique em OK.
Se você aplicar um filtro à planilha, o script ainda vai enviar um e-mail participantes, mas não adicionará o carimbo de data/hora.
Revisar o código
Para revisar o código do Apps Script para esta solução, clique em Veja o código-fonte abaixo:
Acessar o código-fonte
Code.gs
Modificações
Você pode editar a automação de mala direta como quiser. Abaixo estão algumas mudanças opcionais que você pode fazer no código-fonte.
Adicionar parâmetros de e-mail Cco, Cc, ReplyTo ou De
O exemplo de código inclui vários parâmetros adicionais, atualmente que permitem controlar o nome da conta para a qual o e-mail é enviado responder a endereços de e-mail e endereços de e-mail Cco e Cc.
Ative os parâmetros que você quer adicionar removendo as barras
//
na frente de cada um.
O exemplo a seguir mostra um trecho do sendEmails
que ativa a maioria dos parâmetros de e-mail:
GmailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, { htmlBody: msgObj.html, bcc: 'bcc@example.com', cc: 'cc@example.com', from: 'from.alias@example.com', name: 'name of the sender', replyTo: 'reply@example.com', // noReply: true, // if the email should be sent from a generic no-reply email address (not available to gmail.com users)
No exemplo acima, o parâmetro noReply
ainda está comentado
porque o parâmetro replyTo
está definido.
Incluir caracteres Unicode nos e-mails
Se quiser incluir caracteres Unicode, como emojis, em seus e-mails, você precisa atualizar o código para usar o serviço de e-mail em vez do serviço do Gmail.
No exemplo de código, atualize a seguinte linha:
GmailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, {
Substitua a linha por este código:
MailApp.sendEmail(row[RECIPIENT_COL], msgObj.subject, msgObj.text, {
Colaboradores
A amostra foi criada por Martin Hawksey, líder de design e tecnologia de aprendizado na Edinburgh Futures Institute, blogueiro e Google Developer Expert.
- Encontre Martin no Twitter @mhawksey.
- Leia as postagens do blog relacionadas ao Google Apps Script de Martin.
- Assista ao programa de Martin no YouTube, Totally Unscripted.
Este exemplo é mantido pelo Google com a ajuda de especialistas do Google Developers.