التكاملات

تكامل 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. إذا فشل الرفع (مثلًا بسبب حد حجم الملف)، فاستخرج الملف وانسخ المجلد business-messaging-for-wbiztool إلى /wp-content/plugins/ عبر FTP، ثم فعّله من Plugins.
افتح إعدادات الإضافة
تظهر قائمة WbizTool جديدة في الشريط الجانبي للوحة الإدارة بأربع صفحات: Settings (الإعدادات) وTemplates (القوالب) وTest Messages (رسائل الاختبار) وLogs (السجلات).

أعدّ الإضافة#

أدخل بيانات اعتماد API
في WbizTool → Settings، تحت API Configuration (إعداد API)، املأ 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#

تُرسل الرسائل إلى هاتف الفوترة في الطلب. يُؤخذ رمز الدولة من بلد الفوترة؛ وإذا لم يُتعرّف على ذلك البلد، يُستخدم 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. تحقق من Client ID ومفتاح 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);