Start free
Broadcast & Marketing WhatsApp

Conversions API WhatsApp: Cara Kirim Lead & Purchase dari CRM

Conversions API WhatsApp mengirim sinyal LeadSubmitted dan Purchase beserta ctwa_clid dari CRM ke Meta. Ini syarat teknis, JSON, dan cara setup-nya.

12 menit bacaDiperbarui

Jawaban Langsung: Conversions API WhatsApp (CAPI for Business Messaging) adalah jalur integrasi server-ke-server resmi dari Meta yang mengirimkan sinyal konversi dari percakapan WhatsApp Business API kembali ke Meta Events Manager. Dengan menyertakan kode klik iklan (ctwa_clid) dan ID WABA, sistem CRM dapat melaporkan event LeadSubmitted serta Purchase bernilai Rupiah dalam batas waktu 7 hari setelah iklan diklik.

Pembaruan per 9 November 2026. Dicek langsung ke dokumentasi resmi Meta for Developers (Conversions API for Business Messaging), AWS End User Messaging, serta diuji pada WhatsApp Business Cloud API v21.0 dan sistem CRM Agendiz Cloud.

Pengiklan yang menjalankan kampanye Click to WhatsApp (CTWA) di Facebook dan Instagram sering menghadapi kebuntuan data. Di dashboard Meta Ads Manager, laporan berhenti pada metrik jumlah percakapan yang dimulai (Messaging conversations started) dan biaya per percakapan. Sementara itu, proses tanya jawab, pengiriman penawaran, hingga transfer pembayaran berlangsung di dalam chat WhatsApp dan dicatat terpisah oleh tim admin.

Tanpa jembatan data dari ruang chat kembali ke server Meta, algoritma iklan hanya belajar mencari orang yang gemar mengklik tombol chat, bukan orang yang benar-benar menyelesaikan pembayaran. Meta menyediakan Conversions API for Business Messaging untuk menutup celah tersebut.

Kenapa iklan Click to WhatsApp butuh Conversions API?

Pada halaman resmi WhatsApp for Business: Down-funnel optimizations dan dokumentasi Meta for Developers: Conversions API for Business Messaging (dicek 9 November 2026), Meta membagi optimasi iklan klik ke WhatsApp ke dalam tiga lapis tujuan:

  1. Conversations (Percakapan): Mengarahkan penayangan iklan ke pengguna yang paling mungkin memulai chat di WhatsApp.
  2. Leads (Prospek Berkualitas): Mengarahkan iklan ke pengguna yang berpeluang masuk kualifikasi prospek di dalam chat. Dalam riset eksperimen Meta pada 4 sampai 10 November 2024 terhadap 116 ribu kampanye, optimasi Leads diklaim menghasilkan biaya per lead rata-rata 24% lebih rendah dibandingkan optimasi percakapan.
  3. Purchase (Pembelian): Mengarahkan iklan ke pengguna yang paling berpeluang melakukan transaksi dari percakapan WhatsApp. Dalam studi global Meta pada paruh kedua 2024, optimasi Purchase diklaim menghasilkan biaya per pembelian rata-rata 10% lebih rendah dibandingkan optimasi percakapan.

Angka 24% dan 10% di atas merupakan klaim riset internal Meta, bukan jaminan otomatis untuk setiap akun iklan. Namun satu syarat teknisnya mutlak: opsi optimasi Purchase (serta pelaporan konversi bawah corong dari CRM) hanya terbuka apabila bisnis mengirimkan event konversi dari percakapan WhatsApp melalui Conversions API. Pembahasan lengkap mengenai strategi pemilihan ketiga lapis tersebut dapat Anda baca di artikel pilar Optimasi Iklan Click to WhatsApp (CTWA): Bedah Conversations, Leads, dan Purchase.

Perbedaan Conversions API Website dan Conversions API Pesan Bisnis (WhatsApp)

Banyak pengiklan yang sudah memasang Meta Pixel atau Conversions API untuk situs web mengira setelan yang sama bisa langsung dipakai untuk iklan WhatsApp. Padahal struktur parameter, jalur atribusi, dan dataset yang digunakan keduanya berbeda. Perbandingan jalur akuisisi antara iklan langsung ke WhatsApp dan halaman web juga kami bahas di panduan Iklan CTWA vs Landing Page ke WhatsApp.

Aspek Teknis Conversions API Pesan Bisnis (WhatsApp) Conversions API Situs Web (Web CAPI)
Nilai action_source Wajib diisi "business_messaging" Diisi "website"
Nilai messaging_channel Wajib diisi "whatsapp" Tidak digunakan
Dataset tujuan di Events Manager Dataset khusus yang tertaut langsung ke akun WABA (/{WABA_ID}/dataset) Dataset atau Pixel situs web
Parameter pencocokan utama (user_data) whatsapp_business_account_id dan ctwa_clid client_ip_address, client_user_agent, fbp, fbc (fbclid), email/telepon ter-hash
Sumber pengenal klik iklan Objek referral.ctwa_clid pada webhook pesan masuk pertama Parameter URL ?fbclid= di peramban pengunjung
Ketergantungan pada browser & cookie Bebas dari pemblokir iklan browser karena murni server-ke-server Bergantung pada pemuatan halaman web jika dikombinasikan dengan Pixel browser
Batas waktu pengiriman event Maksimal 7 hari sejak interaksi klik iklan Mengikuti jendela atribusi kampanye web

Daftar event dan syarat parameter wajib di Meta Conversions API WhatsApp

Berdasarkan dokumentasi Meta for Developers: Conversions API for Business Messaging, pengiklan dapat mengirim beberapa jenis event standar dari percakapan WhatsApp ke endpoint Graph API POST https://graph.facebook.com/v21.0/{DATASET_ID}/events:

  • LeadSubmitted: Dikirim ketika calon pelanggan yang masuk dari iklan telah memberikan informasi yang dibutuhkan atau masuk ke tahapan prospek di pipeline penjualan CRM.
  • Purchase: Dikirim ketika pelanggan menyelesaikan pembayaran atau penguncian pesanan (misalnya transfer uang muka paket umroh atau pelunasan invoice). Event ini wajib menyertakan mata uang (currency) dan nominal transaksi (value).
  • Event siklus belanja lainnya: QualifiedLead, OrderCreated, OrderShipped, InitiateCheckout, AddToCart, dan ViewContent.

Empat parameter yang wajib ada di setiap pengiriman event

Agar server Graph API Meta menerima event dari CRM WhatsApp Anda tanpa penolakan, pastikan empat syarat berikut terpenuhi:

  1. action_source dan messaging_channel: Di tingkat objek event, action_source harus bernilai "business_messaging" dan messaging_channel harus bernilai "whatsapp".
  2. whatsapp_business_account_id: ID akun WhatsApp Business Account (WABA) tempat nomor bisnis Anda terdaftar, diletakkan di dalam objek user_data.
  3. ctwa_clid: Kode unik klik iklan yang ditangkap CRM dari webhook pesan pertama pengguna. Penjelasan rinci mengenai cara menangkap kode ini dari payload webhook dapat Anda pelajari di artikel Apa Itu ctwa_clid? Cara Kerja Kode Klik Iklan WhatsApp untuk Tracking Closing.
  4. currency dan value (khusus Purchase): Di dalam objek custom_data, currency diisi kode mata uang tiga huruf ISO (seperti "IDR") dan value diisi angka nominal transaksi.

Contoh payload JSON untuk event LeadSubmitted dan Purchase

Berikut contoh struktur body JSON (menggunakan ID dan nilai contoh) saat server CRM mengirimkan event LeadSubmitted ketika kartu deal dibuat, disusul event Purchase ketika deal berubah menjadi Won:

{
  "data": [
    {
      "event_name": "LeadSubmitted",
      "event_time": 1731135600,
      "action_source": "business_messaging",
      "messaging_channel": "whatsapp",
      "user_data": {
        "whatsapp_business_account_id": "104928374650192",
        "ctwa_clid": "ARBn8x3k-YvLz9Pq0mK1jRt7W_U2iOsP5xLqA9B8c7D6e5F4g3H2i1"
      }
    },
    {
      "event_name": "Purchase",
      "event_time": 1731142800,
      "action_source": "business_messaging",
      "messaging_channel": "whatsapp",
      "user_data": {
        "whatsapp_business_account_id": "104928374650192",
        "ctwa_clid": "ARBn8x3k-YvLz9Pq0mK1jRt7W_U2iOsP5xLqA9B8c7D6e5F4g3H2i1"
      },
      "custom_data": {
        "currency": "IDR",
        "value": 5000000,
        "order_id": "DEAL-CONTOH-109"
      }
    }
  ]
}

Empat kesalahan yang membuat event Purchase WhatsApp gagal masuk Events Manager

Saat kami menguji pengiriman event secara langsung dari iklan aktif ke Meta Events Manager pada 29 Oktober 2026 (catatan lengkap pengujian dari sudut pandang praktisi juga terdokumentasi di artikel uji nyata iklan CTWA sampai Purchase masuk Events Manager), ada empat kendala teknis dan operasional yang paling sering menjebak tim iklan:

1. Mengirim event WhatsApp ke Dataset Website (Error 2804132)

Menurut dokumentasi Meta dan AWS End User Messaging: Conversions API, setiap akun WABA memiliki tepat satu dataset konversi khusus (/{WABA_ID}/dataset). Jika Anda menembakkan payload business_messaging ke ID Pixel atau Dataset yang dibuat untuk situs web biasa, Graph API Meta akan menolak permintaan tersebut dengan kode galat 2804132.

2. Mengetes klik dari menu Pratinjau Iklan (Ad Preview)

Banyak pengiklan mencoba mengetes alur CAPI dengan membuka menu Ad Preview di Ads Manager lalu mengklik tombol kirim pesan. Klik yang berasal dari pratinjau iklan tidak menyertakan objek referral maupun ctwa_clid di webhook WhatsApp Business API. Akibatnya, CRM tidak memiliki kode klik untuk dikirim balik ke Meta. Pengujian harus dilakukan lewat tayangan iklan yang sudah berstatus Active di feed atau menggunakan alat uji payload Meta.

3. Admin CS terlambat menggeser status deal melewati batas 7 hari

Dokumentasi AWS End User Messaging menegaskan bahwa event konversi harus dikirimkan untuk interaksi iklan yang terjadi dalam 7 hari terakhir. Selain itu, aturan tarif Meta juga memberikan jendela pesan gratis Free Entry Point WhatsApp sampai 7 hari sejak balasan pertama bisnis.

Jika calon jamaah umroh mengklik iklan pada hari Senin dan mentransfer uang muka (DP) pada hari Jumat, tetapi admin CS baru memperbarui status deal di CRM pada pekan berikutnya setelah lewat 7 hari, sinyal Purchase tersebut tidak lagi terhubung ke iklan asal. Disiplin mengikuti SOP follow-up calon jamaah umroh H+1 sampai H+12 dan memperbarui pipeline di hari yang sama sangat menentukan akurasi laporan iklan.

4. Memaksakan optimasi Purchase saat volume konversi belum cukup

Memiliki integrasi Conversions API bukan berarti setiap ad set baru harus langsung disetel ke optimasi Purchase sejak hari pertama. Algoritma Meta memerlukan patokan sekitar 50 konversi per minggu per ad set agar bisa keluar dari fase pembelajaran (learning phase).

Jika jumlah transaksi mingguan Anda masih di bawah angka tersebut, jalankan kampanye dengan optimasi Conversations atau Leads terlebih dahulu sambil tetap menyalakan pengiriman event LeadSubmitted dan Purchase dari CRM. Dengan begitu, laporan jumlah pembelian dan nilai transaksi tetap tampil di kolom Ads Manager tanpa membuat penayangan iklan macet di status Learning Limited.

Cara kerja otomatis add-on Meta CAPI (WhatsApp) di Agendiz Cloud

Merakit penyimpan webhook ctwa_clid, pencocokan dataset WABA, dan antrean pengiriman Graph API secara manual membutuhkan waktu pengembangan yang tidak sebentar. Di Agendiz Cloud, seluruh alur tersebut sudah tersedia siap pakai melalui add-on Meta CAPI (WhatsApp) v1.1.4:

  1. Koneksi nomor resmi tanpa harus ganti nomor: Anda cukup menghubungkan nomor ke WhatsApp Business API, baik mendaftarkan nomor baru lewat cara daftar WA Business API maupun mempertahankan nomor aplikasi WhatsApp Business yang sedang berjalan di ponsel lewat fitur WhatsApp Coexistence.
  2. Deteksi otomatis WABA dan Dataset di halaman /meta-capi: Begitu akun terhubung, halaman pengaturan /meta-capi di dashboard Agendiz Cloud mendeteksi WABA ID dan Dataset WhatsApp Anda secara otomatis. Halaman ini tersedia dalam dua bahasa, dilengkapi riwayat pengiriman lengkap di Activity Log, serta panduan teknis di menu Guidebook dashboard (/guidebook/meta-capi).
  3. Penyimpanan ctwa_clid permanen di profil kontak: Saat chat iklan masuk ke inbox tim satu nomor banyak admin, Agendiz Cloud otomatis menampilkan sumber kampanye dan menyimpan ctwa_clid (klik pertama maupun klik terakhir) di profil kontak. Data atribusi tetap aman meskipun ruang obrolan diarsipkan.
  4. Pemicu otomatis dari Sales Pipeline:
    • Saat admin CS membuat kartu deal dari chat yang memiliki atribusi iklan, Agendiz Cloud otomatis mengirimkan event LeadSubmitted ke Meta Events Manager.
    • Saat deal tersebut ditandai Won beserta nilai Rupiah, Agendiz Cloud otomatis mengirimkan event Purchase dengan currency: "IDR", nominal value, ctwa_clid, dan whatsapp_business_account_id ke Meta. Pada pengujian nyata kami tanggal 29 Oktober 2026, deal bernilai Rp220.000 yang ditandai Won langsung tercatat sebagai event Purchase di Meta Events Manager.
  5. Pembagian jelas antara dashboard CRM dan Meta Ads Manager:
    • Untuk kampanye dengan optimasi percakapan (Conversations), Anda dapat membuat iklan CTWA langsung dari menu Meta Ads di dashboard Agendiz Cloud (lengkap dengan pengaturan lokasi kota, radius, behavior, exclude, custom audience, lookalike, CBO, bid cap, dan cost cap).
    • Untuk kampanye dengan optimasi Leads atau Purchase, pemilihan tujuan optimasi dilakukan langsung di Meta Ads Manager (pilih tujuan Sales atau Leads, destinasi WhatsApp, dan Dataset WhatsApp yang sudah menerima sinyal dari Agendiz Cloud). Evaluasi metrik pembelian dan ROAS juga dilihat langsung di laporan Ads Manager.

Seluruh fitur inbox tim, sales pipeline, dan integrasi di Agendiz Cloud dihitung flat per workspace, bukan per user (paket Starter gratis selamanya dengan kuota dasar, Growth 3 seat Rp176.000/bulan pada tagihan tahunan, dan Pro 10 seat Rp448.000/bulan pada tagihan tahunan; rincian lengkap ada di halaman harga Agendiz Cloud). Jika Anda butuh bantuan mengecek kesesuaian Dataset WhatsApp dan koneksi WABA, tim teknis kami siap mendampingi langsung lewat sesi MBG (Minta Bantuan Gmeet) dan Grup WhatsApp Bantuan Cepat.

Bagi biro perjalanan haji dan umroh yang ingin merapikan alur dari iklan sampai keberangkatan, Anda juga dapat mempelajari ekosistem CRM WhatsApp untuk travel haji dan umroh serta panduan khusus iklan WhatsApp travel umroh: cara ukur dari chat sampai DP. Apabila kendala utama biro Anda bukan pada tools melainkan keterbatasan SDM admin untuk menjaga kerapian label, membalas chat iklan, dan mengelola database alumni, tim CRM Specialist di Agendiz.com menyediakan layanan operasional pendampingan yang bisa didiskusikan lewat sesi MBG.

Pertanyaan yang sering ditanyakan

Apa itu Conversions API WhatsApp (CAPI for Business Messaging)?

Conversions API WhatsApp adalah antarmuka server-ke-server resmi dari Meta yang memungkinkan sistem CRM mengirimkan data peristiwa konversi (seperti LeadSubmitted dan Purchase) dari percakapan WhatsApp Business API kembali ke Meta Events Manager menggunakan pengenal klik iklan ctwa_clid.

Apakah Conversions API WhatsApp bisa dipakai di aplikasi WhatsApp Business biasa tanpa API?

Tidak bisa. Aplikasi WhatsApp Business biasa di ponsel tidak memiliki webhook server untuk menangkap ctwa_clid dan tidak terhubung ke Dataset WABA di Meta Events Manager. Anda perlu menggunakan WhatsApp Business Platform (Cloud API), baik dengan nomor baru maupun dengan fitur WhatsApp Coexistence agar aplikasi di ponsel tetap aktif.

Kenapa muncul error 2804132 saat mengirim event Purchase dari WhatsApp ke Meta?

Kode error 2804132 muncul karena event pesan bisnis (action_source: "business_messaging") dikirimkan ke ID Pixel atau Dataset yang dibuat untuk situs web. Solusinya, buat atau gunakan Dataset khusus yang tertaut langsung ke akun WhatsApp Business Account (WABA ID) Anda di Meta Events Manager.

Dimana saya memilih optimasi Purchase setelah Conversions API WhatsApp aktif?

Pemilihan tujuan optimasi Purchase dilakukan langsung di Meta Ads Manager saat menyusun kampanye (pilih tujuan Sales atau Engagement, lokasi konversi Messaging apps -> WhatsApp, pilih Dataset WhatsApp Anda, lalu pilih sasaran performa Maximize number of purchases). Sementara itu, menu pembuatan iklan di dalam dashboard Agendiz Cloud digunakan untuk kampanye dengan optimasi percakapan (Conversations).

Langkah berikutnya

Ubah laporan iklan WhatsApp Anda dari sekadar menghitung jumlah chat masuk menjadi pelacakan prospek dan pembelian nyata yang terhubung ke algoritma Meta.

Anda dapat langsung mencoba seluruh fitur inbox tim, sales pipeline, dan add-on Meta CAPI (WhatsApp) lewat program Coba Gratis 14 Hari di Agendiz Cloud (semua fitur terbuka selama 14 hari pertama, dan otomatis beralih ke paket Starter gratis bila belum berlangganan), lengkap dengan pendampingan setup MBG (Minta Bantuan Gmeet).

Sumber resmi

Ditulis oleh Suhendra Nasution, Founder & CEO PT Agendiz Digital Teknologi, praktisi website, SEO, dan iklan digital sejak 2018.

Bagikan WhatsApp Facebook Telegram

Baca juga

Semua artikel
Masih ada yang bikin bingung?

Tanya langsung ke tim kami.

Ceritakan kondisi bisnis Anda. Kami jawab dengan bahasa sehari-hari, bukan jawaban template.

Tanya lewat chat Lihat harga