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

في عالم التجارة الإلكترونية، يُعدّ التواصل السريع والفعّال مع العملاء أحد أهم مفاتيح النجاح. إذا كنت تدير متجرًا إلكترونيًا على منصة شوبيفاي (Shopify) وترغب في إرسال إشعارات فورية عبر واتساب عند استلام طلب جديد، فإن إعداد Webhook مع خدمة Whats360 هو الحل الأمثل. في هذا المقال التعليمي، سنشرح بالتفصيل كيفية تنفيذ Webhook من شوبيفاي لإرسال رسائل واتساب تلقائية باستخدام سكريبت PHP، مع الاعتماد على استضافة مجانية مثل 000webhost، Vercel، أو Replit.

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

لماذا استخدام Webhook مع Whats360؟

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

فوائد هذا النظام:

• تحسين تجربة العميل: إشعارات فورية تعزز رضا العملاء.
• أتمتة العمليات: تقليل الوقت والجهد المبذول في التواصل اليدوي.
• تكلفة منخفضة: استخدام استضافة مجانية يجعل الحل اقتصاديًا.
• مرونة عالية: إمكانية تخصيص الرسائل أو إرسال قوالب رسمية.

الخطوة الأولى: كتابة سكريبت PHP لإرسال رسالة واتساب

لنبدأ بكتابة سكريبت PHP بسيط يتلقى بيانات Webhook من شوبيفاي ويرسل رسالة واتساب عبر Whats360. السكريبت التالي يستخرج بيانات العميل (مثل الاسم ورقم الهاتف) من الطلب ويرسل رسالة ترحيبية.

السكريبت الأساسي:

<?php
// استقبال بيانات Webhook من شوبيفاي
$input = json_decode(file_get_contents("php://input"), true);

// بيانات الاتصال بـ Whats360
$client_id = "YOUR_CLIENT_ID"; // استبدل بمعرف العميل الخاص بك
$api_key = "YOUR_API_KEY"; // استبدل بمفتاح API الخاص بك

// استخراج بيانات العميل من الطلب
$phone = $input['customer']['phone'];
$name = $input['customer']['first_name'];
$order_number = $input['name'];

// صيغة الرسالة
$text = "مرحبًا $name، تم استلام طلبك رقم $order_number. شكرًا لتسوقك معنا!";

// رابط إرسال الرسالة عبر Whats360
$url = "https://apis.whats360.live/api/user/v2/send_message_url?client_id=$client_id&mobile=$phone&text=" . urlencode($text) . "&token=$api_key";

// تنفيذ طلب الإرسال
$response = file_get_contents($url);

// تسجيل النتيجة في ملف log.txt
file_put_contents("log.txt", $response . "\n", FILE_APPEND);
?>

شرح السكريبت:

1. استقبال البيانات: يستخدم file_get_contents("php://input") لاستقبال بيانات Webhook بصيغة JSON من شوبيفاي.
2. بيانات Whats360: تحتاج إلى إدخال client_id وapi_key الخاصين بحسابك في Whats360.
3. استخراج البيانات: يتم استخراج رقم الهاتف، اسم العميل، ورقم الطلب من البيانات المستلمة.
4. إنشاء الرسالة: يتم إنشاء رسالة نصية مخصصة تحتوي على اسم العميل ورقم الطلب.
5. إرسال الرسالة: يتم إرسال الرسالة عبر رابط API الخاص بـ Whats360.
6. تسجيل النتيجة: يتم حفظ استجابة API في ملف log.txt لتتبع عمليات الإرسال.

ملاحظات هامة:

• تأكد من استبدال YOUR_CLIENT_ID وYOUR_API_KEY بالبيانات الفعلية من حسابك في Whats360.
• يجب أن يكون رقم الهاتف بصيغة دولية (مثل: +201234567890).

الخطوة الثانية: رفع السكريبت على استضافة مجانية

لتشغيل السكريبت، تحتاج إلى استضافة تدعم PHP. يمكنك استخدام منصات مجانية مثل 000webhost، Vercel، أو Replit. سنشرح خطوات الرفع على 000webhost كمثال رئيسي.

خطوات رفع السكريبت على 000webhost:

1. إنشاء حساب: سجّل حسابًا مجانيًا على 000webhost.
2. إنشاء موقع جديد: بعد تسجيل الدخول، اضغط على “Create New Website” واختر اسمًا لموقعك.
3. إدارة الملفات:
   • ادخل إلى “File Manager” من لوحة التحكم.
   • انتقل إلى مجلد public_html.
   • أنشئ ملفًا جديدًا باسم whatsapp.php.
4. إضافة السكريبت: انسخ السكريبت السابق والصقه في ملف whatsapp.php.
5. حفظ الملف: احفظ التغييرات.
6. الحصول على الرابط: انسخ الرابط العام للملف، مثل: https://yourname.000webhostapp.com/whatsapp.php.

بدائل الاستضافة:

• Vercel: إذا كنت تفضل منصة حديثة، يمكنك رفع السكريبت على Vercel باستخدام مشروع PHP بسيط.
• Replit: منصة Replit توفر بيئة برمجة تفاعلية تدعم PHP، ويمكنك نشر السكريبت مباشرة من خلالها.

الخطوة الثالثة: إعداد Webhook في شوبيفاي

الآن، سنقوم بتوصيل شوبيفاي بالسكريبت عبر إعداد Webhook يتم تنشيطه عند إنشاء طلب جديد.

خطوات إعداد Webhook:

1. تسجيل الدخول إلى شوبيفاي: افتح لوحة تحكم متجرك على شوبيفاي.
2. الانتقال إلى الإعدادات:
   • من القائمة الجانبية، اختر “الإعدادات” (Settings).
   • انتقل إلى قسم “الإشعارات” (Notifications).
3. إنشاء Webhook:
   • اضغط على “Webhooks” ثم “Create Webhook”.
   • اختر الحدث: Order Created (إنشاء طلب).
   • اختر الصيغة: JSON.
   • الصق رابط السكريبت في حقل URL (مثل: https://yourname.000webhostapp.com/whatsapp.php).
4. حفظ الإعدادات: اضغط على “Save” لحفظ Webhook.

نصيحة:

• تأكد من أن الرابط يبدأ بـ https:// لضمان الأمان، حيث تتطلب شوبيفاي روابط آمنة لـ Webhooks.

الخطوة الرابعة: اختبار النظام

بعد إعداد Webhook، يمكنك اختبار النظام للتأكد من أن الرسائل تُرسل بشكل صحيح.

خطوات الاختبار:

1. إنشاء طلب تجريبي:
   • قم بإنشاء طلب جديد في متجر شوبيفاي (يمكنك استخدام وضع الاختبار في شوبيفاي إذا لزم الأمر).
2. التحقق من ملف السجل:
   • ارجع إلى File Manager في 000webhost.
   • افتح ملف log.txt للتحقق من استجابة API الخاص بـ Whats360.
   • إذا كانت الاستجابة تحتوي على "status": "success"، فهذا يعني أن الرسالة أُرسلت بنجاح.
3. التحقق من واتساب: تأكد من أن العميل تلقى الرسالة على رقم الهاتف المسجل في الطلب.

حل المشكلات الشائعة:

• رقم الهاتف غير صحيح: تأكد من أن الرقم بصيغة دولية.
• خطأ في API: تحقق من صحة client_id وapi_key في السكريبت.
• عدم استجابة Webhook: تأكد من أن رابط السكريبت يعمل بشكل صحيح وأن الاستضافة نشطة.

تحسين السكريبت: إرسال قالب رسمي (Template)

بدلاً من إرسال رسالة نصية عادية، يمكنك استخدام قوالب واتساب الرسمية (Templates) لإرسال رسائل احترافية تحتوي على أزرار تفاعلية أو تنسيقات محددة. إليك سكريبتًا محسنًا لإرسال قالب رسمي:

السكريبت المحسن:

<?php
// استقبال بيانات Webhook من شوبيفاي
$input = json_decode(file_get_contents("php://input"), true);

// بيانات الاتصال بـ Whats360
$client_id = "YOUR_CLIENT_ID"; // استبدل بمعرف العميل
$api_key = "YOUR_API_KEY"; // استبدل بمفتاح API
$template_name = "order_confirmation"; // اسم القالب المسجل في Whats360

// استخراج بيانات العميل
$phone = $input['customer']['phone'];
$name = $input['customer']['first_name'];
$order_number = $input['name'];

// بيانات القالب
$template_data = [
    "name" => $template_name,
    "language" => ["code" => "ar"],
    "components" => [
        [
            "type" => "body",
            "parameters" => [
                ["type" => "text", "text" => $name],
                ["type" => "text", "text" => $order_number]
            ]
        ]
    ]
];

// إعداد طلب إرسال القالب
$url = "https://apis.whats360.live/api/user/v2/send_template?client_id=$client_id&mobile=$phone&token=$api_key";
$options = [
    'http' => [
        'method' => 'POST',
        'header' => 'Content-Type: application/json',
        'content' => json_encode($template_data)
    ]
];
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);

// تسجيل النتيجة
file_put_contents("log.txt", $response . "\n", FILE_APPEND);
?>

شرح السكريبت المحسن:

• القالب الرسمي: يستخدم API send_template الخاص بـ Whats360 لإرسال قالب معتمد مسبقًا.
• التخصيص: يتم تمرير اسم العميل ورقم الطلب كمتغيرات في القالب.
• التنسيق: يتم إرسال البيانات بصيغة JSON باستخدام طلب POST.

كيفية إعداد القالب:

1. سجّل قالبًا رسميًا في لوحة تحكم Whats360.
2. تأكد من أن اسم القالب (مثل order_confirmation) مطابق في السكريبت.
3. اختبر القالب قبل استخدامه في Webhook.

الأسئلة الشائعة (FAQ)

هل يمكنني استخدام هذا النظام مع منصات أخرى غير شوبيفاي؟

نعم، يمكن تكييف السكريبت للعمل مع أي منصة تدعم Webhooks، مثل تجار كوم أو ووكومرس.

هل الاستضافة المجانية آمنة لتشغيل Webhooks؟

الاستضافة المجانية مثل 000webhost مناسبة للاختبار، ولكن للاستخدام التجاري الدائم، يُفضل استخدام استضافة مدفوعة لضمان الأداء والأمان.

كيف أحصل على client_id و api_key من Whats360؟

سجّل حسابًا في Whats360، ثم انتقل إلى إعدادات API للحصول على بيانات الاتصال.

هل يمكن تخصيص الرسائل بشكل أكبر؟

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

الخاتمة

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

ابدأ الآن بإنشاء متجرك الإلكتروني المستقل على تجار كوم واستفد من نظام الأفلييت المتكامل. لمزيد من الشروحات، تابع قناة Affiegy على يوتيوب أو انضم إلى جروب أفلييت مصر.

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