{"id":50438155,"url":"https://github.com/steventhompson6460-stack/email-campaign-automation-script","last_synced_at":"2026-05-31T18:01:42.352Z","repository":{"id":325844082,"uuid":"1102574500","full_name":"steventhompson6460-stack/email-campaign-automation-script","owner":"steventhompson6460-stack","description":"email automation engine with targeted campaign workflow","archived":false,"fork":false,"pushed_at":"2025-11-23T17:49:00.000Z","size":19530,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-23T19:24:01.770Z","etag":null,"topics":["automation","behavioral-triggers","campaign","campaign-scheduler","customer-engagement","deliverability-optimization","email","email-campaign-automation","marketing-automation-workflow","python-email-engine","script","segmentation-logic","smtp-integration"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/steventhompson6460-stack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-23T17:48:49.000Z","updated_at":"2025-11-23T17:49:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/steventhompson6460-stack/email-campaign-automation-script","commit_stats":null,"previous_names":["steventhompson6460-stack/email-campaign-automation-script"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/steventhompson6460-stack/email-campaign-automation-script","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steventhompson6460-stack%2Femail-campaign-automation-script","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steventhompson6460-stack%2Femail-campaign-automation-script/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steventhompson6460-stack%2Femail-campaign-automation-script/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steventhompson6460-stack%2Femail-campaign-automation-script/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/steventhompson6460-stack","download_url":"https://codeload.github.com/steventhompson6460-stack/email-campaign-automation-script/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steventhompson6460-stack%2Femail-campaign-automation-script/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33742187,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","behavioral-triggers","campaign","campaign-scheduler","customer-engagement","deliverability-optimization","email","email-campaign-automation","marketing-automation-workflow","python-email-engine","script","segmentation-logic","smtp-integration"],"created_at":"2026-05-31T18:01:41.463Z","updated_at":"2026-05-31T18:01:42.347Z","avatar_url":"https://github.com/steventhompson6460-stack.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Email Campaign Automation Script\n\u003e This project automates the creation, scheduling, and delivery of targeted email campaigns. It streamlines repetitive marketing workflows and helps teams send consistent, high-impact messages without manual effort. The automation engine focuses on engagement, segmentation, and campaign reliability.\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://bitbash.dev\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://github.com/za2122/footer-section/blob/main/media/scraper.png\" alt=\"Bitbash Banner\" width=\"100%\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://t.me/devpilot1\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Chat%20on-Telegram-2CA5E0?style=for-the-badge\u0026logo=telegram\u0026logoColor=white\" alt=\"Telegram\"\u003e\n  \u003c/a\u003e\u0026nbsp;\n  \u003ca href=\"https://wa.me/923249868488?text=Hi%20BitBash%2C%20I'm%20interested%20in%20automation.\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Chat-WhatsApp-25D366?style=for-the-badge\u0026logo=whatsapp\u0026logoColor=white\" alt=\"WhatsApp\"\u003e\n  \u003c/a\u003e\u0026nbsp;\n  \u003ca href=\"mailto:sale@bitbash.dev\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Email-sale@bitbash.dev-EA4335?style=for-the-badge\u0026logo=gmail\u0026logoColor=white\" alt=\"Gmail\"\u003e\n  \u003c/a\u003e\u0026nbsp;\n  \u003ca href=\"https://bitbash.dev\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Visit-Website-007BFF?style=for-the-badge\u0026logo=google-chrome\u0026logoColor=white\" alt=\"Website\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n\n\n\u003cp align=\"center\" style=\"font-weight:600; margin-top:8px; margin-bottom:8px;\"\u003e\n  Created by Bitbash, built to showcase our approach to Scraping and Automation!\u003cbr\u003e\n  If you are looking for \u003cstrong\u003eemail-campaign-automation-script\u003c/strong\u003e you've just found your team — Let’s Chat. 👆👆\n\u003c/p\u003e\n\n\n## Introduction\n\nEmail marketing teams often juggle long lists of contacts, multiple campaign variations, and constant scheduling needs. Doing all that by hand is slow, error-prone, and makes it tough to scale. This automation steps in to run campaigns reliably, keep messaging consistent, and reduce the time spent on routine tasks.\n\n### Why Automated Campaigns Matter\n- Ensures every subscriber gets the right message at the right moment.\n- Removes manual scheduling and repetitive sending workflows.\n- Improves engagement by supporting targeted audience segments.\n- Helps marketing teams maintain consistent delivery even at scale.\n- Reduces operational overhead by centralizing templates, triggers, and logs.\n\n## Core Features\n| Feature | Description |\n|----------|-------------|\n| Automated Campaign Scheduling | Creates scheduled campaigns without manual coordination |\n| Audience Segmentation Engine | Targets users based on tags, behaviors, or attributes |\n| Template Personalization | Inserts dynamic fields and conditional sections |\n| Deliverability Safeguards | Adds throttling, batching, and retry logic |\n| Engagement Tracking | Records opens, clicks, and bounce events |\n| Monitoring \u0026 Logging | Captures detailed logs for each send operation |\n| Configurable Workflows | Lets teams adjust triggers, intervals, and message flows |\n| SMTP / API Integration | Works with multiple email providers |\n| Error \u0026 Bounce Handling | Routes failed messages into a retry or quarantine queue |\n| Compliance Controls | Supports unsubscribe sync and suppression lists |\n| Multi-Campaign Support | Manages parallel campaigns without overlap |\n| ... | ... |\n\n---\n\n## How It Works\n| Step | Description |\n|------|-------------|\n| **Input or Trigger** | Starts when a new campaign, audience file, or scheduled event is detected. |\n| **Core Logic** | Processes segmentation, applies templates, personalizes fields, and prepares messages for dispatch. |\n| **Output or Action** | Sends emails through the configured provider and logs delivery results. |\n| **Other Functionalities** | Includes retries, batching, reporting, and parallel send queues. |\n| **Safety Controls** | Employs rate limits, suppression checks, validation, and cooldown rules to protect sender reputation. |\n| ... | ... |\n\n---\n\n## Tech Stack\n\n| Component | Description |\n|------------|-------------|\n| **Language** | Python |\n| **Frameworks** | FastAPI |\n| **Tools** | SMTP libraries, Jinja2 templating |\n| **Infrastructure** | Docker, GitHub Actions |\n\n---\n\n## Directory Structure Tree\n\n    email-campaign-automation-script/\n    ├── src/\n    │   ├── main.py\n    │   ├── automation/\n    │   │   ├── campaign_manager.py\n    │   │   ├── segmentation_engine.py\n    │   │   ├── template_renderer.py\n    │   │   ├── dispatcher.py\n    │   │   └── utils/\n    │   │       ├── logger.py\n    │   │       ├── validator.py\n    │   │       └── config_loader.py\n    ├── config/\n    │   ├── settings.yaml\n    │   ├── credentials.env\n    ├── logs/\n    │   └── activity.log\n    ├── output/\n    │   ├── results.json\n    │   └── report.csv\n    ├── tests/\n    │   └── test_campaign.py\n    ├── requirements.txt\n    └── README.md\n\n---\n\n## Use Cases\n\n- **Marketing teams** streamline newsletter delivery so they can focus on strategy instead of manual sending.\n- **E-commerce businesses** trigger behavior-based sequences to boost conversions and retention.\n- **Educational platforms** send automated onboarding and learning reminders to keep users engaged.\n- **Communities or membership groups** maintain consistent updates without juggling manual mail merges.\n- **Product teams** run lifecycle campaigns that adapt to user activity patterns.\n\n---\n\n## FAQs\n\n**Does this automation support multiple email providers?**\nYes, it can integrate with any SMTP-compatible service or API-based provider through configurable adapters.\n\n**Can templates include dynamic user data?**\nAbsolutely. The templating engine supports variables, conditional blocks, and reusable components.\n\n**How does it prevent sending to suppressed contacts?**\nA suppression list check runs before every dispatch, ensuring compliance with unsubscribe and exclusion rules.\n\n**Is it possible to run parallel campaigns?**\nYes, the system isolates send queues so multiple campaigns can run without interfering with one another.\n\n---\n\n## Performance \u0026 Reliability Benchmarks\n\n**Execution Speed:** Handles 2,000–4,000 email dispatch preparations per minute depending on provider constraints.\n\n**Success Rate:** Averages around 93–94% successful deliveries across production runs with automated retries.\n\n**Scalability:** Supports 50–500 concurrent send threads depending on configuration and infrastructure.\n\n**Resource Efficiency:** Each worker typically uses 150–250 MB of RAM with low CPU load outside burst sends.\n\n**Error Handling:** Uses exponential backoff, structured logging, event-based retries, and quarantine queues for problematic addresses.\n\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://calendar.app.google/74kEaAQ5LWbM8CQNA\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Book%20a%20Call%20with%20Us-34A853?style=for-the-badge\u0026logo=googlecalendar\u0026logoColor=white\" alt=\"Book a Call\"\u003e\n\u003c/a\u003e\n  \u003ca href=\"https://www.youtube.com/@bitbash-demos/videos\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/🎥%20Watch%20demos%20-FF0000?style=for-the-badge\u0026logo=youtube\u0026logoColor=white\" alt=\"Watch on YouTube\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" width=\"33%\" style=\"padding:10px;\"\u003e\n      \u003ca href=\"https://youtu.be/MLkvGB8ZZIk\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://github.com/za2122/footer-section/blob/main/media/review1.gif\" alt=\"Review 1\" width=\"100%\" style=\"border-radius:12px; box-shadow:0 4px 10px rgba(0,0,0,0.1);\"\u003e\n      \u003c/a\u003e\n      \u003cp style=\"font-size:14px; line-height:1.5; color:#444; margin:0 15px;\"\u003e\n        “Bitbash is a top-tier automation partner, innovative, reliable, and dedicated to delivering real results every time.”\n      \u003c/p\u003e\n      \u003cp style=\"margin:10px 0 0; font-weight:600;\"\u003eNathan Pennington\n        \u003cbr\u003e\u003cspan style=\"color:#888;\"\u003eMarketer\u003c/span\u003e\n        \u003cbr\u003e\u003cspan style=\"color:#f5a623;\"\u003e★★★★★\u003c/span\u003e\n      \u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"33%\" style=\"padding:10px;\"\u003e\n      \u003ca href=\"https://youtu.be/8-tw8Omw9qk\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://github.com/za2122/footer-section/blob/main/media/review2.gif\" alt=\"Review 2\" width=\"100%\" style=\"border-radius:12px; box-shadow:0 4px 10px rgba(0,0,0,0.1);\"\u003e\n      \u003c/a\u003e\n      \u003cp style=\"font-size:14px; line-height:1.5; color:#444; margin:0 15px;\"\u003e\n        “Bitbash delivers outstanding quality, speed, and professionalism, truly a team you can rely on.”\n      \u003c/p\u003e\n      \u003cp style=\"margin:10px 0 0; font-weight:600;\"\u003eEliza\n        \u003cbr\u003e\u003cspan style=\"color:#888;\"\u003eSEO Affiliate Expert\u003c/span\u003e\n        \u003cbr\u003e\u003cspan style=\"color:#f5a623;\"\u003e★★★★★\u003c/span\u003e\n      \u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"33%\" style=\"padding:10px;\"\u003e\n      \u003ca href=\"https://youtube.com/shorts/6AwB5omXrIM\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://github.com/za2122/footer-section/blob/main/media/review3.gif\" alt=\"Review 3\" width=\"35%\" style=\"border-radius:12px; box-shadow:0 4px 10px rgba(0,0,0,0.1);\"\u003e\n      \u003c/a\u003e\n      \u003cp style=\"font-size:14px; line-height:1.5; color:#444; margin:0 15px;\"\u003e\n        “Exceptional results, clear communication, and flawless delivery. Bitbash nailed it.”\n      \u003c/p\u003e\n      \u003cp style=\"margin:10px 0 0; font-weight:600;\"\u003eSyed\n        \u003cbr\u003e\u003cspan style=\"color:#888;\"\u003eDigital Strategist\u003c/span\u003e\n        \u003cbr\u003e\u003cspan style=\"color:#f5a623;\"\u003e★★★★★\u003c/span\u003e\n      \u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteventhompson6460-stack%2Femail-campaign-automation-script","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteventhompson6460-stack%2Femail-campaign-automation-script","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteventhompson6460-stack%2Femail-campaign-automation-script/lists"}