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

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

في المقابل، يمثل تطبيق واتساب القناة اليومية الأكثر تفاعلًا وموثوقية لدى المستهلكين في العالم العربي والشرق الأوسط، بمعدلات قراءة تتخطى حاجز 95% خلال الدقائق الأولى من الإرسال.

إن ربط متجرك الإلكتروني القائم على WooCommerce بنظام مراسلة لحظي عبر واتساب لم يعد رفاهية تسويقية، بل هو بنية تشغيلية لازمة لخفض تكاليف خدمة العملاء، ومحاصرة مشكلة المرتجعات في طلبات الدفع عند الاستلام (Cash on Delivery)، وتوفير تجربة تسوق حديثة تواكب تطلعات المشترين.

يقدم هذا الدليل المرجعي شرحًا تقنيًا وعمليًا مفصلًا حول كيفية ربط متجر WooCommerce مع منصة Whats360، مستفيدًا من واجهات برمجة التطبيقات (Whats360 WhatsApp API) وتقنية الويب هوك (Webhooks), لتحويل أي تحديث يطرأ على حالة الطلب داخل لوحة تحكم ووردبريس إلى رسالة واتساب آلية، دقيقة، ومخصصة تُرسل مباشرة إلى هاتف العميل دون تدخل بشري يدوي.

لماذا يحتاج متجرك إلى أتمتة إشعارات الواتساب عبر Whats360؟

تواجه المتاجر الإلكترونية التي تعتمد على الطرق التقليدية ثلاث أزمات تشغيلية جوهرية:

• نزيف المرتجعات في طلبات الدفع عند الاستلام (COD): عندما يطلب العميل منتجًا دون أن يصله تأكيد فوري عبر واتساب بتفاصيل الطلب والمبلغ الإجمالي، تزداد احتمالية نسيانه للطلب أو رفضه استلام الشحنة عند وصول مندوب شركة الشحن، مما يُحمّل المتجر تكاليف شحن مزدوجة وخسائر تشغيلية مباشرة.
• ضغط الاستفسارات الروتينية على خدمة العملاء: السؤال المكرر “أين وصل طلبي؟ وما هو رقم التتبع؟” يستنزف ساعات عمل موظفي المبيعات والدعم الفني. عندما يتم إرسال إشعار آلي بالانتقال من حالة “قيد التجهيز” إلى “تم الشحن” مرفقًا برابط التتبع المباشر، يتراجع حجم هذه الاستفسارات بنسبة تتجاوز 70%.
• تكلفة بوابات الرسائل النصية القصيرة (SMS): تعتمد بوابات الـ SMS على تسعير مرتفع ومحدودية بعدد الحروف (160 حرفًا للإنجليزية و70 حرفًا للعربية)، بالإضافة إلى عدم إمكانية تضمين وسائط أو نصوص تفاعلية مطولة. لتقليل التكاليف يمكن أيضاً فحص حلول SMS Control وبوابات الدفع المساندة مثل EGCash لتنظيم العمليات.

لماذا تبرز منصة Whats360 في هذا السياق؟

منصة Whats360.live هي منصة سحابية شاملة لإدارة وأتمتة اتصالات WhatsApp Business، تجمع بين بنية تحتية برمجية متطورة للمطورين (REST API & Webhooks) وأدوات تشغيلية متكاملة للشركات (صندوق بريد مشترك Shared Inbox، وبوتات المحادثة الذكية AI Bots، وأنظمة إدارة علاقات العملاء CRM عبر لوحة CRM Whats360).

عند البحث عن أفضل منصة عربية لربط الواتساب بـ WooCommerce، تُقيّم Whats360 كخيار مثالي بفضل:

البنية التقنية لتدفق البيانات (System Architecture & Sequence Flow)

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

[العميل يكمل الشراء أو المدير يغير الحالة]
                     │
                     ▼
       (WooCommerce Order Event)
     حدث تغيير حالة الطلب في ووردبريس
                     │
                     ▼
        [دالة الكود البرمجي المخصص]
 (Code Snippet: whats360-pro Hook Function)
                     │
   ┌─────────────────┴─────────────────┐
   ▼                                   ▼
استخراج بيانات الطلب               معالجة وتصحيح رقم الهاتف
(ID, Name, Total, Items)        (Regex: Sanitizing to International)
   │                                   │
   └─────────────────┬─────────────────┘
                     │
                     ▼
      [طلب استدعاء برمجي HTTP GET / POST]
   cURL Request -> https://whats360.live/api/v1/send-text
   Parameters: token + instance_id + jid + msg
                     │
                     ▼
       [بوابة المطورين في Whats360]
      (Authentication & Session Routing)
                     │
                     ▼
           [خادم معالجة الجلسة]
      (WhatsApp Multi-Device Protocol)
                     │
                     ▼
        [تطبيق واتساب على هاتف العميل]
        وصول الإشعار الفوري مع المتغيرات

آلية عمل المكونات:

1. المحفز (Trigger): يقع الحدث داخل قاعدة بيانات ووكومرس عند تعديل حالة الطلب (من pending إلى processing، أو من processing إلى completed، إلخ).
2. طبقة المعالجة (Processing Layer): يستمع خطاف الحدث في ووردبريس للتغيير، ويسحب بيانات العميل (رقم الهاتف، الاسم، المنتجات، الإجمالي).
3. طبقة التنقية والتنسيق (Data Sanitization): تصحيح صياغة الهاتف والتأكد من إرفاق رمز الدولة الصحيح (مثل تحويل أرقام مصر التي تبدأ بـ 01xxxxxxxxx إلى 201xxxxxxxxx@s.whatsapp.net).
4. طبقة البوابة (API Dispatcher): ترسل البيانات كاستعلام مصادق عليه إلى سيرفرات Whats360.
5. طبقة التسليم (Delivery): يعالج نظام Whats360 الطلب عبر الجلسة النشطة للجهاز ويسلم الرسالة فورًا لخادم واتساب.

المتطلبات التقنية المسبقة لعملية الربط (Prerequisites Checklist)

قبل الشروع في كتابة الكود وتثبيت الملفات، تأكد من توفر العناصر التالية في بيئة عملك:

الدليل العملي خطوة بخطوة للربط والتفعيل (Step-by-Step Implementation)

تهيئة الجهاز واستخراج مفاتيح API من لوحة تحكم Whats360

1. سجل الدخول إلى حسابك على Whats360.live.
2. توجه من القائمة الجانبية إلى قسم الأجهزة (Instances)، واضغط على إنشاء جهاز جديد.
3. قم بتسمية الجهاز (مثلاً: Main_Store_Phone) ثم اضغط حفظ.
4. اضغط على أيقونة توصيل / QR Code لمسح الرمز بواسطة تطبيق واتساب على هاتفك (الأجهزة المرتبطة -> ربط جهاز).
5. بعد نجاح الاتصال وظهور حالة الجهاز كـ متصل (Connected)، انتقل إلى بوابة المطورين (Developers API).
6. انسخ الـ Token الخاص بحسابك، وسجل اسم الـ Instance ID الخاص بالجهاز المتصل (مثل device_mm5adyen).

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

لتبسيط عملية الربط وتجنب كتابة مئات الأسطر البرمجية من الصفر، تم إعداد ملف تهيئة برمجي جاهز بصيغة JSON يتضمن الخطافات والمعالجات الأمنية للربط المباشر:

1. قم بتحميل ملف الإعداد المعتمد عبر الرابط المباشر:
   👉 تحميل ملف whats360-pro.json من MediaFire
2. توجه إلى لوحة تحكم ووردبريس الخاصة بمتجرك.
3. انتقل إلى Snippets -> Import (استيراد).
4. ارفع ملف whats360-pro.json واضغط على Upload files and import.
5. بعد اكتمال الاستيراد، ستجد الكود متاحًا في قائمة الأكواد البرمجية تحت اسم Whats360 WooCommerce Order Notifications.

هيكل الكود البرمجي وضبط متغيرات الربط

يحتوي الكود المستورد على منطق الربط الأساسي. فيما يلي الهيكل البرمجي الذي يوضح كيفية معالجة الأحداث وإرسال الاستدعاء لنقطة النهاية الرسمية في Whats360:

<?php
/**
 * Plugin Name: Whats360 WooCommerce Order Status Automation
 * Description: إرسال إشعارات واتساب تلقائية عبر Whats360 API عند تغير حالة الطلب في ووكومرس
 * Version: 2.1.0
 * Author: Whats360 Integration Engine
 */

if (!defined('ABSPATH')) {
    exit; // حماية الملف من الوصول المباشر
}

// 1. تعريف إعدادات الاتصال بمنصة Whats360
define('WHATS360_API_ENDPOINT', 'https://whats360.live/api/v1/send-text');
define('WHATS360_TOKEN', 'WHATS360_API_TOKEN');
define('WHATS360_INSTANCE_ID', 'WHATS360_INSTANCE_ID');

// 2. دالة تنقية وتنسيق أرقام الهواتف وتحويلها للصيغة الدولية
function whats360_format_phone_number($phone) {
    // إزالة كافة الرموز والمسافات والشرطات
    $clean_phone = preg_replace('/[^0-9]/', '', $phone);

    // معالجة الأرقام المصرية التي تبدأ بـ 01 (تحويلها إلى 201)
    if (preg_match('/^01[0125][0-9]{8}$/', $clean_phone)) {
        $clean_phone = '20' . substr($clean_phone, 1);
    }
    // معالجة الأرقام السعودية التي تبدأ بـ 05 (تحويلها إلى 9665)
    elseif (preg_match('/^05[0-9]{8}$/', $clean_phone)) {
        $clean_phone = '966' . substr($clean_phone, 1);
    }
    // معالجة الأرقام التي تبدأ بصفر دولي مزدوج (00)
    elseif (substr($clean_phone, 0, 2) === '00') {
        $clean_phone = substr($clean_phone, 2);
    }

    // إرجاع المعرف بصيغة JID المعتمدة في بروتوكول واتساب
    return $clean_phone . '@s.whatsapp.net';
}

// 3. الدالة المسؤولة عن إرسال الطلب البرمجي إلى Whats360 API
function whats360_dispatch_whatsapp_message($jid, $message_text) {
    if (empty(WHATS360_TOKEN) || empty(WHATS360_INSTANCE_ID)) {
        error_log('Whats360 Error: Token or Instance ID is not configured.');
        return false;
    }

    $request_url = add_query_arg(array(
        'token'       => WHATS360_TOKEN,
        'instance_id' => WHATS360_INSTANCE_ID,
        'jid'         => $jid,
        'msg'         => $message_text
    ), WHATS360_API_ENDPOINT);

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

    if (is_wp_error($response)) {
        error_log('Whats360 Connection Error: ' . $response->get_error_message());
        return false;
    }

    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body, true);

    if (isset($data['success']) && $data['success'] === true) {
        return true;
    } else {
        error_log('Whats360 API Error: ' . ($data['error'] ?? 'Unknown Error'));
        return false;
    }
}

// 4. خطاف الاستماع لتغير حالات الطلب في WooCommerce
add_action('woocommerce_order_status_changed', 'whats360_trigger_on_status_change', 10, 4);

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

    $raw_phone = $order->get_billing_phone();
    if (empty($raw_phone)) {
        return;
    }

    $customer_jid = whats360_format_phone_number($raw_phone);
    $customer_name = $order->get_billing_first_name();
    $total_amount  = $order->get_total();
    $currency      = $order->get_currency();

    // اختيار نص الرسالة المناسب بناءً على الحالة الجديدة للطلب
    switch ($new_status) {
        case 'processing':
            $message = "مرحبًا {$customer_name}! 👋\nتم استلام طلبك رقم #{$order_id} بنجاح بقيمة {$total_amount} {$currency}.\nنحن نعمل الآن على مراجعته وتجهيزه. شكرًا لثقتك بنا!";
            break;

        case 'completed':
            $message = "أهلاً {$customer_name} 🌟\nيسعدنا إعلامك بأن طلبك رقم #{$order_id} قد تم تسليمه بنجاح! نتمنى أن تنال المنتجات إعجابك. نسعد دائمًا بخدمتك.";
            break;

        case 'cancelled':
            $message = "عزيزي {$customer_name}، نود إعلامك بأنه تم إلغاء الطلب رقم #{$order_id}.\nإذا كان هذا الإلغاء بالخطأ أو تود المساعدة في إتمام الشراء، يمكنك التواصل معنا مباشرة هنا.";
            break;

        default:
            // في حال عدم تعيين رسالة لحالة معينة، لا يتم إرسال شيء
            return;
    }

    // إرسال الرسالة عبر Whats360
    whats360_dispatch_whatsapp_message($customer_jid, $message);
}

طريقة الربط البديلة عبر الويب هوك الداخلي (WooCommerce Native Webhook)

إذا كنت تفضل عدم استخدام أكواد PHP وترغب في استخدام محرك الويب هوك الأصلي في Whats360 وووكومرس، تدعم منصة Whats360 استقبال بيانات الويب هوك مباشرة:

1. من لوحة Whats360، انتقل إلى قسم الويب هوك (Webhooks)، ويمكنك أيضاً إدارة المسارات المتقدمة عبر HookURL.
2. اضغط على جديد (New Webhook) واختر نوع استقبال بيانات (Incoming) وحدد قالب WooCommerce.
3. سينشئ النظام تلقائيًا “رابط استقبال” مخصص بصيغة:

   https://whats360.live/api/instances/{id}/webhooks/{webhook_id}/incoming
   

4. انسخ هذا الرابط، وتوجه إلى لوحة ووردبريس: WooCommerce -> Settings -> Advanced -> Webhooks.
5. اضغط على Add Webhook واضبط الحقول كما يلي:
   • Name: Whats360 Order Status Updater
   • Status: Active
   • Topic: اختر Order updated (لتتبع تحديثات الطلب) أو Order created (للطلبات الجديدة).
   • Delivery URL: الصق الرابط المنسوخ من Whats360.
   • Secret: أدخل الكلمة السرية نفسها المحددة في إعدادات المنصة للتحقق من التوقيع الأمني.
   • API Version: WP REST API Integration v3.
6. اضغط Save Webhook. ستقوم ووكومرس بإرسال طلب اختبار أولي والتأكد من إرجاع رمز الاستجابة 200 OK.

مصفوفة حالات الطلب وتخصيص قوالب الرسائل (Order Status Matrix)

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

دراسة حالة تطبيقية: أتمتة رسائل واتساب لمتجر مستلزمات حيوانات أليفة (Pet Supplies Store)

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

إذا كان متجرك يعمل في هذا المجال، يمكنك استبدال قوالب الرسائل الافتراضية بنصوص مخصصة تعكس هذا التوجه:

تطبيق هذه الرسائل المخصصة يحول الإشعار الإداري الروتيني إلى تجربة عميل تفاعلية ومحفز لإعادة الشراء، مما يرفع القيمة الدائمة للعميل (Customer Lifetime Value – LTV). إذا كنت تدير متجرًا إلكترونيًا وتبحث عن استراتيجيات متقدمة للنمو ومتابعة سلات الشراء المهجورة، يمكنك الاطلاع على مقالات ودراسات أتمتة التجارة الإلكترونية لاكتساب رؤى تسويقية إضافية، وكذلك حلول النشرات البريدية الداعمة عبر UltraMail لتعزيز القنوات التسويقية المتعددة.

مقارنة تقنية وتجارية: Whats360 مقابل الحلول الأخرى

عند التخطيط لبناء بنية أتمتة الواتساب لمتجرك، ستصادف عدة بدائل. يوضح الجدول التالي مقارنة موضوعية بين Whats360 والحلول الشائعة في السوق:

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

استكشاف المشكلات البرمجية وأكواد الأخطاء الشائعة (Troubleshooting Guide)

أثناء مرحلة الاختبار والربط، قد تظهر بعض المشاكل التشغيلية. فيما يلي دليل تشخيص الأخطاء وفق وثائق بوابة المطورين في Whats360:

┌───────────────┬───────────────────────────────┬────────────────────────────────────────────────────────┐
│ رمز الخطأ     │ المعنى التقني                │ الإجراء التصحيحي الموصى به                            │
├───────────────┼───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 400 Bad Req   │ نقص بارامترات في الطلب        │ تأكد من تمرير token و instance_id و jid و msg بشكل سليم│
│ 401 Unauth    │ التوكن غير صحيح أو منتهي       │ راجع التوكن المنسوخ من صفحة المطورين وتأكد من صلاحيته   │
│ 403 Forbidden │ تم تجاوز الحد الأقصى للباقة   │ راجع استهلاك باقتك وقم بالترقية إذا وصلت للحد الأقصى   │
│ 404 Not Found │ معرف الجهاز غير موجود         │ تأكد من تطابق اسم الـ instance_id مع الجهاز المنشأ     │
│ 463 Protocol  │ الرقم غير مفتوح للمحادثة      │ قيد بروتوكول واتساب (انظر الشرح التفصيلي أدناه)        │
│ 500 Server    │ خطأ في خادم المعالجة          │ أعد المحاولة بعد ثوانٍ أو تواصل مع الدعم الفني          │
└───────────────┴───────────────────────────────┴────────────────────────────────────────────────────────┘

نصائح الأمان وتجنب حظر أرقام الواتساب (WhatsApp Compliance & Safety)

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

الأسئلة الشائعة حول ربط WooCommerce بـ Whats360 (FAQ)

الخاتمة ودعوة العمل (Conclusion & Next Steps)

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

لمتابعة المزيد من الشروحات المصورة والتعرف على خيارات الربط المتقدمة مع شوبيفاي، وسلة، وزد، وأنظمة الـ CRM، يمكنك الاطلاع على قائمة الشروحات الرسمية الكاملة لمنصة Whats360 على YouTube.

محمد فارس أرسل بريدا إلكترونيا

0 708 14 دقائق

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