Integrasi Kapso WhatsApp

Hubungkan nomor WhatsApp resmi Anda di Kapso dengan Konektor. Setelah terhubung, pesan yang masuk otomatis tersimpan sebagai Leads dan tampil di Kotak Masuk, dan Anda bisa mengirim pesan keluar (teks & template) langsung dari Konektor.

Tentang Kapso

Kapso adalah penyedia koneksi WhatsApp resmi (Cloud API). Anda mendaftar dan membayar Kapso secara langsung, bukan lewat Konektor. Konektor hanya menempelkan satu API key dari akun Kapso Anda.

Jumlah nomor yang bisa Anda hubungkan mengikuti plan Kapso Anda, bukan plan Konektor:

Prasyarat

Sebelum mulai, siapkan:

1. Akun Kapso yang aktif.
2. Satu nomor WhatsApp untuk dihubungkan (nomor baru, atau nomor yang sudah punya WhatsApp Business).
3. Akses ke Konektor sebagai Owner atau Admin workspace Anda.

Hubungkan Nomor di Kapso

1. Masuk ke dashboard Kapso dengan akun Anda.
2. Buka menu WhatsApp, lalu tambahkan nomor baru.
3. Ikuti langkah verifikasi nomor sampai selesai.
4. Saat diminta memilih mode koneksi, pilih salah satu di bawah ini.

Coexistence atau Dedicated?

• Coexistence — aplikasi WhatsApp Business di ponsel Anda tetap bisa dipakai berdampingan. Cocok untuk mencoba-coba lebih dulu. Kecepatan kirim dibatasi sekitar 5 pesan per detik, dan koneksi kadang putus sendiri.
• Dedicated — koneksi lebih stabil dan tidak terbatas seperti coexistence. Nomor tidak bisa lagi dibuka di aplikasi WhatsApp Business setelah ini.

Pilih coexistence dulu bila Anda masih menguji coba dengan nomor cadangan. Pindah ke dedicated setelah siap dipakai penuh untuk bisnis.

Buat API Key di Kapso

1. Di dashboard Kapso, buka menu Integrations > API keys.
2. Buat key baru, lalu salin nilainya.
3. Simpan key ini baik-baik. Key ini berlaku untuk seluruh nomor di akun Kapso Anda, jadi jangan bagikan ke pihak yang tidak Anda percaya.

Tempel API Key di Konektor

1. Masuk ke Konektor sebagai Owner atau Admin workspace Anda.
2. Buka menu Integrations > Partner Integrations.
3. Klik + Add Integration, lalu pilih Kapso.
4. Tempel API key dari Kapso.
5. Konektor akan mencari nomor yang tersedia di akun Kapso Anda dan menampilkannya sebagai pilihan.

Pilih Nomor

• Pilih nomor yang belum terhubung ke integrasi Kapso lain.
• Nomor yang sudah dipakai integrasi Kapso lain di workspace ini akan tampil, tetapi tidak bisa dipilih lagi.
• Bila daftar nomor tidak muncul, isi Nomor WhatsApp secara manual dengan ID nomor dari Kapso.
• Klik Save untuk menyelesaikan.

Pesan Otomatis Masuk ke Kotak Masuk

Setelah integrasi aktif, pesan WhatsApp yang masuk ke nomor itu otomatis muncul di Kotak Masuk Anda, sejajar dengan kanal WhatsApp lain. Tidak ada langkah tambahan yang perlu dilakukan.

Uji Kirim dan Terima

1. Kirim pesan WhatsApp dari nomor pribadi ke nomor Kapso yang baru terhubung.
2. Buka Kotak Masuk, pastikan pesan itu muncul sebagai percakapan baru.
3. Balas pesan itu dari Kotak Masuk.
4. Pastikan balasan Anda diterima di WhatsApp, dan status pesan berubah dari terkirim menjadi tersampaikan lalu terbaca.

Tambah Nomor Kedua

1. Buat integrasi Kapso baru di Konektor dengan API key yang sama (lihat langkah Tempel API Key di Konektor di atas).
2. Pilih nomor lain yang belum terhubung.

Batas jumlah nomor mengikuti plan Kapso Anda (lihat tabel di atas). Tingkatkan plan Kapso Anda dulu bila sudah mencapai batas.

Kegagalan yang Sering Terjadi

• API key ditolak — pastikan key tersalin lengkap dan belum dicabut dari dashboard Kapso. Buat key baru bila perlu.
• Nomor tidak muncul di daftar pilihan — pastikan proses verifikasi nomor di Kapso sudah selesai. Gunakan isian manual sebagai jalan lain.
• Nomor tidak bisa dipilih — nomor itu sudah terhubung ke integrasi Kapso aktif lain di workspace ini. Pilih nomor lain, atau hapus integrasi yang lama dulu.
• Pesan tidak terkirim — periksa mode koneksi nomor di dashboard Kapso masih aktif. Mode coexistence kadang putus sendiri; pindah ke dedicated bila sering terjadi.
• Balasan lambat sampai — nomor dengan mode coexistence dibatasi sekitar 5 pesan per detik. Tunggu sebentar, atau pindah ke dedicated untuk volume lebih besar.

Langkah Berikutnya

• Kotak Masuk WhatsApp
• Integrasi Partner Konektor