Langsung ke konten
Wbiztool

Integrasi

Integrasi WordPress

Business Messaging for WbizTool adalah plugin WordPress resmi. Plugin ini mengirim pesan WhatsApp dari nomor Anda yang terhubung saat sesuatu terjadi di situs Anda: pesanan WooCommerce berubah, booking WP Amelia dijadwal ulang atau dibatalkan, atau formulir Contact Form 7 dikirim.

PersyaratanNilai
Versi plugin1.0.3
Memerlukan WordPress5.0 atau lebih baru (diuji hingga 6.8)
Memerlukan PHP7.4 atau lebih baru
WooCommerce4.0 atau lebih baru (diuji hingga 9.0)
Bekerja denganWooCommerce, WP Amelia, Contact Form 7

Sebelum memulai#

Memasang plugin#

  1. Pasang dari WordPress

    Di admin WordPress Anda, buka Plugins → Add New, cari Business Messaging for WbizTool, klik Install Now lalu Activate. Anda juga dapat mengunduhnya dari direktori plugin WordPress dan mengunggah file zip di Plugins → Add New → Upload Plugin. Jika unggahan gagal (misalnya karena batas ukuran file), ekstrak file tersebut dan salin folder business-messaging-for-wbiztool ke /wp-content/plugins/ melalui FTP, lalu aktifkan di Plugins.

  2. Buka pengaturan plugin

    Menu WbizTool baru muncul di sidebar admin dengan empat halaman: Settings, Templates, Test Messages, dan Logs.

Menyiapkan plugin#

  1. Masukkan kredensial API Anda

    Di WbizTool → Settings, di bawah API Configuration, isi Client ID, API Key, dan WhatsApp Client ID, lalu klik Test Connection.

    Dengan kredensial yang benar, Test Connection memasukkan pesan uji sungguhan ke antrean untuk nomor placeholder 10000000000, sehingga pesan tersebut muncul di riwayat pesan Wbiztool Anda. Pesan itu tidak dapat terkirim dan ditampilkan sebagai gagal di sana; Anda dapat mengabaikannya. Jika Anda melihat Unable to connect to WbizTool API. Please check your internet connection., kemungkinan besar Client ID, API key, atau WhatsApp Client ID Anda salah, atau paket Anda tidak memiliki sisa pesan. Pesan ini jarang berarti ada masalah dengan koneksi internet Anda.

  2. Atur opsi umum

    Di bawah General Settings:

    • Default Country Code: digunakan saat negara penagihan pesanan WooCommerce tidak dapat dicocokkan dengan kode panggilan. Default-nya 1, jadi ubah ke negara utama Anda, misalnya 91, atau 62 untuk Indonesia.
    • Test Mode: saat aktif, pesan ditulis ke log tetapi tidak dikirim.
    • Admin Notifications: kotak centang ini tidak memiliki efek yang terlihat di versi 1.0.3, karena halaman pengaturan tidak memiliki kolom untuk nomor telepon admin yang digunakannya. Untuk notifikasi admin pada kiriman formulir, gunakan pengaturan Contact Form 7 di bawah.
  3. Aktifkan integrasi dan event

    Di bawah Integration Settings, aktifkan setiap plugin yang Anda gunakan dan centang event yang harus mengirim pesan. Sebuah integrasi hanya menampilkan opsinya saat plugin tersebut aktif di situs Anda. Klik Save Settings.

  4. Ubah template pesan

    Di WbizTool → Templates, pilih tab WooCommerce, Amelia, atau Contact Form 7, pilih event, lalu ubah teksnya. Halaman ini mencantumkan variabel yang dapat Anda gunakan dan menampilkan pratinjau langsung. Reset mengembalikan teks default.

  5. Kirim pesan uji

    Di WbizTool → Test Messages, kirim pesan ke nomor Anda sendiri untuk memastikan semuanya berfungsi, lalu periksa WbizTool → Logs.

WooCommerce#

Pesan dikirim ke billing phone (nomor telepon penagihan) pesanan. Kode negara diambil dari negara penagihan; jika negara tersebut tidak dikenali, Default Country Code yang digunakan.

EventKapan dikirim
Order CreatedPesanan baru dibuat.
Order ProcessingPesanan berpindah dari pending ke processing, atau pembayaran selesai dan pesanan berstatus processing.
Order CompletedPesanan berpindah ke completed dari pending atau processing, atau pembayaran selesai dan pesanan berstatus completed.
Order ShippedPesanan berpindah ke status bernama shipped.
Order CancelledPesanan dibatalkan.
Order RefundedDana pesanan dikembalikan.
Payment FailedStatus pesanan berubah menjadi failed.

Variabel template:

KelompokVariabel
Pelanggan{customer_first_name}, {customer_last_name}, {customer_full_name}, {customer_email}, {customer_phone}
Pesanan{order_id}, {order_number}, {order_total}, {order_subtotal}, {order_tax}, {order_shipping}, {order_date}, {order_status}, {order_currency}, {order_items}, {order_items_count}
Tautan{order_url}, {payment_retry_url}, {my_account_url}
Toko{store_name}, {store_url}, {store_email}, {store_phone}
Pengiriman{shipping_method}, {tracking_number}, {tracking_url}, {delivery_date}
Pembayaran{payment_method}, {transaction_id}, dan untuk pengembalian dana {refund_amount}, {refund_reason}

Contoh template:

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

Pesan dikirim ke nomor telepon pelanggan pada booking. Halaman pengaturan mencantumkan enam event:

  • Booking Added (Frontend bookings)
  • Booking Rescheduled
  • Booking Cancelled
  • Appointment Added (Backend)
  • Event Booking Saved
  • Event Booking Updated

Variabel yang tersedia di template Amelia:

KelompokVariabel
Booking{booking_id}, {booking_status}, {booking_date}, {booking_time}, {booking_duration}, {booking_price}, {booking_persons}
Pelanggan{customer_first_name}, {customer_last_name}, {customer_full_name}, {customer_email}, {customer_phone}
Layanan{service_name}, {service_description}, {service_duration}, {service_price}, {service_category}
Penyedia{provider_first_name}, {provider_last_name}, {provider_full_name}, {provider_email}, {provider_phone}
Lokasi{location_name}, {location_address}, {location_phone}
Janji temu{appointment_id}, {appointment_date}, {appointment_start_time}, {appointment_end_time}
Penjadwalan ulang{old_appointment_time}, {new_appointment_time}
Situs{site_name}, {site_url}, {current_date}, {current_time}

Contact Form 7#

Saat formulir dikirim, plugin dapat mengirim pesan kepada Anda (admin), orang yang mengisi formulir, atau keduanya.

PengaturanFungsinya
Admin Phone NumberNomor Anda dengan kode negara, misalnya +919876543210.
Enable admin notificationsMengirim pesan ke nomor admin. Aktif secara default.
Enable customer auto-replyMengirim pesan terima kasih ke nomor telepon yang dimasukkan di formulir. Nonaktif secara default.
Form Submitted SuccessfullyDikirim saat Contact Form 7 berhasil mengirim email-nya.
Form Submission FailedDikirim saat Contact Form 7 gagal mengirim email-nya.

Plugin menemukan nama, email, telepon, dan pesan di formulir Anda berdasarkan nama field. Gunakan nama umum seperti your-name, your-email, your-phone (atau phone, mobile, whatsapp), your-subject, dan your-message. Balasan otomatis ke pelanggan hanya dikirim jika field telepon ditemukan. Minta nomor beserta kode negaranya: plugin hanya mengenali sebagian kode negara dan menggunakan Default Country Code untuk sisanya.

Variabel template:

KelompokVariabel
Formulir{form_id}, {form_title}, {form_url}, {submission_date}, {submission_time}
Kontak{contact_name}, {contact_email}, {contact_phone}, {contact_company}, {contact_website}
Isi{subject}, {message}, {all_form_data}
Situs{site_name}, {site_url}, {admin_email}, {current_date}, {current_time}, {current_datetime}

Setiap field formulir juga tersedia dengan namanya sendiri, dengan tanda hubung diganti garis bawah. Misalnya, field bernama your-city menjadi {your_city}.

Contoh notifikasi admin:

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

Baris baru dalam pesan pengunjung dihapus, sehingga {message} tiba sebagai satu baris.

Log#

WbizTool → Logs menampilkan pesan yang dicoba dikirim oleh plugin, dengan tanggal, jenis event, integrasi, telepon, pesan, dan status. Gunakan untuk memeriksa apakah sebuah event terpicu dan apakah pesan terkirim. Log tidak menunjukkan alasan pesan gagal.

Pemecahan masalah#

MasalahYang perlu diperiksa
Tidak ada pesan setelah pesananPastikan integrasi WooCommerce dan event tersebut dicentang, pesanan memiliki billing phone, dan Test Mode nonaktif.
Pesan terkirim ke nomor yang salahNegara penagihan atau Default Country Code salah untuk pelanggan tersebut.
Status log FailedKlik Test Connection di WbizTool → Settings. Periksa Client ID dan API key di Settings → API keys serta WhatsApp Client ID di WhatsApp settings, dan pastikan paket Anda masih memiliki sisa pesan.
Tercatat terkirim tetapi tidak diterimaPesan berada di antrean sampai nomor WhatsApp Anda terhubung.
Event Amelia dicentang tetapi tidak ada yang dikirimLihat keterbatasan Amelia di atas.
Tidak ada menu WbizTool di sidebar adminPastikan plugin diaktifkan di Plugins, dan Anda login sebagai administrator (menu memerlukan capability manage_options). Jika tetap tidak muncul, periksa log error PHP, lalu nonaktifkan dan aktifkan kembali plugin.

Untuk melihat error PHP dari plugin, aktifkan debug logging WordPress di wp-config.php. Error ditulis ke wp-content/debug.log. Nonaktifkan lagi setelah selesai.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);