# aldinokemal/go-whatsapp-web-multidevice

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/aldinokemal-go-whatsapp-web-multidevice).**

3,510 stars · 819 forks · Go · mit

## Links

- GitHub: https://github.com/aldinokemal/go-whatsapp-web-multidevice
- awesome-repositories: https://awesome-repositories.com/repository/aldinokemal-go-whatsapp-web-multidevice.md

## Topics

`bot` `go` `golang` `golang-whatsapp` `golang-whatsapp-api` `rest` `rest-api` `whatsapp` `whatsapp-api` `whatsapp-api-go` `whatsapp-multi-device` `whatsapp-web-multi-device`

## Description

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.

## Tags

### Networking & Communication

- [WhatsApp Messaging Integrations](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/whatsapp-messaging-integrations.md) — Exposes a REST API gateway for sending and receiving text, media, contacts, and polls on WhatsApp. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))
- [AI Agent Integrations](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/messaging-platform-integrations/whatsapp-integrations/ai-agent-integrations.md) — Provides a standardized server protocol that allows AI agents to read and send messages programmatically via WhatsApp. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))
- [WhatsApp Bot Frameworks](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/messaging-platform-integrations/whatsapp-integrations/whatsapp-bot-frameworks.md) — Provides a standardized API and protocol for building automated agents that interact via the WhatsApp multi-device system.
- [API Gateways](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/whatsapp-messaging-integrations/api-gateways.md) — Exposes WhatsApp Multi-Device functionality as a REST API gateway for external application integration.
- [Multi-Account Management](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/whatsapp-messaging-integrations/multi-account-management.md) — Allows the operation of multiple independent WhatsApp sessions from a single API instance.
- [Webhook Receivers](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/whatsapp-messaging-integrations/webhook-receivers.md) — Captures incoming WhatsApp messages and reactions in real time and forwards them to external URLs via secure webhooks. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))
- [Webhook Providers](https://awesome-repositories.com/f/networking-communication/api-integration-frameworks/communication-apis/messaging-platform-integrations/whatsapp-integrations/webhook-providers.md) — Provides a secure webhook system that forwards real-time messages and reactions to external URLs using signature verification.
- [Messaging Automation](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-automation.md) — Triggers automatic message replies and manages read-receipt statuses based on configurable rules. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))
- [WebSocket Synchronization](https://awesome-repositories.com/f/networking-communication/distributed-systems-p2p/distributed-computing/communication-protocols/websocket-implementations/websocket-synchronization.md) — Maintains a persistent WebSocket connection to synchronize real-time event streams and state between client and server.
- [JSON-RPC Implementations](https://awesome-repositories.com/f/networking-communication/json-rpc-implementations.md) — Implements the JSON-RPC protocol to standardize communication between external AI agents and the WhatsApp server.

### Security & Cryptography

- [Headless Clients](https://awesome-repositories.com/f/security-cryptography/multi-account-session-management/whatsapp-session-lifecycles/headless-clients.md) — Implements a session-persistent headless client for connecting WhatsApp accounts via QR or pairing codes without a browser.
- [Stateful Session Persistence](https://awesome-repositories.com/f/security-cryptography/identity-access-management/session-management/stateful-session-persistence.md) — Persists authentication tokens and session keys in a local database to enable reconnects without re-pairing.
- [WhatsApp Session Lifecycles](https://awesome-repositories.com/f/security-cryptography/multi-account-session-management/whatsapp-session-lifecycles.md) — Manages the full lifecycle of multiple WhatsApp device sessions, including connection and persistence via API. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))
- [QR-Code Handshakes](https://awesome-repositories.com/f/security-cryptography/user-authentication-flows/qr-code-handshakes.md) — Facilitates account linking through the generation and monitoring of session-specific QR codes for device pairing.
- [User Profile Management](https://awesome-repositories.com/f/security-cryptography/identity-access-management/identity-management/user-management/user-profile-management.md) — Provides API endpoints to update account details such as pushnames, avatars, and business profile information. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))

### Artificial Intelligence & ML

- [Automation Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-servers/automation-servers.md) — Ships a backend server for automating responses, sending media, and managing group chats via the WhatsApp protocol.
- [Chat History APIs](https://awesome-repositories.com/f/artificial-intelligence-ml/chat-history-apis.md) — Provides interfaces to retrieve contact lists and paginated message histories with media filtering. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))

### Data & Databases

- [Real-Time Event Processing](https://awesome-repositories.com/f/data-databases/real-time-event-processing.md) — Processes incoming WhatsApp events and reactions in real time via webhooks to trigger external workflows.
- [Chat History Synchronization](https://awesome-repositories.com/f/data-databases/data-engineering-infrastructure/data-persistence-storage/data-storage/metadata-state-management/chat-history-synchronization.md) — Synchronizes WhatsApp conversation histories and contact lists with external business applications.

### Development Tools & Productivity

- [Conversation Event Webhooks](https://awesome-repositories.com/f/development-tools-productivity/event-triggers/github-event-integrations/webhook-event-receivers/conversation-event-webhooks.md) — Pushes real-time WhatsApp conversation events and account updates to external endpoints using signed HTTP requests.

### Business & Productivity Software

- [WhatsApp Group Moderation](https://awesome-repositories.com/f/business-productivity-software/group-management/group-settings-management/whatsapp-group-moderation.md) — Enables programmatic creation of groups, modification of member roles, and management of invitation links. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))

### DevOps & Infrastructure

- [Concurrent Event Processors](https://awesome-repositories.com/f/devops-infrastructure/message-queue-workers/concurrent-event-processors.md) — Uses Go routines to process incoming events and outgoing messages without blocking the main execution thread.

### System Administration & Monitoring

- [Global Presence Controllers](https://awesome-repositories.com/f/system-administration-monitoring/user-presence-monitoring/global-presence-controllers.md) — Allows setting and simulating account online/offline status to manage how contacts perceive user presence. ([source](https://cdn.jsdelivr.net/gh/aldinokemal/go-whatsapp-web-multidevice@main/README.md))