WA Poster
Post one saved message to many WhatsApp communities you run, from a small app on your own computer.
Pick a message, tick the communities, check the preview, and send. Site: https://sahilkumar1122.github.io/wa-poster/
Read this first
WA Poster connects the way WhatsApp Web does, through the unofficial Baileys library. Automating an ordinary account can break WhatsApp's terms, and your number can be banned. Use a number set aside for this, post only to communities you run, and read the safety notes. Not affiliated with WhatsApp or Meta.
Features
- Message library with CSV import and in-app editing
- Community picker, sorted by the date in the group name, sent in list order
- WhatsApp-style preview with formatting, links and image captions
- Image attachments (saved with a message or for one send)
- Random gap between groups (default 15 to 25 s) and optional per-group variation
- Dry run, scheduling, live per-group status, local send log
- Optional password login
Run it
Needs Node.js 20 or newer.
git clone https://github.com/sahilKumar1122/wa-poster.git
cd wa-poster
npm install
npm start
Open http://localhost:3000, scan the QR code (WhatsApp, Linked devices, Link a device), then import your messages. Do a dry run, then a real send to one community, then the rest.
Options:
WA_POSTER_PASSWORD='a-long-password' npm start # require a login
caffeinate -i npm start # macOS: stay awake for scheduled sends
CSV format
First row names the columns. A title (or name) column is the label and a message (or text) column is the body. Until you add messages, four samples from messages.example.json are shown.
Where data lives
| Path | What | Committed |
|---|
auth/ | WhatsApp login. Full access to the linked account | never |
messages.json | Your saved messages | no |
images/ | Attached images | no |
schedules.json | Scheduled sends | no |
sent-log.jsonl | Exact text each group received | no |
The server listens on 127.0.0.1 only.
Notes
- In announcement-only groups the linked number must be an admin.
- A scheduled job more than 20 minutes late is marked missed and never sent.
- The landing site is in
docs/ and is served by GitHub Pages.
License
MIT
