wasphere Files

The self-hosted, open-source WhatsApp API platform. Run your own WhatsApp automation — multi-session, multi-webhook, developer-first — on infrastructure you control. MIT licensed, no per-message fees, no vendor lock-in.

▶️ Live demo: https://demo.wasphere.com · 📺 Walkthrough: https://youtu.be/k6tBGIApd8I · 📖 Docs: https://wasphere.com/docs

✨ Highlights

Messaging — 14 send types

Text, image, video, audio, document, sticker, GIF, view-once, buttons, list, poll, reaction, location, and contact — each with a dedicated REST endpoint. Plus bulk send with per-recipient outcome tracking and configurable anti-ban send delays.

Multi-session & multi-tenant

Run many WhatsApp numbers from one deployment, isolated per workspace. QR-link a number in seconds; sessions reconnect automatically.

Developer-first API

A clean REST API behind scoped API keys (wsk_) — 12 permission scopes, optional per-session scoping, Bearer-token auth. Every endpoint documented.

Webhooks that survive production

HMAC-SHA256 signed deliveries (v1,sha256= over timestamp.body), per-webhook secrets, automatic retries, and SSRF-guarded outbound delivery (DNS pinning + private-IP denylist) across 19 event types.

Secure by default

• AES-256-GCM encryption for stored WA Server tokens
• argon2id password hashing, JWT with refresh-token rotation
• Helmet security headers; registration locks after the first admin
• Baileys isolated to a single adapter — Pro code never touches GPL internals

🏗️ Architecture

Four services, one docker compose up: PostgreSQL · WA Server (NestJS + Baileys) · Dashboard API (NestJS + Prisma) · Dashboard UI (Next.js). No Redis and no bundled proxy — front the stack with your own reverse proxy for TLS in production.

🚀 Quick start

:::bash
git clone https://github.com/wasphere/wasphere.git
cd wasphere && cp .env.example .env   # fill in secrets: openssl rand -hex 32
docker compose up -d

Then open the dashboard, create your admin account, link a number, and send your first message. Full walkthrough: https://wasphere.com/docs/getting-started/quick-start

📦 What's included

• MIT-licensed WA Server + Dashboard core
• Portable docker-compose.yml plus a Dokploy-flavoured docker-compose.prod.yml
• Complete documentation — getting started, concepts, guides, operations
• A live, read-only demo

🗺️ What's next

Poll-vote decryption and additional integrations are tracked on the issues board.

Built with ❤️ by Waqas Ahmed Waseer. Not affiliated with WhatsApp Inc. or Meta.