Panduan WhatsApp Business API (WABA)
Panduan lengkap untuk menghubungkan dan menggunakan WhatsApp Business API di kirim.chat.
Daftar Isi
- Pengenalan
- Menghubungkan WABA
- Coexistence (WhatsApp Business App + API)
- Quality Metrics & Monitoring
- Troubleshooting
Pengenalan
Apa itu WhatsApp Business API?
WhatsApp Business API (WABA) adalah solusi resmi dari Meta untuk bisnis yang ingin berkomunikasi dengan pelanggan dalam skala besar. Dengan WABA di kirim.chat, Anda dapat:
- Mengirim dan menerima pesan WhatsApp langsung dari dashboard
- Menggunakan template pesan yang sudah disetujui Meta
- Mengelola percakapan pelanggan secara terpusat
- Memantau kualitas pengiriman pesan
- Broadcast pesan ke ribuan pelanggan
- Menggunakan AI untuk auto-reply
Keuntungan Menggunakan API Resmi
kirim.chat menggunakan API resmi dari Meta, yang berarti:
- Akun Anda aman dan tidak berisiko diblokir
- Sesuai dengan kebijakan dan regulasi Meta
- Performa pengiriman pesan yang lebih stabil
- Fitur lengkap yang didukung oleh Meta
Menghubungkan WABA
Persyaratan
Sebelum memulai, pastikan Anda memiliki:
- Akun Facebook Business yang terverifikasi
- Nomor telepon yang belum terdaftar di WhatsApp biasa (atau gunakan Coexistence)
- Akses sebagai admin di Facebook Business Manager
Langkah-langkah Koneksi
-
Buka Menu WABA
- Login ke dashboard kirim.chat
- Navigasi ke menu WhatsApp Business Account di sidebar
-
Klik Tombol Connect
- Pada halaman WABA, Anda akan melihat kartu “Connect WhatsApp Business”
- Klik tombol “Connect with WhatsApp”
-
Proses Embedded Signup
- Akan muncul popup dari Facebook
- Login dengan akun Facebook yang terhubung ke Business Manager
- Ikuti langkah-langkah yang ditampilkan:
- Pilih atau buat Business Portfolio
- Pilih atau buat WhatsApp Business Account
- Daftarkan nomor telepon bisnis Anda
- Verifikasi nomor dengan kode OTP
-
Verifikasi Koneksi
- Setelah proses selesai, halaman akan otomatis refresh
- Anda akan melihat status “Connected” berwarna hijau
- Informasi WABA ID dan nama bisnis akan ditampilkan
Informasi yang Ditampilkan Setelah Terkoneksi
| Informasi | Keterangan |
|---|---|
| WABA ID | ID unik WhatsApp Business Account Anda |
| Business Name | Nama bisnis yang terverifikasi |
| Timezone | Zona waktu akun |
| Currency | Mata uang yang digunakan |
| Last Synced | Waktu sinkronisasi terakhir |
Mengelola Koneksi
Refresh Data:
- Klik tombol Refresh untuk menyinkronkan data terbaru dari Meta
Disconnect (Putuskan Koneksi):
- Klik tombol Disconnect untuk memutus koneksi
- Pilih mode disconnect:
- Soft Disconnect: Hanya memutus koneksi di kirim.chat, data WABA tetap ada di Meta
- Hard Disconnect: Menghapus koneksi sepenuhnya
Coexistence (WhatsApp Business App + API)
Apa itu Coexistence?
Coexistence adalah fitur dari Meta yang memungkinkan Anda menggunakan satu nomor telepon yang sama untuk:
- WhatsApp Business App - Untuk chat personal 1:1 dari handphone
- WhatsApp Cloud API (via kirim.chat) - Untuk broadcast, automasi, dan integrasi
Dengan Coexistence, Anda tidak perlu lagi memilih antara menggunakan aplikasi atau API - keduanya bisa digunakan bersamaan dengan sinkronisasi pesan otomatis.
Keuntungan Coexistence
| Fitur | Keterangan |
|---|---|
| Satu Nomor | Tidak perlu nomor terpisah untuk API dan aplikasi |
| Sinkronisasi Pesan | Riwayat chat 6 bulan terakhir tersinkronisasi antara App dan API |
| Kontak Tersinkronisasi | Semua kontak WhatsApp otomatis tersedia di kedua platform |
| Fleksibilitas | Balas dari HP (App) atau dari dashboard (API) sesuai kebutuhan |
| Pesan Gratis di App | Pesan yang dikirim via WhatsApp Business App tetap gratis |
Persyaratan Coexistence
Untuk menggunakan Coexistence, pastikan:
- Versi App Minimum: WhatsApp Business App versi 2.24.17 atau lebih tinggi
- Negara Didukung: Kode negara nomor telepon harus didukung oleh Meta
- Akun Sudah Ada: Nomor harus sudah terdaftar di WhatsApp Business App sebelumnya
Cara Mengaktifkan Coexistence
- Buka menu WhatsApp Business Account di kirim.chat
- Klik “Connect with WhatsApp”
- Pada proses Embedded Signup, pilih opsi “Use existing WhatsApp Business App number”
- Login dengan akun Facebook yang sama dengan WhatsApp Business App Anda
- Berikan izin yang diminta
- Verifikasi kepemilikan nomor dengan kode OTP
- Setelah berhasil, kedua platform akan tersinkronisasi
Fitur yang Tersedia di Coexistence
| Fitur | WhatsApp Business App | Cloud API (kirim.chat) |
|---|---|---|
| Chat Individual (1:1) | ✅ Tersedia | ✅ Tersedia + Tersinkronisasi |
| Kontak | ✅ Tersedia | ✅ Tersinkronisasi |
| Kirim Template Message | ❌ | ✅ Tersedia |
| Broadcast Massal | ❌ (Broadcast List terbatas) | ✅ Tersedia |
| AI Auto-Reply | ❌ | ✅ Tersedia |
| Webhook & API | ❌ | ✅ Tersedia |
| Group Chat | ✅ Tersedia | ❌ Tidak tersinkronisasi |
| Voice/Video Call | ✅ Tersedia | ❌ Tidak tersedia |
| Status/Stories | ✅ Tersedia | ❌ Tidak tersedia |
| Catalog & Orders | ✅ Tersedia | ❌ Tidak tersedia |
Batasan Coexistence
| Batasan | Keterangan |
|---|---|
| Throughput | Maksimal 20 pesan per detik (lebih rendah dari API-only) |
| Disappearing Messages | Dinonaktifkan untuk semua chat 1:1 |
| View Once | Dinonaktifkan untuk semua chat 1:1 |
| Live Location | Dinonaktifkan untuk semua chat 1:1 |
| Broadcast Lists | Tidak bisa membuat broadcast list baru di App |
| Edit/Revoke | Tidak bisa edit atau revoke pesan di App |
Biaya Coexistence
| Sumber Pesan | Biaya |
|---|---|
| Pesan dari WhatsApp Business App | Gratis |
| Pesan dari Cloud API (kirim.chat) | Sesuai tarif WhatsApp Business API |
Tips: Gunakan WhatsApp Business App untuk chat personal 1:1 (gratis), dan gunakan kirim.chat untuk broadcast dan automasi.
Customer Service Window
- Window 24 jam hanya terbuka ketika pelanggan mengirim pesan setelah Anda sudah onboard ke Cloud API
- Jika pelanggan mengirim pesan sebelum onboarding, Anda hanya bisa membalas dengan Template Message
- Pesan dari App dan API sama-sama membuka/menggunakan window yang sama
Memutus Koneksi Coexistence
Jika Anda ingin memutus koneksi API tanpa menghapus WhatsApp Business App:
- Buka WhatsApp Business App di handphone
- Pergi ke Settings > Account > Business Platform
- Klik “Disconnect Account”
Setelah disconnect, nomor akan kembali hanya bisa digunakan di WhatsApp Business App saja.
Quality Metrics & Monitoring
Memahami Quality Rating
Quality Rating menunjukkan kualitas pengiriman pesan WhatsApp Anda. Meta mengevaluasi berdasarkan feedback pelanggan dan engagement.
Level Kualitas
| Rating | Warna | Keterangan |
|---|---|---|
| HIGH | Hijau | Kualitas pengiriman pesan sangat baik |
| MEDIUM | Kuning | Kualitas sedang dalam review |
| LOW | Merah | Ada masalah kualitas yang terdeteksi |
Messaging Limit (Batas Pengiriman)
Batas pengiriman harian ditentukan oleh tier akun Anda:
| Tier | Limit Harian | Keterangan |
|---|---|---|
| TIER_1K | 1,000 pesan | Akun baru |
| TIER_10K | 10,000 pesan | Setelah memenuhi syarat |
| TIER_100K | 100,000 pesan | Performa baik konsisten |
| TIER_UNLIMITED | Tidak terbatas | Performa sangat baik |
Cara Meningkatkan Tier
- Jaga kualitas pesan tetap HIGH (Hijau)
- Hindari spam dan pesan yang tidak diinginkan
- Gunakan template yang sudah disetujui
- Respons cepat terhadap pesan pelanggan
Komponen Quality Metrics
Template Quality:
- Menunjukkan performa template pesan Anda
- Dipengaruhi oleh berapa banyak penerima yang memblokir atau melaporkan pesan
Phone Number Quality:
- Status kesehatan akun nomor telepon Anda
- Warna hijau (GREEN) menandakan kondisi baik
Trend:
- UP (Naik): Kualitas membaik
- STABLE: Kualitas stabil
- DOWN (Turun): Kualitas menurun, perlu perhatian
Troubleshooting
”No WABA Connected”
Penyebab: Akun WABA belum terhubung atau koneksi terputus. Solusi:
- Klik tombol “Connect with WhatsApp”
- Ikuti proses Embedded Signup
- Pastikan memiliki akses admin di Facebook Business Manager
Gagal Memuat Data WABA
Penyebab: Masalah koneksi atau token akses kedaluwarsa. Solusi:
- Klik tombol Refresh
- Jika masih gagal, coba disconnect dan connect ulang
- Hubungi support jika masalah berlanjut
Nomor Telepon Tidak Muncul
Penyebab: Sinkronisasi belum selesai. Solusi:
- Klik tombol Refresh untuk sinkronisasi ulang
- Tunggu beberapa saat dan refresh halaman
Quality Rating Turun ke YELLOW/RED
Penyebab: Terlalu banyak pelanggan memblokir atau melaporkan pesan. Solusi:
- Review konten template pesan Anda
- Pastikan pesan relevan dan tidak spam
- Kirim pesan hanya ke pelanggan yang opt-in
- Berikan opsi unsubscribe yang jelas
Messaging Limit Tidak Naik
Penyebab: Belum memenuhi kriteria Meta. Solusi:
- Jaga quality rating tetap HIGH
- Tingkatkan engagement dengan pelanggan
- Konsisten kirim pesan berkualitas
- Proses upgrade tier memerlukan waktu
Butuh Bantuan?
Jika Anda mengalami masalah yang tidak tercantum di panduan ini, silakan hubungi tim support kirim.chat:
- WhatsApp: +6281295648580
- Email: support@kirim.chat
Dokumentasi ini terakhir diperbarui: Januari 2026