Meta CAPI WhatsApp: Panduan Mengirim Closing dari Chat ke Meta Ads

01Kenapa pixel browser tidak melihat closing di WhatsApp

Meta Pixel adalah potongan kode yang berjalan di browser pengunjung. Ia hanya bisa melaporkan apa yang terjadi di halaman yang memasang kodenya: halaman dibuka, tombol diklik, form dikirim. Begitu pengunjung menekan tombol WhatsApp, ia pindah ke aplikasi lain dan pixel tidak ikut. Tawar-menawar, bukti transfer, dan konfirmasi pesanan terjadi di chat yang tidak pernah terlihat oleh browser.

Akibatnya, bagi bisnis yang menutup penjualan lewat chat, data yang sampai ke Meta berhenti di klik atau chat masuk. Meta tidak tahu chat mana yang menjadi pembeli dan chat mana yang hanya bertanya harga lalu menghilang. Kalau campaign dioptimasi ke sinyal yang tidak membedakan pembeli dari penanya iseng, algoritme belajar mencari lebih banyak orang yang suka klik dan bertanya, bukan orang yang membayar.

Conversion API WhatsApp menutup celah itu. Server Anda, atau sistem seperti Dalekta, mengirim event langsung ke Meta setelah status lead berubah, tanpa bergantung pada browser. Konsep dasarnya dibahas di Apa itu Meta CAPI, dan perbandingan lengkap dengan pixel ada di Meta Pixel vs Conversions API. Artikel ini fokus pada satu skenario: penjualan terjadi di WhatsApp, bukan di halaman checkout.

Ilustrasi berikut memakai angka rekaan untuk menunjukkan apa yang berubah, dengan asumsi hanya Masuk WA (dipetakan ke Lead) dan Closing (dipetakan ke Purchase) yang dikirim. Ini bukan data pelanggan dan bukan hasil produksi.

Tanpa CAPI, pixel hanya melihat klik ke WhatsApp, sehingga kedua campaign tampak seimbang. Dengan CAPI, Meta menerima event Purchase yang menunjukkan campaign B menghasilkan tiga kali lebih banyak pembeli dan tiga kali nilai penjualan dari jumlah chat yang sama, selama event itu berhasil dicocokkan ke pengguna yang mengklik iklan. Perbedaan itulah yang tidak pernah terbaca oleh pixel.

02Yang dibutuhkan untuk mengirim conversion API WhatsApp

Ada delapan komponen yang perlu lengkap. Kalau Pixel ID, token, atau mapping hilang, event tidak terkirim. Kalau data pencocokan lemah, event tetap terkirim tetapi sulit dicocokkan ke iklan. Tabel ini juga menunjukkan di mana masing-masing komponen diatur di Dalekta.

Urutan setup di Dalekta, dari nol sampai siap dites:

1. Ambil Pixel ID dari Meta Events Manager, pada data source yang dipakai campaign.
2. Di Events Manager, buka Settings untuk Pixel itu, cari bagian Conversions API, lalu generate access token.
3. Di Dalekta buka Tracking Ads, tab Platform, lalu hubungkan Meta dengan Pixel ID dan token.
4. Buka tab Event Mapping, pilih event Meta untuk tiap tahap, lalu simpan.
5. Buka tab Tracking Code, salin script workspace, dan pasang sekali di landing page (panduan script).
6. Buka tab UTM, salin template parameter Meta, lalu pasang di level iklan di Ads Manager (panduan parameter Meta).
7. Ganti semua tombol WhatsApp campaign dengan link rotator Dalekta, bukan link wa.me manual.

03Alur data dari klik iklan sampai event di Meta

Sebelum membahas mapping, pahami dulu jalur datanya. Di Dalekta, satu lead yang berasal dari iklan Meta melewati langkah berikut sampai Meta menerima event Closing.

1. Iklan Meta membawa parameter di URL: fbclid dari Meta, ditambah utm_*, campaign_id, adset_id, dan ad_id dari template yang Anda pasang.
2. Landing page memuat tracker Dalekta. Tracker menyimpan parameter itu, memakai cookie _fbp yang sudah ada (atau membuatnya jika belum ada), dan membentuk _fbc dari fbclid.
3. Pengunjung menekan tombol WhatsApp yang memakai rotator. Klik tercatat sebagai Click CTA, dan pesan awal membawa kode tracking seperti [D-XXXXX].
4. Saat pesan itu masuk ke nomor WhatsApp yang terhubung, Dalekta memasangkannya ke klik tadi. Lead tercatat sebagai Masuk WA dengan konteks campaign yang utuh.
5. Status lead naik lewat Rules (misalnya jumlah pesan customer untuk MQL) atau lewat update manual di halaman Leads. Untuk Closing, nominal wajib terisi.
6. Dalekta menyusun payload, mencatat satu baris sync log, lalu mengirimnya ke Conversions API Meta.
7. Hasilnya, SUCCESS atau FAILED beserta pesan errornya, disimpan di log yang bisa dibaca di menu Event Logs.

Template parameter Meta yang dipakai pada langkah pertama tersedia di Tracking Ads, tab UTM. Bentuk intinya seperti ini (template lengkap di dashboard juga memuat placement dan ad_account_id). Berbeda dari parameter lain, ad_account_id bukan macro dinamis Meta, jadi Dalekta mengisinya dengan ID akun iklan yang sebenarnya bila sudah diketahui:

?utm_source=meta&utm_medium=paid&utm_campaign={{campaign.name}}&utm_term={{adset.name}}&utm_content={{ad.name}}&campaign_id={{campaign.id}}&adset_id={{adset.id}}&ad_id={{ad.id}}&campaign_name={{campaign.name}}&adset_name={{adset.name}}&ad_name={{ad.name}}&site_source_name={{site_source_name}}

Untuk iklan Click-to-WhatsApp yang membuka chat langsung tanpa landing page, Dalekta membuat lead berkode CTWA- dari metadata iklan yang ikut di pesan. Lead seperti ini tidak punya klik di landing page, jadi eventnya dikirim tanpa data klik website seperti event_source_url, fbc, fbp, IP, dan user agent. Akibatnya kualitas pencocokan lebih rendah dan Meta bisa menganggap event itu kurang lengkap, karena Dalekta belum memakai jalur Business Messaging CAPI. Cek hasilnya di Event Logs dan Events Manager seperti biasa. Tracking jalur CTWA dibahas terpisah di CTWA tracking. Untuk melihat gambaran besar dari iklan sampai closing, baca pilar tracking closing WhatsApp dari iklan.

04Mapping status lead ke event Meta

Dalekta memakai enam tahap bisnis. Mapping menentukan nama event Meta apa yang dikirim untuk tiap tahap. Tabel di bawah memuat usulan bawaan di dashboard, bukan aturan yang harus diikuti.

Tiga hal yang sering terlewat. Pertama, hanya event yang sudah dipetakan dan disimpan yang dikirim. Tombol rekomendasi di dashboard hanya mengisi usulan di layar, dan baru berlaku setelah Anda menyimpan. Kedua, kalau Masuk WA dan MQL sama-sama dipetakan ke Lead, satu orang menghasilkan dua event Lead di Meta. Pilih salah satu sebagai sinyal utama, atau petakan MQL ke event lain seperti CompleteRegistration. Field business_event di custom data tetap membedakan keduanya. Ketiga, pilihan di mapping terbatas pada event standar Meta seperti Lead, Contact, Schedule, dan Purchase. Nama event custom belum bisa dipilih.

Event mana yang layak dijadikan sinyal utama bergantung pada seberapa sering closing terjadi dan seberapa rapi tim Anda mencatat status.

05Contoh payload Closing yang dikirim Dalekta

Berikut bentuk payload untuk tahap Closing pada lead yang datang lewat landing page. Semua nilai adalah placeholder ilustrasi, dan hash diganti keterangan agar mudah dibaca. Field opsional hanya ikut jika datanya tersedia pada lead, dan contoh ini diringkas: user data aslinya juga bisa memuat ln, st, dan zp, sedangkan custom data bisa memuat utm_term, utm_content, serta nama campaign, adset, dan iklan.

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1790000000,
      "event_id": "<id-lead>:CLOSING",
      "action_source": "website",
      "event_source_url": "https://contoh.id/promo",
      "user_data": {
        "ph": ["<sha256 nomor WhatsApp>"],
        "fn": ["<sha256 nama depan>"],
        "external_id": ["<sha256 id pengunjung>"],
        "fbc": "fb.1.<waktu klik>.<fbclid>",
        "fbp": "fb.1.<waktu>.<angka acak>",
        "client_ip_address": "<IP saat klik>",
        "client_user_agent": "<user agent browser>",
        "ct": "<sha256 kota>",
        "country": "<sha256 id>"
      },
      "custom_data": {
        "currency": "IDR",
        "value": 2500000,
        "content_name": "<nama campaign>",
        "status": "CLOSING",
        "business_event": "CLOSING",
        "lead_code": "[D-ABC12]",
        "utm_source": "meta",
        "utm_medium": "paid",
        "utm_campaign": "<nama campaign>",
        "adset_id": "<id adset>",
        "ad_id": "<id iklan>",
        "assigned_sales": "<nama sales>",
        "visitor_city": "<kota>",
        "visitor_country": "ID"
      }
    }
  ]
}

Isi percakapan WhatsApp tidak ikut dikirim. Yang keluar dari Dalekta hanya metadata lead, campaign, dan klik yang tercantum di atas. Perhatikan bahwa custom data memuat nama sales dan perkiraan lokasi visitor (kota, provinsi, kode pos, negara) dalam teks biasa. Pertimbangkan itu saat Anda menulis kebijakan privasi bisnis.

06Customer information: apa yang di-hash dan bagaimana soal privasi

Aturan Meta membedakan dua kelompok parameter. Email, nomor telepon, nama depan, nama belakang, kota, provinsi, kode pos, dan negara wajib di-hash dengan SHA-256 setelah dibersihkan: spasi di ujung dibuang dan huruf dijadikan kecil. Untuk external_id, hash hanya direkomendasikan. Nomor telepon harus berisi angka saja dengan kode negara dan tanpa nol di depan. Sebaliknya fbc, fbp, client_ip_address, dan client_user_agent dikirim tanpa hash, dan Meta menegaskan client_ip_address tidak boleh di-hash. Dalekta sendiri tidak mengirim email, karena data lead tidak menyimpan alamat email.

Meta menilai kualitas pencocokan lewat skor Event Match Quality di Events Manager, dan parameter yang valid umumnya menaikkan skor itu. Lead dari landing page membawa fbp, IP, dan user agent, ditambah fbc bila ada fbclid. Lead tanpa landing page, seperti lead CTWA, hanya punya nomor telepon, nama, dan ID lead, sehingga pencocokannya lebih lemah. Nama pada lead juga berasal dari nama profil WhatsApp yang sering berupa panggilan, jadi jangan berharap nama menjadi penentu utama.

Soal privasi, ada beberapa hal yang perlu Anda putuskan sendiri karena Dalekta tidak bisa memutuskannya untuk bisnis Anda:

• Hash bukan anonimisasi. Meta memakai hash itu untuk mencocokkan dengan akun penggunanya, jadi perlakukan tetap sebagai data pribadi. Alamat IP dan user agent dikirim tanpa hash, begitu juga perkiraan lokasi di custom data.
• Consent di landing page. Script tracker Dalekta tidak menampilkan banner persetujuan sendiri. Pengaturan cookie dan consent di halaman Anda tetap tanggung jawab Anda.
• Kebijakan privasi bisnis. Jelaskan bahwa data konversi dibagikan ke platform iklan. Dokumentasi Dalekta menyarankan hal yang sama di halaman privasi dan retensi data.
• Ketentuan Meta. Ketentuan Meta Business Tools meminta Anda punya hak yang sah untuk membagikan data pelanggan, termasuk persetujuan bila hukum setempat mewajibkannya. Di Indonesia, rujukannya termasuk UU No. 27 Tahun 2022 tentang Pelindungan Data Pribadi.
• Data sensitif. Jangan mengarahkan tim sales menulis informasi sensitif ke field yang ikut dikirim. Nama lead dan nama sales termasuk di dalamnya.

07Meta CAPI Indonesia: mata uang, nomor telepon, dan format nominal

Secara teknis, setup Meta CAPI Indonesia tidak berbeda dari negara lain. Namun ada beberapa detail lokal yang sering membuat data salah tanpa ada pesan error, terutama untuk nominal dan nomor telepon.

Kalau Anda mengirim data closing dari CRM sendiri di luar Dalekta, nomor telepon paling sering menjebak: nomor yang ditulis 0812... harus diubah menjadi 62812... sebelum di-hash, kalau tidak hash-nya sulit cocok dengan data di Meta.

08event_id, sync log, dan cara mencegah hitungan ganda

Hitungan ganda bisa terjadi di dua tempat, dan penanganannya berbeda.

Dalekta tidak menjalankan Pixel di browser Anda, jadi tidak ada Pixel Dalekta yang perlu dideduplikasi. Masalahnya muncul kalau landing page Anda punya Pixel sendiri yang menembak Lead atau Contact. Event itu tidak memakai event_id yang sama dengan event Dalekta, jadi metode deduplikasi utama tidak bekerja. Meta punya metode cadangan berbasis fbp atau external_id, tetapi hasilnya tidak bisa Anda kendalikan: event bisa terhitung dua kali atau salah satunya dibuang. Cara paling aman adalah membagi tugas: biarkan Pixel mengurus PageView dan ViewContent di halaman, dan pakai Dalekta untuk kejadian setelah klik WhatsApp seperti Lead, Schedule, dan Purchase. Kalau Click CTA dipetakan ke Contact sementara Pixel juga menembak Contact di tombol yang sama, Anda mendapat dua Contact untuk satu klik, atau salah satunya hilang tanpa Anda tahu.

Bentuk event_id yang tetap per lead dan tahap membawa beberapa konsekuensi yang perlu Anda ketahui:

• Satu lead hanya mengirim satu event per tahap. Pembelian kedua dari lead yang sama tidak menjadi Purchase kedua.
• Koreksi nominal setelah event berstatus SUCCESS tidak otomatis mengirim ulang. Pastikan nominal benar sebelum menyimpan Closing.
• Retry manual memakai event_id yang sama, dan itu memudahkan audit. Deduplikasi yang didokumentasikan Meta menyangkut pasangan Pixel dan server, jadi pakai retry hanya untuk log FAILED yang jelas belum diterima Meta.
• Baris PENDING yang lebih tua dari sekitar dua menit dianggap sisa proses yang mati dan bisa diambil alih pengiriman berikutnya. Permintaan ke Meta dibatasi sekitar delapan detik.

09Cara memverifikasi event di Dalekta dan Events Manager

Lakukan tes ujung ke ujung sebelum campaign besar berjalan. Gunakan satu lead percobaan, jangan menunggu lead asli.

1. Pastikan Pixel ID, token, dan mapping sudah tersimpan di Tracking Ads.
2. Buka landing page dengan URL yang membawa utm_source=meta atau fbclid, plus parameter campaign. Tanpa salah satunya, lead tidak dianggap berasal dari Meta dan event dilewati.
3. Klik tombol WhatsApp rotator, lalu kirim pesan yang membawa kode tracking [D-...] dari ponsel lain.
4. Cek halaman Leads. Lead harus muncul sebagai Masuk WA dengan campaign yang benar.
5. Ubah status lead sesuai tahap yang mau dites, misalnya Closing dengan nominal percobaan.
6. Buka Event Logs di Dalekta (judul halamannya Sync Logs). Rentang tanggalnya awalnya hari ini, jadi sesuaikan bila tes dilakukan di hari lain. Cari baris untuk lead itu dan baca statusnya, jumlah attempts, dan pesan error.
7. Buka Events Manager, pilih Pixel, lalu tab Overview. Cari event dengan nama dari mapping dan periksa jumlahnya, statusnya, serta skor Event Match Quality. Meta menyebut event umumnya bisa diverifikasi dalam sekitar 20 menit setelah pengiriman dimulai.

Kalau event tidak muncul sama sekali di log, penyebabnya biasanya ada di daftar berikut. Pesan di kolom tengah adalah teks yang dipakai Dalekta saat melewati sebuah event. Pada pengiriman otomatis, event yang dilewati tidak selalu meninggalkan baris log, jadi anggap daftar ini sebagai titik awal pemeriksaan.

Untuk error dari Meta sendiri, seperti token kedaluwarsa atau izin Business Manager yang kurang, Dalekta menyimpan pesan error yang dikembalikan Meta di log. Urutan debug yang lebih lengkap ada di dokumentasi Event Logs dan Sync Logs.

10Batasan yang perlu Anda ketahui

Supaya ekspektasi tepat, berikut batas dari implementasi yang dibahas di artikel ini.

• Hanya Meta. Meta CAPI adalah integrasi aktif dan produksi di Dalekta. Google Ads masih berstatus fondasi atau beta, dan TikTok belum tersedia, jadi tidak dibahas sebagai fitur aktif.
• Payload bergaya website. Semua event dikirim dengan action_source website, termasuk lead CTWA dan perubahan status di sisi WhatsApp. Meta juga punya jalur terpisah untuk business messaging yang memakai action_source business_messaging, ctwa_clid, dan ID akun WhatsApp Business. Dalekta belum memakai jalur itu dan tidak mengirim ctwa_clid ke Meta. Lead CTWA dikirim tanpa data klik website, sehingga kualitas pencocokannya lebih rendah. Untuk konteks tracking iklan Click-to-WhatsApp, lihat CTWA tracking.
• Kualitas data mengikuti disiplin tim. Rules yang longgar atau status yang tidak dicatat membuat Meta belajar dari sinyal salah. Mulai dari rule yang konservatif.
• Satu event per tahap per lead. Lihat bagian event_id di atas.
• Retry setelah timeout perlu dicek dulu. Deduplikasi yang didokumentasikan Meta menyangkut event dari dua sumber berbeda, yaitu Pixel dan server, bukan kiriman ulang dari server yang sama. Jika error log berupa timeout, request mungkin sempat diterima Meta, jadi cek Events Manager dulu sebelum menekan retry.
• Log jangka pendek. Sync log dipakai untuk troubleshooting dan disimpan lebih singkat daripada data lead, sesuai paket. Jangan menjadikannya arsip.
• Angka Meta dan Dalekta tidak selalu sama. Ads Manager menghitung hasil dengan model attribution Meta sendiri, sedangkan Dalekta menghitung berdasarkan lead dan status di sistemnya. Dalekta tidak menghitung spend, CPL, cost per closing, maupun ROAS per campaign, jadi ambil angka spend dari Ads Manager. Untuk membaca hasil iklan sampai revenue, lihat cara ukur ROAS iklan WhatsApp.

11Kesalahan umum yang merusak sinyal CAPI

Kalau Anda baru mulai, jangan langsung memetakan enam tahap sekaligus. Kirim dua atau tiga event yang definisinya paling jelas, baca sync log selama beberapa hari, baru tambah tahap berikutnya.

12Bacaan lanjutan

13Pertanyaan umum