DEV Community

Waqas Ahmed Waseer
Waqas Ahmed Waseer

Posted on AI-assisted

WhatsApp Business API Alternative: Self-Host a Free WhatsApp API with WaSphere (No Meta Approval)

#whatsapp #api #opensource #selfhosted

The official WhatsApp Business API is powerful, but it comes with real friction: Meta approval, a Business Service Provider in the middle, per-message pricing, and your messaging data flowing through someone else's infrastructure. If you would rather own your WhatsApp stack end to end, the open-source route is worth a serious look.

WaSphere (wasphere.com) is a free, MIT-licensed, self-hosted WhatsApp API platform. It gives you a REST API, multi-session support, a web dashboard, and HMAC-signed webhooks — with no Meta approval and no per-message fees. You run it on your own server with Docker.

Why self-host your WhatsApp API?

  • No Meta approval process — connect a regular WhatsApp number by scanning a QR code.
  • No per-message fees — your server, your costs.
  • Your data stays with you — sessions and contacts never leave your infrastructure.
  • Full API control — REST endpoints, webhooks, and scoped API keys.

Get running in minutes

You need Docker Engine 24+ and Docker Compose v2:

git clone https://github.com/wasphere/wasphere.git
cd wasphere
cp .env.example .env
# generate each secret, e.g.: openssl rand -hex 32
docker compose up -d
Enter fullscreen mode Exit fullscreen mode

Open the dashboard at http://localhost:3004, register the first admin account, then connect a number under Sessions by scanning the QR code.

Send your first message

WaSphere exposes a REST API covering 14 message types — text, image, video, audio, documents, stickers, buttons, lists, polls, reactions, location, contacts, and more:

curl -X POST http://localhost:3000/workspaces/{workspaceId}/proxy/api/sessions/{sessionId}/messages/text \
  -H "Authorization: Bearer wsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "to": "12125550100", "text": "Hello from WaSphere!" }'
Enter fullscreen mode Exit fullscreen mode

Every inbound message and delivery update arrives on your webhook, HMAC-signed so you can verify it.

Who is it for?

Developers building chatbots, order and invoice notifications, CRM integrations, and hosting resellers who want a WhatsApp gateway they fully control. There is a seeded live demo at demo.wasphere.com if you want to click around before self-hosting.

If the official API's approval process and pricing have been blocking you, a self-hosted WhatsApp API like WaSphere is a practical alternative: free, open source, and entirely yours.

Links: Website · GitHub · Live demo

Top comments (0)