Introdução
Você precisa enviar milhares de e-mails personalizados para seus clientes ou contatos – mas não quer compartilhar seus contatos com um serviço SaaS de terceiros – como MailChimp ou HubSpot, ou… talvez você não queira gastar uma fortuna? Criamos um modelo de planilha com um script em Python para enviar e-mails customizados automaticamente a partir do seu computador pessoal. Diferente de outros serviços de e-mail online, esta ferramenta é gratuita e executada diretamente em seu computador — garantindo que sua lista de e-mails, conteúdo, anexos e credenciais permaneçam privados e seguros. Além disso, você pode escolher entre diversos estilos e opções de e-mail para adaptar sua mensagem a cada destinatário.
Neste artigo, você aprenderá como:
- Configurar a planilha com suas credenciais para envio de e-mails;
- Instalar e configurar o Python em seu computador;
- Executar o script para enviar e-mails automaticamente.
Com nosso modelo, você recebe um arquivo compactado contendo a planilha, o script em Python e arquivos auxiliares.Depois de descompactar ou extrair nosso modelo, certifique-se de manter todos os arquivos na mesma pasta extraída. Lembre-se de que a planilha modelo é fundamental para o funcionamento correto do script em Python. Não altere nomes de colunas, campos ou a estrutura geral. Edite apenas os campos destacados em azul.
Modelo de planilha
Configurações de e-mail
Nosso modelo de planilha possui uma aba que reúne todas as configurações e parâmetros necessários para o envio dos e-mails. Na aba 'Campos', defina o tipo de conexão, se deseja incluir um anexo, a linha da planilha a partir da qual o envio deve começar, e a opção de adicionar uma assinatura ao final de todos os seus e-mails.
Conexão SMTP vs. API do Gmail
O modelo oferece duas opções de conexão. Uma delas é SMTP, adequada para servidores de e-mail como Hotmail, Outlook e Yahoo; a outra é a conexão via API do Gmail, indicada para usuários do Google — seja Gmail ou Google Worksuite. Selecione o tipo de conexão através do menu suspenso. Para conexões SMTP, será necessário informar os dados do servidor e porta do seu provedor de e-mail.Esta informação pode ser encontrada pesquisando online – basta procurar "[nome] configurações de servidor SMTP e porta" – por exemplo – "Yahoo configurações de servidor SMTP e porta."
Ao utilizar SMTP, será necessário inserir suas credenciais de e-mail no modelo, como seu endereço de e-mail e senha. Fique tranquilo, esses dados permanecem totalmente locais em seu computador e não são compartilhados com ninguém. Para maior privacidade, você pode até ocultar esses campos dentro do modelo. No entanto, uma vez que a planilha contenha suas credenciais, não compartilhe a planilha com terceiros.
Por outro lado, se optar pela conexão via API do Google, não será necessário fornecer detalhes adicionais de SMTP. A API do Google gerencia tudo, estabelecendo a conexão automaticamente quando o script Python é executado. O único requisito é acessar sua conta do Gmail ou Google Worksuite normalmente. Os dados de login não são armazenados ou salvos, portanto, será necessário fazer login toda vez que utilizar o script. Isso garante que suas informações permaneçam privadas e seguras.
Configurações gerais
Outras opções configuráveis incluem a adição de um anexo e de uma assinatura aos seus e-mails enviados. Para habilitar anexos, selecione "Sim" no menu correspondente. Quando o script for executado, você será solicitado a escolher o arquivo que será anexado aos seus e-mails. Da mesma forma, para ativar a assinatura, escolha "Sim" e personalize sua assinatura conforme desejar. Uma pré-visualização da formatação estará disponível ao lado para que você veja como sua assinatura aparecerá nos e-mails.
Por fim, é possível selecionar a linha a partir da qual os e-mails devem começar a ser enviados. Por exemplo, se houver 100 endereços de e-mail em sua lista, mas você deseja enviar apenas para os últimos 50, é possível ajustar o ponto de início. Este recurso é especialmente útil caso ocorra algum problema durante o envio e seja necessário reiniciar a partir do meio da lista, evitando o envio duplicado.
Lista de e-mails
Destinatários de e-mail
Nosso modelo permite que você envie e-mails personalizados para todos os seus contatos, integrando campos customizados ao conteúdo do e-mail que você redigir.Personalizar e-mails é fundamental, pois aumenta as chances de suas mensagens chegarem diretamente à caixa de entrada dos destinatários. Além disso, permite que você envie URLs, datas, informações e dados específicos para cada contato de forma individualizada.
Em vez de criar e-mails separados para cada destinatário, nosso modelo irá mesclar os campos personalizados que você definiu para cada contato no corpo e no assunto do e-mail – substituindo [Column1] até [Column10]. O script em Python fará essa substituição automaticamente com os dados reais à medida que os e-mails forem enviados. Isso elimina a necessidade de criar e-mails individualizados para cada pessoa. Basta usar a criatividade ao definir esses campos.
Conteúdo do e-mail
Neste modelo, é possível criar até seis opções de conteúdo de e-mail. Cinco dessas abas são para e-mails padrão, enquanto a sexta pode ser personalizada com um layout baseado em HTML. Mas não se preocupe, você não precisa ter conhecimento em HTML! Vamos começar pelas abas de e-mails padrão. O layout desses e-mails não é personalizável. No entanto, você pode editar livremente o conteúdo das mensagens que deseja enviar.[double]
Para e-mails que exigem uma aparência mais personalizada, a aba 'E-mail HTML' é ideal. Nesta aba, os usuários podem ajustar estilos de texto, adicionar links e selecionar tipos de títulos. Essas personalizações podem ser escolhidas utilizando os menus suspensos ao lado de cada opção.
Após cada seleção, o e-mail será atualizado automaticamente, criando uma aparência bem organizada. E lembre-se: todas as configurações aplicadas na aba 'Campos' são mantidas. Portanto, se assinaturas ou anexos estiverem habilitados, eles serão incorporados em todos os e-mails.
Script Python
Antes de executar nosso script em Python, é necessário instalar o Python em seu computador. Python é uma linguagem de programação simples que funciona em computadores Windows, Mac e Linux. Sem o Python, nosso script não funcionará e seus e-mails não serão enviados — mesmo com o modelo configurado corretamente.
Instalação do Python
Para configurar o Python, siga estes passos:
- Acesse o site oficial do Python: Site do Python
- Clique em 'Downloads' e escolha a versão 3.11 ou superior.
- Execute o instalador baixado para iniciar o processo de instalação.
Nota: Usuários do Windows devem marcar a opção "Add Python to PATH" durante a instalação. Caso esqueça este passo, desinstale o Python e reinstale, certificando-se de selecionar a opção de adicionar ao PATH. Esta etapa é fundamental para a execução futura do script utilizando o "Prompt de Comando" do Windows.
Bibliotecas Python
As bibliotecas Python ampliam as capacidades de um script, permitindo funcionalidades como integração com a API do Gmail ou leitura de arquivos Excel. Todas as bibliotecas essenciais para esta ferramenta estão detalhadas no arquivo "requirements.txt" fornecido, facilitando o download. Sem elas, o script não funcionará. Esta configuração precisa ser feita apenas uma vez.
Extraia ou descompacte nosso modelo em uma pasta de sua preferência; tanto no Windows quanto no Mac, nosso modelo será extraído para uma pasta chamada "email_sender". Agora vamos explicar como instalar as bibliotecas necessárias e executar o remetente de e-mails no Windows, e posteriormente explicaremos o mesmo para Macs.
Abaixo está um guia passo a passo para instalar essas bibliotecas Python:
Windows
- No Windows, clique com o botão direito na pasta e selecione "Copiar como caminho" para poder colar posteriormente.
- Abra o "Prompt de Comando" no Windows
- Dentro do Prompt de Comando, digite "cd" e cole o caminho da pasta onde os arquivos foram colocados.Aqui está um exemplo se a pasta estiver na sua Área de Trabalho: cd C:\Users\example_user\Desktop\email_sender
- Em seguida, pressione "Enter" para acessar a referida pasta
- Dentro da pasta, digite: pip3 install -r requirements.txt
- E pressione "Enter". Isso fará o download de todos os arquivos necessários para garantir o funcionamento do remetente de e-mails.
- Por fim, após configurar a planilha do Excel, você pode começar a enviar os e-mails digitando: python3 email_sender.py
- E pronto – pressione "Enter" e seus e-mails começarão a ser enviados.
Enquanto os e-mails estão sendo enviados, você poderá visualizar todos os registros e detalhes no Prompt de Comando. A partir de agora, não será necessário reinstalar as bibliotecas repetidamente. Para enviar e-mails novamente, basta acessar sua pasta pelo "Prompt de Comando" e digitar o último comando "python3".
Para Macs
- Clique com o botão direito na pasta chamada "email_sender" – que é a pasta criada quando você extraiu ou descompactou nosso modelo.
- Em seguida, selecione "Novo Terminal na Pasta" – isso abrirá um novo prompt de comando Terminal automaticamente na pasta extraída.
- Por fim, digite: pip3 install -r requirements.txt
- E pressione "Return"; isso fará o download e instalará todas as bibliotecas necessárias para o remetente de e-mails.
- Por último, após configurar sua planilha Excel, digite: python3 email_sender.py
- E pressione "Return"; isso iniciará o envio dos seus e-mails personalizados.
Assim como nas instruções para Windows, não é necessário reinstalar as bibliotecas repetidamente. Para começar a enviar e-mails, basta retornar à sua pasta pelo "Terminal" e digitar novamente o último comando "python3".
Fluxo de trabalho do script Python
O script Python funciona de maneira direta. Primeiro, ele verifica o arquivo Excel para obter todos os detalhes de configuração que você inseriu na aba Campos. Se você ativou anexos de arquivos, por exemplo, ele solicitará que você selecione qual arquivo deseja anexar a todos os seus e-mails.
Utilizando a opção de conexão SMTP, o script estabelecerá uma conexão com o provedor de e-mail especificado. Caso utilize a opção da API do Gmail, o script abrirá uma página da web para que você faça login em sua conta do Gmail ou Google Worksuite.
Desenvolvemos este recurso de API especificamente para esta finalidade. Para funcionar corretamente, certifique-se de conceder permissão ao Python para utilizar seus dados de login. Conforme destacado pelo Python, o único objetivo deste acesso é o envio de e-mails. Suas informações de login e quaisquer outros dados não serão compartilhados com a You Exec nem armazenados pelo Python. Após conceder todas as permissões necessárias, você receberá uma mensagem de confirmação indicando que o acesso foi autorizado.
Após a confirmação das credenciais, o script inicia o processo de envio dos e-mails. Para cada e-mail enviado, o Prompt de Comando ou Terminal exibirá uma mensagem de confirmação indicando o tipo de e-mail e o destinatário. Esse processo continua até que todos os e-mails sejam enviados. Ao final, um relatório resumido apresentará o total de e-mails enviados e o tempo gasto na operação.Se ocorrer um erro durante o envio dos e-mails, o script irá notificá-lo e indicar qual foi o último e-mail enviado. Isso permite que você retome o envio a partir do ponto em que parou na próxima vez que iniciar o processo. Para isso, basta alterar o campo "Iniciar envio de e-mails a partir da linha" no arquivo Excel.
O script também foi desenvolvido com proteções. Ele consegue identificar situações que possam impedir o funcionamento adequado, como falta de conexão com a internet, modelo não preenchido corretamente ou alterações na estrutura dos arquivos originais. Por fim, para quem utiliza o Google Sheets, o funcionamento é semelhante. Basta baixar a versão em Excel selecionando "Arquivo > Fazer download > Microsoft Excel" e colocar esse arquivo na mesma pasta dos demais documentos. Você pode sempre substituir por uma versão mais recente, conforme necessário.
Conclusão
Esperamos que esta ferramenta ajude a otimizar o seu processo de envio de e-mails. Ficaremos felizes em saber sobre sua experiência ou caso tenha alguma dúvida.Ao utilizar este modelo, caso tenha sugestões de funcionalidades, compartilhe seu feedback conosco para que possamos continuar aprimorando este remetente de e-mails. Muito obrigado por assistir.
