Um Google Apps Script que envia e-mails personalizados do seu Gmail para as pessoas da sua planilha do Google

Exemplo de resultado

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Pasta: sales/2026-10, 9 arquivos encontrados
2026-11-02 09:14:03 INFO  shop-01.csv: 1.284 linhas
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 linhas
2026-11-02 09:14:04 WARN  shop-07.csv: 3 linhas sem preço ignoradas (linhas 88, 412, 913)
2026-11-02 09:14:05 INFO  Pronto: 10.412 linhas -> report-2026-10.xlsx (abas "Vendas" e "Totais")

[columns]
date = Data, Data da venda, Dia
product = Produto, Item, Descrição
quantity = Qtd, Quantidade, Unid
price = Preço, Preço unitário

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Lê o arquivo de uma loja e dá a ele os nomes de colunas do relatório."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: nenhuma coluna para '{name}' (procuradas: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

Sobre este serviço

Quando você precisa escrever o mesmo e-mail para 80 clientes, alunos ou parceiros com o nome, a data ou o valor de cada um, copiar e colar leva horas. Este Google Apps Script fica na sua planilha do Google e envia a cada linha um e-mail personalizado do seu próprio Gmail: preenche {{Name}}, {{Date}} e qualquer outra coluna no seu modelo, grava Enviado e a hora na linha e pula as linhas já enviadas, então você pode rodá-lo de novo com segurança. Ele é feito para a sua própria lista de pessoas que esperam os seus e-mails, não para listas compradas nem disparos em massa para quem não conhece você. O Google limita quantos e-mails um script pode enviar por dia, menos em um Gmail gratuito do que no Google Workspace; o script para no limite e continua depois. Você instala e roda na sua conta.

O que está incluído

• O que você recebeUm arquivo ZIP com o código do Apps Script e um README que mostra como colá-lo na sua planilha, autorizar o acesso e enviar; o código também aparece na página do pedido.
• Campos personalizadosQualquer coluna da planilha no assunto e no texto
• Do seu próprio GmailAs respostas voltam para você, como qualquer e-mail que você envia
• Marcas de envioCada linha mostra quando foi enviada, então nada sai duas vezes
• Dentro dos limites do GooglePara no limite diário e continua depois
• Código legívelCom comentários, fácil de mudar o modelo depois

Como funciona

1. 1
   TarefaVocê envia as colunas da planilha e o e-mail que quer enviar
2. 2
   CódigoEscrevemos o script e o guia de instalação
3. 3
   TesteVocê cola em uma cópia da planilha e envia primeiro para o seu próprio endereço
4. 4
   AjustesVocê pede ajustes dentro do seu pacote e envia qualquer mensagem de erro

O que precisamos de você

Os nomes das colunas da sua planilha e duas ou três linhas com nomes e endereços inventados, o assunto e o texto do e-mail com os lugares onde entram as colunas, e se é texto simples ou com formatação a partir de um rascunho do Gmail. Quem são as pessoas da lista e como elas entraram nela (seus clientes, associados, alunos), mais ou menos quantas linhas, e se você usa um Gmail gratuito ou o Google Workspace. Anexos, se houver, e onde eles ficam no seu Drive.

Vamos perguntar:

• Para quem você está escrevendo?
• Quais são as colunas da planilha?
• O que o e-mail deve dizer?
• Gmail gratuito ou Google Workspace?

Compare os pacotes

Perguntas e respostas

Não encontrou a resposta? Pergunte