دليل حملات وتسابدليل واتساب API

كيفية ربط واتساب API مع ووردبريس لإرسال إشعارات تلقائية مع تصحيح أرقام السعودية

ربط واتساب API مع ووردبريس 2026: إرسال رسائل تلقائية مع تصحيح الأرقام السعودية عبر Whats360

أتمتة رسائل واتساب في 2026

في عام 2026، أصبحت أتمتة التواصل عبر واتساب ليست مجرد ميزة إضافية، بل جزء أساسي من بنية أي نظام تجاري ناجح في السوق العربي، خاصة في مصر والخليج. مع تزايد حجم المعاملات اليومية عبر المتاجر الإلكترونية، أصبح الاعتماد على رسائل فورية موثوقة – سواء لإشعارات الطلبات، تذكيرات السلة المتروكة، أو متابعة العملاء – ضرورة لا غنى عنها لضمان عدم ضياع أي عميل محتمل في زحام المهام اليومية. الواقع العملي الذي عشناه في إدارة المشاريع التقنية خلال السنوات الأخيرة أثبت أن التأخير في الرد أو إرسال تأكيد الطلب بنصف ساعة قد يكلفك إلغاء الطلب بالكامل، لأن العميل ببساطة يبحث عن الأمان الفوري. هنا يأتي دور حلول مثل Whats360، التي توفر واجهة API مستقرة تعتمد على الـ WhatsApp Business API الرسمي من ميتا، مع إمكانية التحكم الكامل من خلال لوحة CRM سحابية متكاملة تسمح لك بإدارة مئات المحادثات والرسائل المؤتمتة دون الحاجة لتدخل بشري مستمر، مما يقلل بشكل حاد من تكاليف التشغيل المرتفعة لموظفي الدعم الفني.

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

التحليل التقني لدالة الإرسال send_w360_msg

الدالة الرئيسية send_w360_msg تمثل النواة البرمجية لعملية الإرسال. دعونا نفككها خطوة بخطوة من منظور تنفيذي بحت:

أولاً، يتم استرجاع الإعدادات الأساسية من قاعدة بيانات ووردبريس باستخدام get_option. هذه البيانات هي “مفاتيح التشغيل” التي تربط موقعك بخادم الإرسال الرسمي:

انضم لـ تجار كوم واستعرض الاف المنتجات المتاحة للتسويق بالعمولة
  • $token → مفتاح الوصول (Token) الخاص بحسابك على Whats360، وهو بمثابة الهوية الرقمية التي تمنح موقعك صلاحية التحدث مع الـ API.
  • $instance_id → معرف النسخة (Instance ID) الذي يميز الجهاز أو الرقم المرتبط، وهو ضروري في الحالات التي تدير فيها أكثر من رقم واتساب لمشاريع مختلفة من لوحة تحكم واحدة.

إذا كان أي منهما فارغًا، أو إذا كان رقم الهاتف فارغًا، تتوقف الدالة مباشرة – وهذا إجراء أمان أولي جيد لتجنب استهلاك موارد السيرفر في طلبات محكوم عليها بالفشل مسبقًا. في تجربتنا العملية، تجاهل هذه التحققات البسيطة يؤدي إلى تضخم ملفات الخطأ (error logs) بشكل قد يبطئ استجابة الموقع ككل.

ثم يتم تنظيف الرقم باستخدام تعبير نمطي (regex):

$phone = preg_replace('/[^0-9]/', '', $phone);

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

الجزء الأكثر أهمية هنا هو منطق تصحيح الأرقام السعودية، وهو التحدي الذي يعاني منه كل من أدار متجرًا يستهدف المملكة:

واتس 360 (Whats360.live) هو منصة سحابية متكاملة تتيح إدارة التواصل عبر واتساب باستخدام واجهة برمجة التطبيقات (API). تقدم أدوات متقدمة مثل إرسال رسائل جماعية، إدارة المجموعات، روبوتات الدردشة الذكية، ودمجها مع أنظمة CRM. تُستخدم المنصة لتحسين خدمة العملاء، تنظيم الحملات التسويقية، وزيادة التفاعل مع العملاء عبر واتساب بشكل فعّال وسهل.
if (preg_match('/^05[0-9]{8}$/', $phone)) {
$phone = '966' . substr(phone, 1);
}
elseif (preg\_match('/^5[0-9]{8}/', $phone)) {
$phone = '966' . $phone;
}

هذا المنطق يعالج “سلوك المستخدم” الحقيقي في السعودية:

  • النمط الأول /^05[0-9]{8}/</code> → يطابق أرقامًا تبدأ بـ 05 وتليها 8 أرقام (مثال: 0512345678). يُحذف الـ 0 الأول ويُضاف 966 → يصبح 966512345678. هذا التصحيح يحل مشكلة الإدخال المحلي التقليدي الذي يعتاده العملاء عند تعبئة نماذج الشحن.</li>
    <li>النمط الثاني <code>/^5[0-9]{8}/
    → يطابق أرقامًا تبدأ بـ 5 مباشرة (مثال: 512345678). يُضاف 966 فقط → 966512345678. بعض الأنظمة أو المتصفحات تقوم أحيانًا بحذف الصفر تلقائيًا، وهذا السطر يحمي عملية الإرسال من الفشل في تلك الحالة.

هذا المنطق يغطي أغلب الصيغ الشائعة في السعودية، حيث يدخل العملاء أرقامهم محليًا دون كود الدولة. بدون هذا التصحيح، تفشل الرسالة لأن WhatsApp API يتطلب صيغة دولية كاملة (معرف JID ينتهي بـ @s.whatsapp.net). التكلفة الحقيقية لعدم وجود هذا المنطق هي فقدان القدرة على التواصل مع حوالي 40% من العملاء الذين يخطئون في كتابة الصيغة الدولية.

بعد التصحيح، يُبنى الـ JID وهو المعرف الفريد للمستلم في شبكة واتساب:

$jid = $phone . "@s.whatsapp.net";

ثم يُشكّل رابط الـ GET الكامل للتواصل مع خادم Whats360:

$params = [
'token' => $token,
'instance_id' => $instance_id,
'jid' => $jid,
'msg' => $message
];
$url = 'https://crm.whats360.live/api/v1/send-text?' . http_build_query($params);

استخدام http_build_query يضمن تشفير الرسالة (URL Encoding) بشكل صحيح، مما يمنع حدوث أخطاء عند إرسال نصوص تحتوي على رموز خاصة أو إيموجي، وهو أمر أساسي في رسائل واتساب العصرية. أخيرًا، يتم الإرسال باستخدام wp_remote_get مع timeout 10 ثوانٍ – اختيار مناسب لأن الاستجابة من Whats360 عادة سريعة للغاية، ويمنع هذا التوقيت تعليق السكريبت لفترات طويلة في حال وجود مشكلة مؤقتة في الشبكة.

إدارة الإعدادات وحفظها في ووردبريس

الكود الثاني يستخدم add_action('init', ...) كطريقة سريعة لحفظ الإعدادات في قاعدة البيانات:

update_option('whats360_new_token', 'ضع_هنا_التوكن_الخاص_بك');
update_option('whats360_instance_id', 'ضع_هنا_معرف_النسخة');
update_option('whats360_admin_phone', 'ضع_هنا_رقم_المدير');

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

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

معالجة الأرقام السعودية: تحديات وحلول

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

  • بعض العملاء يكتبون 05xxxxxxxx بدافع العادة المحلية.
  • آخرون يكتفون بـ 5xxxxxxxx لأنهم يعتقدون أن النظام ذكي بما يكفي.
  • البعض يضيف +966 أو 00966، وهذه الصيغ إذا لم تُعالج قد تؤدي لمضاعفة كود الدولة (966966) مما يفسد الرقم تمامًا.
  • هناك أيضًا حالات استخدام أرقام دولية لعملاء مقيمين في السعودية، وهذا يتطلب مرونة إضافية في الكود.

الكود الحالي يغطي حالتين شائعتين فقط، وهما الأكثر تكرارًا بنسبة تتجاوز 90% في السعودية. ولكن للوصول إلى دقة 100% وتجنب أي فقدان للبيانات، يجب علينا كمطورين التفكير في الحالات الشاذة. التحقق من طول الرقم النهائي بعد عملية التنظيف والتعديل هو المعيار الذهبي؛ فالرقم السعودي الدولي الصحيح يجب أن يتكون من 12 رقمًا يبدأ بـ 966. أي نتيجة تخرج عن هذا الإطار تعني أن العميل أدخل رقمًا خاطئًا أو أن منطق التصحيح يحتاج لتطوير إضافي.

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

دمج Whats360 ضمن أنظمة التجارة الإلكترونية وأتمتة التسويق

في 2026، لم يعد التواصل عبر واتساب مجرد “رسالة ترحيب”، بل أصبح المحرك الرئيسي لعمليات “التحويل” (Conversion). التكامل بين WooCommerce والـ API الخاص بـ Whats360 يفتح أبوابًا للأتمتة لم تكن متاحة بسهولة من قبل. استدعاء الدالة البرمجية send_w360_msg يمكن أن يتم في لحظات فارقة في رحلة العميل:

  • استخدام woocommerce_new_order: لإرسال فاتورة وتأكيد فوري للطلب، مما يقلل من قلق العميل ويدفعه للثقة في المتجر.
  • التكامل مع woocommerce_order_status_changed: لإبلاغ العميل بمجرد شحن الطلب أو خروجه للتوصيل، مما يقلل من ضغط المكالمات على قسم خدمة العملاء للاستفسار عن موعد الوصول.
  • برمجة مهام مجدولة (Cron Jobs): لإعادة استهداف العملاء الذين تركوا سلاتهم دون إتمام الشراء، وهي واحدة من أعلى الاستراتيجيات ربحية في الوقت الحالي.

الاعتماد على لوحة تحكم Whats360 يوفر ميزات تنافسية للمشاريع النامية:

  • قدرة هائلة على الإرسال الجماعي المنظم دون التعرض للحظر، بفضل الالتزام بالمعايير الرسمية.
  • أنظمة “الشات بوت” التي ترد على الأسئلة المتكررة (مثل: أين طلبي؟ أو ما هي طرق الدفع؟) مما يوفر ساعات من وقت العمل البشري.
  • تقارير دقيقة توضح للتاجر متى تم استلام الرسالة ومتى قُرئت، وهي بيانات ذهبية لتحسين استراتيجيات البيع.

هذا التوجه نحو الأتمتة الكاملة هو ما يميز المتاجر التي تحقق نموًا بمعدل 3x في عام 2026 مقارنة بمن لا يزالون يعتمدون على الإرسال اليدوي المجهد وغير الدقيق.

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

أفضل الممارسات والاعتبارات الأمنية

عند التعامل مع الـ APIs في بيئة حساسة مثل ووردبريس، الأمان ليس خيارًا. التوكن الخاص بك هو مفتاح الوصول لكل محادثات عملائك، لذا فإن حمايته هي الأولوية القصوى. من واقع تجاربي في تأمين الأنظمة، لا ينبغي أبدًا ترك التوكنات في ملفات القالب البرمجية القابلة للوصول بسهولة.

  • حماية البيانات: يفضل تخزين المفاتيح الحساسة في ملف wp-config.php بعيدًا عن قاعدة البيانات، أو استخدام حقول مشفرة إذا كنت تبني إضافة مخصصة.
  • معالجة أخطاء الشبكة: إن إضافة فحص بسيط للاستجابة باستخدام is_wp_error يمنع موقعك من الانهيار في حال تعطل الاتصال بالخارج. النظام القوي هو الذي يعرف كيف يفشل بصمت ودون إزعاج المستخدم النهائي.
$response = wp_remote_get($url, ['timeout' => 10]);
if (is_wp_error($response)) {
error_log('Whats360 Connection Error: ' . $response->get_error_message());
return false; // فشل الإرسال لكن الموقع يعمل بسلام
}
  • الامتثال لسياسات الخصوصية: في سوق 2026، القوانين صارمة. تأكد دائمًا من الحصول على موافقة العميل (Opt-in) قبل إرسال رسائل تسويقية لتجنب التبليغات التي قد تؤدي لإغلاق رقمك الرسمي.
  • إدارة الأداء: بالنسبة للمتاجر التي ترسل آلاف الرسائل، ننصح باستخدام نظام “الطابور” (Queueing) بحيث يتم إرسال الرسائل في الخلفية دون التأثير على سرعة تحميل صفحة إتمام الطلب للعميل.

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

شاهد هذا الشرح العملي من قناة Affiegy:

شاهد هذا الشرح العملي من قناة Affiegy:

مقالات ذات صلة

الناشر:

محمد فارس

اترك تعليقاً

زر الذهاب إلى الأعلى