ربط واتساب بووكومرس: دليل التكامل الكامل مع Store API

ربط واتساب بووكومرس لا يقتصر على إضافة زر دردشة. أنت تريد إرسال تأكيدات الطلبات، ومشاركة السلات، والسماح للعملاء بالاستفسار عن المنتجات مباشرة من متجرك. يوضح هذا الدليل كيفية القيام بذلك، مع التركيز على WooCommerce Store API والقوالب المخصصة.

لماذا تربط واتساب بووكومرس؟

يفضل العملاء في مصر والسعودية والخليج واتساب على البريد الإلكتروني. من خلال ربط واتساب، يمكنك:

• إرسال تأكيدات الطلبات والتحديثات عبر واتساب.
• السماح للعملاء بالاستفسار عن المنتجات والحصول على ردود فورية.
• استعادة السلات المتروكة بإرسال رسالة واتساب مع رابط للعودة إلى الدفع.
• تقديم دعم فوري دون مغادرة الدردشة.

ولكن للقيام بذلك بشكل صحيح، تحتاج إلى دمج واتساب مع بيانات متجر ووكومرس الخاص بك.

طرق ربط واتساب بووكومرس

هناك ثلاثة أساليب رئيسية، لكل منها مستوى مختلف من الجهد والقدرات.

1. زر دردشة واتساب (أساسي)

يضيف هذا زر دردشة عائم إلى موقعك. عند النقر عليه، يفتح واتساب برسالة معدة مسبقًا. إنه سهل ولكن محدود: لا يمكنك إرسال تفاصيل الطلب تلقائيًا.

كيفية القيام بذلك:

• استخدم إضافة مثل "Click to Chat" أو أضف رابطًا مخصصًا: https://wa.me/1234567890?text=مرحبا.
• لرسائل خاصة بالمنتج، يمكنك إدراج اسم المنتج ورابطه ديناميكيًا.

القيد: لا مزامنة ثنائية الاتجاه. لن تعرف من طلب ماذا إلا إذا تحققت من WooCommerce يدويًا.

2. واتساب بزنس API (متقدم)

يتيح هذا الإرسال البرمجي للرسائل. ستحتاج إلى مزود واتساب بزنس API (مثل Twilio أو MessageBird أو Co-Social). ثم يمكنك إرسال تأكيدات الطلبات وتحديثات الشحن والمزيد.

كيفية القيام بذلك:

• سجل مع مزود واحصل على بيانات اعتماد API.
• استخدم خطافات WooCommerce (مثل woocommerce_thankyou، woocommerce_order_status_changed) لتشغيل رسائل واتساب.
• أرسل الرسائل عبر API المزود.

مثال على كود (باستخدام Twilio):

```php

add_action('woocommerce_thankyou', 'send_whatsapp_order_confirmation');

function send_whatsapp_order_confirmation($order_id) {

$order = wc_get_order($order_id);

$phone = $order->get_billing_phone();

$message = "شكرًا لطلبك #$order_id. سنؤكد قريبًا.";

// استدعاء Twilio API لإرسال رسالة واتساب

}

```

ملاحظة: يتطلب هذا خادمًا مع PHP وSDK المزود.

3. WooCommerce Store API + تكامل مخصص

Store API هو REST API يعرض بيانات متجرك (المنتجات، السلة، الدفع) بصيغة JSON. يمكنك استخدامه لبناء تكامل واتساب مخصص، خاصة إذا كان لديك قالب مخصص أو إعداد بدون واجهة.

لماذا استخدام Store API؟

• إنه مدمج في WooCommerce (منذ الإصدار 3.6) ولا يتطلب إضافات إضافية.
• يوفر نقاط نهاية لمعالجة السلة، وهو مفيد لاستعادة السلات المتروكة.
• يعمل بشكل جيد مع القوالب المخصصة وأطر JavaScript.

نقاط النهاية الرئيسية:

• /wp-json/wc/store/products – قائمة المنتجات.
• /wp-json/wc/store/cart – الحصول على السلة أو تحديثها.
• /wp-json/wc/store/checkout – تقديم الطلب.

كيفية التكامل مع واتساب:

1. عندما يضيف العميل عناصر إلى السلة، يمكنك تخزين رقم واتساب (إذا قدموه).
2. استخدم Store API لجلب محتويات السلة وإنشاء رسالة واتساب مع رابط الدفع.
3. أرسل الرسالة عبر واتساب بزنس API.

مثال لسير العمل لسلة متروكة:

• يضيف العميل منتجًا إلى السلة لكنه لا يكمل الدفع.
• بعد 30 دقيقة، يستدعي الخادم Store API للحصول على السلة.
• أرسل رسالة واتساب: "لقد تركت عناصر في سلتك. أكمل طلبك هنا: [رابط]".

اعتبارات القالب المخصص:

• إذا كان قالبك يستخدم Store API لتفاعلات السلة، يمكنك الربط بتلك الطلبات لالتقاط السلة.
• تأكد من أن JavaScript في قالبك متوافق مع nonce وإدارة الجلسة في Store API.
• بالنسبة للإعدادات بدون واجهة، يمكنك استخدام Store API من واجهة أمامية منفصلة (مثل React) ولا يزال بإمكانك إرسال رسائل واتساب من الواجهة الخلفية.

خطوة بخطوة: ربط واتساب بووكومرس باستخدام Store API

إليك خطة تنفيذ عملية:

1. إعداد واتساب بزنس API: اختر مزودًا واحصل على مفتاح API.
2. إنشاء نقطة نهاية مخصصة في ووردبريس: أضف مسار REST يقبل معرف السلة ورقم واتساب.
3. استخدم Store API لجلب السلة: في نقطة النهاية، اتصل بـ GET /wp-json/wc/store/cart?cart_id=... للحصول على العناصر.
4. إنشاء الرسالة: قم بتكوين رسالة تحتوي على أسماء المنتجات والكميات ورابط الدفع.
5. الإرسال عبر واتساب API: استخدم SDK المزود لإرسال الرسالة.
6. معالجة الردود: إذا رد العميل، يمكنك تحديث حالة الطلب عبر خطافات WooCommerce.

مثال على كود لنقطة نهاية مخصصة:

```php

add_action('rest_api_init', function () {

register_rest_route('myplugin/v1', '/send-cart/', array(

'methods' => 'POST',

'callback' => 'send_cart_via_whatsapp',

));

});

function send_cart_via_whatsapp($request) {

$cart_id = $request->get_param('cart_id');

$phone = $request->get_param('phone');

// جلب السلة عبر Store API

$response = wp_remote_get("https://yoursite.com/wp-json/wc/store/cart?cart_id=$cart_id");

$cart = json_decode(wp_remote_retrieve_body($response), true);

// بناء الرسالة

$message = "سلتك: ";

foreach ($cart['items'] as $item) {

$message .= $item['name'] . " x " . $item['quantity'] . "\n";

}

$message .= "الدفع: https://yoursite.com/checkout/?cart_id=$cart_id";

// إرسال عبر واتساب API

// ...

return new WP_REST_Response('تم إرسال الرسالة', 200);

}

```

الأخطاء الشائعة وكيفية تجنبها

• تنسيق رقم الهاتف: احفظ الأرقام دائمًا بالتنسيق الدولي (مثل +201234567890).
• حدود معدل API: واتساب بزنس API له حدود؛ لا ترسل الكثير من الرسائل بسرعة كبيرة.
• رسائل القالب: للرسائل التي يبدأها النشاط التجاري، يجب استخدام قوالب معتمدة. خطط مسبقًا.
• مصادقة Store API: يستخدم Store API nonces وملفات تعريف الارتباط للجلسة؛ عند الاتصال من جانب الخادم، قد تحتاج إلى استخدام رمز السلة بدلاً من ذلك.

اختبار التكامل الخاص بك

قبل الإطلاق، اختبر مع مجموعة صغيرة:

• قم بطلب تجريبي وتأكد من إرسال رسالة واتساب.
• اترك سلة وتحقق من وصول رسالة الاستعادة.
• رد على رسالة واتساب وانظر ما إذا كان يتم تحديث الطلب.

الذهاب أبعد من ذلك

إذا كنت تريد حلاً جاهزًا يتعامل مع واتساب بزنس API وتأكيدات الطلبات وحتى ردود الذكاء الاصطناعي المدربة على منتجاتك، فكر في Co-Social. يتصل بـ WooCommerce ويمنحك صندوق وارد واحد لواتساب وإنستجرام وماسنجر، مما يحول الدردشات إلى طلبات مؤكدة.

لكن سواء قمت ببنائه بنفسك أو استخدمت أداة، المفتاح هو دمج واتساب بعمق مع بيانات WooCommerce الخاصة بك. ابدأ بـ Store API، وسيكون لديك أساس متين.