دليل ربط متجر WooCommerce مع Whats360: أتمتة إشعارات حالات الطلب عبر WhatsApp API وWebhooks

أهمية أتمتة إشعارات الواتساب في تخفيض نزيف المرتجعات

تواجه المتاجر الإلكترونية في العالم العربي تحديًا مصيريًا يتمثل في ارتفاع معدل رفض استلام الشحنات عند الدفع عند الاستلام. تنشأ هذه المشكلة أساسًا من بطء التواصل وانعدام التأكيد الفوري، حيث يقدم العميل الطلب ثم ينسى تفاصيله أو يتردد في الاستلام نتيجة غياب الإشعار اللحظي، مما يثقل كاهل إدارة المتجر بفواتير شحن مزدوجة.

عبر تحويل الحدث البرمجي في ووكومرس إلى رسالة مباشرة على واتساب، يحصل المشتري على فاتورة مصغرة وتفاصيل الشحن فضلًا عن رابط مباشر للتتبع، مما يحول تجربة الشراء من حالة الغموض إلى الاطمئنان الكامل، ويخفض استفسارات خدمة العملاء الروتينية بنسبة تتجاوز النصف.

البنية المعمارية وتدفق البيانات بين ووكومرس والواجهة البرمجية

يعتمد التكامل على آلية خطافات الأحداث البرمجية الصادرة من المتجر دون تحميل صفحات الموقع أي كود معطل للسرعة. عندما يقوم مدير المتجر أو نظام الدفع بتغيير حالة الطلب، يتم إطلاق الدالة المخصصة لنقل المعطيات إلى المنصة المركزية.

المتطلبات الأساسية قبل البدء في ربط النظام

لإتمام عملية التكامل بنجاح ودون انقطاع، يجب تجهيز بيئة العمل بالمتطلبات الرقمية التالية والتحقق من صلاحيتها مسبقًا:

خطوات الإعداد والتكامل البرمجي الفعلي

استخراج مفاتيح الربط من لوحة تحكم Whats360

توجه إلى لوحة تحكم حسابك على المنصة، واضغط على خيار الأجهزة لإضافة جهاز جديد باسم متجرك، ثم قم بمسح رمز الاستجابة السريعة عبر تطبيق واتساب على هاتفك لتأسيس الجلسة السحابية. بعد إتمام الاتصال، توجه مباشرة إلى بوابة المطورين الرسمية للحصول على مفتاح التوكن والـ Instance ID الخاص بجهازك.

يمكنك الاطلاع على الشرح المرئي الكامل للوحة التحكم والأدوات التشغيلية من خلال هذا الفيديو التوضيحي:
مشاهدة شرح لوحة تحكم Whats360 على يوتيوب.

تحميل واستيراد ملف الإعداد whats360-pro.json

بدلًا من كتابة الأكواد يدويًا، يمكنك تحميل ملف التكوين الجاهز المعتمد مباشرة عبر الرابط التالي:
تحميل ملف whats360-pro.json من ميديافاير.
بعد التنزيل، انتقل إلى لوحة تحكم ووردبريس، ثم توجه إلى Snippets واضغط على Import، وارفع الملف المستخرج ليظهر لديك كود متكامل ومجهز للاستخدام الفوري. لمتابعة خطوات الاستيراد العملية بدقة، يمكنك مشاهدة
فيديو شرح ربط ووكومرس وإرسال الإشعارات على يوتيوب.

هيكل الكود البرمجي المخصص لتنفيذ الربط والتنقية

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

add_action('woocommerce_order_status_changed', 'whats360_handle_status_notification', 10, 4);

function whats360_handle_status_notification($order_id, $old_status, $new_status, $order) {
    if (!$order) {
        return;
    }

    $api_endpoint = 'https://whats360.live/api/v1/send-text';
    $api_token    = 'WHATS360_API_TOKEN';
    $instance_id  = 'WHATS360_INSTANCE_ID';

    $phone_number = $order->get_billing_phone();
    $clean_phone  = preg_replace('/[^0-9]/', '', $phone_number);

    if (preg_match('/^01[0125][0-9]{8}$/', $clean_phone)) {
        $clean_phone = '20' . substr($clean_phone, 1);
    } elseif (preg_match('/^05[0-9]{8}$/', $clean_phone)) {
        $clean_phone = '966' . substr($clean_phone, 1);
    }

    $customer_jid = $clean_phone . '@s.whatsapp.net';
    $first_name   = $order->get_billing_first_name();
    $total_amount = $order->get_total();
    $currency     = $order->get_currency();

    $messages = array(
        'processing' => "مرحبًا {$first_name}! تم تأكيد استلام طلبك رقم #{$order_id} بقيمة {$total_amount} {$currency}. جاري تحضير المنتجات بعناية.",
        'completed'  => "أهلاً {$first_name}! يسعدنا إعلامك باكتمال تسليم طلبك رقم #{$order_id}. نشكرك لثقتك بنا ونتطلع لخدمتك مجددًا.",
        'cancelled'  => "عزيزي {$first_name}، نأسف لإعلامك بإلغاء الطلب رقم #{$order_id}. يمكنك مراسلتنا هنا إذا كنت ترغب في إعادة تفعيله."
    );

    if (!isset($messages[$new_status])) {
        return;
    }

    $request_url = add_query_arg(array(
        'token'       => $api_token,
        'instance_id' => $instance_id,
        'jid'         => $customer_jid,
        'msg'         => $messages[$new_status]
    ), $api_endpoint);

    wp_remote_get($request_url, array(
        'timeout'   => 15,
        'sslverify' => true
    ));
}

مصفوفة حالات الطلب وتخصيص قوالب الرسائل التفاعلية

يساعد تخصيص صياغة الرسالة لكل مرحلة على بناء انطباع احترافي يدعم نمو متجرك. يوضح الجدول التالي الحالات القياسية في ووكومرس والصياغات المثالية لكل منها:

تطبيق عملي: أتمتة رسائل متجر مستلزمات الحيوانات الأليفة

تتميز المتاجر المتخصصة في أغذية ورعاية الحيوانات الأليفة بارتفاع وتيرة الشراء المتكرر والارتباط العاطفي للعميل بمشترياته. يمكن توظيف الأتمتة لتعزيز هذه العلاقة من خلال رسائل مبتكرة ومبهجة:

استكشاف الأخطاء البرمجية وتشخيص رموز الاستجابة

عند إجراء الاختبارات البرمجية، قد يواجه المطور بعض رموز الأخطاء الصادرة من نقطة النهاية. يوضح الدليل التالي كيفية معالجة كل حالة بدقة:

قواعد الأمان وتجنب حظر الأرقام في واتساب

للحفاظ على موثوقية رقم هاتفك التجاري وضمان استمرارية الإرسال دون أي تعليق من أنظمة المراقبة، اتبع الضوابط التشغيلية التالية:

الأسئلة الشائعة حول ربط ووكومرس بـ Whats360