WAHA - WhatsApp HTTP API

This project sets up the WAHA (WhatsApp HTTP API) using Docker. WAHA allows you to interact with WhatsApp through an HTTP API.

Prerequisites

• Docker
• Docker Compose

Setup

1. Clone the repository or download the files.

2. Create a .env file from the example:

   cp env.example .env

3. Configure your .env file:

   Open the .env file and fill in the required environment variables, such as WAHA_API_KEY, WAHA_DASHBOARD_USERNAME, and WAHA_DASHBOARD_PASSWORD. You can generate strong random values for these.

4. Review the docker-compose.yml file:

   The docker-compose.yml file is configured to use the variables from your .env file. You can customize the services and volumes as needed.

Usage

1. Start the services:

   docker-compose up -d

2. Access the WAHA Dashboard:

   Open your browser and navigate to http://localhost:3000 (or the WAHA_BASE_URL you configured). You should see the WAHA dashboard.

3. Access the Swagger UI:

   The Swagger UI for the WhatsApp API is available at http://localhost:3000/swagger.

Configuration

The main configuration is done through the .env file. Here are some of the key variables:

• WAHA_API_KEY: Your API key for securing the WAHA API.
• WAHA_DASHBOARD_USERNAME: Username for the WAHA dashboard.
• WAHA_DASHBOARD_PASSWORD: Password for the WAHA dashboard.
• WHATSAPP_DEFAULT_ENGINE: The WhatsApp engine to use (e.g., WEBJS, GOWS).
• WAHA_BASE_URL: The base URL for the API.
• WHATSAPP_HOOK_URL: The URL for webhook notifications.

For more detailed configuration options, please refer to the official WAHA documentation.

Stopping the services

To stop the services, run:

docker-compose down

Data Persistence

• Sessions: Session data is stored in the sessions directory, mounted as a volume.
• Media: Media files are stored in the media directory, mounted as a volume.