Konektor

Pelacakan Konversi Click-to-WhatsApp (CTWA)

Iklan Click-to-WhatsApp (CTWA) mengarahkan orang dari Facebook atau Instagram langsung ke percakapan WhatsApp Anda. Konektor menghubungkan konversi dari percakapan tersebut kembali ke iklan melalui Meta Conversions API, sehingga Meta dapat mengoptimalkan kampanye Anda.

Cara kerjanya

Saat pelanggan mengklik iklan CTWA dan mengirim pesan pertama, Meta menyisipkan sebuah ctwa_clid (Click-to-WhatsApp Click ID) ke dalam webhook pesan tersebut. Konektor menyimpan ctwa_clid itu pada lead. Ketika lead kemudian berkembang (misalnya menjadi qualified atau won), Konektor mengirim event konversi ke Meta.

Agar Meta mengaitkan konversi itu ke iklan CTWA, event harus dikirim sebagai business messaging, bukan event website biasa. Konektor mengirim tiga field wajib:

  • action_source: "business_messaging"
  • messaging_channel: "whatsapp"
  • user_data.ctwa_clid (nilai mentah, tidak di-hash)

ditambah identitas bisnis (whatsapp_business_account_id) dan dikirim ke dataset CTWA khusus milik akun WhatsApp Anda.

Kenapa perlu dataset & token khusus

Meta menggunakan dataset CTWA tersendiri untuk konversi WhatsApp, berbeda dari pixel website. Mengirim event ke dataset itu memerlukan izin akses. Saat Anda menghubungkan WhatsApp Business Account (WABA), Meta memilih dataset yang sudah terkait atau membuatnya jika belum tersedia. Konektor menyimpan Dataset ID dan token secara otomatis.

Partner yang didukung

Deteksi ctwa_clid bergantung pada partner WhatsApp yang Anda pakai.

Partnerctwa_clid terdeteksiIdentitas bisnis (WABA)
WhatsApp API (gateway)✅ (paling lengkap)Otomatis dari session
Qiscus✅Otomatis dari webhook
Kirimdev✅Otomatis dari webhook
Halo AI✅Lewat penautan WABA
kirim.chat✅Lewat penautan WABA
Qontak✅Lewat penautan WABA
Pancake❌ belum—
Untuk Qiscus dan Kirimdev, ID WhatsApp Business Account terbaca otomatis dari webhook. Anda tidak perlu memasukkannya secara manual, tetapi tetap perlu menghubungkan Meta satu kali.

Prasyarat

  1. Anda menjalankan iklan Click-to-WhatsApp di Meta.
  2. Nomor WhatsApp bisnis Anda menerima pesan melalui salah satu partner yang didukung di atas.
  3. Anda memiliki akses ke Meta Business Manager untuk memberi izin.

Cara menghubungkan

  1. Buka WhatsApp > Sessions di Konektor.
  2. Buat Session atau lengkapi Session untuk nomor bisnis yang menerima pesan dari iklan CTWA.
  3. Pilih Simpan.
  4. Pilih Siapkan CTWA pada baris Session yang sudah disimpan. Pilih Kelola CTWA jika Session pernah dihubungkan.
  5. Isi WhatsApp Business Account ID dengan WABA ID untuk nomor tersebut pada modal CTWA.
  6. Ikuti panduan koneksi Meta CTWA dengan Token App Meta.

Untuk metode manual, pilih Token App Meta, lalu gunakan Verifikasi & hubungkan. Untuk metode OAuth yang tersedia, pilih Login Meta, lalu gunakan Login dengan Meta.

Konfigurasi lokal siap saat Session menampilkan status kesiapan CTWA. Status lokal tersebut belum membuktikan bahwa Meta menerima event.

Setelah aktif, konversi dari lead CTWA otomatis dikirim sebagai event business messaging ke dataset CTWA Anda.

Jika koneksi CTWA khusus belum siap, Konektor tetap mengirim konversi baru sebagai event chat biasa melalui dataset Meta default workspace. Konversi tetap terkirim, tetapi Meta belum menerima atribusi business messaging khusus CTWA sampai Anda menyelesaikan penautan WABA.

Memeriksa hasil

  • Buka Konversi > Log Sinkronisasi.
  • Badge Meta CTWA menunjukkan jalur khusus CTWA. Badge tersebut bukan bukti penerimaan.
  • Status accepted pada baris Meta CTWA membuktikan bahwa Meta menerima event khusus.
  • Badge CTWA fallback menunjukkan jalur fallback Meta CAPI.
  • Periksa pelaporan atau atribusi secara terpisah di Meta Ads Manager.

Konektor membuktikan kesiapan konfigurasi lokal dan penerimaan event khusus oleh Meta. Konektor tidak membuktikan pelaporan atau atribusi Ads Manager.

Troubleshooting

Konversi CTWA terkirim sebagai chat

Lead memiliki ctwa_clid, tetapi dataset atau izin CTWA khususnya belum siap. Konektor mengirim konversi sebagai event chat biasa agar pengiriman tetap berjalan. Meta tidak menganggap event tersebut sebagai konversi business messaging yang teratribusi.

Solusi: buka WhatsApp > Sessions, lalu pilih Kelola CTWA. Jalankan Periksa koneksi, lalu buat satu konversi baru.

Baris CTWA fallback dengan status accepted atau failed dapat memenuhi syarat untuk Kirim Ulang sebagai Meta CTWA. Baris Meta CTWA dengan status akhir failed juga dapat memenuhi syarat. Baris yang masih queued, sending, atau retry tidak memenuhi syarat. Baris Meta CTWA yang sudah accepted memblokir duplikat. Baris Meta CAPI biasa tidak menawarkan pengiriman ulang CTWA.

"WABA belum ditautkan"

Nomor WhatsApp yang menerima lead belum terhubung ke Meta. Pilih Siapkan CTWA pada Session yang sudah disimpan, lalu isi WABA ID pada modal CTWA. Ikuti panduan koneksi Meta CTWA.

Lead dari Pancake tidak teratribusi

Adapter Pancake belum mengekstrak ctwa_clid. Jika Anda menjalankan iklan CTWA, gunakan partner yang didukung, atau hubungi tim kami.

Pesan tidak menjadi lead sama sekali

Ini masalah koneksi partner, bukan CTWA. Lihat panduan partner terkait (mis. Qiscus, Kirimdev).

Langkah selanjutnya

Butuh Bantuan Lebih Lanjut?

Tim kami siap membantu Anda memaksimalkan tracking iklan dan atribusi bisnis.

support@konektor.idYouTube

Coba atau lanjutkan

Jadwalkan DemoOnboardingSupport Teknis

© 2026 Konektor. Seluruh hak cipta dilindungi.

Privacy PolicyTerms of Service