ربط WooCommerce مع WhatsApp API – Whats360: إشعارات تلقائية احترافية

مقدمة: لماذا تكامل WooCommerce مع WhatsApp؟

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

المتطلبات الأساسية لتكامل WooCommerce مع Whats360

لضمان نجاح التكامل، تحتاج إلى:

• موقع ووردبريس محدث مع إضافة WooCommerce مفعّلة.
• حساب نشط على Whats360 مع Client ID وAPI Key.
• إضافة Code Snippets لإدارة الأكواد بأمان.
• رقم هاتف العميل بصيغة دولية (مثل: +201234567890).

إذا كنت تدير متجرًا عبر منصة مثل تجار كوم، تأكد من إعداد الشحن والدفع بما يتناسب مع السوق المصري.

خطوات إعداد WooCommerce وCode Snippets

تثبيت وتفعيل WooCommerce

اتبع الخطوات التالية من لوحة تحكم ووردبريس:

• اذهب إلى الإضافات → أضف جديد.
• ابحث عن WooCommerce، ثم قم بتثبيته وتفعيله.
• أكمل معالج الإعداد لتحديد العملة (مثل الجنيه المصري)، خيارات الدفع، والشحن.

تثبيت Code Snippets

تتيح إضافة Code Snippets إدارة الأكواد بأمان دون تعديل ملفات الثيم. الخطوات:

• ابحث عن Code Snippets في الإضافات.
• قم بتثبيتها وتفعيلها.
• ستجد قائمة Snippets في لوحة التحكم لإضافة الأكواد.

ربط WooCommerce مع Whats360 API: الخطوات العملية

سننشئ كودًا يرسل إشعار واتساب تلقائي عند اكتمال طلب جديد (صفحة Thank You).

الكود الأساسي لإشعار الطلب الجديد

أضف هذا الكود في Code Snippets تحت اسم WooCommerce WhatsApp Notification:

add_action('woocommerce_thankyou', 'send_whats360_message', 10, 1);
function send_whats360_message($order_id) {
    $order = wc_get_order($order_id);
    $phone = $order->get_billing_phone();
    $name = $order->get_billing_first_name();
    $message_text = "مرحبًا $name، شكرًا لطلبك رقم #$order_id من متجرنا! سنوافيك بتحديثات الشحن قريبًا.";

    $url = 'https://v2.whats360.live/api/user/v2/send_message';
    $body = [
        'client_id' => 'YOUR_CLIENT_ID',
        'mobile'    => $phone,
        'text'      => $message_text
    ];
    $token = 'YOUR_API_KEY';

    $headers = [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $token
    ];

    $curl = curl_init($url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($body));

    $response = curl_exec($curl);
    $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);

    if ($response === false || $httpCode >= 400) {
        error_log('Whats360 Error: ' . curl_error($curl));
    } else {
        $data = json_decode($response, true);
        if (!empty($data['success']) && $data['success']) {
            error_log('Whats360 Message Sent Successfully');
        }
    }

    curl_close($curl);
}

استبدل YOUR_CLIENT_ID وYOUR_API_KEY ببياناتك من Whats360. قم بتخصيص $message_text لتضمين تفاصيل الطلب.

اختبار الإشعار

للتحقق من عمل الإشعار:

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

قائمة حالات WooCommerce القابلة للإشعارات

يمكنك إرسال إشعارات واتساب لمختلف حالات الطلبات. إليك جدولًا يوضح الحالات المدعومة:

مثال: لمتجر في مصر يبيع ملابس، يمكنك إرسال رسالة مثل: “مرحبًا أحمد، طلبك لتيشيرت أسود (#5678) قيد التجهيز. توقع التسليم خلال يومين!”

كود موحد لجميع الحالات

لتبسيط الأكواد، استخدم دالة موحدة لتغطية حالات متعددة:

add_action('woocommerce_thankyou', 'whats360_notify', 10, 1);
add_action('woocommerce_order_status_processing', 'whats360_notify', 10, 1);
add_action('woocommerce_order_status_completed', 'whats360_notify', 10, 1);
add_action('woocommerce_order_status_cancelled', 'whats360_notify', 10, 1);

function whats360_notify($order_id) {
    $order = wc_get_order($order_id);
    $status = $order->get_status();
    $phone = $order->get_billing_phone();
    $name = $order->get_billing_first_name();

    $messages = [
        'thankyou'   => "مرحبًا $name، شكرًا لطلبك رقم #$order_id! سنوافيك بالتحديثات قريبًا.",
        'processing' => "مرحبًا $name، طلبك رقم #$order_id قيد التجهيز الآن.",
        'completed'  => "مرحبًا $name، تم شحن طلبك رقم #$order_id. شكرًا لتسوقك معنا!",
        'cancelled'  => "عزيزي $name، تم إلغاء طلبك رقم #$order_id. تواصل معنا لمزيد من التفاصيل."
    ];

    if (!isset($messages[$status])) return;

    $message_text = $messages[$status];

    $url = 'https://v2.whats360.live/api/user/v2/send_message';
    $body = [
        'client_id' => 'YOUR_CLIENT_ID',
        'mobile'    => $phone,
        'text'      => $message_text
    ];
    $token = 'YOUR_API_KEY';

    $headers = [
        'Content-Type: application/json',
        'Authorization: Bearer ' . $token
    ];

    $curl = curl_init($url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($body));

    $response = curl_exec($curl);
    $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);

    if ($response === false || $httpCode >= 400) {
        error_log('Whats360 Error: ' . curl_error($curl));
    } else {
        $data = json_decode($response, true);
        if (!empty($data['success']) && $data['success']) {
            error_log('Whats360 Message Sent Successfully');
        }
    }

    curl_close($curl);
}

هذا الكود يقلل التكرار ويسهل إضافة حالات جديدة.

تحسين تجربة العميل

لجعل الإشعارات أكثر جاذبية:

• استخدم لغة ودية مثل: “شكرًا لثقتك بنا!”
• أضف روابط تفاعلية، مثل رابط تتبع الطلب.
• أرسل إشعارات فقط عند التغييرات المهمة.
• تأكد من تخزين أرقام العملاء بصيغة دولية.

مثال مصري: لمتجر في الإسكندرية، أرسل رسالة مثل: “طلبك وصلك قريبًا يا محمد!”

استكشاف الأخطاء وإصلاحها

إذا لم تصل الإشعارات، تحقق من الجدول التالي:

برمبت ذكي لتطبيق الاستراتيجية

استخدم البرمبت التالي مع أدوات الذكاء الاصطناعي مثل ChatGPT أو Claude AI لتطبيق خطوات المقال:

أنا صاحب متجر إلكتروني يعمل على WooCommerce. أريد ربط متجري مع Whats360 API لإرسال إشعارات واتساب تلقائية للعملاء عند تغيير حالة الطلب (مثل طلب جديد، قيد التنفيذ، مكتمل، إلغاء). قم بإنشاء كود PHP متوافق مع Code Snippets يستخدم Client ID وAPI Key من Whats360، مع رسائل مخصصة باللغة العربية تناسب السوق المصري. تأكد من أن الكود يدعم صيغة أرقام دولية ويتضمن معالجة الأخطاء. قدم شرحًا لكيفية اختبار الكود.

الأسئلة الشائعة

هل يمكنني تخصيص الرسائل حسب نوع المنتج؟

نعم، يمكنك تعديل $message_text لتضمين تفاصيل المنتج باستخدام دوال WooCommerce مثل get_items().

هل يدعم Whats360 إرسال الصور أو الملفات؟

نعم، تحقق من وثائق Whats360 لإرسال الوسائط عبر API.

هل التكامل آمن؟

نعم، باستخدام Code Snippets وتأمين API Key، يبقى التكامل آمنًا.

كيف أختبر الإشعارات بدون طلب حقيقي؟

استخدم طلبًا تجريبيًا عبر وضع Sandbox في WooCommerce.

هل يمكن إرسال إشعارات للفريق الإداري؟

نعم، يمكنك تعديل الكود لإرسال إشعارات إلى أرقام الفريق عند انخفاض المخزون.

الخاتمة: ابدأ الآن في تحسين متجرك!

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

سيرفر خدمات وتساب API السحابي