Stars
Forks
Watchers
Developer links
WPPConnect Server
WhatsApp becomes an HTTP service your own systems can call. WPPConnect Server wraps WhatsApp Web sessions in a REST API for integrators who need to send and receive messages, manage contacts and groups, and react to events without building browser automation themselves. Each session pairs by QR code and gets its own token, and multiple sessions run side by side for different numbers, teams, or customers. Endpoints cover text and media messaging, contact and group operations, product catalog actions, and session lifecycle, all documented in a built-in Swagger UI and a Postman collection. Webhooks push incoming messages and status changes to your backend, with destination allowlists keeping callbacks pointed only where you configured. Chatwoot connects through a dedicated authenticated webhook, so support conversations can flow between the help desk and WhatsApp in both directions. The Docker image bundles WPPConnect Manager, a web workspace for session administration, QR pairing, and reading and answering chats, protected by the server secret key at the top level and per-session tokens below it. Credentials, browser data, media, and logs persist in named volumes, surviving container restarts without re-pairing. Support desks automate ticket updates, shops send order notifications, and clinics confirm appointments through numbers they already publish. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. Apache-2.0 licensed.
Benefits
- WhatsApp Behind Your API
- Your backend sends and receives WhatsApp messages over plain REST instead of driving a browser, so notifications, alerts, and replies plug into systems you already run and monitor.
- Many Numbers, One Server
- Multiple QR-paired sessions run concurrently, each with its own token and scope, letting different teams, brands, or customers operate separate WhatsApp numbers on one deployment.
- Events Pushed To You
- Webhooks deliver incoming messages and status changes to allowlisted destinations in real time, and the authenticated Chatwoot webhook syncs support conversations between help desk and WhatsApp.
- Sessions Survive Restarts
- Credentials, browser data, media, and logs persist in named Docker volumes, so containers restart, upgrade, and roll back without forcing every number through QR pairing again.
Features
- Session And Messaging API
- REST endpoints handle session pairing and lifecycle, text and media messages, contacts, groups, and product catalog operations, documented interactively in the built-in Swagger UI.
- Bundled Manager Workspace
- The Docker image includes WPPConnect Manager for session administration, QR pairing, and chat handling, guarded by the server secret key and per-session access tokens.
- Authenticated Event Channel
- A dedicated Socket.IO namespace streams messages, status changes, and QR codes to the Manager for authorized sessions only, reconciling missed events by polling on reconnect.
- Hardened Callback Controls
- Webhook and Chatwoot destinations are restricted by explicit allowlists, legacy secret-bearing URLs are retired, and Manager API rates are limited per source address.