Lead Capture Form

Ringkasan

Secara default, link rotator akan langsung membuka WhatsApp.
Jika Anda aktifkan Lead Capture Form, pengunjung akan melihat formulir dulu, lalu setelah submit baru diarahkan ke WhatsApp.

Versi terbaru mendukung:

• Core field: name, phone, email
• Custom field dinamis (maksimal 10)
• Tipe custom field: text, textarea, select, checkbox
• Token pesan WhatsApp: [k:key]

Kapan Sebaiknya Dipakai?

Gunakan Lead Form jika Anda ingin:

• Menyimpan data lead lebih lengkap sebelum chat
• Mengukur kualitas traffic iklan (bukan hanya klik WA)
• Membawa konteks ke pesan awal WA (contoh: budget, kebutuhan)

Cara Aktivasi Cepat

1. Buka menu WhatsApp > Rotator.
2. Buat rotator baru, atau edit rotator yang sudah ada.
3. Pilih mode Form Link.
4. Aktifkan toggle Lead Capture Form.
5. Isi pengaturan form:
   • Judul form
   • Deskripsi
   • Logo URL (opsional)
   • Label tombol submit
6. Simpan rotator.

Atur Field Form

Core field (bawaan)

• name dan phone selalu aktif dan wajib.
• email bisa diaktifkan/nonaktifkan, dan bisa dijadikan wajib.

Custom field

• Maksimal 10 field per rotator.
• Setiap field punya Key (ID field) yang wajib:
  • unik
  • format snake_case
  • tidak boleh memakai key sistem

Gunakan Token di Pesan WhatsApp

Di template pesan rotator, Anda bisa pakai:

• [uniquecode] untuk kode unik visitor
• [k:key] untuk nilai custom field

Contoh:

Halo admin, saya mau konsultasi.
Budget: [k:budget]
Kebutuhan: [k:kebutuhan]
Kode: [uniquecode]

Jika nilai custom field kosong/tidak ada, token akan diganti string kosong.

Custom URL Param k_* untuk Rotator

Selain dari form.custom_fields, Anda juga bisa kirim konteks dari query param URL dengan prefix k_, contoh:

• ?k_budget=50jt
• ?k_channel=meta
• ?k_produk=umroh_plus

Nilai k_* akan:

• Disimpan ke custom field lead sebagai key yang tetap (contoh k_budget)
• Ikut ke CSV export sebagai kolom cf_k_budget
• Bisa dipakai di template pesan WhatsApp dengan dua bentuk token:
  • [k:k_budget] (key penuh)
  • [k:budget] (alias otomatis dari k_budget)

Jika token tidak punya nilai, output tetap string kosong.

Jika Anda ingin k_* otomatis ikut saat user klik link rotator/form dari halaman website yang punya query (tanpa menulis ulang query di setiap link), aktifkan opsi tracker berikut:

konektor('init', 'WS-XXXX', {
  crossDomain: {
    autoLink: true,
    forwardKParams: true
  }
})

Format Link

• Link langsung WA (tanpa form): domain.com/wa/[slug] atau domain.com/[slug] (tergantung domain setup)
• Link dengan form: domain.com/form/[slug]

Di Mana Data Disimpan?

• Lead tetap masuk ke menu Leads seperti biasa.
• Custom field disimpan dengan aman.
• Custom field ditampilkan di Detail Lead.
• Saat export CSV lead, custom field ikut diekspor sebagai kolom cf_<key>.
• Di halaman daftar leads, yang tampil tetap data utama. Untuk melihat custom field, buka Detail Lead atau file export.

Hak Akses

• Hanya pemilik workspace (owner) dan admin yang bisa membuat, mengubah, atau menghapus rotator.
• Anggota tim (staff) hanya bisa melihat detail lead yang ditugaskan ke dirinya.

Checklist Implementasi (Recommended)

1. Aktifkan Lead Form di 1 rotator dulu (pilot).
2. Tambahkan 2-3 custom field yang paling penting.
3. Tambahkan token [k:key] ke template pesan.
4. Submit test dari link /form/[slug].
5. Verifikasi:
   • Redirect WA berjalan
   • Nilai custom field tampil di detail lead
   • Token pesan terisi sesuai input

Troubleshooting

Perlu update script tracking?

• Tidak wajib untuk fitur Lead Capture Form + custom field rotator.
• Selama link diarahkan ke /form/[slug], form custom field tetap bekerja tanpa perubahan script tracking.
• Update script tracking tetap disarankan jika Anda sedang memperbaiki tracking website umum (mis. UTM/cross-domain), tetapi bukan syarat khusus fitur ini.

Form tidak bisa dikirim

Penyebab umum:

• Field wajib kosong
• Key custom field duplikat
• Pilihan select tidak ada di daftar opsi
• Nilai checkbox bukan Ya/Tidak

Token [k:key] tidak muncul nilainya

Periksa:

• Key token sama persis dengan key field
• Field dalam kondisi aktif
• User benar-benar mengisi field (jika kosong akan jadi -)

Batasan Saat Ini

• Custom field tampil di Detail Lead dan ikut CSV export (cf_<key>)
• Maksimal 10 custom field
• Tipe field terbatas: text, textarea, select, checkbox