Template Pesan WhatsApp Buy Button dan Parameter Produk (LarisTurbo)

Placeholder pesan produk di WhatsApp Buy Button, perbedaan dengan greeting global, shortcode, dan integrasi rotator serta Meta Pixel.

Tutorial ini melengkapi panduan dasar WhatsApp Buy Button. Fokusnya ke WhatsApp Message / Greeting Text khusus tombol beli dan cara pesan dimasukkan ke link WhatsApp.

Dua lapisan pesan WhatsApp

Sumber	Lokasi Settings	Dipakai oleh
Pesan global	LarisTurbo → For WhatsApp → WhatsApp Integration → Default WhatsApp Message / Greeting Text	Floating button, link umum, rotator tanpa konteks produk
Pesan produk	LarisTurbo → For WhatsApp → WhatsApp Buy Button For WooCommerce → WhatsApp Message / Greeting Text	Tombol beli di halaman produk/shop, shortcode, sticky CTA

Tombol beli selalu memakai template produk (wc_whatsapp_message), bukan pesan global—kecuali filter kode mengubah perilaku.

Parameter template produk

Field WhatsApp Message / Greeting Text mendukung placeholder berikut (label persis di admin: Available Parameters):

Parameter	Diganti dengan
`%site_name%`	Nama blog/situs
`%site_url%`	URL home
`%current_url%`	URL halaman saat ini
`%product_title%`	Judul produk
`%product_price%`	Harga (HTML di-strip, format harga WooCommerce)
`%product_id%`	ID produk
`%product_sku%`	SKU dari meta `_sku`
`%product_url%`	Permalink produk
`%product_categories%`	Nama kategori, dipisah koma
`%product_tags%`	Nama tag, dipisah koma

Placeholder kosong jika data tidak ada (misalnya produk tanpa SKU).

Contoh template

Halo %site_name%, saya tertarik produk %product_title% (%product_price%).
Link: %product_url%

Setelah diganti, teks di-rawurlencode untuk parameter &text= di URL WhatsApp.

Placeholder default

Jika field dikosongkan, plugin memakai Text::wc_whatsapp_product() sebagai placeholder di UI dan fallback isi pesan.

Cara pesan masuk ke link

Tanpa rotator

Link bentuk:

https://api.whatsapp.com/send?phone={nomor}&text={pesan_produk_encoded}

Nomor dari Main WhatsApp Number (WhatsApp Integration), diformat internasional.

Dengan Simple WhatsApp Rotator

Link tombol beli → layar ?laristurbo_whatsapp_screen=1&laristurbo_product_id={id} (plus parameter lokasi internal).

Filter laristurbo_whatsapp_screen_message diganti oleh product_screen_message() agar pesan rotator memakai template produk yang sama, bukan greeting global.

Shortcode dan produk spesifik

Shortcode	Konteks
`[laristurbo_wc_whatsapp_button]`	Di dalam loop produk; footprint `ltwcwabp` untuk block theme
`[laristurbo_wc_whatsapp_button product_id="123"]`	Produk ID tetap, di mana pun

Shortcode shop	Konteks
`[laristurbo_wc_whatsapp_button_shop]`	Loop katalog
`[laristurbo_wc_whatsapp_button_shop product_id="123"]`	Produk tetap

Pesan selalu dihasilkan dari produk yang direferensikan.

Posisi tombol vs template pesan

Position (After Add to Cart Section, dll.) hanya mengatur di mana tombol dirender; template pesan sama di semua posisi untuk produk yang sama.

Manual Placement (custom) memakai shortcode/block; pesan tetap mengikuti produk di loop atau product_id.

Integrasi Meta Pixel (opsional)

Jika Meta Pixel & CAPI Integration aktif, pengaturan tambahan muncul di Meta Pixel Settings (bukan di Buy Button):

Enable Meta Pixel Event on WhatsApp Button Click
WhatsApp Button Event (placeholder default Lead)

Klik tombol menambahkan class lt-button-track-event dengan data-fbevent, data-fbtrack, dan data-fbparams berisi value, currency, content_ids dari produk (wc_ + product ID).

Bagian Integration → Sticky WhatsApp Button mengarah ke Sticky Mobile CTA. Tombol sticky memakai template pesan produk yang sama (get_product_message) dan bisa teks berbeda lewat pengaturan sticky (Button Text di Button Sticky).

Langkah menyusun template

Pastikan Main WhatsApp Number terisi di WhatsApp Integration.
Buka WhatsApp Buy Button For WooCommerce → Settings.
Isi WhatsApp Message / Greeting Text dengan placeholder yang Anda butuhkan.
Aktifkan tombol di Single Product Page dan/atau Shop Page.
Buka halaman produk, klik tombol, periksa pratinjau pesan di app WhatsApp (belum perlu kirim).
Jika rotator aktif, uji juga lewat layar loading—pesan harus tetap berisi data produk.

Troubleshooting

Pesan tidak menyebut nama produk

Template tidak memuat %product_title%.
Shortcode dipakai di luar loop tanpa product_id.

Harga aneh di pesan

%product_price% mengikuti harga aktif produk (termasuk sale); format mengikuti WooCommerce lalu strip tag HTML.

Pesan global muncul di tombol beli

Field wc_whatsapp_message kosong dan fallback default bukan template produk—isi ulang template.
Rotator: pastikan laristurbo_product_id ada di URL layar (otomatis dari tombol beli).