Apa Itu ctwa_clid? Cara Kerja Kode Klik Iklan WhatsApp untuk Tracking Closing

ctwa_clid (Click to WhatsApp Click Identifier) adalah kode alfanumerik unik yang dibuat Meta saat pengguna mengklik iklan Click to WhatsApp (CTWA). Meta meneruskan kode ini lewat webhook WhatsApp Business API pada pesan pertama. Sistem CRM menyimpan kode ini untuk mengirimkan sinyal konversi (seperti LeadSubmitted dan Purchase) kembali ke Meta Conversions API dalam batas waktu 7 hari.

Pembaruan per 5 November 2026. Diuji langsung menggunakan WhatsApp Business Cloud API v21.0, Meta Conversions API for Business Messaging, dan sistem CRM Agendiz Cloud.

Iklan Click to WhatsApp sering memperlihatkan biaya per pesan yang murah di Ads Manager. Kendalanya, data di Ads Manager berhenti di jumlah percakapan yang dimulai. Tim pemasaran melihat ratusan chat masuk, sementara buku kasir penjualan mencatat data secara terpisah. Akibatnya, pengiklan sulit memastikan ad set atau materi kreatif mana yang benar-benar menghasilkan pembayaran.

Meta menyediakan parameter ctwa_clid untuk menjembatani data klik iklan dengan data penjualan di sistem internal bisnis.

Fungsi ctwa_clid pada iklan WhatsApp

ctwa_clid adalah kependekan dari Click to WhatsApp Click Identifier. Parameter ini berupa deretan karakter unik yang dibuat otomatis oleh server Meta setiap kali seseorang menekan tombol kirim pesan pada iklan di feed Facebook, Instagram Stories, Reels, atau Marketplace.

Kode ini diteruskan ke nomor WhatsApp bisnis Anda saat pengguna mengirimkan chat pertama. Saat transaksi terjadi di kemudian hari, misalnya pembayaran uang muka paket umroh atau pembelian barang, sistem CRM mengirimkan kode tersebut kembali ke server Meta melalui Conversions API (CAPI).

Meta mencocokkan ctwa_clid dari CRM dengan catatan klik miliknya untuk:

Menghubungkan nominal penjualan dengan kampanye dan materi iklan asal.
Menampilkan nilai belanja riil di kolom laporan Ads Manager.
Mengarahkan algoritma penayangan iklan ke pengguna yang memiliki kebiasaan belanja serupa.

Posisi ctwa_clid pada payload webhook Meta

Saat pengguna mengirim pesan pertama dari iklan CTWA, WhatsApp Business Cloud API mengirimkan data webhook ke endpoint server CRM.

Parameter ctwa_clid berada di dalam objek referral pada pesan masuk pertama:

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "104928374650192",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "6285176827729",
              "phone_number_id": "109823475612345"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Ahmad Fauzi"
                },
                "wa_id": "6281234567890"
              }
            ],
            "messages": [
              {
                "from": "6281234567890",
                "id": "wamid.HBgNNjI4MTIzNDU2Nzg5MBUCABEYEkRFM0E4OUY0OTAyQkFDREVCAA==",
                "timestamp": "1730784000",
                "type": "text",
                "text": {
                  "body": "Halo, saya ingin tanya info paket umroh yang ada di iklan."
                },
                "referral": {
                  "source_url": "https://fb.me/2AbCdEfGh",
                  "source_id": "120215987654320123",
                  "source_type": "ad",
                  "headline": "Paket Umroh Reguler 12 Hari Syawal",
                  "body": "Daftar sekarang dan dapatkan potongan biaya perlengkapan.",
                  "media_type": "image",
                  "image_url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/...",
                  "ctwa_clid": "ARBn8x3k-YvLz9Pq0mK1jRt7W_U2iOsP5xLqA9B8c7D6e5F4g3H2i1"
                }
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

Objek referral memuat beberapa data penting:

ctwa_clid: token identifikasi klik yang dikirim balik ke Conversions API.
source_id: ID iklan di Ads Manager yang diklik pengguna.
source_type: tipe sumber interaksi, bernilai "ad" untuk iklan berbayar.
headline dan body: judul serta teks penawaran yang tampil di iklan.
image_url: tautan gambar materi iklan.

Meta hanya menyertakan objek referral pada pesan masuk pertama. Pesan kedua dan seterusnya tidak lagi memuat data rujukan ini. Sistem CRM perlu menyimpan nilai ctwa_clid ke basis data kontak saat pesan pertama kali diterima.

Perbedaan ctwa_clid dan fbclid

Pemasar yang mengelola situs web umumnya mengenal fbclid (Facebook Click Identifier). Walaupun sama-sama dibuat oleh Meta untuk pelacakan, jalur pengiriman keduanya berbeda.

Parameter	ctwa_clid (Iklan WhatsApp)	fbclid (Iklan Situs Web)
Jalur tujuan	Aplikasi WhatsApp (Android dan iOS)	Peramban web
Pengiriman data	Server ke server lewat webhook Cloud API	Parameter URL halaman web (?fbclid=...)
Pemblokir iklan	Tidak terpengaruh ekstensi pemblokir di peramban	Berisiko diblokir oleh ekstensi browser atau DNS
Pengaturan privasi	Bebas dari pembatasan cookie pihak ketiga	Dibatasi oleh Safari ITP dan pelacak privasi iOS
Alur pengguna	Langsung masuk ke chat WhatsApp	Melewati pemuatan halaman web terlebih dahulu
Pelaporan konversi	Conversions API for Business Messaging	Meta Pixel atau Conversions API Web
Parameter wajib	WABA ID dan ctwa_clid	Alamat IP, user agent, dan data kontak terenkripsi

Karena data ctwa_clid berpindah langsung antarsistem server, informasi klik tidak bergantung pada pembacaan script di browser pengunjung.

Alur pengiriman data konversi dari CRM ke Meta

Pelaporan nilai transaksi ke Ads Manager berlangsung melalui lima tahap:

Pengguna melihat iklan di Instagram atau Facebook, lalu menekan tombol chat. Meta menyematkan nilai ctwa_clid pada sesi tersebut.
Pengguna mengirim pesan pertama di WhatsApp. Webhook Cloud API meneruskan teks pesan dan objek referral.ctwa_clid ke CRM. Sistem CRM mengaitkan kode tersebut pada profil kontak.
Tim admin melayani kebutuhan calon pembeli dan membuka peluang di pipeline penjualan. Sistem mengirimkan event LeadSubmitted ke Meta.
Calon pembeli menyelesaikan pembayaran, misalnya transfer uang muka. Admin mengubah status transaksi menjadi Won dan mencantumkan nilai pembayaran.
CRM mengirimkan event Purchase bersama ctwa_clid ke Meta Conversions API via endpoint POST /{DATASET_ID}/events. Nominal penjualan tercatat di dashboard Ads Manager.

Format data Conversions API untuk event Purchase WhatsApp

Endpoint Conversions API untuk perpesanan bisnis menerima format JSON berikut:

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1730787600,
      "action_source": "business_messaging",
      "messaging_channel": "whatsapp",
      "user_data": {
        "whatsapp_business_account_id": "104928374650192",
        "ctwa_clid": "ARBn8x3k-YvLz9Pq0mK1jRt7W_U2iOsP5xLqA9B8c7D6e5F4g3H2i1"
      },
      "custom_data": {
        "currency": "IDR",
        "value": 25000000.00,
        "content_type": "product",
        "order_id": "DEAL-UMROH-8821"
      }
    }
  ]
}

Tiga ketentuan teknis pengiriman event pesan bisnis:

Batas waktu 7 hari. Dokumentasi Meta dan AWS End User Messaging for WhatsApp menetapkan event konversi yang membawa ctwa_clid harus terkirim maksimal 7 hari setelah klik terjadi.
Satu WABA terhubung ke satu dataset WhatsApp. Mengirimkan event perpesanan bisnis ke dataset situs web menghasilkan galat kode 2804132.
Parameter nilai transaksi. Event Purchase mewajibkan pengisian custom_data.currency (tiga huruf, misalnya IDR) dan custom_data.value (angka positif).

Situasi saat ctwa_clid tidak tercatat

Ada lima kondisi umum saat chat dari iklan masuk tanpa membawa ctwa_clid:

Mengklik dari pratinjau iklan. Pengujian melalui menu pratinjau Ads Manager tidak menyertakan kode ctwa_clid. Pengujian membutuhkan kampanye aktif atau alat pengujian resmi Meta.
Memakai tautan wa.me di kampanye non-CTWA. Iklan bertipe lalu lintas situs web yang diarahkan ke link wa.me diperlakukan sebagai kunjungan web biasa. Webhook pesan masuk tidak menerima objek referral.
Memakai aplikasi WhatsApp biasa. Aplikasi WhatsApp standar di ponsel tidak menyediakan koneksi webhook server, sehingga kode rujukan tidak dapat diekstrak ke sistem pelacakan. Fitur ini memerlukan WhatsApp Business Platform (Cloud API).
Jeda pengiriman pesan terlalu lama. Jika calon pembeli membuka WhatsApp dari iklan lalu menutup aplikasi tanpa berkirim pesan, dan baru menyapa nomor bisnis beberapa minggu kemudian, sesi rujukan iklan sudah kedaluwarsa.
Pencatatan terlambat melewati pesan pertama. Objek referral hanya terkirim di pesan pembuka. Jika sistem tidak merekamnya saat itu juga, kode klik tidak dapat diambil dari pesan-pesan berikutnya.

Penerapan pelacakan di Agendiz Cloud

Platform CRM WhatsApp Agendiz Cloud mengotomatisasi penanganan ctwa_clid melalui add-on Meta CAPI (WhatsApp) v1.1.4:

Sistem membaca objek referral saat pesan pertama masuk. Panel samping inbox menampilkan detail kampanye, judul iklan, dan gambar yang dilihat pengguna.
Parameter ctwa_clid pertama dan terakhir tersimpan pada data kontak, sehingga tetap tersedia saat chat diarsipkan.
Pemindahan kontak ke tahapan tertentu di sales pipeline dapat memicu event LeadSubmitted.
Pada pengujian 29 Oktober 2026, status deal bernilai Rp220.000 yang diubah ke Won secara otomatis mengirimkan event Purchase dengan ctwa_clid ke Meta Events Manager. Laporan pembelian dan omzet masuk secara tepat ke kampanye iklan terkait.

Fitur ini membantu pengiklan membaca metrik Purchases, Cost per Purchase, dan Purchase ROAS langsung dari percakapan WhatsApp.

Langkah persiapan teknis

Empat hal yang perlu dipersiapkan untuk menjalankan pelacakan closing iklan WhatsApp:

Sambungkan nomor bisnis ke WhatsApp Business Cloud API resmi dengan platform CRM yang mencatat data webhook referral.
Atur kampanye di Ads Manager dengan memilih nomor WhatsApp bisnis terverifikasi sebagai tujuan iklan.
Buat dataset WhatsApp khusus yang terhubung dengan akun WABA di Meta Events Manager.
Terapkan SOP bagi admin penjualan untuk memperbarui status transaksi di pipeline sebelum melewati batas 7 hari dari pesan pertama.

Pelajari juga panduan periklanan dan operasional WhatsApp kami lainnya:

Untuk bantuan teknis integrasi WhatsApp API dan pelacakan iklan Meta CAPI, tim teknis Agendiz menyediakan pendampingan lewat sesi MBG (Minta Bantuan Gmeet). Bila biro perjalanan haji dan umroh Anda membutuhkan tim khusus untuk mengelola database alumni dan operasional penjualan, pelajari layanan kami di Agendiz.com.