Koneksi Meta

Buat menghubungkan akun Meta (Facebook Business Manager) kamu, buka Settings → Koneksi & API di sidebar, lalu klik tombol "Hubungkan via OAuth". Kamu bakal diarahkan ke halaman izin Facebook — login (kalau belum) dan setujui izin yang diminta buat akun Kanzen Ads kamu. Nggak ada App ID, App Secret, atau token yang perlu kamu isi manual — semuanya lewat OAuth.

Nama aplikasi yang muncul di layar Facebook itu kadang beda dari "Kanzen Ads" — itu normal dan aman, karena layar itu dirender Facebook sesuai app Meta yang lagi dipakai, bukan sesuatu yang bisa diubah dari sisi kita. Izin yang kamu setujui tetap dipakai khusus buat akun Kanzen Ads kamu sendiri, bukan pihak lain.

Setelah kamu setujui, Facebook ngarahin kamu balik ke Kanzen Ads dan akun Meta kamu langsung muncul di daftar "Akun Meta Terhubung" dengan badge sumber "OAuth" dan status koneksinya (Connected, Needs Assets, dst). Business, ad account, dan halaman terkait ke-sinkron otomatis di belakang layar.

Token dari OAuth juga punya masa berlaku. Kalau mau habis dalam waktu dekat, atau sudah lewat, kartu akun kamu di halaman Koneksi & API bakal berubah status jadi "Expired" atau "Needs Reconnect" — dan begitu status ini muncul, fitur yang butuh nulis ke Meta (misalnya rule automation yang mengubah budget, atau launch campaign) otomatis berhenti dieksekusi sampai koneksinya dipulihkan. Ini demi keamanan, biar nggak ada aksi yang jalan pakai token yang udah nggak valid.

Buat reconnect, cukup klik lagi tombol "Hubungkan via OAuth" di halaman Koneksi & API — kamu diarahkan ke Facebook buat approve ulang izinnya. Nggak perlu cari atau copy-paste token secara manual, semuanya lewat OAuth yang sama seperti waktu connect pertama kali.

Kalau setelah reconnect statusnya masih bermasalah, atau kamu butuh bantuan lebih lanjut, hubungi support lewat channel yang ada di halaman utama Pusat Bantuan.

Selain self-service OAuth di atas, ada satu jalur tambahan di halaman Kelola Akun (/meta-connections) yang cuma kelihatan buat admin — dipakai buat kasus khusus seperti provisioning akun dari pool/sewa, bukan jalur yang dipakai customer biasa sehari-hari.

Jalur ini minta App ID dan App Secret dari Meta Developer Console, plus User Access Token — idealnya token System User dari Meta Business Suite biar lebih stabil (bukan token user personal biasa yang gampang expired kalau logout). Setelah kredensial diisi dan diklik "Test Connection", sistem ngecek langsung ke API Meta apakah token-nya valid, scope apa aja yang aktif, dan kapan kedaluwarsa.

Kalau kamu customer biasa dan nggak lihat opsi ini di menu kamu, itu memang disengaja — App ID/App Secret dan Access Token adalah kredensial sensitif tingkat aplikasi, jadi jalur ini sengaja dibatasi ke admin. Cara normal buat kamu tetap lewat tombol "Hubungkan via OAuth" di halaman Koneksi & API.

Kalau kamu nolak atau batal di layar izin Facebook, kamu cuma diarahin balik ke Kanzen Ads tanpa akun baru ke-tambah — nggak ada state rusak yang ketinggalan, tinggal klik "Hubungkan via OAuth" lagi buat coba ulang.

Kalau koneksi kelihatan "Connected" tapi statusnya berubah "Needs Assets" (badge kuning), itu artinya tokennya valid tapi belum ada ad account yang kamu izinkan diakses saat approve di Facebook — reconnect ulang dan pastikan kamu centang ad account yang mau dipakai di layar izin Facebook.

Kalau akun Meta itu udah pernah kamu (atau tim kamu) hubungkan sebelumnya, sistem bakal ngarahin kamu langsung ke halaman detail koneksi yang sudah ada, nggak bikin duplikat. Untuk jalur manual admin, error tambahan yang umum: token salah paste (kepotong atau ada spasi), scope belum lengkap, atau System User yang belum di-assign ke ad account terkait di Meta Business Settings.