explorin/wapi

Laravel SDK & Fluent Message Builder for WAPI Service

dev-main 2026-08-10 15:43 UTC

Requires

• php: ^7.4|^8.0
• illuminate/http: ^7.0|^8.0|^9.0|^10.0|^11.0
• illuminate/support: ^7.0|^8.0|^9.0|^10.0|^11.0

MIT

• Explorin

Published on Packagist.org on 2026-08-10 15:48 UTC

README

Package SDK Laravel resmi dari Explorin untuk mengirimkan pesan WhatsApp (pesan langsung & template message) via HTTP service WAPI secara mudah dan ringkas.

Fitur Utama

• 🚀 Expressive & Simple Syntax: Mengirim pesan hanya dengan 1 baris kode yang sangat sederhana.
• 💬 Support Template & Direct Message: Mengirim pesan biasa atau menggunakan kode template & parameter.
• 📎 Media & Attachment Support: Mengirim file via URL maupun direct upload file lokal.
• ⚙️ Laravel Auto-Discovery & Facade: Otomatis teregister Wapi Facade.
• 📦 Vendor Publishing: Mudah menerbitkan file konfigurasi config/wapi.php.

Instalasi

Install package melalui Composer:

composer require explorin/wapi

Publish Konfigurasi

Jalankan perintah berikut untuk menerbitkan file konfigurasi config/wapi.php:

php artisan vendor:publish --tag="wapi-config"

Konfigurasi .env

Tambahkan kredensial WAPI ke dalam file .env project Anda:

WAPI_URL=https://wapi.domainanda.com
WAPI_KEY=your_wa_api_key_here
WAPI_TIMEOUT=30

Cara Penggunaan

Gunakan Facade Explorin\Wapi\Facades\Wapi:

1. Mengirim Pesan Biasa (Super Ringkas)

Paling Ringkas (1 Baris):

use Explorin\Wapi\Facades\Wapi;

// Format: Wapi::message($isiPesan, $nomorTujuan)->send()
Wapi::message('Halo, ini pesan pemberitahuan langsung dari aplikasi.', '081234567890')->send();

Atau dengan Chaining (Fluid):

Wapi::message('Halo, ini pesan pemberitahuan.')
    ->to('081234567890')
    ->send();

2. Mengirim Pesan Template dengan Parameter

Sintaks Ringkas:

use Explorin\Wapi\Facades\Wapi;

// Format: Wapi::template($kodeTemplate, $parameters, $nomorTujuan)->send()
Wapi::template('verifikasi_otp', [
    'nama' => 'Imam',
    'otp'  => '592019',
    'exp'  => '5 menit'
], '081234567890')->send();

Atau dengan Chaining (Fluid):

Wapi::message()
    ->to('081234567890')
    ->template('verifikasi_otp', [
        'nama' => 'Imam',
        'otp'  => '592019',
    ])
    ->send();

3. Mengirim Pesan Template + File Lampiran via URL

use Explorin\Wapi\Facades\Wapi;

Wapi::template('tagihan_pembayaran', [
        'bulan' => 'Agustus 2026',
        'total' => 'Rp 150.000'
    ], '081234567890')
    ->withFileUrl('https://domain.com/invoices/INV-2026-001.pdf')
    ->send();

4. Mengirim Pesan dengan Upload File Lokal

use Explorin\Wapi\Facades\Wapi;

Wapi::message('Berikut lampiran dokumen pendukung Anda.', '081234567890')
    ->withFile(storage_path('app/public/berkas.pdf'))
    ->send();

Lisensi

The MIT License (MIT). Silakan lihat LICENSE untuk informasi lebih lanjut.