Tutorial Lengkap: Broadcast Hybrid untuk WhatsApp

Pengenalan Broadcast Hybrid

Broadcast Hybrid adalah fitur pengiriman pesan WhatsApp yang memungkinkan Anda mengirim pesan langsung ke provider (Konekwa/WABA) tanpa menggunakan template WABA yang sudah di-approve Meta.

Perbedaan dengan Broadcast WABA Biasa

Kapan Menggunakan Broadcast Hybrid?

• ✅ Butuh mengirim pesan cepat tanpa menunggu approval template Meta
• ✅ Butuh kontrol penuh terhadap waktu pengiriman (batch processing)
• ✅ Butuh mengirim pesan dalam waktu tertentu saja (time range)
• ✅ Template bersifat dinamis dan sering berubah
• ✅ Tidak ingin terikat dengan aturan template Meta

Keuntungan Menggunakan Broadcast Hybrid

1. Tidak Perlu Approval Template

Template hybrid hanya disimpan di database lokal, tidak perlu dikirim ke Meta untuk approval. Anda bisa langsung menggunakan template yang baru dibuat.

2. Fleksibilitas Konten

Tidak terikat dengan aturan ketat Meta seperti:

• Kategori template (UTILITY, MARKETING, AUTHENTICATION)
• Format bahasa yang spesifik
• Footer dan buttons yang wajib

3. Batch Processing

Mengirim pesan dalam batch kecil untuk menghindari rate limiting dan meningkatkan deliverability.

4. Time Range Control

Mengontrol kapan broadcast berjalan, misalnya hanya pada jam kerja (06:00 - 20:00).

5. Delay Configuration

Mengatur delay antar batch untuk menghindari spam detection.

Prasyarat dan Persiapan

Sebelum membuat broadcast hybrid, pastikan Anda memiliki:

1. Customer Service dengan Provider Hybrid

• Customer Service harus memiliki provider konekwa atau waba
• Customer Service harus aktif dan terhubung dengan akun WhatsApp

1. Template Hybrid

• Template dengan type_api = 'hybrid'
• Template harus memiliki body text
• Optional: Header dengan media (image/video/document)

1. Data Penerima

• CSV file dengan kolom phone (wajib)
• Optional: Kolom untuk parameter template ({{1}}, {{2}}, dll)

Membuat Template Hybrid

Langkah 1: Buka Halaman Create Template

1. Login ke dashboard
2. Navigasi ke menu Template atau Broadcast Template
3. Klik tombol Create Template atau Tambah Template

Langkah 2: Pilih Type API "Hybrid"

Di form create template, pilih Type API: Hybrid

Type API: [Hybrid ▼]

Catatan: Saat memilih Hybrid, field berikut akan disembunyikan:

• Category
• Language
• WABA ID
• Footer
• Buttons

Langkah 3: Isi Informasi Template

Template Name (Wajib)

Template Name: promo_januari_2024

• Gunakan nama yang deskriptif
• Hindari spasi, gunakan underscore (_)
• Contoh: welcome_message, promo_diskon, notifikasi_pesanan

Body Text (Wajib)

Body Text:

Halo {{1}}, selamat datang di {{2}}!

Terima kasih telah bergabung dengan kami.

Tips:

• Gunakan {{1}}, {{2}}, dll untuk parameter dinamis
• Atau gunakan named parameter: {{name}}, {{company}}
• Maksimal panjang body: sesuai limit provider

Header (Optional)

Anda bisa menambahkan header berupa:

• Text: Teks sederhana
• Media: Upload image, video, atau document

Contoh Header dengan Media:

Header: [Upload Image] promo-banner.jpg

Langkah 4: Simpan Template

Klik tombol Create Template atau Simpan

Membuat Broadcast Hybrid

Langkah 1: Buka Halaman Create Broadcast

1. Navigasi ke menu Broadcast Message
2. Klik tombol Create Broadcast atau Tambah Broadcast

Langkah 2: Pilih Type API "Hybrid"

Di form create broadcast, pilih Type API: Hybrid

Type API: [Hybrid ▼]

Langkah 3: Pilih Customer Service

Pilih Customer Service yang memiliki provider hybrid (konekwa atau waba).

Customer Service: [CS Hybrid - WABA ▼]

Catatan:

• Hanya Customer Service dengan type_api = 'hybrid' yang akan muncul
• Provider akan otomatis diambil dari Customer Service yang dipilih

Langkah 4: Pilih Template Message

Pilih template hybrid yang sudah dibuat sebelumnya.

Template Message: [promo_januari_2024 ▼]

Catatan:

• Hanya template dengan type_api = 'hybrid' yang akan muncul
• Category tidak ditampilkan untuk template hybrid

Langkah 5: Konfigurasi Batch Processing

Batch Size

Jumlah nomor yang dikirim per eksekusi.

Batch Size: [10]

Rekomendasi:

• 10-20 untuk pengiriman normal
• 5-10 untuk menghindari rate limiting
• 20-50 untuk pengiriman cepat (risiko tinggi)

Delay (detik)

Delay antar eksekusi batch.

Delay (detik): [5]

Rekomendasi:

• 5-10 detik untuk pengiriman normal
• 10-30 detik untuk menghindari spam detection
• 1-5 detik untuk pengiriman cepat (risiko tinggi)

Contoh:

• Batch size: 10, Delay: 5 detik
• Mengirim 10 nomor → tunggu 5 detik → kirim 10 nomor berikutnya

Langkah 6: Konfigurasi Time Range

Running Time Start

Waktu mulai broadcast berjalan.

Running Time Start: [06:00]

Running Time End

Waktu akhir broadcast berjalan.

Running Time End: [20:00]

Catatan:

• Broadcast hanya berjalan dalam range waktu ini
• Jika waktu saat ini di luar range, broadcast akan menunggu sampai waktu start
• Format waktu: HH:MM (24 jam)

Contoh:

• Start: 06:00, End: 20:00
• Broadcast hanya berjalan dari jam 6 pagi sampai jam 8 malam
• Jika dijadwalkan jam 22:00, broadcast akan mulai jam 06:00 keesokan harinya

Langkah 7: Pilih Tipe Customer

Option 1: Custom (Upload CSV)

Upload file CSV dengan data penerima.

Format CSV:

phone,name,company

6281234567890,John Doe,ABC Corp

6289876543210,Jane Smith,XYZ Ltd

Kolom Wajib:

• phone: Nomor WhatsApp (format: 628xxxxxxxxxx)

Kolom Optional:

• Kolom untuk parameter template ({{1}}, {{2}}, dll)
• Kolom untuk named parameter ({{name}}, {{company}}, dll)

Tips:

• Format nomor phone sebagai text di CSV (hindari scientific notation)
• Validasi CSV akan dilakukan sebelum submit

Option 2: Filter

Filter customer berdasarkan kriteria tertentu.

Filter Type: [All Customers]

Filter Source: [WhatsApp]

Filter Date Start: [2024-01-01]

Filter Date End: [2024-01-31]

Langkah 8: Set Jadwal

Pilih tanggal dan waktu untuk menjalankan broadcast.

Jadwal: [2024-01-15 10:00:00]

Catatan:

• Jika waktu jadwal di luar time range, broadcast akan mulai pada waktu start terdekat
• Contoh: Jadwal 22:00, Time range 06:00-20:00 → Broadcast mulai jam 06:00 keesokan harinya

Langkah 9: Review dan Submit

1. Review semua konfigurasi
2. Klik tombol Submit atau Create Broadcast
3. Modal Terms & Conditions akan muncul
4. Baca dan setujui terms & conditions
5. Klik Confirm untuk mengirim broadcast

Catatan:

• Biaya hybrid: 100/message akan ditampilkan di modal
• Pastikan saldo mencukupi sebelum submit

Konfigurasi Batch Processing

Cara Kerja Batch Processing

Broadcast hybrid menggunakan batch processing untuk mengirim pesan secara bertahap.

Contoh Skenario:

• Total penerima: 100 nomor
• Batch size: 10
• Delay: 5 detik

Alur Pengiriman:

Batch 1: Kirim 10 nomor (nomor 1-10)

  ↓ Delay 5 detik

Batch 2: Kirim 10 nomor (nomor 11-20)

  ↓ Delay 5 detik

Batch 3: Kirim 10 nomor (nomor 21-30)

  ↓ Delay 5 detik

...

Batch 10: Kirim 10 nomor (nomor 91-100)

Total Waktu: (10 batch × 5 detik) = 50 detik (belum termasuk waktu pengiriman)

Menghitung Waktu Pengiriman

Rumus:

Total Batch = Total Penerima / Batch Size

Total Delay = Total Batch × Delay Seconds

Total Waktu ≈ Total Delay + (Total Batch × Waktu Pengiriman per Batch)

Contoh:

• 1000 penerima
• Batch size: 20
• Delay: 10 detik
• Waktu pengiriman per batch: ~2 detik

Total Batch = 1000 / 20 = 50 batch

Total Delay = 50 × 10 = 500 detik (8.3 menit)

Total Waktu ≈ 500 + (50 × 2) = 600 detik (10 menit)

Rekomendasi Konfigurasi

Pengiriman Normal (Recommended)

Batch Size: 10-20

Delay: 5-10 detik

Time Range: 06:00 - 20:00

• Cocok untuk sebagian besar kasus
• Balance antara kecepatan dan deliverability

Pengiriman Cepat

Batch Size: 20-50

Delay: 1-5 detik

Time Range: 06:00 - 20:00

• Cocok untuk urgent broadcast
• Risiko rate limiting lebih tinggi

Pengiriman Aman (High Deliverability)

Batch Size: 5-10

Delay: 10-30 detik

Time Range: 08:00 - 18:00

• Cocok untuk broadcast penting
• Minim risiko spam detection

Contoh Penggunaan Praktis

Contoh 1: Promo Diskon Bulanan

Skenario: Mengirim promo diskon ke 500 customer setiap awal bulan.

Template:

Name: promo_diskon_januari

Body: Halo {{1}}, dapatkan diskon {{2}}% untuk semua produk! 

      Kode promo: {{3}}. Berlaku sampai {{4}}.

Broadcast Configuration:

Type API: Hybrid

Customer Service: CS Promo - WABA

Template: promo_diskon_januari

Batch Size: 15

Delay: 8 detik

Time Range: 08:00 - 20:00

Jadwal: 2024-01-01 08:00:00

Type Customer: Filter (All Customers)

CSV Format (jika Custom):

phone,name,discount,code,expiry

6281234567890,John Doe,20,DISC20,2024-01-31

6289876543210,Jane Smith,30,DISC30,2024-01-31

Contoh 2: Notifikasi Pesanan Siap

Skenario: Notifikasi pesanan siap diambil ke customer yang baru order.

Template:

Name: notifikasi_pesanan_siap

Body: Halo {{1}}, pesanan Anda #{{2}} sudah siap diambil!

      Silakan datang ke {{3}} sebelum jam {{4}}.

Broadcast Configuration:

Type API: Hybrid

Customer Service: CS Order - Konekwa

Template: notifikasi_pesanan_siap

Batch Size: 10

Delay: 5 detik

Time Range: 06:00 - 21:00

Jadwal: Sekarang (immediate)

Type Customer: Custom (Upload CSV)

CSV Format:

phone,name,order_id,location,pickup_time

6281234567890,John Doe,ORD001,Store A,18:00

6289876543210,Jane Smith,ORD002,Store B,19:00

Contoh 3: Welcome Message untuk New Customer

Skenario: Welcome message untuk customer baru yang mendaftar.

Template:

Name: welcome_new_customer

Body: Selamat datang {{1}} di {{2}}!

      Terima kasih telah bergabung. Nikmati berbagai promo menarik.

Broadcast Configuration:

Type API: Hybrid

Customer Service: CS Marketing - WABA

Template: welcome_new_customer

Batch Size: 20

Delay: 3 detik

Time Range: 07:00 - 22:00

Jadwal: 2024-01-15 09:00:00

Type Customer: Filter (New Customers, Date: Today)

Tips dan Best Practices

1. Template Design

• ✅ Gunakan nama template yang deskriptif dan konsisten
• ✅ Hindari karakter khusus di nama template
• ✅ Gunakan parameter untuk konten dinamis
• ✅ Test template dengan beberapa contoh data sebelum broadcast

2. Batch Configuration

• ✅ Mulai dengan batch size kecil (10) dan delay besar (10 detik)
• ✅ Monitor deliverability dan adjust sesuai kebutuhan
• ✅ Jangan terlalu agresif (batch size besar + delay kecil) untuk menghindari spam

3. Time Range

• ✅ Set time range sesuai jam aktif customer
• ✅ Hindari mengirim di jam istirahat (misal: 12:00-13:00, 22:00-06:00)
• ✅ Pertimbangkan timezone customer jika berbeda

4. CSV Preparation

• ✅ Format nomor phone sebagai text (hindari scientific notation)
• ✅ Validasi nomor phone sebelum upload
• ✅ Pastikan kolom parameter sesuai dengan template
• ✅ Test dengan sample kecil sebelum broadcast besar

5. Monitoring

• ✅ Monitor status broadcast secara berkala
• ✅ Check deliverability rate
• ✅ Review error messages jika ada
• ✅ Adjust konfigurasi berdasarkan hasil

6. Cost Management

• ✅ Hitung biaya sebelum broadcast (100/message)
• ✅ Pastikan saldo mencukupi
• ✅ Monitor penggunaan untuk budget planning

Troubleshooting

Masalah: Template tidak muncul di dropdown

Penyebab:

• Template belum dibuat dengan type_api = 'hybrid'
• Customer Service tidak memiliki provider hybrid

Solusi:

1. Pastikan template dibuat dengan Type API: Hybrid
2. Pastikan Customer Service memiliki provider konekwa atau waba
3. Refresh halaman atau clear cache

Masalah: Broadcast tidak berjalan

Penyebab:

• Waktu saat ini di luar time range
• Jadwal belum tercapai
• Batch processing masih berjalan

Solusi:

1. Check time range configuration
2. Check jadwal broadcast
3. Tunggu sampai waktu start tercapai
4. Check status broadcast di dashboard

Masalah: CSV validation error

Penyebab:

• Format nomor phone tidak valid
• Nomor phone dalam scientific notation
• Kolom phone tidak ada

Solusi:

1. Format nomor phone sebagai text di Excel/Google Sheets
2. Pastikan format: 628xxxxxxxxxx (tanpa +, spasi, atau karakter khusus)
3. Pastikan kolom phone ada di header CSV
4. Validasi nomor phone sebelum upload

Masalah: Parameter tidak ter-replace

Penyebab:

• Format parameter tidak sesuai
• Kolom CSV tidak sesuai dengan parameter template
• Parameter tidak ada di CSV

Solusi:

1. Pastikan format parameter: {{1}}, {{2}}, atau {{name}}
2. Pastikan kolom CSV sesuai dengan parameter template
3. Check CSV file untuk memastikan data ada

Masalah: Rate limiting atau spam detection

Penyebab:

• Batch size terlalu besar
• Delay terlalu kecil
• Terlalu banyak pengiriman dalam waktu singkat

Solusi:

1. Kurangi batch size (misal: dari 20 ke 10)
2. Tingkatkan delay (misal: dari 5 ke 10 detik)
3. Perluas time range untuk distribusi lebih merata
4. Tunggu beberapa saat sebelum broadcast berikutnya

FAQ

Q: Apakah template hybrid perlu approval dari Meta?

A: Tidak, template hybrid hanya disimpan di database lokal dan tidak perlu approval dari Meta.

Q: Berapa biaya broadcast hybrid?

A: Biaya broadcast hybrid adalah 100/message.

Q: Apakah broadcast hybrid bisa digunakan untuk marketing?

A: Ya, broadcast hybrid bisa digunakan untuk berbagai tujuan termasuk marketing, asalkan sesuai dengan kebijakan provider dan peraturan yang berlaku.

Q: Apakah bisa mengirim media dengan broadcast hybrid?

A: Ya, jika template memiliki header dengan media (image/video/document), media akan otomatis dikirim bersama pesan.

Q: Apakah broadcast hybrid mendukung parameter dinamis?

A: Ya, broadcast hybrid mendukung parameter seperti {{1}}, {{2}}, atau named parameter seperti {{name}}, {{company}}.

Q: Bagaimana cara menghitung waktu pengiriman?

A: Gunakan rumus: Total Batch × Delay Seconds + (Total Batch × Waktu Pengiriman per Batch). Lihat bagian Konfigurasi Batch Processing untuk detail.

Q: Apakah bisa mengubah konfigurasi setelah broadcast dibuat?

A: Tergantung implementasi sistem. Biasanya broadcast yang sudah dibuat tidak bisa diubah, tetapi bisa di-cancel dan dibuat ulang.

Q: Apakah broadcast hybrid lebih cepat dari broadcast WABA biasa?

A: Broadcast hybrid bisa lebih cepat karena tidak perlu approval template, tetapi kecepatan pengiriman tergantung konfigurasi batch processing.

Q: Apakah broadcast hybrid aman dari spam detection?

A: Dengan konfigurasi yang tepat (batch size kecil, delay cukup, time range sesuai), broadcast hybrid relatif aman dari spam detection.

Q: Apakah bisa menggunakan broadcast hybrid untuk broadcast besar (ribuan penerima)?

A: Ya, dengan konfigurasi batch processing yang tepat, broadcast hybrid bisa digunakan untuk broadcast besar. Pastikan time range cukup panjang untuk mengakomodasi semua batch.

Kesimpulan

Broadcast Hybrid adalah solusi fleksibel untuk mengirim pesan WhatsApp tanpa perlu approval template Meta. Dengan fitur batch processing, delay configuration, dan time range control, Anda memiliki kontrol penuh terhadap pengiriman pesan.

Key Takeaways:

• ✅ Template hybrid tidak perlu approval Meta
• ✅ Batch processing untuk kontrol pengiriman
• ✅ Time range untuk kontrol waktu aktif
• ✅ Biaya: 100/message
• ✅ Fleksibel dan mudah digunakan

Selanjutnya:

• Buat template hybrid pertama Anda
• Test dengan sample kecil
• Monitor dan optimize konfigurasi
• Scale up untuk broadcast besar

Support: Jika ada pertanyaan atau issue, silakan hubungi tim development atau buka ticket support.