📖 Introduction

WAHA - WhatsApp HTTP API that you can install on your own server and run in less than 5 minutes!

Get started #

We will guide you through the necessary steps to successfully send your first text message using WhatsApp HTTP API in Quick Start →.

Disclaimer #

This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at whatsapp.com.

“WhatsApp” as well as related names, marks, emblems and images are registered trademarks of their respective owners. Also it is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn’t be considered totally safe.

For any businesses looking to integrate with WhatsApp for critical applications, we highly recommend using officially supported methods, such as Twilio’s solution or other alternatives. You might also consider the official API ->.

Features #

Here’s the available features:

Messages #

• Send messages
• Receive messages
• Message replies
• Send location
• Receive location
• React to messages
• Send media (images/documents/files)
• Send voice messages
• Receive media (images/audio/video/documents)
• Receive messages - webhook retries

Groups #

• Create a group
• Get invite for group
• Modify group info (subject, description)
• Add group participants
• Kick group participants
• Promote/demote group participants

Contacts #

• Mute/unmute chats
• Block/unblock contacts
• Get contact info
• Get profile pictures
• Get presence (online\offline\typing) status

Sessions #

• Multi Device
• Get the screenshot
• Single WhatsApp account running inside one container
• Multiple WhatsApp account running inside one container
• Session saving (don’t have to scan QR on every restart)
• Session saving on remote storage (mongodb)

Security #

• API authentication
• Swagger panel authentication

Updates #

• Bug fixes and updates come as soon as they are implemented.

Engines #

Not all Engines support all Features, see the feature supported by engines ->.

Versions #

WAHA is distributed in two versions:

• Core - the basic version that meet almost 80% people’s needs. 100% free and open source ->.
• Plus - the version with advanced messages, security, and reliability features. Donations, no license expiration, quick updates, read more about Plus Version →