PHP code example of manzar / laravel-whatsapp-cloud

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

manzar / laravel-whatsapp-cloud example snippets

use Manzar\WhatsAppCloud\Facades\WhatsApp;

// Text
WhatsApp::sendText('15551234567', 'Hello');

// Media
WhatsApp::sendImage('15551234567', 'https://example.com/image.jpg', 'Sample image');
WhatsApp::sendVideo('15551234567', 'https://example.com/video.mp4', 'Sample video');
WhatsApp::sendAudio('15551234567', 'https://example.com/audio.mp3');
WhatsApp::sendDocument('15551234567', 'https://example.com/invoice.pdf', 'Invoice attached', 'invoice.pdf');
WhatsApp::sendSticker('15551234567', 'https://example.com/sticker.webp');

// Location
WhatsApp::sendLocation('15551234567', 23.8103, 90.4125, 'Dhaka', 'Bangladesh');
WhatsApp::requestLocation('15551234567', 'Please share your location');

// Contacts
WhatsApp::sendContact('15551234567', [
    'name' => ['formatted_name' => 'John Doe', 'first_name' => 'John'],
    'phones' => [['phone' => '+15551234567', 'type' => 'CELL']],
]);

WhatsApp::sendContacts('15551234567', [
    [
        'name' => ['formatted_name' => 'John Doe', 'first_name' => 'John'],
        'phones' => [['phone' => '+15551234567', 'type' => 'CELL']],
    ],
    [
        'name' => ['formatted_name' => 'Jane Doe', 'first_name' => 'Jane'],
        'phones' => [['phone' => '+15557654321', 'type' => 'WORK']],
    ],
]);

// Interactive: buttons
WhatsApp::sendButtons('15551234567', 'Choose one', [
    'yes' => 'Yes',
    'no' => 'No',
]);

// Interactive: list
WhatsApp::sendList('15551234567', 'Pick an option', 'View', [
    'Main' => [
        ['id' => 'opt_1', 'title' => 'Option 1', 'description' => 'First option'],
        ['id' => 'opt_2', 'title' => 'Option 2'],
    ],
]);

// Template (without dynamic variables)
WhatsApp::sendTemplate('15551234567', 'welcome_message', 'en_US');

// Template (with dynamic variables)
WhatsApp::sendTemplate('15551234567', 'order_update', 'en_US', [
    [
        'type' => 'body',
        'parameters' => [
            ['type' => 'text', 'text' => 'John'],
            ['type' => 'text', 'text' => 'ORD-123'],
        ],
    ],
]);

// Flow
WhatsApp::sendFlow(
    '15551234567',
    'flow_id_123',
    'Start Flow',
    'published',
    'optional-flow-token',
    ['screen' => 'WELCOME']
);

// Reactions
WhatsApp::react('15551234567', 'wamid.HBgM...', '👍');
WhatsApp::unreact('15551234567', 'wamid.HBgM...');

// Read receipts
WhatsApp::markAsRead('wamid.HBgM...');

// Upload only
$uploaded = WhatsApp::uploadMedia('/path/to/photo.jpg', 'image/jpeg');

// Upload + send in one step
WhatsApp::uploadAndSendImage('15551234567', '/path/to/photo.jpg', 'image/jpeg', 'Caption');
WhatsApp::uploadAndSendVideo('15551234567', '/path/to/video.mp4', 'video/mp4', 'Video caption');
WhatsApp::uploadAndSendAudio('15551234567', '/path/to/audio.mp3', 'audio/mpeg');
WhatsApp::uploadAndSendDocument('15551234567', '/path/to/file.pdf', 'application/pdf', 'Invoice', 'invoice.pdf');
WhatsApp::uploadAndSendSticker('15551234567', '/path/to/sticker.webp', 'image/webp');

use Manzar\WhatsAppCloud\Facades\WhatsApp;

// Option 1: get raw binary bytes (store in DB, stream to browser, etc.)
$bytes = WhatsApp::downloadMedia($incomingMessage->media_id);

// Stream directly to the browser
return response($bytes, 200)->header('Content-Type', 'image/jpeg');

// Option 2: save to a local path, returns the saved path
$path = WhatsApp::downloadMediaTo(
    $incomingMessage->media_id,
    storage_path('app/whatsapp/media/' . $incomingMessage->media_id . '.jpg')
);

// Option 3: use the media service directly for more control
$meta = WhatsApp::getMediaUrl($incomingMessage->media_id);
// $meta['url']       — authenticated temporary URL
// $meta['mime_type'] — e.g. image/jpeg
// $meta['sha256']    — checksum for verification

$templates = WhatsApp::templates()->list();
$single = WhatsApp::templates()->get('order_update');

// Build payload with dynamic variable examples (recommended)
$payload = WhatsApp::buildTemplateCreatePayload(
    'order_update',
    'en_US',
    'UTILITY',
    [
        [
            'type' => 'body',
            'text' => 'Hi {{1}}, your order {{2}} is confirmed.',
        ],
    ],
    [
        'BODY' => [
            'body_text' => [['John', 'ORD-123']],
        ],
    ]
);

$created = WhatsApp::templates()->create($payload);

$created = WhatsApp::templates()->create([
    'name' => 'order_update',
    'language' => 'en_US',
    'category' => 'UTILITY',
    'components' => [
        [
            'type' => 'BODY',
            'text' => 'Hi {{1}}, your order {{2}} is confirmed.',
        ],
    ],
]);

$updated = WhatsApp::templates()->update('TEMPLATE_ID', [
    'category' => 'UTILITY',
]);

// Manager passthrough helper
WhatsApp::updateTemplate('TEMPLATE_ID', ['category' => 'UTILITY']);

$deleted = WhatsApp::templates()->delete('order_update');

use Manzar\WhatsAppCloud\Models\WhatsAppIncomingMessage;
use Manzar\WhatsAppCloud\Models\WhatsAppOutgoingMessage;
use Manzar\WhatsAppCloud\Models\WhatsAppMessageStatus;
use Manzar\WhatsAppCloud\Models\WhatsAppWebhookLog;

// All unread incoming text messages
WhatsAppIncomingMessage::where('type', 'text')->latest()->get();

// All outgoing messages not yet delivered
WhatsAppOutgoingMessage::whereIn('status', ['pending', 'sent'])->get();

// Status history for a specific message
WhatsAppMessageStatus::where('wamid', 'wamid.HBgM...')->orderBy('sent_at')->get();

use Manzar\WhatsAppCloud\Contracts\WhatsAppStorageInterface;

// In AppServiceProvider::register()
$this->app->bind(WhatsAppStorageInterface::class, MyCustomStorage::class);

bash
php artisan vendor:publish --tag=whatsapp-config

bash
php artisan vendor:publish --tag=whatsapp-migrations
php artisan migrate

dotenv
WHATSAPP_LOG_OUTGOING=true