Meta CAPI
Panduan edukatif dan teknis untuk Meta Conversions API dalam flow WhatsApp, termasuk Pixel ID, Access Token, event_id, dan testing.
Diperbarui 18 November 2026Apa itu Meta Conversions API
test_event_code, jadi lead percobaan yang statusnya dinaikkan masuk ke data Pixel asli, bukan ke Test Events. Untuk memeriksa setup tanpa lead, pakai Kirim event uji (lihat Kirim event uji); event uji itu pun tetap disimpan Meta di dataset.Meta Conversions API atau CAPI adalah jalur server-side untuk mengirim event conversion ke Meta. Berbeda dengan Pixel browser yang berjalan di website, CAPI mengirim event dari server setelah event bisnis tercatat.
Kenapa dibutuhkan untuk flow WhatsApp
Dalam flow WhatsApp, conversion sering terjadi setelah visitor meninggalkan website dan masuk ke chat. Dalekta membantu menjembatani status lead WhatsApp seperti Masuk WA, MQL, Prospek, atau Closing menjadi event yang bisa dipakai sebagai sinyal conversion jika konfigurasi Meta aktif.
Penjelasan lengkap untuk bisnis yang closing di chat ada di artikel Meta CAPI untuk WhatsApp.
Pixel browser vs CAPI server-side
| Aspek | Pixel browser | CAPI server-side |
|---|---|---|
| Lokasi | Berjalan di browser visitor. | Dikirim dari server setelah event tercatat. |
| Cocok untuk | Page view, click, event website. | Lead, status, dan closing yang tercatat di Dalekta. |
| Risiko | Bisa dipengaruhi browser, adblock, consent, atau network. | Butuh data dan mapping yang benar. |
| Dedup | Perlu event_id jika event sama juga dikirim server. | Perlu event_id yang konsisten jika dikirim bersama Pixel. |
Data minimum yang perlu disiapkan
- Meta Pixel ID.
- Access Token CAPI dari Meta Events Manager.
- Domain/landing page yang dipakai campaign.
- Tracking script Dalekta di landing page.
- Event mapping status Dalekta ke event platform.
- Rules yang menentukan kapan event dikirim.
Cara mengambil Pixel ID
- Buka Meta Events Manager.
- Pilih Data Source / Pixel yang dipakai campaign.
- Salin Pixel ID.
- Masukkan Pixel ID ke halaman integrasi Meta di dashboard Dalekta.
Pixel ID juga bisa dipilih tanpa menyalin: di Tracking → Tracking Ads, tab Platform, tombol Kelola di Meta Ads, klik Hubungkan lewat Facebook, pilih Pixel dari akun iklan Meta yang dipilih workspace, lalu Pakai Pixel ini. Tombol ini memakai login Meta dengan izin kelola di Tracking → Ad Connections; tanpa login itu, isi Pixel ID secara manual. Login ini hanya mengisi Pixel ID. Access Token tetap dibuat di Events Manager dan ditempel seperti langkah di bawah, karena token itulah yang mengirim event. Dialog menampilkan apakah Pixel diisi lewat Facebook atau manual, dan kapan token terakhir ditempel. Hanya owner dan admin yang bisa memakainya.
Cara generate Access Token
- Buka Meta Events Manager untuk Pixel terkait.
- Masuk ke Settings.
- Cari bagian Conversions API.
- Generate Access Token sesuai akses business yang benar.
- Salin token dan simpan di dashboard Dalekta.
- Batasi akses token hanya untuk pihak yang memang mengelola integrasi.
Di Tracking Ads → Platform → Meta Ads → Kelola, status Token tersimpan menunjukkan token sudah ada. Owner dan admin dapat menekan tombol mata untuk melihat token asli, lalu Sembunyikan token untuk menutupnya. Menutup modal juga menghapus nilai yang ditampilkan. Ganti token membuka input baru; membatalkan atau membiarkannya kosong tetap memakai token lama. Status tersimpan tidak membuktikan token masih diterima Meta.
Test connection dan Events Manager
- Masukkan Pixel ID dan Access Token di dashboard Dalekta.
- Simpan konfigurasi.
- Aktifkan event mapping yang ingin diuji.
- Lakukan test lead dari landing page ke WhatsApp.
- Ubah status lead sesuai trigger event.
- Cek Event Logs di Dalekta.
- Cek Meta Events Manager untuk memastikan event diterima atau membaca error diagnostics.
Kirim event uji
Untuk memeriksa Pixel ID dan token tanpa menunggu lead, owner atau admin bisa mengirim satu event contoh dari Tracking → Tracking Ads, tab Platform, tombol Kelola di Meta Ads, bagian Kirim event uji.
- Buka Meta Events Manager, pilih Pixel yang sama, lalu buka tab Test Events dan salin kode ujinya (Test Event Code).
- Di Dalekta, tempel kode itu, pilih event dari Event Mapping, lalu klik Kirim.
- Lihat event-nya muncul di tab Test Events di Events Manager.
- Event uji adalah satu event contoh tanpa data pelanggan: tanpa nomor, email, nama, IP, atau lokasi, dan tidak terhubung ke lead mana pun.
- Pixel ID dan token harus sudah tersimpan, dan minimal satu event sudah dipetakan di Event Mapping.
- Kode uji hanya dipakai untuk satu kiriman itu dan tidak disimpan. Paling banyak 5 event uji per workspace per menit.
- Meta tetap menyimpan event uji di dataset Pixel. Menurut Meta, event dengan
test_event_codetidak dibuang dan bisa ikut dipakai untuk targeting dan pengukuran iklan. - Di Event Logs event uji ditandai Uji dan tidak dihitung di ringkasan maupun laporan, dan tidak bisa di-retry.
- Event lead sungguhan tetap dikirim tanpa
test_event_code.
Catatan teknis event server Meta
Event server Meta umumnya memakai field seperti event_name, event_time, user_data, custom_data, event_source_url, event_id, dan action_source.
- Sender Dalekta memakai action_source
websiteuntuk lead yang punya URL landing page dari klik, termasuk untuk status yang terjadi setelah percakapan WhatsApp, danchatuntuk lead tanpa URL itu, termasuk lead Click to WhatsApp yang tidak membuka landing page lebih dulu. Jalur Business Messaging CAPI dengan action_sourcebusiness_messagingdan ctwa_clid belum dipakai. - event_time adalah waktu tahap tercapai. Retry dari Event Logs memakai waktu event pertama kali dicoba, dan event yang lebih tua dari 7 hari tidak dikirim karena Meta menolak seluruh permintaan yang memuatnya.
- user_data membawa nomor telepon dengan kode negara, nama depan dan belakang dalam huruf kecil tanpa sapaan, emoji, dan tanda baca, ID pengunjung atau lead, dan lokasi dari IP bila ada, semuanya di-hash. Tanpa lokasi IP, kota dan provinsi yang diisi tim di detail lead ikut dikirim, dan negara dibaca dari kode negara nomor telepon. Kota tidak pernah dibaca dari nomor.
- event_id penting untuk menghindari double counting jika Pixel browser dan CAPI sama-sama mengirim event yang sama.
- custom_data dapat membawa value, currency, content_name, atau konteks lain jika tersedia dan sesuai mapping. Nama sales atau session tidak dikirim.
- user_data harus mengikuti kebijakan Meta dan hanya memakai data yang valid serta diizinkan.
Pertanyaan umum
Kenapa event dari Dalekta tidak muncul di Meta Events Manager?
Cek dulu Event Logs di Dalekta, lalu pastikan Pixel ID dan Access Token tersimpan, event mapping yang diuji aktif, dan status lead sudah berubah sesuai trigger event. Setelah itu buka Meta Events Manager untuk memastikan event diterima atau membaca error diagnostics. Arti tiap status log ada di Event Logs.
Apakah event dari Dalekta muncul di tab Test Events Meta?
Event lead sungguhan tidak, karena dikirim tanpa test_event_code; lead percobaan yang statusnya dinaikkan masuk ke data Pixel asli. Yang muncul di Test Events adalah event dari tombol Kirim event uji di Tracking → Tracking Ads, tab Platform, dengan kode uji dari Events Manager. Untuk kiriman lead sungguhan, baca Event Logs di Dalekta lalu cek tab Overview di Events Manager untuk Pixel yang dipakai campaign.
Di mana mengambil Pixel ID dan Access Token untuk Meta CAPI?
Keduanya diambil dari Meta Events Manager. Pixel ID disalin dari Data Source atau Pixel yang dipakai campaign. Access Token dibuat di Settings Pixel tersebut pada bagian Conversions API, lalu disimpan di dashboard Dalekta. Token adalah kredensial sensitif, jadi batasi aksesnya dan rotasi jika akses tim berubah.
Apakah Dalekta mengirim ctwa_clid ke Meta lewat Conversions API for Business Messaging?
Belum. Sender Dalekta memakai action_source website untuk lead dari landing page dan chat untuk lead tanpa landing page, termasuk lead Click to WhatsApp. Jalur Business Messaging CAPI dengan action_source business_messaging dan ctwa_clid belum dipakai, jadi event lead Click to WhatsApp dari Dalekta tidak membawa ctwa_clid.