इंटीग्रेशन

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 नंबर हो।
सेटिंग्स → API Keys से आपका Client ID (क्लाइंट ID) और API key (API की)।
जिस नंबर से भेजना है उसका WhatsApp Client ID (WhatsApp क्लाइंट ID), जो WhatsApp सेटिंग्स पर दिखता है।

प्लगइन इंस्टॉल करें#

WordPress से इंस्टॉल करें
अपने WordPress एडमिन में Plugins → Add New पर जाएं, Business Messaging for WbizTool खोजें, Install Now और फिर Activate पर क्लिक करें। आप इसे WordPress प्लगइन डायरेक्टरी से डाउनलोड करके zip फाइल को Plugins → Add New → Upload Plugin में अपलोड भी कर सकते हैं। अगर अपलोड फेल हो जाए (जैसे फाइल साइज़ लिमिट की वजह से), तो zip को अनज़िप करें और business-messaging-for-wbiztool फोल्डर को FTP से /wp-content/plugins/ में कॉपी करें, फिर 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. दिखे, तो ज़्यादा संभावना है कि आपका 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	ऑर्डर pending या processing से completed में जाने पर, या पेमेंट पूरा होने पर जब ऑर्डर completed हो।
Order Shipped	ऑर्डर `shipped` नाम के स्टेटस में जाने पर।
Order Cancelled	ऑर्डर कैंसल होने पर।
Order Refunded	ऑर्डर रिफंड होने पर।
Payment Failed	ऑर्डर का स्टेटस failed होने पर।

वर्ज़न 1.0.3 की ज्ञात सीमाएं

Order Shipped के लिए एक कस्टम shipped ऑर्डर स्टेटस चाहिए। WooCommerce में डिफ़ॉल्ट रूप से यह नहीं होता, इसलिए इसे किसी दूसरे प्लगइन से जोड़ें।
Payment Failed संदेश 5 मिनट बाद भेजने के लिए शेड्यूल होते हैं, लेकिन मौजूदा वर्ज़न ये देर से भेजे जाने वाले संदेश नहीं भेजता।
कुछ बदलाव एक से ज़्यादा WordPress hook चलाते हैं, जैसे रिफंड या पूरा हुआ पेमेंट, इसलिए किसी ग्राहक को एक ही संदेश दो बार मिल सकता है।

टेम्प्लेट वेरिएबल:

ग्रुप	वेरिएबल
ग्राहक	`{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 जैसे आम नाम इस्तेमाल करें। ग्राहक को auto-reply तभी जाता है जब कोई फोन फील्ड मिलता है। नंबर कंट्री कोड के साथ मांगें: प्लगइन सिर्फ कुछ कंट्री कोड पहचानता है और बाकी मामलों में 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 है	WbizTool → Settings पर Test Connection पर क्लिक करें। सेटिंग्स → API Keys पर क्लाइंट ID और API की, और WhatsApp सेटिंग्स पर WhatsApp क्लाइंट ID जांचें, और पक्का करें कि आपके प्लान में संदेश बचे हैं।
लॉग में भेजा गया दिखता है लेकिन मिला नहीं	जब तक आपका WhatsApp नंबर कनेक्ट नहीं होता, संदेश कतार में रहता है।
Amelia इवेंट टिक है लेकिन कुछ नहीं गया	ऊपर दी गई Amelia की सीमा देखें।
एडमिन साइडबार में WbizTool मेनू नहीं है	प्लगइन Plugins में एक्टिवेट है, और आप एडमिनिस्ट्रेटर के रूप में लॉग इन हैं (मेनू के लिए `manage_options` capability ज़रूरी है)। फिर भी मेनू न दिखे, तो PHP एरर लॉग देखें, फिर प्लगइन को डीएक्टिवेट करके दोबारा एक्टिवेट करें।

प्लगइन के PHP एरर देखने के लिए wp-config.php में WordPress debug logging चालू करें। एरर wp-content/debug.log में लिखे जाते हैं। काम पूरा होने पर इसे फिर से बंद कर दें।

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