WhatsApp Broadcast & Messaging Automation

A Node.js utility for scheduled and batch WhatsApp message delivery with attachment support, retry handling, and progress persistence.

---

Features

• Batch Messaging: Dispatch templated text and media messages to targeted contact lists.
• Media Attachment Support: Attach promotional posters, images, or documents to automated dispatches.
• Progress Persistence: Tracks delivered and pending contacts in progress.json to enable pause and resume.
• Rate-Limiting & Delays: Configurable intervals between dispatches to respect rate limits.

---

Tech Stack

• Runtime: Node.js (ES Modules)
• Engine: WhatsApp Web automation & browser sessions
• Storage: JSON state management

---

Getting Started

Prerequisites

• Node.js 18+
• pnpm or npm

Installation

git clone https://github.com/devsanthoshmk/WA-automation.git
cd WA-automation
pnpm install

Configuration

1. Place target contacts and message templates in messages.json.
2. Configure attachments (e.g., poster.jpg) if sending media.

Execution

node main.js

---

License

MIT