Mengatur Simple WhatsApp Rotator dan Loading Screen (LarisTurbo)
Cara menambah beberapa nomor CS, cara rotasi berurutan, layar loading rotator, dan parameter pesan WhatsApp default.
Tutorial ini melengkapi panduan dasar WhatsApp Integration. Fokusnya ke Simple WhatsApp Rotator, pesan greeting, dan loading screen.
Integrasi WhatsApp dianggap aktif jika kartu fitur aktif dan field Main WhatsApp Number terisi.
Main WhatsApp Number
Field wajib pertama:
| Field | Label | Format |
|---|---|---|
| Main WhatsApp Number | Placeholder 62xxx |
Nomor internasional tanpa + (dinormalisasi plugin) |
Tanpa nomor utama, fitur WhatsApp (termasuk rotator dan tombol beli) tidak dianggap enabled.
Simple WhatsApp Rotator
Mengaktifkan
- Buka LarisTurbo → For WhatsApp → WhatsApp Integration → Settings.
- Isi Main WhatsApp Number.
- Centang ENABLE Simple WhatsApp Rotator (bagian Simple WhatsApp Rotator).
- Isi WhatsApp Number #2 hingga #10 (field #2–#10 hanya muncul saat rotator aktif).
Jumlah slot tambahan bisa diubah developer lewat filter laristurbo_whatsapp_rotator_numbers (default maksimal 10 nomor total termasuk utama).
Cara rotasi bekerja
Saat rotator aktif, setiap permintaan nomor aktif (get_active_number()):
- Mengumpulkan semua nomor yang terisi (utama + #2…#N) dalam urutan.
- Membaca counter option
{setting_db}_rotator. - Menambah counter +1; jika melebihi jumlah nomor, kembali ke 1.
- Mengembalikan nomor pada posisi counter tersebut.
Rotasi round-robin: klik/link berikutnya ke CS berikutnya, bukan random berdasarkan beban.
Tanpa rotator, semua link memakai Main WhatsApp Number saja.
Link dengan vs tanpa rotator
| Rotator | Perilaku link (get_link) |
|---|---|
| Nonaktif | Langsung https://api.whatsapp.com/send?phone=...&text=... (atau whatsapp:// jika filter laristurbo_whatsapp_link_type = deeplink) |
| Aktif | Mengarah ke layar perantara situs Anda: ?laristurbo_whatsapp_screen=1 |
Layar perantara memuat template whatsapp-screen lalu meneruskan ke nomor hasil rotasi.
Tombol beli produk dengan rotator menambahkan query laristurbo_product_id agar pesan produk ikut terisi.
WhatsApp Message / Greeting Text
Bagian WhatsApp Message / Greeting Text:
| Field | Parameter |
|---|---|
| Default WhatsApp Message / Greeting Text | %site_name%, %site_url%, %current_url% |
Jika kosong, memakai teks default dari Text::whatsapp_message(). Pesan di-URL-encode saat ditambahkan ke parameter text= link WhatsApp.
Filter laristurbo_whatsapp_message bisa mengubah pesan final.
WhatsApp Loading Screen Text
Hanya relevan jika rotator aktif. Deskripsi di admin:
WhatsApp loading screen is displayed when you use WhatsApp rotator before user connected to specific WhatsApp number in the rotator.
| Field | Label |
|---|---|
| WhatsApp Loading Screen Text (Available) | Teks saat CS tersedia / menghubungkan |
| WhatsApp Loading Screen Text (Unavailable) | Teks saat tidak ada nomor / gagal |
Placeholder default dari Text::whatsapp_loading_text() dan Text::whatsapp_unavailable_text().
Judul layar loading default: Chat WhatsApp (filter laristurbo_whatsapp_page_title).
WooCommerce Integration (link cepat)
Di bawah rotator, Settings menampilkan tombol Setup Now ke:
- WhatsApp Buy Buttons → pengaturan WcWhatsAppButton
- WhatsApp Checkout Redirect → pengaturan redirect checkout
Rotator memengaruhi semua fitur yang memanggil WhatsApp::get_active_number() atau get_link().
Contoh setup tim CS 3 orang
- Main WhatsApp Number:
628111111111(CS A) - Aktifkan ENABLE Simple WhatsApp Rotator
- WhatsApp Number #2:
628122222222(CS B) - WhatsApp Number #3:
628133333333(CS C) - Sesuaikan Default WhatsApp Message / Greeting Text, misalnya sapaan +
%site_name%. - Isi WhatsApp Loading Screen Text (Available) dengan pesan “Menghubungkan ke admin…”
- Uji widget/floating button tiga kali berturut-turut; nomor tujuan harus bergilir A → B → C → A.
Troubleshooting
Rotator tidak berganti nomor
- Hanya satu nomor yang terisi; rotator butuh minimal dua nomor valid.
- Cache link di browser; uji incognito atau clear cache.
Langsung ke WhatsApp tanpa layar loading
- ENABLE Simple WhatsApp Rotator nonaktif.
- Plugin lain memfilter
pre_laristurbo_whatsapp_linkdengan URL custom.
Pesan greeting kosong di app WhatsApp
- Field pesan kosong dan default teks juga kosong (jarang).
- Karakter khusus; plugin sudah decode entity dan URL-encode.