Skip to content
Join the community

wspp-cli-puppeteer

WhatsApp Web automation from your terminal

Jjhomar

wspp-cli automates WhatsApp Web from the terminal with Puppeteer and Bun, using your own WhatsApp number instead of the official API. It is for people who want to send WhatsApp messages from scripts, CSV lists or tools like n8n, Make or Zapier.

  • Send messages by contact name, position in recent chats or phone number, to one contact or many.
  • Bulk send from a CSV with {{variable}} templates, with --dry-run to preview.
  • Send documents, polls in group chats and scheduled messages with --at.
  • Random 3 to 7 second delays and volume warnings to lower the risk of a ban.
  • A REST API server with /send, /send/bulk and /contacts for webhooks.

Try it: needs Bun 1.0+ and Google Chrome. Run npm install -g wspp-cli, then wspp-login and scan the QR once.

Updates

Every release and change, newest first.

No updates yet. New releases and changes will show up here.

Your turn

Your project can be on this wall.

Publishing takes a couple of minutes. Pick the way that fits how you work.

Publish your Ship