Software CAPI WhatsApp dengan Konektor.id

Kenapa pixel tidak melihat chat WhatsApp?

Pixel adalah kode kecil di halaman web. Pixel bekerja saat browser pengunjung membuka halaman. Ia mencatat kunjungan, klik, dan pembelian yang terjadi di halaman itu.

Iklan Click-to-WhatsApp tidak punya halaman. Orang menekan iklan, lalu WhatsApp terbuka dengan chat kosong. Percakapan, penawaran, dan transfer terjadi di aplikasi chat. Tidak ada satu pun langkah itu yang lewat browser.

Akibatnya Meta hanya tahu bahwa seseorang memulai chat. Meta tidak tahu siapa yang akhirnya membayar. Sistem iklan lalu belajar dari sinyal yang paling awal, bukan dari sinyal yang paling bernilai.

Jalan keluarnya adalah Conversions API, atau CAPI. Server Anda mengirim kejadian ke Meta secara langsung. Pengiriman tidak bergantung pada browser pembeli. Karena itu CAPI bisa melaporkan penjualan yang selesai di chat, di telepon, atau di toko.

Untuk chat dari iklan, Meta menyediakan jalur khusus. Meta menyebutnya Conversions API for business messaging. Jalur ini memakai penanda klik milik iklan Click-to-WhatsApp, yaitu ctwa_clid. Halaman ini menjelaskan jalur itu dan cara Konektor.id menjalankannya. Untuk gambaran setup iklan Meta secara umum, baca software tracking iklan Meta.

Contoh fiktif

Bayangkan toko bernama Batik Contoh. Toko ini menjual kemeja lewat iklan Click-to-WhatsApp. Nama dan angka di bawah ini fiktif.

Seorang calon pembeli bernama Dewi menekan iklan dan menulis, "Ada kemeja ukuran L?" Meta menyisipkan ctwa_clid pada pesan itu. Konektor.id menyimpannya pada lead Dewi.

CS membalas dan mengirim foto. Dewi tertarik, jadi CS mengubah statusnya menjadi Berkualitas. Meta menerima QualifiedLead. Dua hari kemudian Dewi transfer Rp350.000. CS mengubah status menjadi Closing dan mengisi Nilai closing. Meta menerima Purchase bersama nilainya.

Tanpa pengiriman dari server, Meta berhenti di chat pertama Dewi.

Apa isi satu event CAPI untuk chat?

Satu event adalah satu pesan kecil dari server Anda ke Meta. Pesan itu menjawab empat pertanyaan: apa yang terjadi, kapan, pada siapa, dan dari iklan yang mana.

Meta menyatakan ctwa_clid tidak boleh di-hash. Meta meminta email dan nomor telepon dalam bentuk hash. Sumbernya ada di bagian Sumber.

Konektor.id tidak mengirim fbc pada event business messaging. Penanda itu milik klik ke website, bukan klik ke chat.

Bagaimana Konektor.id membuat dan mengirim event itu?

Konektor.id menjalankan lima tahap. Semuanya berjalan di server.

1. Meta menyisipkan ctwa_clid pada pesan pertama dari iklan. Saluran WhatsApp Anda meneruskannya, dan Konektor.id menyimpannya pada lead. Owner bisa melihat nilainya di Parameter Atribusi pada detail lead.
2. Tim mengubah status lead. Aturan otomatis juga bisa melakukannya.
3. Konektor.id membaca tabel Event per status lead. Tabel itu menentukan event untuk status baru.
4. Konektor.id menyusun event di atas, lalu mengirimnya ke dataset CTWA milik WhatsApp Business Account Anda. Anda tidak perlu mencari Dataset ID. Saat Anda menekan Login dengan Meta, Konektor.id meminta Meta memakai dataset yang sudah ada atau membuatnya.
5. Hasil pengiriman masuk ke Log pengiriman.

Konektor.id hanya memakai nama event yang Meta terima di jalur ini. Status Berkualitas menjadi QualifiedLead. Status Closing menjadi Purchase. Status lain yang punya event untuk Meta menjadi LeadSubmitted. Status Loss tidak dikirim lewat jalur ini, karena event itu akan terbaca sebagai lead baru.

Apa beda jalur business messaging dan jalur event website?

Meta memisahkan dua jalur. Keduanya memakai Conversions API, tetapi tujuan dan isinya berbeda.

Jalur chat memakai dataset dan izin yang berbeda dari token pixel website. Jangan menempelkan token CTWA ke kolom Access Token milik pixel.

Satu hal lagi: bila nomor tidak punya koneksi CTWA yang siap, Konektor.id tidak membuang event. Event berangkat lewat jalur Meta biasa sebagai event chat. Log pengiriman menandainya CTWA cadangan. Anda bisa memperbaiki koneksi, lalu mengirim ulang baris yang memenuhi syarat sebagai Meta CTWA.

Bagaimana membuktikan Meta menerima event?

Pisahkan tiga bukti. Jangan mencampurnya.

1. Koneksi lokal siap. Nomor Anda menampilkan status Siap - Login Meta. Artinya Konektor.id sudah memeriksa izin dan akses. Status ini tidak membuktikan ada event yang diterima.
2. Meta menerima event. Buka Konversi > Log pengiriman. Baris Meta CTWA berstatus Terkirim berarti Meta menerima event itu. Nomor Anda juga menampilkan Meta menerima event CTWA.
3. Ads Manager melaporkan konversi. Ini keputusan Meta. Periksa sendiri di Ads Manager. Konektor.id tidak dapat membuktikannya.

Badge di kolom Platform hanya menunjukkan jalur. Meta CTWA berarti jalur khusus chat. CTWA cadangan berarti jalur cadangan. Meta CAPI berarti pengiriman biasa. Status Terkirim pada baris yang sama menunjukkan hasilnya.

Status lain di Log pengiriman: Antre, Gagal, dan Dilewati. Dilewati berarti Konektor.id sengaja tidak mengirim, misalnya karena Mode ketat atau karena lead sudah pernah mengirim event yang sama.

Bagaimana event ganda dicegah?

Meta menyatakan tidak membantu deduplikasi untuk business messaging. Pengiklan sendiri yang harus memastikan satu kejadian tidak masuk dua kali.

Konektor.id menanganinya dengan satu aturan: tiap jenis event keluar sekali untuk setiap lead. Satu lead mengirim satu LeadSubmitted, satu QualifiedLead, dan satu Purchase. Status berikutnya yang akan mengulang salah satunya tampil sebagai Dilewati di Log pengiriman. Baris Meta CTWA yang sudah Terkirim juga memblokir pengiriman ulang untuk event dan dataset yang sama.

Untuk jalur website, Meta menggabungkan event pixel dan event server bila nama event dan ID event sama. Batas waktunya 48 jam, menurut dokumentasi Meta. Konektor.id mengirim ID unik untuk event server. Agar penggabungan berjalan, event pixel di browser harus memakai ID yang sama.

Kebijakan iklan

Iklan Anda tetap tunduk pada Advertising Standards Meta. Konektor.id tidak mengubah aturan itu. Konektor.id hanya mengirim data konversi yang sudah tersimpan pada lead Anda. Jangan menaruh data sensitif di nama event yang Anda atur sendiri. Tautan kebijakan ada di bagian Sumber.