12. Profil saya

Klik avatar atau nama Anda di pojok kiri bawah sidebar untuk buka halaman profil di /settings/profile.

12.1 Ubah nama atau email

1. Edit kolom Nama atau Email → klik “Simpan”.
2. Catatan email: mengubah email akan menghapus status verifikasi — banner kuning “belum diverifikasi” akan muncul lagi, dan kami kirim tautan verifikasi baru ke alamat baru tersebut.
3. Email yang sudah dipakai akun lain tidak bisa dipilih (error inline akan muncul).

12.2 Pengaturan workspace

Buka dari dropdown workspace (sidebar atas) → “Pengaturan workspace”, atau langsung /settings/workspace.

• Nama workspace: hanya pemilik (OWNER) yang bisa mengubah. Anggota lain (ADMIN/MEMBER) melihat banner info.
• Slug: identifier internal di-generate otomatis dari nama; tidak bisa di-edit manual.
• Ringkasan: jumlah anggota dan total kontak di workspace ini — sekadar konteks, bukan untuk edit.

Ubah nama → klik “Simpan”. Sidebar otomatis update.

12.3 Audit log

Buka dari dropdown workspace (sidebar atas) → “Audit log”, atau langsung /settings/audit.

Audit log mencatat aksi penting di workspace, append-only — catatan tidak bisa dihapus (sengaja, untuk keperluan kepatuhan + investigasi insiden).

Yang dicatat saat ini:

Setiap baris menampilkan: waktu (akurat ke detik), aksi (label warna), detail, dan siapa yang melakukan (nama + email). Diurutkan dari terbaru di atas.

Filter (di atas tabel):

• Jenis aksi — dropdown semua jenis aksi yang dicatat (mis. cuma lihat aksi member.role_update).
• Dari tanggal + Sampai tanggal — rentang inklusif. Tanggal akhir dihitung sampai akhir hari (mis. dari 2026-05-01 sampai 2026-05-31 mencakup semua transaksi pada 31 Mei).
• Reset filter — kosongkan semua, kembali ke list lengkap.

Filter dikirim ke server (bukan filter di browser) — jadi total catatan ikut menyesuaikan + pagination tetap akurat untuk hasil terfilter.

Siapa yang bisa melihat? Hanya Pemilik (OWNER) dan Admin. Anggota biasa (MEMBER) dapat error “Hanya Pemilik dan Admin yang bisa melihat audit log.”

12.4 Ganti password (saat login)

Untuk ganti password tanpa lewat “Lupa password”:

1. Isi “Password sekarang” (sebagai konfirmasi — mencegah orang lain yang sempat akses sesi Anda mengubah password).
2. Isi “Password baru” + “Ulangi password baru” (minimal 8 karakter, harus sama).
3. Klik “Simpan password baru”.

Tautan reset password (Lupa password) yang sebelumnya pernah Anda minta akan otomatis hangus setelah ganti password ini — supaya tidak ada celah jadi backdoor.

12.5 Hubungkan WhatsApp Business

Buka dari dropdown workspace → “WhatsApp Business”, atau langsung /settings/whatsapp.

Karibin mendukung dua metode. Hanya satu metode boleh aktif per workspace — kalau salah satu sedang aktif, tab metode satunya akan terkunci dengan pesan jelas. Untuk ganti metode, Putuskan dulu yang sedang aktif.

12.5.1 Mode Cepat (QR) — tanpa akun Meta

Tab Mode Cepat (QR) → klik Mulai pairing:

1. Karibin membuka koneksi ke server WhatsApp.
2. Beberapa detik kemudian muncul kode QR.
3. Di HP, buka WhatsApp → menu (titik tiga) → Perangkat tertaut → Tautkan perangkat → scan QR.
4. Status berubah jadi Terhubung, nomor yang dipakai ditampilkan.

QR refresh otomatis tiap 30 detik kalau belum di-scan. Sesi disimpan terenkripsi, jadi setelah backend restart, sesi otomatis tersambung lagi tanpa scan ulang.

Pengaman bawaan Karibin (Mode Cepat):

• Throttle kirim — minimal 3 detik antar-kirim per workspace, otomatis menunda kalau Anda klik berulang.
• Cold-contact guard — kirim ke kontak yang belum pernah chat duluan akan tertahan dengan konfirmasi “Tetap kirim?”. Membantu mencegah blast yang memicu blok WA.
• Warming cap — nomor baru dibatasi 20 pesan/hari di hari pertama, naik bertahap selama minggu pertama. Cap hilang setelah 7 hari.

Putuskan: tab Mode Cepat → tombol merah Putuskan WhatsApp → konfirmasi. Sesi diakhiri dan kredensial dihapus.

12.5.2 Mode Resmi (Meta) — produksi yang stabil

Tab Mode Resmi (Meta) memakai WhatsApp Business Cloud API resmi dari Meta. Model Bring Your Own WABA — workspace pakai akun Meta + WhatsApp Business sendiri.

Yang Anda butuhkan:

• Akun Meta Business portfolio (business.facebook.com).
• Aplikasi Meta di developers.facebook.com dengan produk WhatsApp.
• Nomor WhatsApp Business (boleh test number Meta untuk uji coba; nomor bisnis asli + verifikasi bisnis untuk produksi serius).

Langkah ringkas:

1. Di Meta dashboard → WhatsApp → API Setup: salin Phone Number ID + WhatsApp Business Account ID (WABA ID) + Access Token (Generate access token). Untuk produksi, ganti dengan System User Token permanen (Business settings → Users → System users) yang tidak kedaluwarsa.
2. App Settings → Basic → Show App Secret → salin.
3. Di Karibin, tab Mode Resmi (Meta) → form Hubungkan WhatsApp Business → tempel keempat nilai → klik Verifikasi & simpan. Karibin akan mem-ping Meta untuk validasi.
4. Karibin menampilkan Callback URL + Verify Token unik untuk workspace ini. Klik Salin masing-masing.
5. Di Meta dashboard → WhatsApp → Configuration → Webhook → Edit → tempel Callback URL + Verify token → Verify and save → di Webhook fields, aktifkan event messages.
6. Tes kirim di Karibin (§12.5.4).

12.5.3 Perbarui Access Token (rotasi token tanpa reset webhook)

Token sementara Meta hidup 24 jam saja. Untuk produksi disarankan token permanen System User. Saat perlu ganti token (rotasi atau ganti dari sementara ke permanen):

1. Tab Mode Resmi (Meta) → section Perbarui Access Token.
2. Tempel token baru di Access Token baru (dan App Secret baru kalau berubah; biarkan kosong kalau tidak).
3. Klik Perbarui token.

Karibin memvalidasi token baru ke Meta dulu. Verify Token webhook tidak berubah, jadi konfigurasi webhook di Meta dashboard tidak perlu disetel ulang. Ini berbeda dari “Putuskan → Hubungkan lagi” yang akan men-generate Verify Token baru dan memaksa Anda re-setup webhook.

12.5.4 Tes kirim (Mode Resmi)

Section Tes kirim → isi nomor tujuan (format 628…) → Kirim tes. Hasil tampil inline di bawah tombol.

Aturan pesan WhatsApp Business Cloud API:

• Window 24 jam: pelanggan baru chat duluan → window terbuka 24 jam → di dalamnya boleh kirim teks bebas.
• Di luar window 24 jam / pesan pertama (business-initiated): wajib pakai template yang sudah di-approve Meta.
• Test number dibatasi (jumlah recipient + tidak boleh ke negara tertentu, mis. error 130497 ke nomor Indonesia). Untuk produksi pakai nomor bisnis asli + payment method + verifikasi bisnis Meta.

Urutan tes yang benar:

1. Dari Meta API Setup → Step 2 → kirim template hello_world ke nomor Anda.
2. Balas dari HP → cek muncul di Karibin → Percakapan (bukti webhook + inbound jalan).
3. Sekarang teks bebas dari Karibin → terkirim (window 24 jam sudah terbuka).

12.5.5 Kirim template (pesan pertama / di luar 24 jam)

Tab Mode Resmi (Meta) punya section Kirim template terpisah dari Tes kirim. Section ini memuat daftar template yang sudah ada di WhatsApp Business Account Anda — fetched langsung dari Meta — dan memungkinkan kirim satu pesan template ke satu nomor sebagai tes connectivity / pesan pertama.

Alur:

1. Pilih template di dropdown. Setiap baris menampilkan nama · bahasa · status — hanya status APPROVED yang bisa dipilih; PENDING / REJECTED hanya info.
2. Kalau template body memakai parameter ({{1}}, {{2}}, …), Karibin otomatis menampilkan input untuk setiap parameter. Pratinjau body di atasnya langsung ter-update sesuai isi parameter.
3. Isi Nomor tujuan (format 628… atau 08… — otomatis dinormalisasi).
4. Klik Kirim template → hasil tampil inline di bawah tombol.

Buat template baru: klik tautan WhatsApp Manager di section ini → tab Templates → New Template. Approval Meta biasanya beberapa jam sampai beberapa hari.

Batasan section ini (test-send 1 nomor):

• Section ini sengaja untuk test connectivity 1 nomor sekaligus (verifikasi template + kredensial Meta bekerja). Untuk kirim massal pakai broadcast: buka Campaigns → Broadcast (/campaigns/broadcast) — di sana bisa pilih banyak penerima (sampai 5000 kontak) plus header media (gambar/video/dokumen).
• Body parameter teks + button URL dinamis + footer parameter belum didukung di template send manapun (test-send maupun broadcast). Yang sudah didukung: body teks polos + parameter {{1}}…{{n}} + header media (broadcast saja).
• Pesan tes ini tidak disimpan sebagai percakapan — sama seperti Tes kirim teks biasa.

Kenapa template penting: WhatsApp Cloud API hanya mengizinkan teks bebas dalam window 24 jam setelah pelanggan chat duluan. Pesan pertama dari bisnis ke pelanggan, atau pesan setelah 24 jam senyap, wajib pakai template approved — kirim teks bebas akan ditolak Meta dengan error 131047. Section ini adalah jalan resmi untuk membuka percakapan.

12.5.6 Putuskan koneksi (Mode Resmi)

Halaman yang sama → tombol merah Putuskan WhatsApp → konfirmasi. Semua kredensial Meta dihapus dari workspace, termasuk Verify Token webhook. Setelah putus, kalau menghubungkan lagi nanti, Anda harus setel ulang webhook di Meta (Verify Token baru). Pakai Perbarui Access Token (§12.5.3) untuk rotasi token tanpa kena setup ulang webhook.

12.5.7 Catatan keamanan & log

• Access Token + App Secret disimpan terenkripsi (AES-256-GCM) di database. Admin server tidak bisa membacanya tanpa kunci master.
• Audit log mencatat connect/disconnect/token-update dengan Phone Number ID + WABA ID saja — tidak pernah token/secret.

12.5.8 Troubleshooting umum

Untuk konteks lebih lengkap (cara dapat token permanen System User, cara verifikasi bisnis, dll), buka Panduan lengkap setup di app (/settings/whatsapp/guide).