Self-Hosted WhatsApp API
& Developer Platform
Multi-session. Multi-webhook. Developer-first dashboard.
Docker-based, MIT licensed, zero config.
$ git clone https://github.com/wasphere/wasphere.git$ cd wasphere && cp .env.example .env# Set your secrets in .env — openssl rand -hex 32$ docker compose up -d✓ 4 services up — migrations applied✓ Dashboard at http://localhost:3004
Up and running in minutes
No proprietary accounts. No approval process. Just Docker, a domain, and your WhatsApp number.
Run one command. Docker pulls the images, configures your domain, and provisions SSL automatically. Up in under 5 minutes.
Open the dashboard, create a session, scan the QR code with WhatsApp. Session goes active instantly — no approval needed.
Hit the REST API with your scoped API key. Send messages, receive webhooks, and automate across all 14 message types.
Everything you need, built in
Every feature works across all 14 message types — anti-ban, audit logs, and webhook signing out of the box.
Multi-Session
Unlimited WhatsApp accounts. Fully isolated. QR-based pairing in seconds. Each session gets its own API key scope and webhook endpoint.
Multi-Webhook
HMAC-signed payloads. Exponential backoff. Test fire from dashboard.
14 Message Types
Text, media, interactive, polls, locations. Full WhatsApp coverage.
Anti-Ban Controls
Configurable delays, typing simulation, rate limits per session.
Scoped API Keys
12 granular permissions. Per-session scoping. Rotate live.
Self-Hosted
Your servers, your data. MIT licensed. Zero vendor lock-in.
Send your first message in 30 seconds
Standard REST with Bearer token auth. Works with any language, any HTTP client.
curl -X POST \ https://wa.your-domain.com/api/messages/send \ -H "Authorization: Bearer wsk_live_9f8e7d6c5b4a..." \ -H "Content-Type: application/json" \ -d '{ "session": "my-business" , "to": "447911123456@s.whatsapp.net" , "text": "Hello from WaSphere! 👋" }'
200 OK — { "messageId": "msg_abc123", "status": "queued" }Built for real workflows
Drop-in messaging layer for any stack — hosting panels, e-commerce, SaaS, internal ops.
WHMCS Integration
Automate client onboarding. Send order confirmations, invoice reminders, and support ticket updates directly to WhatsApp from WHMCS.
Billing Notifications
Replace email for payment alerts. Overdue notices, receipt confirmations, and subscription renewals with 95%+ open rates.
Customer Support
Route incoming WhatsApp messages to your support desk. Build chatbot flows or hand off to live agents with full conversation history.
Custom Dashboards
Build internal tools and operations dashboards that push alerts, reports, and status updates to your team over WhatsApp.
100% Open Source. Forever Free.
No hidden tiers. No source-available bait-and-switch. The entire platform — WA server, dashboard, API — is MIT licensed and on GitHub. Fork it, modify it, ship it.
What's coming next
Built in public. Vote on features and track progress on GitHub.
- Inbox UI — read and reply from dashboard
- Real-time message ticker
- Webhook delivery history + replay
- Bulk message scheduler
- MySQL & SQLite database support
- Custom workspace branding
- Contact list import (CSV/vCard)
- Role-based access control
- WhatsApp Business API bridge
- Multi-tenant team accounts
- Native mobile app (iOS & Android)
- Marketplace for community integrations
Ready to own your
WhatsApp infrastructure?
Deploy in minutes. No license fees. No vendor lock-in.
Your servers, your data, forever.