Omnichannel WhatsApp & Manajemen Multi-Instance
Komunikasi bisnis yang tersebar di berbagai smartphone karyawan sering menimbulkan kekacauan: chat lambat dijawab, riwayat transaksi hilang saat staf berganti, dan pemilik bisnis tidak memiliki visibilitas percakapan. Modul Omnichannel DagangBot menyatukan seluruh nomor WhatsApp toko ke dalam satu dasbor pusat terpadu.
Stable1. Ikhtisar & Nilai Bisnis
Dengan modul Omnichannel DagangBot, toko Anda dapat menghubungkan beberapa nomor WhatsApp sekaligus—mulai dari nomor CS Pusat, nomor admin Cabang Jakarta, hingga nomor CS Cabang Surabaya. Semua pesan masuk ke dalam satu kotak masuk terpadu (Unified Live Inbox) dengan dukungan respons otomatis dari AI.
- Dukungan Dual-Engine WhatsApp: Mendukung mode Scan QR (OpenWA) menggunakan engine
baileysatauwhatsapp-web.jsuntuk UMKM tanpa legalitas PT/CV. Tersedia juga mode Official Meta Cloud API untuk kebutuhan korporasi dengan verifikasi centang hijau. - Smart Routing per Cabang: Pesan masuk yang diterima oleh instance cabang tertentu otomatis dirutekan dan diisolasi ke staf admin yang bertugas di cabang tersebut.
- Proteksi Anti-Ban (Warm-up & Safe Delay): Mode OpenWA dilengkapi simulasi masa pemanasan 72 jam (72-hour anti-ban warmup) dan algoritma jeda ketik (typing jitter 2.0–5.0 detik) menggunakan distribusi Gaussian untuk mencegah blokir algoritma Meta.
- Debounce Pesan Pecah: Pesan yang dikirim terpotong-potong (misal: "Halo" → "Saya mau pesan" → "Kopi") secara otomatis ditahan dan digabung dalam jendela debouncer 10–15 detik, menghemat token AI dan mencegah balasan bertumpuk.
Setiap nomor WhatsApp yang terhubung direkam dalam tabel whatsapp_instances dengan isolasi koneksi (connection_type terpisah). Jika satu instance unofficial mengalami putus jaringan (disconnected), instance cabang lain atau koneksi official tetap beroperasi 100% normal. Arsitektur ini mencegah efek domino kegagalan (single point of failure).
1.1 Keunggulan Model Multi-Instance
Model isolasi Multi-Instance pada modul Omnichannel DagangBot didesain untuk menangani skalabilitas toko yang kompleks.
- Isolasi Beban (Load Isolation): Memisahkan lalu lintas pesan promosi (misal dari cabang utama) dengan lalu lintas layanan pelanggan keluhan (customer care cabang satelit), sehingga tidak ada hambatan laju pemrosesan antrean webhook.
- Skalabilitas Peran (Service Roles): Setiap nomor dapat disematkan peran spesifik seperti
all_in_one(melayani segala pertanyaan), atau peran khusus yang membatasi bot untuk konteks tertentu. - Keamanan Redudansi: Anda dapat memutus dan menyambungkan kembali koneksi nomor spesifik tanpa merestart keseluruhan sesi sistem pada instansi lainnya.
2. Alur Visual & Antarmuka
Berikut adalah tampilan antarmuka saat mengelola instansi nomor WhatsApp, memindai QR code perangkat OpenWA, hingga memantau percakapan terpadu di Unified Live Inbox:



3. Panduan Langkah-demi-Langkah
Ikuti prosedur berikut untuk mengonfigurasi koneksi Omnichannel di toko Anda:
- 1
Langkah 1: Akses Pengaturan Omnichannel
Buka dashboard merchant, navigasi ke menu Integrasi → WhatsApp atau Pengaturan Toko → Saluran Komunikasi. Anda akan disajikan dengan tabel ikhtisar seluruh instansi (instances) yang telah terhubung sebelumnya. Klik tombol kuning + Tambah Nomor WhatsApp di kanan atas tabel.
- 2
Langkah 2: Tentukan Metode Koneksi (Engine)
Pilih salah satu metode koneksi untuk nomor baru Anda:
- OpenWA (Scan QR): Menggunakan engine
baileysatauwhatsapp-web.js. Cocok untuk UMKM. Wajib menyiapkan smartphone toko dengan koneksi internet aktif. Tidak memerlukan proses validasi Facebook atau dokumen NIB. - Meta Cloud API (
official): Untuk bisnis terverifikasi yang mengutamakan stabilitas 100%. Memerlukan akun WhatsApp Business API resmi. Masukkan kredensial berupa Phone Number ID, WABA ID, dan Permanent System User Token dari dasbor Meta Business Manager Anda.
- OpenWA (Scan QR): Menggunakan engine
- 3
Langkah 3: Eksekusi Tautan Perangkat (Mode OpenWA)
Jika memilih mode OpenWA, layar akan menampilkan animasi tunggu (loading) saat kontainer OpenWA Client di backend (Node.js) sedang dipersiapkan (provisioning).
- Buka aplikasi WhatsApp di smartphone toko Anda.
- Pilih menu Perangkat Tertaut pada setelan aplikasi.
- Tekan Tautkan Perangkat lalu verifikasi sidik jari/PIN telepon Anda.
- Arahkan kamera belakang ke layar dashboard DagangBot untuk memindai kode QR.
- Tunggu proses sinkronisasi (syncing) sekitar 5 hingga 10 detik hingga status pada tabel instansi berubah seketika menjadi hijau Terhubung (Connected).
- 4
Langkah 4: Tentukan Cabang Operasional
Pada formulir setelan lanjutan nomor tersebut, pilih cabang operasi dari menu tarik-turun (dropdown, misal: Cabang Bandung Utama). Penetapan cabang ini sangat penting karena ID Cabang ini akan disuntikkan ke dalam relasi Branch-Scoped.
- 5
Langkah 5: Alokasi Peran & Hak Akses Agen
Tentukan Service Role untuk nomor ini (misalnya
all_in_one). Selanjutnya, pilih staf CS atau agen mana yang diberikan izin melihat inbox dari nomor ini pada modul Hak Akses (RBAC). Setelah ditekan Simpan, sistem akan secara mutlak memperbarui rekaman di dalam tabelwhatsapp_instancesdan menyebarkan relasi seketika (real-time).
3.1 Migrasi antar Engine (Switch Infra Engine)
Apabila timbangan beban perpesanan harian Anda tidak lagi sanggup ditopang engine baileys, admin platform dapat menjadwalkan transisi (Switch Infra Engine) ke whatsapp-web.js tanpa kehilangan riwayat chat.
- Masukkan input target engine dengan mengetik persis nama adaptasi baru.
- Isi alasan (reason) audit minimum 10 karakter.
- Tentukan waktu pemeliharaan (maintenance window). Notifikasi broadcast akan diberitahukan ke seluruh sesi merchant terkait.
- Proses transisi ini akan menjalankan fungsi fail-closed di backend (graceful restart), yang mana menghentikan penerimaan webhook sementara, menukar variabel
connection_type, dan menyalakan kembali proses gateway.
4. Parameter & Spesifikasi Teknis
Berikut adalah detail teknis parameter integrasi dari kedua engine WhatsApp yang didukung:
4.1 Mekanisme Safe Delay & Anti-Ban
Sistem Safe Delay Service melindungi instance OpenWA dari penghentian sepihak (blokir) oleh WhatsApp menggunakan perhitungan deterministik namun terkesan organik:
- Algoritma Kalkulasi Jeda (CalculateDelay): Waktu tunggu (delay) dihitung berdasarkan panjang karakter balasan. Formulanya adalah 3.5 detik + (jumlah karakter / 150). Waktu maksimum jeda dibatasi di 6.0 detik.
- Simulasi Pengetikan (SimulateTyping): Sebelum mengirim balasan akhir, bot memancarkan sinyal pengetikan ("composing") menggunakan standar Gaussian (random float) berdurasi di antara 2.0 detik hingga 5.0 detik, tergantung padatnya pesan balasan.
- Distribusi Warm-up (CheckWarmUpStatus): Sistem basis data memeriksa tabel
whatsapp_instances.created_at. Jika instansi nomor baru berjalan kurang dari 72 jam, bot melimitasi agregat aktivitas harian dan mengingatkan administrator toko.
4.2 Arsitektur Pemrosesan Pesan Gabungan (Chat Debouncer)
Terkadang, pelanggan mengirim instruksi pembelian dalam potongan-potongan pesan kecil per detik. Modul ini diintersep oleh Chat Debouncer pada lapisan internal chat pipeline.
- Pesan diterima via antarmuka Webhook Ingestion.
- Bukannya langsung mengeksekusi layanan LLM, webhook melempar isi pesan ke dalam
MessageDebouncer. - Kunci agregat Debounce Buffer ditandai menggunakan kombinasi Merchant ID dan nomor urut.
- Jendela tunggu (debounce window) memiliki nilai tetap standar selama 10 detik. Jika pesan yang masuk terbaca tidak lengkap (unfinished fragment, ditinjau dari fungsi asersi fragmen), jendela tunggu ini diperpanjang menjadi 15 detik (extended window), dengan penundaan agregat mentok di maksimal 25 detik (max wait threshold).
- Pengecualian: Konfirmasi afirmasi ("YA", "BATAL") serta anjuran sistem dibebaskan dari penundaan dan akan langsung di-flush.
5. Relasi & Integrasi
- Live CRM & Pengambilalihan Chat: Data dari
whatsapp_instancesdisalurkan ke antarmuka Human Takeover & Live CRM di mana CS manusia dapat melakukan intervensi dengan WebSocket Push. - Otomasi Pemrosesan (Chat Debouncer): Webhook Ingestion mengirim pesan masuk (incoming payload) menuju antrean
MessageDebounceruntuk menyatukan potongan kalimat sebelum masuk ke saluran pipeline LLM. - Operasional Cabang (Branch Operations): Setiap nomor yang dihubungkan melalui Omnichannel wajib dipetakan ID Cabang-nya untuk mengaktifkan aturan di modul Operasional Multi-Cabang.
