njoguamos/laravel-waha

An opinionated Laravel package for interacting with WAHA API

dev-main 2026-02-22 01:44 UTC

Requires

• php: ^8.4
• giggsey/libphonenumber-for-php-lite: ^9.0
• illuminate/support: ^12.0 || ^13.0
• saloonphp/saloon: ^3.0

Requires (Dev)

• laravel/pint: ^1.25
• orchestra/testbench: ^10.0 || ^11.0
• pestphp/pest: ^3.8.4 || ^4.0.0

MIT

• Njogu Amos

• php
• api
• laravel
• whatsapp
• waha

README

Laravel WAHA is an opinionated Laravel package for interacting with the WAHA API.

Requirements

Version	PHP	Laravel
1.x	8.4.x, 8.5.x	12.x, 13.x

Installation

You can install the package via Composer:

composer require njoguamos/laravel-waha

Documentation

Full documentation is available at waha.njoguamos.me.ke.

Configuration

Environment variables

• WAHA_API_KEY – Your WAHA API key
• WAHA_BASE_URL – Base API URL (default https://waha.example.com)
• WAHA_SESSION – Default WhatsApp session name (default default)
• WAHA_ENGINE – Engine type: WEBJS, GOWS, or NOWEB (default GOWS)

WAHA_API_KEY=your-api-key
WAHA_BASE_URL=https://waha.example.com
WAHA_SESSION=default
WAHA_ENGINE=GOWS

Publishing Configuration

You can publish the configuration by running the following command:

php artisan vendor:publish --tag=config --provider="NjoguAmos\Waha\WahaServiceProvider"

Usage

Here is a quick example of how to send a text status:

use NjoguAmos\Waha\Facades\Status;
use NjoguAmos\Waha\Dto\TextStatusData;

$statusData = new TextStatusData(
    text: 'Have a look! https://waha.example.com/',
    backgroundColor: '#38b42f',
    font: 1
);

$result = Status::sendText(session: 'default', data: $statusData);

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Njogu Amos
• All Contributors

License

The MIT License (MIT). Please see License File for more information.