NWS letter

NWS letter

Project Description

The Python Automated Email Newsletter Sending Script offers an effective and automated way to send newsletters to a list of subscribers.

.

Table of Contents

• NWS letter
  • Project Description
• Table of Contents
• About
• Installation
• How to Use
  • Prerequisites
• Technologies

About

The Python script automates the sending of newsletters via email to a list of subscribers. It uses the Gmail API to create and send customized emails from a defined sender to recipients in a CSV file. With a graphical interface, users enter the subject and content, which are sent to all subscribers. The script handles errors and simplifies communication with subscribers, making information sharing efficient and personalized.

Installation

1. Install Python on your computer.

2. Verify the installation in the Command Prompt by typing:

    python3
   

3. Clone the repository using the following command:

    # Clone the repo
    $ git clone https://github.com/ravimughal/newsletter.git
   

4. Access the Google Developer Console: Go to https://console.developers.google.com/ and log in to your Google account.

5. Create a New Project: In the Developer Console, click the “Select a project” button in the top left corner, then click “New Project.” Give the project a name and select the appropriate options. Click “Create.”

6. Activate the Gmail API: In the project dashboard, click “Enable APIs and Services.” Search for “Gmail” and click “Gmail API.” Then, click the “Enable” button.

7. Create Credentials: In the left-hand menu, click “Credentials.” Next, click “Create credentials” and choose “OAuth Client ID.” Select “Desktop App” as the application type.

8. Configure the Credentials: Fill in the application details such as the name and icon. You can add “http://localhost” to the authorized redirect URLs for testing purposes. Click “Create” to create the credentials.

9. Download the Credentials: In the list of credentials, you’ll see the new credential you created. Click the download icon next to it to download the JSON file containing authentication information.

10. Use the Credentials: In your code, use the JSON credentials file to authenticate your application and access the Gmail API. Place the ‘path_to_credentials.json’ file in the NEWSLETTER folder.

11. In your code, replace ‘testedasilvafilho@gmail.com’ with your email address in the ‘main.py’ file:

    sender_email = 'testedasilvafilho@gmail.com'
    

    Also, replace ‘testedasilvafilho@gmail.com’ with your email in the ‘email_utils.py’ file:

    if sender == 'testedasilvafilho@gmail.com':
    

How to Use

1. Navigate to the ‘newsletter’ directory in your Command Prompt and run ‘main.py’ using the following command:

    cd newsletter
    python main.py
   

2. Enter the email subject and message content that will be sent to the emails listed in ‘lista_assinantes.csv.’

   

3. Access the email account you registered during the installation.

Prerequisites

1. A Gmail account.

2. Python installed on your machine. You can download it here.

Technologies

UNDER DEVELOPMENT 🚧 </h