octopusteam/waapi-laravel

WAAPI whatsapp api integration for Laravel

v1.1.0+1 2025-10-21 19:25 UTC

Requires

• php: >=8.0
• illuminate/support: ^8.0|^9.0|^10.0|^11.0|^12.0

MIT

• Octopus Team
• Abdallah Mahmoud

• api
• laravel
• whatsapp
• WaAPI

README

Simple and flexible WhatsApp API integration for Laravel, built by Octopus Team.
This package provides an easy way to send WhatsApp messages using WAAPI.

🛠️ Compatibility

This package supports the following Laravel and PHP versions:

Laravel Version	PHP Version(s)	Supported
12.x	8.3, 8.4	✅
11.x	8.2, 8.3	✅
10.x	8.1, 8.2, 8.3	✅
9.x	8.0, 8.1, 8.2	✅
8.x	7.4, 8.0, 8.1	⚠️ (no longer officially supported by Laravel, but package works)

ℹ️ We recommend always using the latest Laravel LTS and PHP stable versions for security and performance.

📦 Installation

Install via Composer:

composer require octopusteam/waapi-laravel

⚙️ Configuration

1. Publish the config file:

php artisan vendor:publish --provider="OctopusTeam\Waapi\WaapiServiceProvider" --tag="config"

1. A new config file will be created at:

config/waapi.php

1. Update your .env with your WAAPI credentials with the following variables in config/waapi.php:

WAAPI_URL=https://waapi.octopusteam.net/api/create-message
WAAPI_APP_KEY=your_app_key
WAAPI_AUTH_KEY=your_auth_key

# Webhook
WAAPI_WEBHOOK_URL=/api/webhook/whatsapp
WAAPI_WEBHOOK_ENABLED=true
WAAPI_WEBHOOK_AUTO_REGISTER=true

# Webhook.site 
WAAPI_WEBHOOK_SITE_TOKEN=your-webhook-site-token

🔑 Get Your API Key

To use this package, you need to create an account and generate your WAAPI keys:

1. Go to 👉 https://waapi.octopusteam.net
2. Sign up for a free trial (7 days available 🚀)
3. Choose a subscription plan (affordable options for continued API access)
4. After login, go to My Apps → Integration
5. Copy your appkey and authkey from the dashboard

🚀 Usage

Using the Facade (Recommended)

Since v1.0.6, the package includes a Waapi facade for easier static access:

use Waapi;

Waapi::sendOtp('201234567890', '123456');
Waapi::sendMessage('201234567890', 'Hello from Octopus Team 🚀');

Send WhatsApp Message

use Waapi;

$phone   = '201234567890';
$message = 'Hello from Octopus Team 🚀';

$response = Waapi::sendMessage($phone, $message);

if ($response->successful()) {
    echo "Message sent successfully!";
} else {
    echo "Failed to send message.";
}

🧪 Testing

This package comes with a basic test example.

Run tests with:

php artisan test

📖 Example Test

See tests/Feature/WaapiTest.php for a sample test:

$response = Waapi::sendMessage('201234567890', 'Hello from Waapi Test 🚀');
$this->assertNotNull($response);

🤝 Contributing

Contributions are welcome!
Please open issues and submit pull requests to help improve this package.

📜 License

This package is open-sourced software licensed under the MIT license.

✨ Credits

• Octopus Team
• Abdallah Mahmoud