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.
| Persyaratan | Nilai |
|---|---|
| Versi plugin | 1.0.3 |
| Memerlukan WordPress | 5.0 atau lebih baru (diuji hingga 6.8) |
| Memerlukan PHP | 7.4 atau lebih baru |
| WooCommerce | 4.0 atau lebih baru (diuji hingga 9.0) |
| Bekerja dengan | WooCommerce, WP Amelia, Contact Form 7 |
Sebelum memulai#
- Akun Wbiztool dengan nomor WhatsApp yang terhubung di WhatsApp settings.
- Client ID dan API key Anda dari Settings → API keys.
- WhatsApp Client ID dari nomor pengirim, yang ditampilkan di WhatsApp settings.
Memasang plugin#
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-wbiztoolke/wp-content/plugins/melalui FTP, lalu aktifkan di Plugins.Buka pengaturan plugin
Menu WbizTool baru muncul di sidebar admin dengan empat halaman: Settings, Templates, Test Messages, dan Logs.
Menyiapkan plugin#
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.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, misalnya91, atau62untuk 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.
- Default Country Code: digunakan saat negara penagihan pesanan WooCommerce tidak dapat dicocokkan dengan kode panggilan. Default-nya
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.
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.
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.
| Event | Kapan dikirim |
|---|---|
| Order Created | Pesanan baru dibuat. |
| Order Processing | Pesanan berpindah dari pending ke processing, atau pembayaran selesai dan pesanan berstatus processing. |
| Order Completed | Pesanan berpindah ke completed dari pending atau processing, atau pembayaran selesai dan pesanan berstatus completed. |
| Order Shipped | Pesanan berpindah ke status bernama shipped. |
| Order Cancelled | Pesanan dibatalkan. |
| Order Refunded | Dana pesanan dikembalikan. |
| Payment Failed | Status pesanan berubah menjadi failed. |
Variabel template:
| Kelompok | Variabel |
|---|---|
| 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:
| Kelompok | Variabel |
|---|---|
| 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.
| Pengaturan | Fungsinya |
|---|---|
| Admin Phone Number | Nomor Anda dengan kode negara, misalnya +919876543210. |
| Enable admin notifications | Mengirim pesan ke nomor admin. Aktif secara default. |
| Enable customer auto-reply | Mengirim pesan terima kasih ke nomor telepon yang dimasukkan di formulir. Nonaktif secara default. |
| Form Submitted Successfully | Dikirim saat Contact Form 7 berhasil mengirim email-nya. |
| Form Submission Failed | Dikirim 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:
| Kelompok | Variabel |
|---|---|
| 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#
| Masalah | Yang perlu diperiksa |
|---|---|
| Tidak ada pesan setelah pesanan | Pastikan integrasi WooCommerce dan event tersebut dicentang, pesanan memiliki billing phone, dan Test Mode nonaktif. |
| Pesan terkirim ke nomor yang salah | Negara penagihan atau Default Country Code salah untuk pelanggan tersebut. |
| Status log Failed | Klik 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 diterima | Pesan berada di antrean sampai nomor WhatsApp Anda terhubung. |
| Event Amelia dicentang tetapi tidak ada yang dikirim | Lihat keterbatasan Amelia di atas. |
| Tidak ada menu WbizTool di sidebar admin | Pastikan 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);