Connect WhatsApp numbers, receive real-time webhooks, and send messages — all through a simple API.
No infrastructure to manage. Fully open source.
Documentation · Get Started · Discord · Twitter
Building WhatsApp integrations shouldn't require managing WAHA containers, configuring Kubernetes, or wiring up webhook delivery pipelines. WAHooks handles all of that so you can focus on your application.
- Zero infrastructure — we run the WhatsApp sessions, you receive the webhooks
- Simple API — REST API, TypeScript SDK, Python SDK, CLI, and MCP server
- $0.99/month per connection — no minimums, no hidden fees
- Open source — MIT licensed, self-host if you prefer
curl -fsSL wahooks.com/install | bashOr via npm:
npm install -g wahookswahooks login
wahooks connections create
wahooks connections qr <id> --poll # Scan with WhatsApp
wahooks webhooks create <connection-id> --url https://your-app.com/webhookEvery WhatsApp message, status change, and event is delivered to your endpoint with HMAC-SHA256 signatures and automatic retries.
wahooks send <connection-id> --to 1234567890@s.whatsapp.net --text "Hello from WAHooks"npm install @wahooks/sdkimport { WAHooks } from '@wahooks/sdk';
const client = new WAHooks({ apiKey: 'wh_...' });
const connections = await client.connections.list();
await client.messages.send(connectionId, {
chatId: '1234567890@s.whatsapp.net',
text: 'Hello!',
});pip install wahooksfrom wahooks import WAHooks
client = WAHooks(api_key="wh_...")
connections = client.connections.list()
client.messages.send(connection_id, chat_id="1234567890@s.whatsapp.net", text="Hello!")Connect WAHooks to Claude, Cursor, Windsurf, and other AI assistants:
{
"mcpServers": {
"wahooks": {
"type": "http",
"url": "https://api.wahooks.com/mcp"
}
}
}- Managed WhatsApp Sessions — Cloud-hosted WAHA containers with automatic scaling and health monitoring
- Persistent Sessions — Auth state persisted in Postgres, survives restarts and node replacements
- Webhook Delivery — HMAC-SHA256 signed payloads, 5 retries with exponential backoff, dead-letter queue
- Real-time Events — Messages, status changes, presence updates, delivered via BullMQ
- SDKs & CLI — TypeScript and Python SDKs, Go CLI, MCP server for AI assistants
- Chat Viewer — Built-in dashboard to view chats, send messages, and manage connections
- OAuth & API Tokens — Supabase Auth with JWT, API tokens with
wh_prefix for programmatic access - Auto-scaling — Kubernetes-based scaling with proactive provisioning (buffer at 10 remaining slots)
- Open Source — MIT licensed, self-hostable, fully documented
Browser ──► Next.js Dashboard (Vercel)
│
▼
NestJS API ◄──── Stripe (billing webhooks)
│ │
┌──────┘ └──────┐
▼ ▼
Supabase k3s Cluster (Hetzner Cloud)
(Postgres + Auth) ├── WAHA StatefulSet (autoscaled 1–10 nodes)
├── Redis (BullMQ + AOF persistence)
└── Cluster Autoscaler
│
▼
Customer Webhook
Endpoints (HMAC-signed)
| Component | Tech | Hosting |
|---|---|---|
| Dashboard | Next.js 15, React 19, Tailwind CSS 4 | Vercel |
| API | NestJS 11, TypeScript | k3s on Hetzner Cloud |
| WhatsApp Engine | WAHA Plus (NOWEB, ~50 sessions/pod) | k3s StatefulSet |
| Database + Auth | Supabase (Postgres + Auth + JWTs) | Supabase Cloud |
| Message Queue | BullMQ + Redis 7 (AOF persistence) | k3s Deployment |
| Billing | Stripe prepaid slots ($0.99/connection/month) | Stripe |
| Infrastructure | Terraform + kube-hetzner | Hetzner Cloud |
| Monorepo | Turborepo + pnpm workspaces | — |
All routes prefixed with /api. Auth via Supabase JWT or API token in Authorization: Bearer header.
| Method | Route | Description |
|---|---|---|
GET |
/api/connections |
List connections |
POST |
/api/connections |
Create connection |
GET |
/api/connections/:id |
Get connection detail |
GET |
/api/connections/:id/qr |
Get QR code |
GET |
/api/connections/:id/chats |
Get recent chats |
GET |
/api/connections/:id/me |
Get WhatsApp profile |
POST |
/api/connections/:id/restart |
Restart session |
DELETE |
/api/connections/:id |
Delete connection |
| Method | Route | Description |
|---|---|---|
GET |
/api/connections/:cid/webhooks |
List webhook configs |
POST |
/api/connections/:cid/webhooks |
Create webhook |
PUT |
/api/webhooks/:id |
Update webhook |
DELETE |
/api/webhooks/:id |
Delete webhook |
GET |
/api/webhooks/:id/logs |
Delivery logs |
| Method | Route | Description |
|---|---|---|
GET |
/api/billing/status |
Subscription status |
POST |
/api/billing/checkout |
Create checkout session |
POST |
/api/billing/portal |
Stripe customer portal |
Full API documentation: wahooks.com/docs
git clone https://github.com/dhruvyad/wahooks.git
cd wahooks
pnpm install
cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env
# Fill in your Supabase + Stripe credentials
pnpm db:push # Push schema to DB
pnpm dev # Start API (:3001) + Web (:3000)Infrastructure is fully declarative via Terraform using kube-hetzner:
cd terraform/
cp terraform.tfvars.example terraform.tfvars
terraform init && terraform applyThis provisions:
- k3s control plane on Hetzner Cloud
- Autoscaling 1–10 worker nodes for WAHA pods
- Redis, RBAC, secrets, and all k8s resources
CI/CD via GitHub Actions: build Docker image → run migrations → rolling deploy.
See k8s/README.md for full deployment docs.
wahooks/
├── apps/
│ ├── api/ NestJS API server
│ └── web/ Next.js dashboard + docs (Fumadocs)
├── packages/
│ ├── db/ Drizzle ORM schema + migrations
│ ├── shared-types/ TypeScript domain types
│ └── config/ Shared ESLint + TypeScript configs
├── sdks/
│ ├── python/ Python SDK (PyPI: wahooks)
│ ├── typescript/ TypeScript SDK (npm: wahooks)
│ └── mcp/ MCP server (OAuth via Supabase)
├── cli/ Go CLI (Cobra)
├── terraform/ k3s cluster provisioning
└── k8s/ Kubernetes manifests
Contributions welcome! See the docs for architecture details.
- Fork the repo
- Create a branch (
git checkout -b feat/my-feature) - Commit with conventional commits (
feat:,fix:, etc.) - Open a PR
Join our Discord to discuss ideas and get help.