Lompat ke konten utama
StableTerakhir diperbarui: 27 Okt 2026, 17.37

Broadcast WhatsApp & Manajemen Kampanye Terarah

Mengelola komunikasi massa modern memerlukan pendekatan teknis yang mempertimbangkan restriksi keamanan agregator pesan. Fitur Kampanye Broadcast (Pesan Massal) di dalam DagangBot dirancang dengan arsitektur Smart & Safe Marketing. Fitur ini menggunakan segmentasi mendalam yang dipadukan dengan algoritma penunda acak (Jitter Engine) guna mencegah penahanan nomor secara algoritmis oleh penyedia layanan (Meta), sambil secara ketat mempertahankan efisiensi sinkronisasi sistem penagihan.

Stable

1. Ikhtisar & Nilai Bisnis

Pengiriman puluhan ribu pesan ke audiens yang salah tidak hanya menghabiskan anggaran secara mubazir, tetapi juga merupakan pemicu tertinggi teguran anti-spam. Modul kampanye memecahkan persoalan rasio biaya-terhadap-konversi dengan memastikan eksekusi yang terkalkulasi dan personal.

  • Segmentasi Granular Tanpa Batas: Pembuatan kelompok audiens yang diturunkan langsung dari riwayat transaksi (misal: "tidak aktif belanja selama 60 hari"), tagar dinamis (VIP, Reseller), serta pengelompokan silang asal cabang.
  • Interpolasi Variabel Dinamis: Menginjeksi konten unik secara terprogram. Elemen {{nama}} atau {{kode_voucher}} dievaluasi saat waktu pengiriman, membuat skrip promosi terlihat murni organik di mata klien.
  • Proteksi Penundaan Acak (Jitter Anti-Ban Engine): Algoritma infrastruktur internal kami mensimulasikan pengetikan manusia dengan menyelipkan delay interval (secara bawaan, jeda 3 hingga 8 detik per penerima). Hal ini menghindari deteksi robotik dari server WhatsApp.
  • Akuntansi Kuota Lintas Batas (Atomic Deductions): Integrasi penagihan dan penguncian sistem baris basis data memastikan saldo kuota dipotong tepat di detik saat pengiriman dinyatakan berhasil. Tidak akan ada saldo terpotong ganda pada saat perulangan retry.
Peringatan Regulasi Kampanye Massa

Mengimpor senarai (list) kontak acak yang didapatkan dari praktik scraping atau pembelian pihak ketiga adalah pelanggaran mutlak. Pengiriman yang menghasilkan rasio keluhan (report) di atas 1,5% akan menahan status instance Anda secara sepihak dan memblokir port koneksi. Selalu sisipkan terminologi interupsi opt-out dalam narasi template Anda.

2. Alur Visual & Antarmuka

Antarmuka ini merangkum proses komposisi kampanye kompleks ke dalam ruang interaksi (workspace) tunggal, di mana copywriting, pelampiran media, serta penyisihan filter kontak dilakukan berdampingan dengan evaluasi pratinjau.

Antarmuka perancangan pesan kampanye siaran WhatsApp dengan simulasi preview pesan pada mockup smartphone real-time
Ruang kerja perancangan broadcast dengan editor pesan personalisasi dan pratinjau tampilan WhatsApp secara live.

3. Panduan Langkah-demi-Langkah

Prosedur berikut merinci instruksi operasional untuk merilis gelombang kampanye pemasaran digital melalui konsol administrasi yang aman.

  1. 1

    Langkah 1: Isolasi dan Kualifikasi Segmen Penerima

    Pada menu utama navigasi, tuju bagian Pemasaran → Broadcast WhatsApp, lalu proyeksikan pembuatan kampanye baru dengan menekan + Buat Kampanye. Pada tahapan ini, spesifikasikan grup filter Anda, misalnya "Semua Kontak", kumpulan data ber-tagar "Member Platinum", atau lakukan penetapan statis dengan mengunggah file struktur CSV yang memuat rincian matriks penerima. Sistem akan melakukan validasi deduplikasi format E.164.

  2. 2

    Langkah 2: Merangkai Template Pesan dan Variabel

    Ketikan substansi pemasaran Anda pada modul editor. Untuk tingkatkan personalisasi, gunakan tombol sisipan (insert) untuk membubuhi variabel. Sebagai contoh ilustrasi: "Selamat pagi Kak {{nama}}, barang spesial untuk wilayah {{kota}} kini tersedia. Tukarkan kode diskon {{voucher}} di link berikut!". Sistem bahasa alami akan menukar properti ini dari pangkalan data kontak sebelum transmisi.

  3. 3

    Langkah 3: Integrasi Perlindungan Berhenti Berlangganan (Opt-Out)

    Demi kelestarian infrastruktur WhatsApp, sistem kami mengharuskan penyematan instruksi penyangkalan di paragraf akhir, seperti: "Ketik STOP apabila tidak berkenan menerima warta penawaran ini lagi". Fitur Webhook parser kami akan memindai frasa STOP atau BERHENTI dari balasan masuk (inbound webhook). Kontak yang merespons demikian secara instan dimasukkan ke daftar pencekal sistem, mengeliminasi nomor mereka pada iterasi (batch) kampanye mendatang.

  4. 4

    Langkah 4: Ketetapan Jadwal & Kecepatan Pengiriman

    Pilih profil rentang hari pengiriman, sangat disarankan antara pukul 10:00 - 11:30 atau 19:00 - 20:30 WIB ketika rasio buka (open-rate) berada pada puncaknya. Jika basis data Anda melampaui jumlah rasional, biarkan algoritma Anti-Ban mengambil alih. Proses worker akan menunda jeda pesan sesuai toleransi konfigurasi. Lakukan klik konfirmasi Jadwalkan Kampanye.

4. Parameter & Spesifikasi Teknis

Mesin transmisi latar belakang (backend daemon) memproses ribuan data relasional dengan disiplin yang ketat, mengontrol batas limit asinkronus (Asynq tasks) untuk menjaga keutuhan arsitektur.

Parameter Fungsional Batasan Teknis / Nilai Sistem Deskripsi Penanganan Mesin
Batas Batch Pengiriman (SQL Query) 50 Penerima per Batch Pemrosesan koleksi dikunci (FOR UPDATE SKIP LOCKED) tiap blok berjumlah 50 row per loop SQL agar menghindari memori membludak.
Delay Jitter Maksimum (max_delay_seconds) 8 Detik Angka tertinggi dalam pengacakan waktu tunggu sebelum baris berikutnya dieksekusi oleh pekerja TypeBroadcastSend.
Delay Jitter Minimum (min_delay_seconds) 3 Detik Jeda absolut mutlak terkecil dari algoritma pengirim, mencegah banjir Request jaringan kepada Meta Cloud API dan Gateway OpenWA.
Variabel Resolusi yang Didukung Nama, Kota, Produk, Voucher, Kustom Ekstraksi Regex berbatas. Apabila sebuah kontak tidak melengkapi variabel bersangkutan, string substitusi (misal: "Kak") dapat ditetapkan.
Kapasitas Media (Attachment Size) JPEG/PNG/PDF (Maks. 2 MB) Muatan aset melampaui batas ini akan menghadapi reduksi agresif atau diblokir sepenuhnya sebelum ditransmisikan menuju antarmuka WhatsApp.
Perlakuan Kode Berhenti (Opt-Out Engine) STOP, UNSUBSCRIBE, BERHENTI Eksekusi instan tingkat Webhook dispatcher (Parser Logika Cepat). Otomatis menetapkan flag status isolasi tanpa perlu menarik batas komputasi OpenAI.

4.1 Strategi Jitter Engine Lanjutan

Mekanisme Jitter Engine beroperasi di latar belakang menggunakan pustaka antrian Asynq (TypeBroadcastSend). Fungsi ini bertugas mencegah API Meta membaca pola transmisi Burst yang sering disalahartikan sebagai aktivitas siber-berbahaya.

Ketika sebuah kampanye mulai berjalan (/campaigns/{id}/start), sistem membaca sisa tumpukan penerima yang berstatus queued. Worker daemon secara matematis merandomisasi delay menggunakan fungsi dasar: Delay = Min_Delay + Rand(Max_Delay - Min_Delay) Dalam setelan bawaan merchant, ini mensimulasikan jeda 3 hingga 8 detik per pengiriman. Konfigurasi min_delay_seconds tidak dapat dipaksa di bawah batas Rate-Limit penyedia jaringan, meskipun nilai diubah lewat intervensi REST API.

4.2 Pemrosesan Opt-Out Asinkron

Seluruh beban opt-out dikendalikan langsung oleh Webhook Dispatcher hulu dan melewati verifikasi antrian AI. Detik ketika kata STOP dikenali, status kontak diubah menjadi inaktif dalam tabel campaign_recipients secara absolut. Proses ini dijamin constant-time dan menghindari latensi pangkalan data. Pengiriman kampanye berikutnya (bahkan bila telah dijadwalkan sebulan sebelumnya) akan mengevaluasi flag hitam ini dan menolak mendaftarkan pesan tanpa memotong saldo token akun Anda.

5. Relasi & Integrasi

Subsistem kampanye memegang kaitan (dependency) kritikal terhadap dua tulang punggung infrastruktur, yakni manajemen Kuota Pesan (Gateway Quota) serta Pelacak Kupon Transaksional:

  1. Pemotongan Kuota Atomik Berbasis Transaksi (Gateway Quota): Setiap instance WhatsApp dapat diikat dengan langganan paket yang membatasi volume lalu lintas (Pesanan S2 T-2.9). Jika limit tercapai, pengiriman kampanye secara graceful dipaksa berhenti (Paused). Pengurangan token terjadi hanya ketika status baris campaign_recipients ditransisikan ke arah sent. Integrasi quotaService.ConsumeForMessage(...) menahan Redis SETNX/DECR serta Postgres transaction dalam operasi yang tumpang tindih untuk mencegah penagihan ganda bilamana pekerja (worker) tertimpa putus arus (timeout) asinkronus. Anda dapat menelusurinya di modul Kuota Pesan Gateway.

  2. Afiliasi Modul Voucher Khusus: Sinergi absolut dengan Voucher CRM di mana satu perulangan mesin (batch 50 nomor) mengklaim dan melampirkan UUID diskon unik secara paralel yang kemudian direkapitulasikan dalam analisis Open-Rate.

  3. Korelasi Mesin Multi-Instance (Omnichannel): Bagi merchant yang mengoperasikan beberapa lini dukungan (misal: satu nomor WA untuk CS Keluhan, dan satu lagi khusus Marketing), modul Broadcast dirancang sepenuhnya sadar-nomor (instance-aware). Saat konfigurasi kampanye disahkan, Anda dapat memilih dari titik integrasi Omnichannel mana pesan akan diberangkatkan. Ini menjamin bahwa balasan inbound dari prospek tidak mencemari antrean tiket komplain prioritas yang ditangani staf teknis, memastikan kualitas kontrol dan delegasi tugas di Live CRM tetap rapi.

6. Pemecahan Masalah (Troubleshooting)

Prosedur diagnosis gangguan di lingkungan pengiriman terarah telah dipetakan sebagai berikut:

Simtom Diagnostik (Gejala) Temuan & Analisis Indikator (Root Cause) Tindakan Perbaikan (Resolusi)
Seluruh kampanye tersendat / macet seketika (Status: Paused) Status koneksi instance (mesin OpenWA) Anda telah memutus sesi jabat tangan enkripsi (terputus/baterai habis). Restorasi ulang kode QR / verifikasi port Instance dalam menu Omnichannel. Daemon pengirim akan mengulangi dari sisa antrian (recipients) terakhir secara mandiri.
Gelombang besar pengiriman dinyatakan "Gagal" (Failed) Rentetan nomor kontak tujuan diformat secara cacat, atau menggunakan digit seluler yang sepenuhnya tidak tercatat di infrastruktur global Meta. Standardisasi basis koleksi kontak Anda menjadi format E.164 murni tanpa tambahan spasi, ekstensi lokal (08xxx) maupun tanda kurung.
Penahanan akun / Peringatan Spam WhatsApp di Panel Rasio "Report Spam" oleh pelanggan yang menerimanya telah menyentuh batas rawan (biasa > 1%). Tingkatkan kemurnian (hygiene) segmentasi; hubungi pelanggan lama yang masih menaruh afeksi loyal saja, serta tonjolkan secara dominan kalimat Ketik STOP untuk peredaman dini.
Variabel variabel seperti {{nama}} tak berubah (Kosong) Parameter baris kontak di tabel profil konsumen tidak memuat rekam jejak kolom identitas terkait (Null Field). Terapkan konstruksi nilai jatuh (fallback parameter) di dalam templat: {{nama|Pelanggan Setia}} untuk menangkis celah antarmuka bila kekosongan identitas terdeteksi.
Sistem mencegah klik "Jadwalkan" dengan peringatan kuota Kalkulasi total recipients membelah nilai kuota penagihan yang masih tersisa pada keranjang Merchant bulan ini. Reduksi besaran target dari filter audiens, atau lakukan Top-up Saldo instan ke arah Paket dan Langganan.
Pesan diblokir karena muatan lampiran hilang/korup Berkas attachment media berdimensi atau bervolume lebih dari 2 Megabyte, yang ditolak oleh API Meta pada detik eksekusi. Gunakan perangkat lunak optimisasi gambar yang mengkompres aset Anda ke rentang ukuran yang lebih wajar, yakni 500 KB hingga 1 MB.
Rasio konversi 0% setelah status pengiriman dinyatakan lengkap Variabel promo tertanam tidak di-bind dengan sub-modul pembuatan kode Voucher pada menu Pemasaran. Pastikan variabel referensi telah dipetakan, dan UUID voucher yang Anda sertakan telah diset aktif (Enable) dalam durasi validasi yang selaras dengan hari pengiriman promosi.
Tombol "Kirim Sekarang" lumpuh / berwarna abu-abu kusam Hak akses Anda berada dalam Role staf yang kekurangan klausa RBAC otorisasi kampanye siar (hak baca tanpa hak memutus eksekusi). Mohon hubungi Administrator Toko berwewenang atau pemilik Tenant Utama untuk memodifikasi hak staf profil Anda via menu RBAC & Pengguna.

7. Referensi Terkait

Korelasi fitur-fitur yang memperluas dan mendukung mekanika pemasaran periklanan DagangBot, ditautkan melalui panel modul di bawah ini:

content/docs/features/broadcast.mdx
Terakhir diperbarui: 27 Okt 2026, 17.37

Dokumentasi teknis DagangBot