Criar uma mesclagem de e-mails com o Gmail e o Planilhas Google

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nível de programação: iniciante
Duração: 10 minutos
Tipo de projeto: automação com um menu personalizado

Sobre esta solução

Preencha automaticamente um modelo de e-mail com dados do Planilhas Google. Os e-mails são enviados da sua conta do Gmail para que você possa responder às respostas dos destinatários.

exemplo de mala direta

Como funciona

Você cria um modelo de rascunho do Gmail com marcadores que correspondem aos dados em uma planilha do Planilhas Google. Cada cabeçalho de coluna em uma página representa uma tag de marcador de posição. O script envia as informações de cada marcador de posição da planilha para o local da tag de marcador correspondente no rascunho de e-mail.

Serviços do Apps Script

Essa solução usa os seguintes serviços:

Antes de começar

Para usar esta amostra, você precisa dos seguintes pré-requisitos:

  • Uma Conta do Google (Google Workspace contas podem precisar da aprovação do administrador)
  • Um navegador da Web com acesso à Internet

Testar

Etapa 1: configurar a planilha

  1. Clique no botão abaixo para fazer uma cópia da planilha de amostra Mesclagem de e-mails do Gmail/Planilhas.
    Fazer uma cópia
  2. Atualize a coluna Destinatários com os endereços de e-mail que você quer usar na mesclagem de e-mails.
  3. (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 das colunas Destinatário ou E-mail enviado, será necessário atualizar o código correspondente no projeto do Google Apps Script. Para abrir o projeto do Apps Script na planilha, clique em Extensões > Apps Script.

Etapa 2: criar um modelo de e-mail

  1. Na sua conta do Gmail, crie um rascunho de e-mail. Para incluir dados da planilha no e-mail, use marcadores que correspondam aos nomes das colunas entre chaves, como {{First name}}.
    • Se você formatar o texto no e-mail, formate também os colchetes do marcador.
    • Os marcadores de posição diferenciam maiúsculas de minúsculas e precisam corresponder exatamente aos cabeçalhos das colunas.
  2. Copie o assunto do rascunho do e-mail.

Etapa 3: enviar e-mails

  1. Na planilha, clique em Mesclar e-mails > Enviar e-mails. Talvez seja necessário atualizar a página para que esse menu personalizado apareça.
  2. Quando solicitado, autorize o script.
  3. Clique em Mail Merge > Send Emails novamente.
  4. Cole o assunto do modelo de e-mail e clique em OK.

Se você aplicou um filtro à planilha, o script ainda envia os participantes filtrados, mas não adiciona o carimbo de data/hora.

Abra o projeto do Apps Script

O exemplo de código inclui scripts in-line para ajudar você a entender como ele funciona. Para acessar o código, na planilha, clique em Extensões > Apps Script.

Modificações

Você pode editar a automação da mesclagem de e-mails o quanto quiser. Veja abaixo algumas mudanças opcionais que você pode fazer no código-fonte.

Adicionar parâmetros Cco, Cc, ReplyTo ou De e-mail

O exemplo de código inclui vários outros parâmetros, atualmente comentários, que permitem controlar o nome da conta a partir da qual o e-mail é enviado, responder a endereços de e-mail, bem como endereços de e-mail Cco e Cc.

Para ativar os parâmetros que você quer adicionar, remova as barras // antes de cada um.

O exemplo a seguir mostra um trecho da função 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)

Na amostra acima, o parâmetro noReply ainda está comentado porque o parâmetro replyTo está definido.

Incluir caracteres Unicode nos seus e-mails

Se você quiser incluir caracteres Unicode, como emojis, nos seus e-mails, precisará 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 pelo seguinte 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 aprendizagem do Edinburgh Futures Institute, blogueiro e Especialista do Google Developers.

Essa amostra é mantida pelo Google com a ajuda dos Especialistas do desenvolvedor do Google.