אינטגרציות

אינטגרציה עם WordPress

התוסף Business Messaging for WbizTool הוא תוסף ה-WordPress הרשמי. הוא שולח הודעות WhatsApp מהמספר המחובר שלכם כשמשהו קורה באתר: הזמנת WooCommerce משתנה, תור ב-WP Amelia נקבע מחדש או מבוטל, או טופס של Contact Form 7 נשלח.

דרישה	ערך
גרסת התוסף	1.0.3
דורש WordPress	גרסה 5.0 ומעלה (נבדק עד 6.8)
דורש PHP	גרסה 7.4 ומעלה
WooCommerce	גרסה 4.0 ומעלה (נבדק עד 9.0)
עובד עם	WooCommerce, WP Amelia, Contact Form 7

לפני שמתחילים#

חשבון Wbiztool עם מספר WhatsApp מחובר בדף WhatsApp settings (הגדרות WhatsApp).
ה-Client ID (מזהה לקוח) וה-API key (מפתח API) שלכם מהדף Settings → API keys (הגדרות ← מפתחות API).
ה-WhatsApp Client ID (מזהה לקוח WhatsApp) של המספר שממנו תשלחו, שמוצג בדף WhatsApp settings.

התקנת התוסף#

התקינו מתוך WordPress
בממשק הניהול של WordPress, עברו אל Plugins → Add New, חפשו Business Messaging for WbizTool, לחצו על Install Now ואז על Activate. אפשר גם להוריד אותו מספריית התוספים של WordPress ולהעלות את קובץ ה-zip תחת Plugins → Add New → Upload Plugin. אם ההעלאה נכשלת (למשל בגלל מגבלת גודל קובץ), חלצו את קובץ ה-zip, העתיקו את התיקייה business-messaging-for-wbiztool אל /wp-content/plugins/ דרך FTP, ואז הפעילו את התוסף תחת Plugins.
פתחו את הגדרות התוסף
בסרגל הצד של ממשק הניהול מופיע תפריט חדש, WbizTool, עם ארבעה דפים: Settings, Templates, Test Messages ו-Logs.

הגדרת התוסף#

הזינו את פרטי הגישה ל-API
בדף WbizTool → Settings, תחת API Configuration, מלאו את Client ID, API Key ו-WhatsApp Client ID, ואז לחצו על Test Connection.
כשפרטי הגישה נכונים, Test Connection מכניס לתור הודעת בדיקה אמיתית למספר מציין המקום 10000000000, כך שהיא מופיעה בהיסטוריית ההודעות שלכם ב-Wbiztool. אי אפשר למסור אותה והיא מוצגת שם כנכשלה; אפשר להתעלם ממנה. אם מופיעה ההודעה Unable to connect to WbizTool API. Please check your internet connection. (לא ניתן להתחבר ל-API של WbizTool; בדקו את החיבור לאינטרנט), סביר להניח שה-Client ID, מפתח ה-API או ה-WhatsApp Client ID שגויים, או שלא נותרו הודעות בתוכנית שלכם. רק לעיתים רחוקות מדובר בבעיה בחיבור לאינטרנט.
הגדירו את האפשרויות הכלליות
תחת General Settings:
- האפשרות Default Country Code: משמשת כשאי אפשר להתאים קידומת חיוג למדינת החיוב של הזמנת WooCommerce. ברירת המחדל היא 1, לכן שנו אותה למדינה העיקרית שלכם, למשל 91.
- האפשרות Test Mode: כשהיא מופעלת, ההודעות נרשמות ביומן אבל לא נשלחות.
- האפשרות Admin Notifications: לתיבת הסימון הזו אין השפעה נראית לעין בגרסה 1.0.3, כי בדף ההגדרות אין שדה למספר הטלפון של המנהל שהיא משתמשת בו. להתראות למנהל על שליחת טפסים, השתמשו בהגדרות Contact Form 7 שבהמשך.
הפעילו אינטגרציות ואירועים
תחת Integration Settings, הפעילו כל תוסף שאתם משתמשים בו וסמנו את האירועים שצריכים לשלוח הודעה. אינטגרציה מציגה את האפשרויות שלה רק כשהתוסף המתאים פעיל באתר. לחצו על Save Settings.
ערכו את תבניות ההודעה
בדף WbizTool → Templates, בחרו את הלשונית WooCommerce, Amelia או Contact Form 7, בחרו אירוע וערכו את הטקסט שלו. הדף מציג את המשתנים שאפשר להשתמש בהם ותצוגה מקדימה חיה. הכפתור Reset משחזר את טקסט ברירת המחדל.
שלחו בדיקה
בדף WbizTool → Test Messages, שלחו הודעה למספר שלכם כדי לוודא שהכול עובד, ואז בדקו את WbizTool → Logs.

WooCommerce#

ההודעות נשלחות לטלפון החיוב (billing phone) של ההזמנה. קידומת המדינה נלקחת ממדינת החיוב. אם המדינה לא מזוהה, נעשה שימוש ב-Default Country Code.

אירוע	מתי נשלחת הודעה
Order Created	נוצרת הזמנה חדשה.
Order Processing	הזמנה עוברת מ-pending ל-processing, או שתשלום מושלם וההזמנה בסטטוס processing.
Order Completed	הזמנה עוברת ל-completed מ-pending או מ-processing, או שתשלום מושלם וההזמנה בסטטוס completed.
Order Shipped	הזמנה עוברת לסטטוס בשם `shipped`.
Order Cancelled	הזמנה מבוטלת.
Order Refunded	הזמנה מקבלת החזר כספי.
Payment Failed	הסטטוס של הזמנה משתנה ל-failed.

משתני תבנית:

קבוצה	משתנים
לקוח	`{customer_first_name}`, `{customer_last_name}`, `{customer_full_name}`, `{customer_email}`, `{customer_phone}`
הזמנה	`{order_id}`, `{order_number}`, `{order_total}`, `{order_subtotal}`, `{order_tax}`, `{order_shipping}`, `{order_date}`, `{order_status}`, `{order_currency}`, `{order_items}`, `{order_items_count}`
קישורים	`{order_url}`, `{payment_retry_url}`, `{my_account_url}`
חנות	`{store_name}`, `{store_url}`, `{store_email}`, `{store_phone}`
משלוח	`{shipping_method}`, `{tracking_number}`, `{tracking_url}`, `{delivery_date}`
תשלום	`{payment_method}`, `{transaction_id}`, ובהחזרים כספיים `{refund_amount}`, `{refund_reason}`

דוגמה לתבנית:

Hi {customer_first_name},

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

Track your order: {order_url}

{store_name}

WP Amelia#

ההודעות נשלחות לטלפון של הלקוח שמופיע בתור. דף ההגדרות מציג שישה אירועים:

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

משתנים שזמינים בתבניות של Amelia:

קבוצה	משתנים
תור	`{booking_id}`, `{booking_status}`, `{booking_date}`, `{booking_time}`, `{booking_duration}`, `{booking_price}`, `{booking_persons}`
לקוח	`{customer_first_name}`, `{customer_last_name}`, `{customer_full_name}`, `{customer_email}`, `{customer_phone}`
שירות	`{service_name}`, `{service_description}`, `{service_duration}`, `{service_price}`, `{service_category}`
נותן שירות	`{provider_first_name}`, `{provider_last_name}`, `{provider_full_name}`, `{provider_email}`, `{provider_phone}`
מיקום	`{location_name}`, `{location_address}`, `{location_phone}`
פגישה	`{appointment_id}`, `{appointment_date}`, `{appointment_start_time}`, `{appointment_end_time}`
קביעה מחדש	`{old_appointment_time}`, `{new_appointment_time}`
אתר	`{site_name}`, `{site_url}`, `{current_date}`, `{current_time}`

Contact Form 7#

כשטופס נשלח, התוסף יכול לשלוח הודעה אליכם (המנהלים), לאדם שמילא את הטופס, או לשניכם.

הגדרה	מה היא עושה
Admin Phone Number	המספר שלכם עם קידומת מדינה, למשל `+919876543210`.
Enable admin notifications	שליחת הודעה למספר המנהל. מופעל כברירת מחדל.
Enable customer auto-reply	שליחת הודעת תודה למספר הטלפון שהוזן בטופס. כבוי כברירת מחדל.
Form Submitted Successfully	שליחה כש-Contact Form 7 שולח את האימייל שלו בהצלחה.
Form Submission Failed	שליחה כש-Contact Form 7 נכשל בשליחת האימייל שלו.

התוסף מאתר את השם, האימייל, הטלפון וההודעה בטופס שלכם לפי שם השדה. השתמשו בשמות נפוצים כמו your-name, your-email, your-phone (או phone, mobile, whatsapp), your-subject ו-your-message. המענה האוטומטי ללקוח נשלח רק כשנמצא שדה טלפון. בקשו את המספר עם קידומת המדינה שלו: התוסף מזהה רק חלק מקידומות המדינה, ובשאר המקרים משתמש ב-Default Country Code.

משתני תבנית:

קבוצה	משתנים
טופס	`{form_id}`, `{form_title}`, `{form_url}`, `{submission_date}`, `{submission_time}`
איש קשר	`{contact_name}`, `{contact_email}`, `{contact_phone}`, `{contact_company}`, `{contact_website}`
תוכן	`{subject}`, `{message}`, `{all_form_data}`
אתר	`{site_name}`, `{site_url}`, `{admin_email}`, `{current_date}`, `{current_time}`, `{current_datetime}`

כל שדה בטופס זמין גם לפי השם שלו, כשמקפים מוחלפים בקווים תחתונים. למשל, שדה בשם your-city זמין כ-{your_city}.

דוגמה להתראה למנהל:

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

מעברי שורה בהודעה של המבקר מוסרים, כך ש-{message} מגיע כשורה אחת.

יומנים#

הדף WbizTool → Logs מציג את ההודעות שהתוסף ניסה לשלוח, עם התאריך, סוג האירוע, האינטגרציה, הטלפון, ההודעה והסטטוס. השתמשו בו כדי לבדוק אם אירוע הופעל ואם ההודעה נשלחה. הוא לא מציג למה הודעה נכשלה.

פתרון בעיות#

בעיה	מה לבדוק
לא נשלחה הודעה אחרי הזמנה	האינטגרציה של WooCommerce והאירוע הזה מסומנים, להזמנה יש טלפון חיוב, ו-Test Mode כבוי.
ההודעה נשלחת למספר הלא נכון	מדינת החיוב או Default Country Code שגויים עבור הלקוח הזה.
הסטטוס ביומן הוא Failed	לחצו על Test Connection בדף WbizTool → Settings. בדקו את מזהה הלקוח ואת מפתח ה-API בדף Settings → API keys ואת ה-WhatsApp Client ID בדף WhatsApp settings, וודאו שנותרו הודעות בתוכנית שלכם.
נרשמה כנשלחה אבל לא התקבלה	ההודעה ממתינה בתור עד שמספר ה-WhatsApp שלכם מחובר.
אירוע של Amelia מסומן אבל שום דבר לא נשלח	ראו את המגבלה של Amelia שלמעלה.
אין תפריט WbizTool בסרגל הצד של ממשק הניהול	התוסף מופעל תחת Plugins, ואתם מחוברים כמנהל מערכת (התפריט דורש את היכולת `manage_options`). אם התפריט עדיין לא מופיע, בדקו את יומן השגיאות של PHP, ואז השביתו את התוסף והפעילו אותו מחדש.

כדי לראות שגיאות PHP של התוסף, הפעילו את רישום הדיבאג של WordPress בקובץ wp-config.php. השגיאות נכתבות לקובץ wp-content/debug.log. כשתסיימו, כבו אותו שוב.

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