Integrasi Meta/TikTok Ads

Atur Webhook URL untuk menangkap leads secara real-time per client.

Platform	Client	Webhook Info	Status	Aksi

Panduan Setup Integrasi

Ikuti langkah berikut agar leads dari iklan otomatis masuk ke sistem.

Cara Kerja: Setiap kali seseorang mengisi form iklan Anda (Meta Lead Ads / TikTok Instant Form), platform akan mengirimkan data mereka secara otomatis ke Webhook URL yang Anda daftarkan di bawah ini. Sistem akan menerima data tersebut dan langsung membuat lead baru di List Prospect.

⚠️ Penting — Jangan Keliru: Meta Pixel ≠ Lead Ads Webhook

Meta Pixel

Contoh kode pixel (bukan untuk integrasi ini):

fbq('init', '1287371436515869');
fbq('track', 'PageView');

📊Melacak perilaku pengunjung website (klik, scroll, beli)
🌐Dipasang di HTML website klien
❌Tidak mengirim data lead ke sistem ini

Lead Ads Webhook ← Yang Dibutuhkan

URL webhook yang di-generate sistem ini:

POST /webhooks/facebook/{clientId}
Verify-Token: xxxxxxxx

👤Menerima data lead (nama, HP, email) dari form iklan
⚙️Dikonfigurasi di Meta Developer Portal
✅Langsung buat lead baru di List Prospect

Pixel ID (misal: 1287371436515869) tetap berguna untuk retargeting di campaign iklan, tapi bukan cara untuk mengirim data lead ke sistem ini. Ikuti panduan Webhook di bawah ini.

Buat Integrasi di Sistem Ini → Dapatkan Webhook URL & Token

Klik "+ Tambah Integrasi" di halaman ini → pilih Client → pilih Meta Ads → Simpan. Catat Webhook URL dan Verify Token yang muncul di tabel — keduanya akan dipakai di langkah berikutnya.

https://yourdomain.com/webhooks/facebook/{clientId}

Buat App ID di Meta Business Manager

Buka business.facebook.com → Pengaturan → sidebar kiri → Akun → Aplikasi → klik "+ Tambahkan".

Pilih opsi "Buat ID Aplikasi Baru" → ikuti wizard hingga App ID terbuat. Jika sudah punya App ID, pilih "Hubungkan ID Aplikasi".

Ini adalah halaman yang sama persis seperti screenshot di atas. Pilih "Buat ID Aplikasi Baru" jika belum punya App.

Buka Meta Developer Portal → Tambah Produk Webhooks

❌ Bukan di sini — tempat yang SALAH untuk input Webhook URL:

✗Meta Events Manager → Set data → Siapkan Conversions API — ini untuk tracking konversi website, BUKAN Lead Ads
✗Meta Events Manager → Set data → Siapkan Meta Pixel — ini untuk tracking browser, BUKAN Lead Ads
✗Business Manager → Pengaturan → Aplikasi — ini hanya untuk membuat App ID (langkah 2)

✅ Tempat yang BENAR — Input Webhook URL ada di sini:

developers.facebook.com/apps→Pilih App Anda→Webhooks→Page→"Subscribe to this object" ← input URL di sini

Masuk ke developers.facebook.com/apps → pilih App yang dibuat di langkah 2 → sidebar kiri cari "Webhooks" (jika belum ada, klik "Add Product" dulu).

Pastikan App Type dipilih "Business" saat membuat app, bukan Consumer atau Gaming.

Konfigurasi Webhook → Pilih Objek "Page"

Di halaman Webhooks → dropdown "Select an object" → pilih "Page" → klik "Subscribe to this object". Isi form verifikasi dengan data dari sistem:

Field di Meta Developer	Nilai yang Diisi
Callback URL	Webhook URL dari tabel atas (kolom URL)
Verify Token	Token dari tabel atas (kolom Token)

Klik "Verify and Save" — Meta akan mengirim GET request ke server untuk memverifikasi token.

Subscribe ke Field "leadgen" & Hubungkan ke Facebook Page

Setelah verifikasi berhasil, aktifkan subscription untuk field: leadgen. Lalu pastikan App sudah di-subscribe ke Halaman Facebook Anda:

Developer Portal → Facebook Login (tambah sebagai produk) → Permissions → tambahkan leads_retrieval dan pages_manage_metadata.

Selesai! Uji dengan Lead Ads Testing Tool

Kirim lead dummy via Lead Ads Testing Tool . Lead akan langsung muncul di List Prospect dalam hitungan detik.

Contoh Payload yang Diterima Sistem

{
  "entry": [{
    "changes": [{
      "field": "leadgen",
      "value": {
        "leadgen_id": "1234567890",
        "page_id": "987654321",
        "form_id": "111222333",
        "field_data": [
          { "name": "full_name", "values": ["Budi Santoso"] },
          { "name": "phone_number", "values": ["+6281234567890"] },
          { "name": "email", "values": ["budi@email.com"] }
        ]
      }
    }]
  }]
}

Catatan Penting

⚠Server harus dapat diakses publik. Webhook dari Meta/TikTok tidak bisa dikirim ke localhost. Gunakan domain atau IP publik, atau tools seperti ngrok untuk testing.
🔒HTTPS wajib untuk production. Meta dan TikTok hanya menerima webhook URL dengan protokol HTTPS yang valid (sertifikat SSL).
✓Satu integrasi per client per platform. Buat integrasi terpisah jika ada beberapa client yang menjalankan iklan di platform yang sama.
🔄Leads duplikat ditangani otomatis. Jika nomor WA yang sama sudah ada di sistem, lead baru tidak akan dibuat ulang.