KirimChat menggunakan WhatsApp Business API dengan mode Coexistence yang memungkinkan Anda tetap menggunakan aplikasi WhatsApp Business di HP sambil menerima pesan melalui KirimChat.
Apa itu Mode Coexistence?
Mode Coexistence adalah fitur dari WhatsApp Business API yang memungkinkan:
- Dual Access: Pesan masuk diterima di KirimChat DAN aplikasi WhatsApp Business di HP
- Balas dari Mana Saja: Anda bisa membalas dari KirimChat atau langsung dari HP
- Tidak Perlu Logout: Aplikasi WhatsApp Business di HP tetap aktif
Mode Coexistence hanya tersedia untuk WhatsApp Business App, bukan WhatsApp biasa (personal).
Persyaratan
Sebelum menghubungkan WhatsApp, pastikan Anda memiliki:
- Nomor WhatsApp Business - Nomor yang sudah terdaftar di WhatsApp Business App
- Business Portfolio atau Business Manager - Harus sudah terdaftar di Meta Business Suite
- WhatsApp Business sudah aktif minimal 2 bulan - Persyaratan dari Meta untuk kualitas akun
- Verifikasi Bisnis (Direkomendasikan) - Akun bisnis yang sudah terverifikasi memiliki peluang lebih tinggi untuk berhasil
- Akses Admin - Ke akun KirimChat dan Meta Business Suite Anda
Persyaratan Usia Akun WhatsApp Business Anda harus sudah aktif dan digunakan secara konsisten minimal 2 bulan sebelum dapat dihubungkan ke API. Ini adalah persyaratan dari Meta untuk memastikan kualitas dan kredibilitas akun bisnis.
Peringatan Penting - Kebijakan Meta Proses koneksi WhatsApp sepenuhnya bergantung pada kebijakan dan persetujuan Meta.
Koneksi dapat GAGAL dalam situasi berikut:
- ❌ Akun sedang Under Review oleh Meta
- ❌ Akun Ditolak atau tidak memenuhi kebijakan Meta
- ❌ Akun Dinonaktifkan karena pelanggaran
- ❌ Tidak memenuhi persyaratan kualitas akun
- ❌ Aktivitas mencurigakan atau spam terdeteksi
KirimChat TIDAK DAPAT membantu jika proses koneksi gagal karena alasan di atas. Anda harus menghubungi Meta Business Support untuk menyelesaikan masalah dengan akun Meta/WhatsApp Anda terlebih dahulu.
Pastikan akun WhatsApp Business dan Meta Business Suite Anda dalam kondisi baik dan mematuhi WhatsApp Business Policy sebelum mencoba menghubungkan.
Langkah-langkah Koneksi
1. Buka Halaman WhatsApp
- Login ke dashboard KirimChat
- Klik menu WhatsApp di sidebar
- Klik tombol Connect WhatsApp Business
2. Mulai Proses Koneksi
- Akan muncul pop-up konfirmasi
- Klik Lanjutkan untuk melanjutkan proses
3. Login dengan Facebook
- Anda akan diarahkan ke halaman login Facebook
- Login menggunakan akun Facebook yang memiliki akses ke Meta Business Suite
- Klik Lanjutkan setelah login berhasil
4. Pilih Portofolio Bisnis & Akun WhatsApp
- Pilih Portofolio Bisnis (Business Portfolio) yang sesuai
- Pilih Akun WhatsApp Business yang ingin dihubungkan
- Pilih opsi Hubungkan aplikasi WhatsApp Bisnis untuk mengaktifkan mode Coexistence
- Klik Berikutnya
5. Masukkan Nomor WhatsApp
- Masukkan nomor WhatsApp Business Anda
- Pastikan nomor dalam format yang benar (contoh: 628123456789)
- Klik Berikutnya atau Kirim
6. Verifikasi di HP
- Tunggu hingga muncul notifikasi dari Facebook di aplikasi WhatsApp Business di HP Anda
- Buka notifikasi tersebut
- Klik tombol Connect pada pesan dari Facebook
7. Scan QR Code
- Setelah klik Connect.
- Scan QR code yang ditampilkan di dashboard KirimChat
- Tunggu hingga proses koneksi selesai
8. Verifikasi Koneksi
- Setelah QR code berhasil di-scan, status akan berubah menjadi Connected
- Kirim pesan test dari nomor lain ke WhatsApp Business Anda
- Pastikan pesan muncul di dashboard KirimChat
- Coba balas dari KirimChat dan verifikasi pesan terkirim
Batasan Mode Coexistence
| Fitur | Ketersediaan |
|---|---|
| Terima pesan | Di KirimChat dan HP |
| Kirim pesan | Dari KirimChat atau HP |
| Template messages | Hanya dari KirimChat/API |
| Interactive messages | Hanya dari KirimChat/API |
| Broadcast | Hanya dari KirimChat |
| Webhook notifications | Tersedia |
Biaya WhatsApp Business API
WhatsApp Business API menggunakan model biaya berbasis conversation yang dikelola oleh Meta.
Kapan Gratis?
✅ GRATIS - Membalas pesan customer dalam jendela 24 jam:
- Customer mengirim pesan ke Anda
- Anda membalas dalam waktu 24 jam
- Tidak ada biaya yang dikenakan
Kapan Berbayar?
💰 BERBAYAR - Berikut situasi yang dikenakan biaya:
- Template Messages - Mengirim pesan template di luar jendela 24 jam
- Broadcast - Mengirim pesan ke banyak customer sekaligus
- Inisiasi Percakapan - Mengirim pesan pertama ke customer yang belum chat
Cara Menghemat Biaya
- Balas dalam 24 jam - Pastikan semua pesan customer dibalas dalam jendela 24 jam
- Gunakan template dengan bijak - Hanya kirim template untuk notifikasi penting
- Hindari broadcast berlebihan - Kirim broadcast hanya saat diperlukan
Harga per Conversation
Harga bervariasi tergantung negara tujuan. Untuk Indonesia:
- Service Conversation: ~Rp 300-500 per conversation (balas customer)
- Marketing Conversation: ~Rp 600-1000 per conversation (broadcast, template)
Harga aktual dapat berubah sesuai kebijakan Meta. Cek harga terkini di WhatsApp Platform Pricing.
Troubleshooting
Pesan tidak muncul di KirimChat
- Pastikan koneksi masih aktif di menu WhatsApp > Check Status
- Cek apakah ada error di status channel
- Coba disconnect dan connect ulang
Mode Coexistence tidak tersedia
- Pastikan menggunakan WhatsApp Business App (bukan WA personal)
- Update aplikasi WhatsApp Business ke versi terbaru
- Hubungi support jika masalah berlanjut
Pesan dari KirimChat tidak terkirim
- Periksa apakah nomor penerima valid
- Untuk pesan di luar jendela 24 jam, gunakan template message
- Cek saldo/quota di Meta Business Suite
FAQ
Q: Apakah saya harus membayar ke Meta?
A: Membalas pesan customer dalam jendela 24 jam adalah GRATIS. Anda hanya dikenakan biaya untuk:
- Template messages - Pesan template yang dikirim di luar jendela 24 jam
- Broadcast - Mengirim pesan ke banyak customer sekaligus
Biaya ini ditagih langsung oleh Meta berdasarkan jumlah conversation. KirimChat tidak mengenakan biaya tambahan untuk penggunaan channel WhatsApp.
Untuk menghemat biaya, maksimalkan membalas pesan customer dalam waktu 24 jam sejak mereka mengirim pesan terakhir.
Q: Apa itu jendela 24 jam?
A: Jendela 24 jam adalah periode waktu sejak customer mengirim pesan terakhir kepada Anda. Dalam periode ini, Anda bisa membalas dengan pesan apapun secara gratis. Setelah 24 jam, Anda hanya bisa mengirim template message yang sudah disetujui Meta (berbayar).
Q: Bisakah saya menghubungkan lebih dari satu nomor?
A: Tidak Q: Apa yang terjadi jika saya membalas dari HP?
A: Pesan akan tetap tercatat di KirimChat dan webhook tetap dikirim. Namun, pesan yang dikirim dari HP tidak akan muncul di dashboard KirimChat secara real-time.
Koneksi Manual dengan Access Token
Selain metode Embedded Signup (login dengan Facebook), Anda juga dapat menghubungkan WhatsApp dengan memasukkan Access Token dan WABA ID secara manual. Metode ini cocok untuk:
- Pengguna yang sudah memiliki WhatsApp Business API setup sendiri
- Integrasi dengan BSP (Business Solution Provider) lain
- Kebutuhan enterprise dengan konfigurasi khusus
Persyaratan Manual Login
- WhatsApp Business Account ID (WABA ID) - ID akun WhatsApp Business Anda
- Permanent Access Token - Token akses yang tidak expire
Cara Mendapatkan WABA ID
WABA ID (WhatsApp Business Account ID) adalah identifier unik untuk akun WhatsApp Business Anda di Meta.
Langkah-langkah:
-
Login ke Meta Business Suite
- Buka business.facebook.com
- Login dengan akun Facebook yang memiliki akses ke Business Manager
-
Akses WhatsApp Manager
- Klik Business Settings di menu
- Pilih Accounts > WhatsApp Accounts
- Atau langsung ke: business.facebook.com/wa/manage
-
Temukan WABA ID
- Pilih WhatsApp Business Account Anda
- WABA ID akan terlihat di URL browser atau di halaman detail
- Format: angka panjang seperti
1069013675189724
Alternatif via Meta Developer Console:
- Buka developers.facebook.com/apps
- Pilih App Anda
- Klik WhatsApp > API Setup di sidebar
- WABA ID ditampilkan di bagian atas halaman
Cara Mendapatkan Permanent Access Token
Token temporary dari Meta hanya berlaku 24 jam. Untuk produksi, Anda membutuhkan Permanent Access Token yang tidak expire.
Token permanent hanya bisa dibuat menggunakan System User dengan role Admin.
Langkah-langkah Membuat Permanent Token:
1. Buka Meta Business Settings
- Login ke business.facebook.com/settings
- Pastikan Anda memiliki akses Admin ke Business Manager
2. Buat System User
- Di sidebar, klik Users > System Users
- Klik tombol Add
- Isi detail:
- Name:
kirimchat_api_user(atau nama deskriptif lainnya) - Role: Pilih Admin (WAJIB Admin, bukan Employee)
- Name:
- Klik Create System User
System User harus memiliki role Admin untuk bisa generate permanent token. Role Employee tidak akan bisa mengakses fitur ini.
3. Assign App ke System User
- Pilih System User yang baru dibuat
- Klik Add Assets
- Pilih Apps
- Pilih WhatsApp App Anda
- Set permission: Full Control
- Klik Save Changes
4. Assign WhatsApp Business Account
- Masih di System User, klik Add Assets lagi
- Pilih WhatsApp Accounts
- Pilih WABA Anda
- Set permission: Full Control
- Klik Save Changes
5. Generate Permanent Token
- Klik tombol Generate New Token
- Pilih App Anda dari dropdown
- Centang permissions berikut (WAJIB keduanya):
whatsapp_business_managementwhatsapp_business_messaging
- Set token expiration: Never
- Klik Generate Token
6. Simpan Token dengan Aman
Token hanya ditampilkan SEKALI! Segera copy dan simpan di tempat yang aman (misalnya password manager).