Langkau ke kandungan
Wbiztool

Integrasi

Integrasi WordPress

Business Messaging for WbizTool ialah pemalam WordPress rasmi. Ia menghantar mesej WhatsApp dari nombor anda yang bersambung apabila sesuatu berlaku di laman anda: pesanan WooCommerce berubah, tempahan WP Amelia dijadualkan semula atau dibatalkan, atau borang Contact Form 7 dihantar.

KeperluanNilai
Versi pemalam1.0.3
Memerlukan WordPress5.0 atau lebih baharu (diuji sehingga 6.8)
Memerlukan PHP7.4 atau lebih baharu
WooCommerce4.0 atau lebih baharu (diuji sehingga 9.0)
Berfungsi denganWooCommerce, WP Amelia, Contact Form 7

Sebelum anda bermula#

Pasang pemalam#

  1. Pasang dari WordPress

    Dalam admin WordPress anda, pergi ke Plugins → Add New, cari Business Messaging for WbizTool, klik Install Now dan kemudian Activate. Anda juga boleh memuat turunnya dari direktori pemalam WordPress dan memuat naik fail zip di bawah Plugins → Add New → Upload Plugin. Jika muat naik gagal (contohnya kerana had saiz fail), nyahzip dan salin folder business-messaging-for-wbiztool ke dalam /wp-content/plugins/ melalui FTP, kemudian aktifkannya di bawah Plugins.

  2. Buka tetapan pemalam

    Menu WbizTool baharu muncul di bar sisi admin dengan empat halaman: Settings, Templates, Test Messages dan Logs.

Sediakan pemalam#

  1. Masukkan kelayakan API anda

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

    Dengan kelayakan yang betul, Test Connection memasukkan mesej ujian sebenar ke baris gilir untuk nombor pemegang tempat 10000000000, jadi ia muncul dalam sejarah mesej Wbiztool anda. Ia tidak dapat dihantar dan ditunjukkan sebagai gagal di sana; anda boleh mengabaikannya. Jika anda melihat Unable to connect to WbizTool API. Please check your internet connection., kemungkinan besar Client ID, kunci API atau WhatsApp Client ID anda salah, atau pelan anda tiada baki mesej. Ia jarang bermaksud masalah dengan sambungan internet anda.

  2. Tetapkan pilihan umum

    Di bawah General Settings:

    • Default Country Code: digunakan apabila negara bil pesanan WooCommerce tidak dapat dipadankan dengan kod panggilan. Lalainya ialah 1, jadi tukarkannya kepada negara utama anda, contohnya 91 (Malaysia: 60).
    • Test Mode: apabila dihidupkan, mesej ditulis ke log tetapi tidak dihantar.
    • Admin Notifications: kotak semak ini tiada kesan yang kelihatan dalam versi 1.0.3, kerana halaman tetapan tiada medan untuk nombor telefon admin yang digunakannya. Untuk makluman admin bagi penyerahan borang, gunakan tetapan Contact Form 7 di bawah.
  3. Hidupkan integrasi dan peristiwa

    Di bawah Integration Settings, dayakan setiap pemalam yang anda gunakan dan tandakan peristiwa yang patut menghantar mesej. Sesuatu integrasi hanya menunjukkan pilihannya apabila pemalam itu aktif di laman anda. Klik Save Settings.

  4. Edit templat mesej

    Di WbizTool → Templates, pilih tab WooCommerce, Amelia atau Contact Form 7, pilih peristiwa, dan edit teksnya. Halaman itu menyenaraikan pemboleh ubah yang boleh anda gunakan dan menunjukkan pratonton langsung. Reset memulihkan teks lalai.

  5. Hantar ujian

    Di WbizTool → Test Messages, hantar mesej ke nombor anda sendiri untuk mengesahkan semuanya berfungsi, kemudian semak WbizTool → Logs.

WooCommerce#

Mesej dihantar ke telefon bil pesanan. Kod negara diambil daripada negara bil; jika negara itu tidak dikenali, Default Country Code digunakan.

PeristiwaBila ia dihantar
Order CreatedPesanan baharu dicipta.
Order ProcessingPesanan beralih dari pending ke processing, atau pembayaran selesai dan pesanan dalam processing.
Order CompletedPesanan beralih ke completed dari pending atau processing, atau pembayaran selesai dan pesanan completed.
Order ShippedPesanan beralih ke status bernama shipped.
Order CancelledPesanan dibatalkan.
Order RefundedPesanan dibayar balik.
Payment FailedStatus pesanan bertukar kepada failed.

Pemboleh ubah templat:

KumpulanPemboleh ubah
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}
Pautan{order_url}, {payment_retry_url}, {my_account_url}
Kedai{store_name}, {store_url}, {store_email}, {store_phone}
Penghantaran{shipping_method}, {tracking_number}, {tracking_url}, {delivery_date}
Pembayaran{payment_method}, {transaction_id}, dan untuk bayaran balik {refund_amount}, {refund_reason}

Contoh templat:

Hi {customer_first_name},

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

Track your order: {order_url}

{store_name}

WP Amelia#

Mesej dihantar ke telefon pelanggan pada tempahan. Halaman tetapan menyenaraikan enam peristiwa:

  • Booking Added (tempahan dari bahagian hadapan)
  • Booking Rescheduled
  • Booking Cancelled
  • Appointment Added (bahagian belakang)
  • Event Booking Saved
  • Event Booking Updated

Pemboleh ubah yang tersedia dalam templat Amelia:

KumpulanPemboleh ubah
Tempahan{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}
Perkhidmatan{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}
Temu janji{appointment_id}, {appointment_date}, {appointment_start_time}, {appointment_end_time}
Penjadualan semula{old_appointment_time}, {new_appointment_time}
Laman{site_name}, {site_url}, {current_date}, {current_time}

Contact Form 7#

Apabila borang dihantar, pemalam boleh menghantar mesej kepada anda (admin), orang yang mengisi borang, atau kedua-duanya.

TetapanFungsinya
Admin Phone NumberNombor anda dengan kod negara, contohnya +919876543210.
Enable admin notificationsHantar mesej ke nombor admin. Dihidupkan secara lalai.
Enable customer auto-replyHantar mesej terima kasih ke nombor telefon yang dimasukkan dalam borang. Dimatikan secara lalai.
Form Submitted SuccessfullyHantar apabila Contact Form 7 berjaya menghantar e-melnya.
Form Submission FailedHantar apabila Contact Form 7 gagal menghantar e-melnya.

Pemalam mencari nama, e-mel, telefon dan mesej dalam borang anda mengikut nama medan. Gunakan nama biasa seperti your-name, your-email, your-phone (atau phone, mobile, whatsapp), your-subject dan your-message. Balasan automatik pelanggan hanya dihantar apabila medan telefon ditemui. Minta nombor dengan kod negaranya: pemalam hanya mengenali sesetengah kod negara dan menggunakan Default Country Code jika tidak.

Pemboleh ubah templat:

KumpulanPemboleh ubah
Borang{form_id}, {form_title}, {form_url}, {submission_date}, {submission_time}
Kenalan{contact_name}, {contact_email}, {contact_phone}, {contact_company}, {contact_website}
Kandungan{subject}, {message}, {all_form_data}
Laman{site_name}, {site_url}, {admin_email}, {current_date}, {current_time}, {current_datetime}

Setiap medan borang juga tersedia mengikut namanya sendiri, dengan sengkang digantikan dengan garis bawah. Contohnya, medan bernama your-city ialah {your_city}.

Contoh notifikasi admin:

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

Baris baharu dalam mesej pelawat dibuang, jadi {message} tiba sebagai satu baris.

Log#

WbizTool → Logs menyenaraikan mesej yang cuba dihantar oleh pemalam, dengan tarikh, jenis peristiwa, integrasi, telefon, mesej dan status. Gunakannya untuk menyemak sama ada sesuatu peristiwa dicetuskan dan sama ada mesej telah dihantar. Ia tidak menunjukkan sebab mesej gagal.

Penyelesaian masalah#

MasalahPerkara yang perlu disemak
Tiada mesej selepas pesananPastikan integrasi WooCommerce dan peristiwa itu ditandakan, pesanan mempunyai telefon bil, dan Test Mode dimatikan.
Mesej dihantar ke nombor yang salahNegara bil atau Default Country Code salah bagi pelanggan itu.
Status log ialah FailedKlik Test Connection di WbizTool → Settings. Semak Client ID dan kunci API di Settings → API keys dan WhatsApp Client ID di WhatsApp settings, dan pastikan pelan anda masih mempunyai baki mesej.
Direkod sebagai dihantar tetapi tidak diterimaMesej berada dalam baris gilir sehingga nombor WhatsApp anda bersambung.
Peristiwa Amelia ditandakan tetapi tiada apa-apa dihantarLihat had Amelia di atas.
Tiada menu WbizTool di bar sisi adminPastikan pemalam diaktifkan di bawah Plugins, dan anda log masuk sebagai pentadbir (menu memerlukan keupayaan manage_options). Jika ia masih tidak muncul, semak log ralat PHP, kemudian nyahaktifkan dan aktifkan semula pemalam.

Untuk melihat ralat PHP daripada pemalam, hidupkan pengelogan nyahpepijat WordPress dalam wp-config.php. Ralat ditulis ke wp-content/debug.log. Matikannya semula apabila anda selesai.

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