Campaigns

Broadcast

Copy page

Broadcast

Broadcast memungkinkan Anda mengirim pesan WhatsApp template ke banyak penerima sekaligus. Fitur ini cocok untuk notifikasi, promosi, atau update ke pelanggan.

Persyaratan

Sebelum membuat broadcast, pastikan:

1. Template sudah approved - Hanya template yang disetujui WhatsApp yang bisa digunakan
2. Device terhubung - Pilih device yang akan digunakan untuk mengirim
3. Kontak tersedia - Penerima harus sudah ada di daftar kontak

Membuat Broadcast

1. Buka Broadcast di sidebar
2. Pilih Device yang akan digunakan
3. Klik Buat Broadcast
4. Isi form:
   • Nama Broadcast: Nama untuk identifikasi
   • Template: Pilih template yang sudah approved
   • Penerima: Pilih kontak tujuan
   • Schedule (opsional): Jadwalkan waktu kirim
5. Klik Create

Status Broadcast

Status	Deskripsi
draft	Broadcast belum dimulai
running	Sedang dalam proses pengiriman
completed	Semua pesan sudah terkirim
failed	Gagal (lihat detail untuk error)

Statistik Broadcast

Setiap broadcast menampilkan:

• Total: Jumlah total penerima
• Sent: Jumlah pesan terkirim
• Delivered: Jumlah pesan terdelivered
• Read: Jumlah pesan terbaca
• Failed: Jumlah pengiriman gagal

Detail Penerima

Klik broadcast untuk melihat detail per penerima:

• Nama/nomor kontak
• Status pengiriman
• Waktu terkirim
• Error message (jika gagal)

Memulai Broadcast

Broadcast dengan status draft bisa dimulai:

1. Klik tombol Start
2. Konfirmasi pengiriman
3. Broadcast akan mulai mengirim secara bertahap

Catatan: Pengiriman dilakukan secara bertahap untuk menghindari rate limiting dari WhatsApp.

Menghapus Broadcast

1. Klik icon Delete pada broadcast
2. Konfirmasi penghapusan

Catatan: Broadcast yang sudah berjalan tidak bisa dihapus.

Best Practices

1. Test dengan kelompok kecil - Kirim ke beberapa kontak dulu sebelum blast besar
2. Gunakan template yang tepat - Pastikan template sesuai konteks
3. Perhatikan timing - Kirim di jam yang tepat untuk audience Anda
4. Monitor statistik - Perhatikan delivery rate dan read rate
5. Segmentasi kontak - Gunakan tags untuk menarget audience yang tepat

Rate Limiting

WhatsApp membatasi jumlah pesan yang bisa dikirim:

• Tier 1: 1.000 pesan/hari
• Tier 2: 10.000 pesan/hari
• Tier 3: 100.000 pesan/hari
• Tier 4: Unlimited

Tier Anda tergantung kualitas nomor dan riwayat pengiriman.

API

Create Broadcast

Code
 
curl -X POST "https://api.kirim.dev/api/public/v1/broadcasts" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kc_live_xxx" \
  -H "X-Workspace-ID: 123" \
  -d '{
    "name": "Promo Akhir Tahun",
    "device_id": 1,
    "template_id": 10,
    "recipient_ids": [1, 2, 3, 4, 5]
  }'

Start Broadcast

Code
 
curl -X POST "https://api.kirim.dev/api/public/v1/broadcasts/:id/start" \
  -H "X-API-Key: kc_live_xxx" \
  -H "X-Workspace-ID: 123"

Troubleshooting

Pesan tidak terkirim

1. Cek status device di dashboard
2. Pastikan template masih approved
3. Cek rate limit tier di Meta Business Suite
4. Lihat error message di detail penerima

Template tidak muncul

1. Pastikan template sudah approved di WhatsApp
2. Sync templates dari Meta dengan klik Sync Templates
3. Cek apakah template untuk device yang dipilih