Menyambungkan WhatsApp
Sambungkan nomor WhatsApp Business resmi ke Karibin, lalu atur profil, workspace, dan audit log akun Anda.
Karibin tersambung ke WhatsApp lewat jalur resmi dari Meta, dan setiap workspace memakai akun WhatsApp Business miliknya sendiri. Hanya Pemilik dan Admin yang bisa menyambungkan atau mengubah sambungan, anggota lain hanya bisa melihat statusnya.
Hubungkan WhatsApp Business
- Buka Pengaturan, lalu WhatsApp Business.
- Klik Hubungkan WhatsApp (1 klik).
- Di jendela Meta, masuk ke akun Facebook yang mengelola bisnis Anda.
- Pilih atau buat akun WhatsApp Business, lalu verifikasi nomornya.
- Selesai. Nomor muncul di bagian Status koneksi, tanpa perlu menyalin ID atau token apa pun.
Hubungkan manual
Kalau nomor Anda sudah punya aplikasi Meta sendiri, atau tombol 1 klik bermasalah (misalnya jendela Meta menampilkan “Feature unavailable”), klik Hubungkan manual (masukkan ID) di bawah tombol 1 klik. Form manual punya tautan ke panduan setup langkah demi langkah.
Detail teknis: sambungan manual dengan ID dan token
- Di Meta dashboard, buka WhatsApp, lalu API Setup. Salin Phone Number ID, WhatsApp Business Account (WABA) ID, dan Access Token. Untuk pemakaian sungguhan, pakai token permanen System User (Business settings, Users, System users), karena token sementara kedaluwarsa dalam 24 jam.
- Buka App Settings, lalu Basic, klik Show pada App Secret dan salin.
- Di Karibin, tempel keempat nilai itu di form, lalu klik Verifikasi & simpan. Karibin memeriksanya langsung ke Meta.
- Karibin menampilkan Callback URL dan Verify token khusus workspace ini. Salin keduanya.
- Di Meta dashboard, buka WhatsApp, Configuration, Webhook, lalu Edit. Tempel keduanya dan klik Verify and save.
- Di Webhook fields, aktifkan event messages. Tanpa langkah ini, pesan dari pelanggan tidak akan masuk ke inbox Karibin.
Beberapa nomor dalam satu workspace
Jumlah nomor per workspace mengikuti paket dan bisa ditambah lewat add-on Nomor WhatsApp di Billing. Nomor baru ditambahkan dari bagian Tambah nomor WhatsApp.
| Hal | Cara kerjanya |
|---|---|
| Nomor utama | Selalu ada satu, ditandai lencana UTAMA. Dipakai sebagai bawaan untuk broadcast dan tes kirim. Kalau diputus, nomor lain yang paling lama tersambung otomatis jadi utama. |
| Chat per nomor | Pelanggan yang chat ke dua nomor punya dua percakapan terpisah. Balasan selalu keluar dari nomor yang dituju pelanggan. |
| Template per nomor | Pilihan template mengikuti akun WhatsApp Business milik nomor tersebut. |
| Broadcast per nomor | Halaman broadcast punya pilihan Nomor pengirim. Kalau nomor itu diputus sebelum jadwal kirim, broadcast terjadwal dikirim dari nomor utama. |
Di kartu tiap nomor ada tombol Jadikan utama, Ganti nama (misalnya “Sales” atau “Cabang Bandung”), dan Putuskan. Memutus satu nomor tidak mengganggu nomor lain, dan percakapannya tetap tersimpan.
Aturan pesan WhatsApp
- Dalam 24 jam setelah pelanggan chat duluan, Anda boleh mengirim teks bebas.
- Pesan pertama, atau setelah 24 jam tanpa chat dari pelanggan, wajib memakai template yang sudah disetujui Meta. Teks bebas akan ditolak.
Menguji sambungan
- Di halaman WhatsApp Business, cari bagian Tes kirim.
- Isi Nomor tujuan dengan format internasional, misalnya 628123456789.
- Klik Kirim tes. Hasilnya tampil di bawah tombol.
Urutan tes yang paling aman: kirim template dari Meta ke nomor Anda sendiri, balas dari HP dan pastikan balasan muncul di Percakapan, lalu kirim teks bebas dari Karibin.
Mengirim template tes
Bagian Kirim template mengirim satu pesan template ke satu nomor. Ini cara resmi membuka percakapan dengan pelanggan yang belum chat duluan.
- Pilih template. Hanya template berstatus APPROVED yang bisa dipilih.
- Kalau template punya isian seperti
{{1}}, isi kolom yang muncul. Pratinjau langsung menyesuaikan. - Isi Nomor tujuan (628… atau 08…, otomatis dirapikan).
- Klik Kirim template.
Template baru dibuat di WhatsApp Manager (tautannya ada di bagian ini). Persetujuan Meta biasanya butuh beberapa jam sampai beberapa hari. Pesan tes tidak disimpan sebagai percakapan. Untuk mengirim ke banyak kontak sekaligus, pakai Broadcast.
Memperbarui access token
Bagian ini untuk sambungan manual. Token sementara dari Meta kedaluwarsa tiap 24 jam, jadi sebaiknya ganti dengan token permanen System User.
- Di halaman WhatsApp Business, cari bagian Perbarui Access Token.
- Tempel token baru di Access Token baru. Isi App Secret baru hanya kalau berubah.
- Klik Perbarui token.
Pengaturan di Meta dashboard tidak perlu diubah.
Memutuskan WhatsApp
Di bagian Putuskan koneksi, klik Putuskan WhatsApp, lalu Ya, putuskan. Semua kredensial WhatsApp dihapus dari workspace dan pesan masuk berhenti. Tindakan ini tercatat di audit log.
Kalau ada masalah
| Gejala | Penyebab paling mungkin | Yang perlu dilakukan |
|---|---|---|
| “Diterima Meta” tapi tidak sampai | Pelanggan belum chat dalam 24 jam | Kirim template dulu, atau minta pelanggan chat duluan |
| Error 190 | Access Token kedaluwarsa | Perbarui Access Token, sebaiknya dengan token permanen |
| Error 131047 | Teks bebas di luar 24 jam | Pakai template yang sudah disetujui |
| Error 130497 | Nomor tes Meta tidak bisa mengirim ke nomor Indonesia | Pakai nomor bisnis asli dan verifikasi bisnis di Meta |
| Pesan masuk tidak muncul (sambungan manual) | Event messages belum diaktifkan di Meta | Ulangi langkah 5 dan 6 di detail teknis sambungan manual |
Access Token dan App Secret disimpan terenkripsi, dan audit log tidak pernah mencatat token atau secret.
Profil saya
Klik avatar Anda di pojok kiri bawah, atau buka Pengaturan, lalu Profil saya. Pengaturan di sini hanya berlaku untuk akun Anda.
| Bagian | Isinya |
|---|---|
| Info akun | Nama (tampil di aplikasi) dan email (untuk masuk dan pemulihan akun) |
| Akun terhubung | Hubungkan Google supaya bisa masuk tanpa password |
| Ganti password | Ganti password saat sedang masuk |
| Bahasa | Pilih Indonesia atau English. Tampilan langsung berganti tanpa memuat ulang. |
Mengubah nama atau email
Ubah kolom Nama atau Email, lalu klik Simpan. Email yang sudah dipakai akun lain tidak bisa dipilih.
Ganti password
- Isi Password sekarang sebagai konfirmasi.
- Isi Password baru dan Ulangi password baru (minimal 8 karakter).
- Klik Simpan password baru.
Tautan reset password yang pernah Anda minta otomatis tidak berlaku lagi setelah password diganti.
Notifikasi dan email
- Notifikasi: pilih saluran (di dalam aplikasi, email, Telegram, atau notifikasi browser) dan kejadian yang dipantau di Pengaturan, lalu Notifikasi. Notifikasi browser perlu diaktifkan sekali per browser.
- Email: sambungan email untuk mengirim dan menerima email dari deal diatur di Pengaturan, lalu Email masuk & keluar. Lihat Email di CRM.
Pengaturan workspace
Buka Pengaturan, lalu Pengaturan workspace.
- Nama workspace tampil di menu dan email undangan. Hanya Pemilik yang bisa mengubahnya. Ubah, lalu klik Simpan.
- Slug dibuat otomatis dari nama dan tidak bisa diubah manual.
- Ringkasan menampilkan jumlah anggota dan total kontak.
Audit log
Buka Pengaturan, lalu Audit log. Audit log mencatat tindakan penting di workspace, terbaru di atas, dan catatannya tidak bisa dihapus. Hanya Pemilik dan Admin yang bisa melihatnya.
| Kelompok | Contoh yang dicatat |
|---|---|
| Workspace dan tim | Ubah nama workspace, kirim, batalkan, atau terima undangan, ubah role anggota |
| Kontak | Hapus atau ubah tag banyak kontak sekaligus, buat atau hapus segmen |
| Menyambung, memutus, atau memperbarui token, mengirim template | |
| Pesan keluar | Memulai, menjadwalkan, atau membatalkan broadcast |
| Otomasi dan form | Membuat, mengubah, atau menghapus otomasi, menerbitkan form |
| Penjualan | Pipeline, deal, email dari deal, penawaran |
| Paket dan tagihan | Mulai trial, ganti paket, pembayaran berhasil atau gagal |
Saring dengan Jenis aksi, Dari tanggal, dan Sampai tanggal (tanggal akhir ikut dihitung sampai akhir hari), atau klik Reset filter untuk kembali ke daftar lengkap.