Lompat ke konten utama
StableTerakhir diperbarui: 9 Okt 2026, 09.28

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.

Stable

1. 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 baileys atau whatsapp-web.js untuk 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.
Pemisahan Sesi per Instance

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:

Tabel manajemen instansi WhatsApp multi-channel dengan pemetaan cabang dan status koneksi live
Tabel manajemen instansi WhatsApp multi-channel dengan pemetaan cabang dan status koneksi live
Dialog antarmuka pemindaian kode QR OpenWA live dengan timer sesi
Dialog antarmuka pemindaian kode QR OpenWA live dengan timer sesi kadaluarsa
Dasbor Unified Live Inbox terpadu dengan penandaan kanal per instansi dan panel profil pelanggan
Dasbor Unified Live Inbox terpadu dengan penandaan kanal per instansi dan riwayat pesan pelanggan

3. Panduan Langkah-demi-Langkah

Ikuti prosedur berikut untuk mengonfigurasi koneksi Omnichannel di toko Anda:

  1. 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. 2

    Langkah 2: Tentukan Metode Koneksi (Engine)

    Pilih salah satu metode koneksi untuk nomor baru Anda:

    • OpenWA (Scan QR): Menggunakan engine baileys atau whatsapp-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.
  3. 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. 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. 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 tabel whatsapp_instances dan 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.

  1. Masukkan input target engine dengan mengetik persis nama adaptasi baru.
  2. Isi alasan (reason) audit minimum 10 karakter.
  3. Tentukan waktu pemeliharaan (maintenance window). Notifikasi broadcast akan diberitahukan ke seluruh sesi merchant terkait.
  4. 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:

Parameter Integrasi Mode OpenWA (unofficial) Mode Meta Cloud API (official)
Engine / Adaptor baileys, whatsapp-web.js Meta Graph API via Webhook Resmi
Batas Rate Limiting Kalkulasi Safe Delay (100 pesan/detik/tenant) Sesuai Tier Akun Meta (80–250/detik)
Proteksi Anti-Ban Algoritma Jitter (3.5s + panjang/150s), Warmup 72 Jam Tidak diperlukan (Resmi Meta)
Batas Debouncer Pesan Jendela 10 detik (diperpanjang 15 detik), maks tunggu 25 detik Jendela 10 detik (diperpanjang 15 detik)
Risk Score Monitoring Evaluasi faktor aktivitas (>300 pesan/jam = +20 poin risiko) Aman (Whitelisted)
Webhook Ingestion Dikelola OpenWAClient (Internal Node.js) Langsung via HandleIncoming (Chi Webhook)
Ketergantungan Perangkat Ponsel fisik WA wajib menyala & tersambung internet Tanpa ketergantungan hardware klien

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_instances disalurkan 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 MessageDebouncer untuk 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.

6. Pemecahan Masalah (Troubleshooting)

Gejala Masalah Penyebab Utama Solusi Penanganan
Status berubah menjadi "Disconnected" secara acak Smartphone toko kehabisan baterai, masuk dalam mode tidur pulas (doze mode), atau aplikasi WhatsApp HP memutus sesi. Jaga smartphone toko tetap menyala dengan Wi-Fi stabil. Matikan optimalisasi daya (Battery Saver) untuk aplikasi WhatsApp. Klik Refresh Sesi / Scan Ulang pada dasbor.
QR Code tidak muncul atau terus berputar (loading) Sistem sedang memproses perintah Switch Infra Engine (baileys ke whatsapp-web.js atau sebaliknya) yang merestart proses gateway. Tunggu 30–60 detik lalu klik tombol Muat Ulang QR. Pastikan peramban tidak memblokir antarmuka soket.
Pesan balasan AI terasa sangat lambat (lebih dari 15 detik) Sistem Safe Delay merespons beban (Rate Limit) atau pesan pelanggan terpotong banyak sehingga masuk Extended Debounce Window (15–25 detik). Hindari pengiriman pesan burst yang memicu perlindungan Anti-Ban. Batasi pesan massal yang disengaja. Fenomena lambat ini normal demi menjaga akun tetap awet.
Peringatan "Risk Score Tinggi: >300 pesan/jam" Aktivitas bot melebihi batas organik dalam 1 jam, memicu pengaman Score > 100 poin dan menandai koneksi. Aktifkan opsi perlindungan Safe Delay Jitter dan hindari membalas ribuan chat massal secara paralel. Biarkan algoritma antrean memperlambat ritme lalu pantau grafik harian.
Nomor Meta API menolak koneksi HandleIncoming Webhook Secret tidak cocok dengan profil Meta, salah perizinan ACL, atau token telah kedaluwarsa. Perbarui kunci webhook dan pastikan pengaturan langganan webhook di Business Manager (bagian Webhook Products) telah mengarah ke URL DagangBot yang benar (menyertakan /api/v1/webhook/wa).
Pesan duplikat terkirim kepada pelanggan Gangguan memori internal memutus koneksi di tengah fase Flush Chat Debouncer menyebabkan retry berlebihan tanpa rekam basis data (messages). Muat ulang kontainer mesin OpenWA dengan mengklik tombol Restart Sesi, sistem akan melakukan pembersihan tabel lock.

7. Referensi Terkait

content/docs/features/omnichannel.mdx
Terakhir diperbarui: 9 Okt 2026, 09.28

Dokumentasi teknis DagangBot