Laravel WhatsApp Cloud

A production-ready WhatsApp conversation platform for Laravel. Send messages via Meta Cloud API or Twilio WhatsApp using one unified fluent API, with contacts, conversations, message timelines, multi-account support, webhooks, queues, notifications, and an admin panel.

Requirements

• PHP 8.3+
• Laravel 13.x

Installation

composer require ashararsi/laravel-whatsapp-cloud
php artisan whatsapp:install
php artisan migrate

Provider Comparison

Quick Start (API unchanged)

use Vendor\LaravelWhatsAppCloud\Facades\WhatsApp;

WhatsApp::send('923001234567', 'Hello World');
WhatsApp::account(1)->sendText('923001234567', 'Hello');
WhatsApp::using('marketing')->send('923001234567', 'Sale Started');
WhatsApp::queue()->send('923001234567', 'Queued message');

Supported Methods

WhatsApp::sendText($to, $message, $previewUrl = false);
WhatsApp::sendTemplate($to, 'hello_world', 'en_US', $components);
WhatsApp::sendImage($to, 'https://example.com/image.jpg', $caption);
WhatsApp::sendDocument($to, 'https://example.com/doc.pdf', $filename, $caption);
WhatsApp::sendAudio($to, 'https://example.com/audio.mp3');
WhatsApp::sendVideo($to, 'https://example.com/video.mp4', $caption);
WhatsApp::sendLocation($to, 24.86, 67.00, 'Office', 'Address');

Meta Cloud API Setup

1. Create a Meta App

1. Go to Meta for Developers
2. Create an app with WhatsApp product enabled
3. Add a phone number and generate a permanent access token
4. Copy Phone Number ID and Access Token

2. Create Account (code or admin)

use Vendor\LaravelWhatsAppCloud\Models\WhatsAppAccount;

WhatsAppAccount::create([
    'name' => 'primary',
    'provider' => WhatsAppAccount::PROVIDER_META,
    'phone_number' => '923001234567',
    'phone_number_id' => 'YOUR_PHONE_NUMBER_ID',
    'access_token' => 'YOUR_ACCESS_TOKEN',
    'app_secret' => 'YOUR_META_APP_SECRET',
    'webhook_verify_token' => 'my-secret-token',
    'is_default' => true,
    'is_active' => true,
]);

3. Configure Webhook

GET/POST  /whatsapp/webhook

WHATSAPP_APP_SECRET=your-meta-app-secret
WHATSAPP_WEBHOOK_REQUIRE_SIGNATURE=true

Twilio WhatsApp Setup

1. Enable WhatsApp in Twilio

1. Sign up at Twilio
2. Enable WhatsApp Sandbox or register a WhatsApp sender
3. Copy Account SID, Auth Token, and WhatsApp number

2. Create Twilio Account

WhatsAppAccount::create([
    'name' => 'twilio-support',
    'provider' => WhatsAppAccount::PROVIDER_TWILIO,
    'phone_number' => '923001234567',
    'twilio_sid' => 'ACxxxxxxxx',
    'twilio_token' => 'your_auth_token',
    'twilio_whatsapp_number' => '14155238886',
    'is_default' => false,
    'is_active' => true,
]);

3. Send via Twilio provider

WhatsApp::using('twilio-support')->sendText('923001234567', 'Hello from Twilio');

Provider Architecture

WhatsApp::send()
    └── WhatsAppManager
            └── ProviderFactory::make($account)
                    ├── MetaProvider
                    └── TwilioProvider

Extend with custom providers

Implement WhatsAppProviderInterface and register in config/whatsapp.php:

'providers' => [
    'meta' => \Vendor\LaravelWhatsAppCloud\Providers\MetaProvider::class,
    'twilio' => \Vendor\LaravelWhatsAppCloud\Providers\TwilioProvider::class,
],

Conversation Platform

The package automatically tracks conversations:

• Incoming: stored automatically from webhooks
• Outgoing: stored when WhatsApp::send() succeeds

Disable with WHATSAPP_CONVERSATIONS_ENABLED=false.

Admin URLs

Admin Panel

/admin/whatsapp/accounts — create accounts with provider-specific fields:

• Meta: Phone Number ID, Access Token, App Secret, Webhook Verify Token
• Twilio: Account SID, Auth Token, WhatsApp Number

Environment Variables

WHATSAPP_DEFAULT_ACCOUNT=
WHATSAPP_DEFAULT_PROVIDER=meta
WHATSAPP_API_VERSION=v21.0
WHATSAPP_APP_SECRET=
WHATSAPP_WEBHOOK_REQUIRE_SIGNATURE=false
WHATSAPP_QUEUE_ENABLED=true
WHATSAPP_LOG_MESSAGES=true
WHATSAPP_ADMIN_AUTHORIZATION_ENABLED=true

Notifications

use Vendor\LaravelWhatsAppCloud\Notifications\WhatsAppChannel;

public function via($notifiable): array
{
    return [WhatsAppChannel::class];
}

public function toWhatsApp($notifiable): array
{
    return [
        'using' => 'twilio-support', // or account ID
        'text' => 'Your order shipped!',
        'queue' => true,
    ];
}

Webhooks (Meta)

use Vendor\LaravelWhatsAppCloud\Events\MessageReceived;

Event::listen(MessageReceived::class, function (MessageReceived $event) {
    // Handle incoming Meta message
});

Testing

composer test

Security

See SECURITY.md.

License

MIT — see LICENSE.