🚀 WAHA PHP Client

✨ Fitur Utama

📥 Installation

Install via Composer

Copycomposer require orlinkzz/waha-php

Atau Tambahkan ke composer.json

Copy{
    "require": {
        "orlinkzz/waha-php": "^1.0"
    }
}

⚙️ Setup

Tanpa Framework (Pure PHP)

Copyuse Orlinkzz\Waha\WahaClient;
use Orlinkzz\Waha\WahaConfig;

$config = new WahaConfig(
    baseUrl: 'http://localhost:3000',
    apiKey:  'your-api-key',
    session: 'default',
);

$waha = new WahaClient($config);

Laravel

1. Publish config file:

Copyphp artisan vendor:publish --tag=waha-config

2. Tambahkan ke .env:

CopyWAHA_BASE_URL=https://waha.yourdomain.com
WAHA_API_KEY=your-secret-key
WAHA_SESSION=default

3. Gunakan via Facade:

Copyuse Orlinkzz\Waha\Laravel\WahaFacade as Waha;

Waha::sendText('628123456789@c.us', 'Halo!');

💬 Usage

Reply ke Pesan Masuk (Anti-Banned Flow Otomatis)

Copy// Otomatis: sendSeen → startTyping → delay → stopTyping → sendText
$waha->reply('628123456789@c.us', 'Halo! Ada yang bisa kami bantu?');

Kirim via OutgoingMessage DTO

Copyuse Orlinkzz\Waha\Message\OutgoingMessage;

$message = OutgoingMessage::to('+628123456789', 'Halo {name}!')
    ->personalize('Budi');  // replace {name} + variasi spasi

$waha->send($message);

Kirim Gambar

Copy$waha->sendImage('628123456789@c.us', 'https://example.com/banner.jpg', 'Promo spesial!');

Kirim File

Copy$waha->sendFile('628123456789@c.us', 'https://example.com/invoice.pdf', 'invoice.pdf');

Session Management

Copy// Start session (scan QR di dashboard WAHA)
$waha->startSession();

// Cek status
$status = $waha->getSessionStatus();

// List semua session
$sessions = $waha->listSessions();

// Stop session
$waha->stopSession();

📨 Bulk / Broadcast Messaging

Copyuse Orlinkzz\Waha\Message\OutgoingMessage;

$contacts = [
    ['phone' => '628111111111', 'name' => 'Budi'],
    ['phone' => '628222222222', 'name' => 'Siti'],
    ['phone' => '628333333333', 'name' => 'Andi'],
];

$messages = array_map(fn($c) =>
    OutgoingMessage::to($c['phone'], 'Halo {name}, ada promo spesial!')
        ->personalize($c['name']),
    $contacts
);

$result = $waha->sendBulk(
    messages: $messages,
    onEach: function ($message, $response, $index) {
        echo "✅ Sent to {$message->chatId} ({$index})\n";
    },
    onBatchPause: function ($batchNumber, $pauseSeconds) {
        echo "⏸️  Batch {$batchNumber} selesai, pause {$pauseSeconds} detik...\n";
    }
);

echo "Sukses: {$result->successCount()} / {$result->total}\n";

if ($result->hasFailures()) {
    foreach ($result->failures() as $fail) {
        echo "❌ {$fail['chatId']}: {$fail['error']}\n";
    }
}

Di Laravel — Pakai Queue untuk Bulk

Copy// app/Jobs/SendWhatsappBlast.php

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Orlinkzz\Waha\Laravel\WahaFacade as Waha;
use Orlinkzz\Waha\Message\OutgoingMessage;

class SendWhatsappBlast implements ShouldQueue
{
    use Queueable;

    public int $timeout = 3600; // 1 jam

    public function __construct(private array $contacts, private string $template) {}

    public function handle(): void
    {
        $messages = array_map(fn($c) =>
            OutgoingMessage::to($c['phone'], $this->template)
                ->personalize($c['name']),
            $this->contacts
        );

        $result = Waha::sendBulk($messages);
        // Log result...
    }
}

// Dispatch:
SendWhatsappBlast::dispatch($contacts, 'Halo {name}, ada info penting!');

🗄️ Database Logging

Setiap request ke WAHA API otomatis tercatat di database. Support MySQL dan PostgreSQL.

Quick Start

1. Buat database dan import schema
2. Konfigurasi di .env
3. Jalankan migration (Laravel)
4. Selesai! Semua request otomatis tercatat

1. Import SQL Schema

Copy# MySQL
mysql -u root -p waha < database/sql/mysql_schema.sql

# PostgreSQL
psql -U postgres -d waha -f database/sql/postgres_schema.sql

2. Konfigurasi di .env

CopyWAHA_DB_DRIVER=mysql
WAHA_DB_HOST=127.0.0.1
WAHA_DB_PORT=3306
WAHA_DB_DATABASE=waha
WAHA_DB_USERNAME=root
WAHA_DB_PASSWORD=

3. Jalankan Migration (Laravel)

Copyphp artisan waha:migrate --force
php artisan waha:migrate --rollback --force   # rollback

Tabel Database

Apa yang Tercatat

Query Data

Copy// Log pesan
$pending = $waha->getMessageLogs('pending');
$sent    = $waha->getMessageLogs('sent');
$failed  = $waha->getMessageLogs('failed');

// Sessions
$sessions = $waha->getSessions();

// Contacts
$contacts = $waha->getContacts();
$contacts = $waha->getContacts('default'); // per session

Webhook Integration

Copypublic function handleWebhook(Request $request)
{
    app('waha')->handleIncomingMessage($request->all());
    return response()->json(['status' => 'ok']);
}

🔧 Configuration

WAHA API Configuration

Database Configuration

📚 Examples

Complete Example: Send Message with Database Logging

Copy<?php

require 'vendor/autoload.php';

use Orlinkzz\Waha\WahaClient;
use Orlinkzz\Waha\WahaConfig;

// Configure WAHA client with database
$config = new WahaConfig(
    baseUrl: 'http://localhost:3000',
    apiKey: 'your-api-key',
    session: 'default',
    database: [
        'driver' => 'mysql',
        'host' => '127.0.0.1',
        'port' => '3306',
        'database' => 'waha',
        'username' => 'root',
        'password' => '',
    ]
);

$waha = new WahaClient($config);

// Send message - automatically logged to database
try {
    $result = $waha->sendText('628123456789@c.us', 'Halo! Pesan otomatis tercatat di database.');
    echo "✅ Message sent successfully!\n";

    // Query logs
    $logs = $waha->getMessageLogs('sent');
    echo "Total sent messages: " . count($logs) . "\n";

} catch (Exception $e) {
    echo "❌ Error: " . $e->getMessage() . "\n";
}

Laravel Example: Webhook Handler

Copy<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Orlinkzz\Waha\Laravel\WahaFacade as Waha;

class WhatsAppController extends Controller
{
    // Handle incoming messages
    public function webhook(Request $request)
    {
        // Automatically log to database
        Waha::handleIncomingMessage($request->all());

        // Auto-reply with anti-banned flow
        if (isset($request->from)) {
            Waha::reply($request->from, 'Terima kasih! Pesan Anda telah diterima.');
        }

        return response()->json(['status' => 'ok']);
    }

    // Send bulk messages
    public function broadcast()
    {
        $contacts = [
            ['phone' => '628111111111', 'name' => 'Budi'],
            ['phone' => '628222222222', 'name' => 'Siti'],
        ];

        $messages = array_map(fn($c) =>
            \Orlinkzz\Waha\Message\OutgoingMessage::to($c['phone'], 'Halo {name}!')
                ->personalize($c['name']),
            $contacts
        );

        $result = Waha::sendBulk($messages);

        return response()->json([
            'success' => $result->successCount(),
            'failed' => $result->failureCount(),
            'total' => $result->total
        ]);
    }
}

🔍 Troubleshooting

Copyphp artisan config:clear
php artisan waha:migrate --force

📄 License

MIT License - Copyright (c) 2026 Orlinkzz

Lihat file LICENSE untuk detail lengkap.