devlikeapro/waha
Waha
WAHA is a server that exposes WhatsApp as a programmable REST API, enabling applications and AI agents to send and receive messages programmatically. It operates unlimited independent WhatsApp sessions from a single instance, each with its own connection state and message history, and can switch between underlying WhatsApp communication libraries by changing a single environment variable while preserving the same API interface.
The system distinguishes itself through its engine abstraction layer, which allows operators to swap the WhatsApp communication library without modifying integrations, and its Model Context Protocol (MCP) server capability that lets AI agents read and send WhatsApp messages programmatically. It provides scope-based access control to restrict which operations AI agents can perform, and supports horizontal scaling by distributing sessions across multiple server instances. The service runs in a Docker container, authenticates via QR code scanning, and forwards incoming messages to configured webhook URLs for real-time processing.
Beyond core messaging, WAHA handles session lifecycle management through REST calls, supports multimedia message sending, and provides monitoring endpoints for health checks, uptime reporting, and configuration exposure. It also offers presence management features including chat-level typing indicators and global online status control.
Features
- Messaging - Exposes WhatsApp as an MCP server so AI agents can read and send messages programmatically.
- WhatsApp - Exposes a self-hosted WhatsApp instance as an MCP server for AI agent integration.
- WhatsApp Multimedia Transmissions - Sends images and videos through the WhatsApp REST API alongside text messages.
- Docker Container Deployments - Ships a Docker container deployment for running the WhatsApp API server with a single command.
- WhatsApp Integrations - Provides WhatsApp integration capabilities including engine switching via environment variable.
- AI Agent Integrations - Exposes WhatsApp as an MCP server so AI agents can read and send messages programmatically.
- Engine Abstraction Layers - Provides an abstraction layer to switch WhatsApp libraries via environment variable.
- Engine Switching - Provides the ability to swap WhatsApp communication libraries by changing a single environment variable.
- Multi-Account Managers - Operates unlimited independent WhatsApp sessions from a single API instance with per-account message history.
- Session Controllers - Creates, authenticates, and manages WhatsApp Web sessions with QR code scanning and engine switching.
- Session Lifecycle Controllers - Creates, starts, stops, and removes authenticated WhatsApp sessions via REST calls for multi-account control.
- Session Management APIs - Provides REST API endpoints for creating, listing, and removing WhatsApp sessions.
- WhatsApp Messaging Integrations - Provides REST API endpoints for sending and receiving WhatsApp messages programmatically.
- API Gateways - Provides a REST API gateway that exposes WhatsApp messaging and session management as programmable endpoints.
- Message Senders - Transmits text or media messages to specified contacts or groups through a REST API call.
- Multi-Account Management - Operates unlimited independent WhatsApp sessions from a single API instance.
- Webhook Receivers - Forwards incoming WhatsApp messages to configured URLs in real time for automated processing.
- WhatsApp Text Transmissions - Sends plain-text messages to WhatsApp contacts via REST API calls.
- Multi-Account Session Management - Operates unlimited independent WhatsApp sessions from one API instance with separate connection states.
- WhatsApp Session Lifecycles - Creates, starts, stops, and removes WhatsApp sessions to control multiple accounts via REST API.
- WhatsApp Session Initiations - Creates a new WhatsApp Web session by scanning a QR code with a mobile phone.
- Webhook Event Notifications - Forwards incoming messages and real-time events to configured URLs for automated processing.
- Session Distribution - Distributes WhatsApp sessions across multiple API instances for horizontal scaling.
- Authentication QR Codes - Uses QR code scanning to link WhatsApp accounts to the service for authentication.
- Engine Switchers - Switches between WhatsApp communication libraries by changing a single environment variable while preserving the API interface.
- Webhook Processors - Captures incoming WhatsApp messages in real time through webhooks for automated processing.
- Messaging Webhook Receivers - Captures incoming WhatsApp messages via webhooks or polling so the server can react to them.
- Agent Action Scopes - Controls which WhatsApp operations an AI agent can perform by assigning read, send, control, setting, app, or delete scopes.
- API Access Security - Authenticates and authorizes API requests using integrated security features to protect the infrastructure.
- Horizontal Scaling - Distributes WhatsApp sessions across multiple API instances to handle increased account loads.
- Agent Action Scoping - Restricts AI agent actions by assigning fine-grained scopes to session keys.
- Browser Automation - Launches a real WhatsApp Web instance using browser automation to send and receive messages programmatically.
- Browser Automation Engines - Launches a real WhatsApp Web instance using headless browser automation for messaging.
