bale / vada
Inbox chat admin WhatsApp untuk tenant Bale CMS
Requires
- php: ^8.3
- bale/cms: *
- bale/core: *
- bale/wara: *
- illuminate/contracts: ^11.0||^12.0||^13.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-22 18:18:26 UTC
README
Inbox chat WhatsApp untuk tenant Bale CMS. Admin tenant membaca percakapan, membalas teks atau media, mengutip pesan, dan menghapus pesan langsung dari dashboard. Package ini hanya berisi ruang kerja chat; halaman, layout, dan judulnya milik package pemanggil.
Data percakapan disimpan di database tenant, bukan landlord: satu tenant hanya
melihat nomornya sendiri. Pengiriman dan penerimaan WhatsApp didelegasikan ke
bale/wara; Vada tidak tahu detail gateway.
Kemampuan
| Kemampuan | Keterangan |
|---|---|
| Daftar percakapan | Dikelompokkan per nomor, diurutkan last_message_at, pencarian nomor lewat blind index |
| Thread pesan | 200 pesan terakhir, polling ringan, penanda belum dibaca |
| Kirim teks | Antre lewat job, status queued → sent → delivered → read |
| Kirim media | Gambar (jpg/jpeg/jfif/png/webp), audio (ogg/mp3), dokumen (pdf/doc/docx/xls/xlsx); video dan stiker belum didukung |
| Balas pesan | Reply WhatsApp asli (reply_message_id), termasuk kutipan dari pesan masuk |
| Hapus pesan | Hapus untuk saya, atau tarik untuk semua orang (revoke) |
| Pesan masuk | Listener WaraIncomingMessage menyimpan teks, media, echo dari HP, dan kutipan |
| Panel konteks | Provider dari package lain bisa menampilkan data kontak di sidebar kanan |
| Media | Salinan milik Bale di disk privat, disajikan lewat URL bertanda tangan untuk gateway |
Kebutuhan
| Dependency | Alasan |
|---|---|
PHP ^8.3 |
Kebutuhan runtime |
bale/cms |
Multi-tenancy, koneksi database tenant, permission |
bale/core |
Auth, komponen UI, layout |
bale/wara |
Pengiriman dan penerimaan WhatsApp |
Laravel ^11 || ^12 || ^13 |
Kompatibilitas lintas versi |
Livewire ^4 |
Komponen inbox chat |
Instalasi
Package ini adalah Composer path repository di dalam monorepo bale-dev,
bukan paket Packagist. Daftarkan dulu di composer.json aplikasi:
"repositories": [ { "type": "path", "url": "./packages/vada" } ], "require": { "bale/vada": "dev-master" }
Lalu pasang:
composer install php artisan vada:install
vada:install mempublish config, men-seed permission vada.access dan
vada.manage, mempublish migration tenant, lalu menjalankan migrasi. Gunakan
--tenant=<slug> untuk langsung memigrasi satu tenant dan --all untuk
menjalankan semua langkah tanpa prompt.
Alternatif manual:
php artisan vada:publish-config php artisan vada:publish-migrations php artisan vada:migrate --tenant=<slug>
Migrasi tabel tenant dipublikasikan ke database/migrations/vada/, bukan
database/migrations/tenant/. Jalankan vada:migrate --tenant=<slug> untuk
setiap tenant yang memakai Vada.
Setelah package terpasang, hubungkan nomor WhatsApp tenant ke device Wara:
php artisan vada:assign <slug-tenant> <session-id-device> --label="Layanan Sosial"
Satu tenant memakai satu kanal. --disable menonaktifkan kanal tanpa
menghapus percakapan.
Menampilkan Halaman Chat
Vada tidak mendaftarkan route halaman. Package pemanggil membuat halaman tipis
sendiri (contoh: bale/sidulur) dengan middleware tenant lalu merender
komponennya:
<livewire:vada.shared-components.chat.inbox />
Route halaman wajib memakai EnsureBaleSelected dan SwitchBaleConnection
supaya koneksi tenant aktif. Izin vada.access diperiksa komponen saat mount,
jadi pengguna tanpa izin ditolak 403 sebelum data tenant dibaca.
Konfigurasi
config/vada.php di-merge di register(). Semua nilai punya default yang aman.
| Env | Default | Fungsi |
|---|---|---|
VADA_INDEX_KEY |
app.key |
Kunci HMAC untuk blind index nomor; jangan diganti setelah ada data |
VADA_QUEUE_CONNECTION |
default queue | Koneksi antrean pengiriman |
VADA_QUEUE_NAME |
default |
Nama antrean pengiriman |
VADA_QUEUE_TRIES |
3 |
Batas percobaan job kirim |
VADA_POLL_SECONDS |
5 |
Interval polling halaman chat |
VADA_MAX_BODY_LENGTH |
4096 |
Panjang maksimum teks pesan |
VADA_MEDIA_DISK |
vada |
Disk penyimpanan salinan media |
VADA_MEDIA_BUCKET |
— | Bucket S3 untuk media; produksi memakai kredensial disk s3 |
VADA_MEDIA_MAX_KB |
16384 |
Ukuran maksimum unggahan |
VADA_MEDIA_PRUNE_DAYS |
100 |
Retensi media sebelum dihapus scheduler |
Antrean pengiriman membutuhkan worker (php artisan queue:work). Retensi media
dijadwalkan otomatis; cukup jalankan php artisan schedule:work.
Command
| Command | Fungsi |
|---|---|
vada:install |
Publish config, seed permission, publish migration, migrate. Opsi --tenant=, --all |
vada:publish-config |
Publish config/vada.php. Opsi --force |
vada:publish-migrations |
Publish migration tenant ke database/migrations/vada/. Opsi --force |
vada:migrate |
Migrasi database tenant. Opsi --tenant= |
vada:assign |
Tetapkan atau nonaktifkan kanal WhatsApp tenant. Opsi --label=, --disable |
vada:sync-history |
Impor riwayat chat lama dari gateway. Opsi --tenant=, --days=, --dry-run |
vada:repair-echoes |
Pindahkan echo lama dari percakapan "nomor sendiri" ke lawan bicara |
vada:prune-media |
Hapus media melewati retensi. Opsi --days=, --tenant= |
Panel Konteks Kontak
Package lain bisa menampilkan data kontak (mis. warga, pelanggan) di sidebar
kanan dengan mengimplementasikan Bale\Vada\Contracts\ContactContextProvider
lalu mendaftarkannya saat boot:
use Bale\Vada\Services\ContextRegistry; $this->app->make(ContextRegistry::class)->register(MyContactContext::class);
Panel hanya muncul bila ada provider yang mengembalikan konteks untuk nomor percakapan aktif. Semua provider bersifat global, jadi beberapa package bisa menampilkan panel untuk nomor yang sama.
Testing
vendor\bin\pest packages\vada
Credits
- Papa Ree (Ricky R) — Developer
License
MIT.