Skip to content

release: 1.3.0 - bulk WhatsApp sender (Linux) - #1

Merged
DariusDev16 merged 1 commit into
mainfrom
release/1.3.0
Nov 7, 2026
Merged

DariusDev16 merged 1 commit into
mainfrom
release/1.3.0

Conversation

@DariusDev16

Copy link
Copy Markdown
Owner

What's new in 1.3.0 (Linux / AppImage only)

Bulk WhatsApp sender. The leads panel has a new Bulk send button. It sends your saved WhatsApp message to every lead in the current filter (for example No website), one at a time, with no clicks per lead.

  1. Pick: a checklist shows the leads that have a WhatsApp number. Untick anyone to skip them and click a row to preview its message.
  2. Send: WhatsApp Web runs inside MAPLEAD. You scan the QR code once and the session is kept. Each chat opens with the message filled in and is sent. Numbers that are not on WhatsApp are detected and skipped.
  3. Control: Pause, Skip lead and Stop work at any time, and an activity log shows every step.

Safety pauses, all editable before each run:

setting default
random pause between messages 45–120 s
rest 10 min every 10 messages
"WhatsApp may block the number — continue? (Yes/No)" every 25 messages
daily limit (asks before going over) 50

Contact history. Every number messaged is saved with its date and result in ~/.local/share/maplead/whatsapp-history.json. Leads already contacted come unticked and show a Contacted chip. The new Not contacted filter hides them.

Technical

  • New maplead/outreach.py (queue, pacing, history; standard library only) and maplead/gui/bulk_sender.py (picker dialog plus the WhatsApp Web window). WhatsApp-specific selectors live only in its _JS_* scripts.
  • The AppImage now bundles QtWebEngine (about 187 MB), and build-appimage.sh installs the full PySide6.
  • tools/bulk_test.py lets you try the sender on your own numbers.
  • The Windows build and the terminal wizard are unchanged.

Tested

  • Real sends through WhatsApp Web to 3 numbers.
  • End-to-end run against a fake WhatsApp page covering sent, not on WhatsApp, the continue prompt and the daily limit.
  • --selftest passes from source and from the built AppImage.

🤖 Generated with Claude Code

- Bulk send in the leads panel: pick the leads of the current filter,
  preview each message, then WhatsApp Web inside the app sends them one
  by one (QR code scanned once, session kept).
- Safety pauses: random 45-120 s between messages, 10 min rest every 10,
  "may get blocked - continue?" prompt every 25, 50-a-day limit.
- Contact history (whatsapp-history.json): contacted leads are skipped,
  marked "Contacted" on their card, new "Not contacted" filter.
- tools/bulk_test.py to try the sender on your own numbers.
- AppImage bundles QtWebEngine; build-appimage.sh installs full PySide6.
  Windows build and terminal wizard unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@DariusDev16
DariusDev16 merged commit c668741 into main Nov 7, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant