aldinokemal/go-whatsapp-web-multidevice
Go Whatsapp Web Multidevice
This project is a headless WhatsApp client and automation server that exposes multi-device functionality as a REST API gateway. It provides a centralized interface for managing multiple account sessions, automating messages, and developing bots through a standardized protocol.
The system distinguishes itself by providing a secure webhook provider that forwards real-time messages and reactions to external URLs using signature verification. It includes specialized media utilities for converting images and GIFs into the WebP format required for stickers, as well as tools to simulate active user presence.
The software covers a broad range of capabilities, including account and profile management, group chat administration, and the retrieval of paginated conversation histories. It also supports the implementation of automated message responses and the synchronization of chat data with external business applications.
Authentication is handled via QR codes or pairing codes with stateful session persistence to allow reconnects without repeated pairing.
Features
- WhatsApp Messaging Integrations - Exposes a REST API gateway for sending and receiving text, media, contacts, and polls on WhatsApp.
- Headless Clients - Implements a session-persistent headless client for connecting WhatsApp accounts via QR or pairing codes without a browser.
- Automation Servers - Ships a backend server for automating responses, sending media, and managing group chats via the WhatsApp protocol.
- Real-Time Event Processing - Processes incoming WhatsApp events and reactions in real time via webhooks to trigger external workflows.
- Conversation Event Webhooks - Pushes real-time WhatsApp conversation events and account updates to external endpoints using signed HTTP requests.
- AI Agent Integrations - Provides a standardized server protocol that allows AI agents to read and send messages programmatically via WhatsApp.
- WhatsApp Bot Frameworks - Provides a standardized API and protocol for building automated agents that interact via the WhatsApp multi-device system.
- API Gateways - Exposes WhatsApp Multi-Device functionality as a REST API gateway for external application integration.
- Multi-Account Management - Allows the operation of multiple independent WhatsApp sessions from a single API instance.
- Webhook Receivers - Captures incoming WhatsApp messages and reactions in real time and forwards them to external URLs via secure webhooks.
- Stateful Session Persistence - Persists authentication tokens and session keys in a local database to enable reconnects without re-pairing.
- WhatsApp Session Lifecycles - Manages the full lifecycle of multiple WhatsApp device sessions, including connection and persistence via API.
- QR-Code Handshakes - Facilitates account linking through the generation and monitoring of session-specific QR codes for device pairing.
- Chat History APIs - Provides interfaces to retrieve contact lists and paginated message histories with media filtering.
- WhatsApp Group Moderation - Enables programmatic creation of groups, modification of member roles, and management of invitation links.
- Chat History Synchronization - Synchronizes WhatsApp conversation histories and contact lists with external business applications.
- Concurrent Event Processors - Uses Go routines to process incoming events and outgoing messages without blocking the main execution thread.
- Webhook Providers - Provides a secure webhook system that forwards real-time messages and reactions to external URLs using signature verification.
- Messaging Automation - Triggers automatic message replies and manages read-receipt statuses based on configurable rules.
- WebSocket Synchronization - Maintains a persistent WebSocket connection to synchronize real-time event streams and state between client and server.
- JSON-RPC Implementations - Implements the JSON-RPC protocol to standardize communication between external AI agents and the WhatsApp server.
- User Profile Management - Provides API endpoints to update account details such as pushnames, avatars, and business profile information.
- Global Presence Controllers - Allows setting and simulating account online/offline status to manage how contacts perceive user presence.
