كبسولة الإجابة المباشرة (Direct Answer Box)

الويب هوك في منصة Whats360 هو قناة اتصال برمجية غير متزامنة تعتمد على بروتوكول HTTP POST لنقل البيانات اللحظية بين المنصة والأنظمة الخارجية دون الحاجة للاستعلام الدوري (Polling). يعمل النظام عبر مسارين هندسيين رئيسيين: استقبال البيانات (Incoming Webhook / HookURL) لاستقبال كائنات JSON من منصات التجارة مثل Shopify و WooCommerce ومعالجة حقولها لإرسال رسائل واتساب آلية فورية للعملاء، وإرسال البيانات (Outgoing Webhook) لبث أحداث الواتساب الميدانية (وصول رسالة، إرسال رسالة، فشل التسليم) لحظياً نحو سيرفرات المؤسسة وأنظمة الـ CRM لمزامنة المحادثات وتحديث السجلات المركزية.

معمارية الحدث اللحظي والتخلص من فخ الاستعلام الدوري (Polling)

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

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

تتجاوز الأنظمة الموجهة بالأحداث (Event-Driven Architecture) هذا الاختناق التقني تماماً عبر بروتوكول الويب هوك (Webhook). الويب هوك يمثل خط أنابيب اتصال عكسي (Reverse API) يتم تفعيله لحظياً بدفع كائن البيانات (HTTP POST Request) المحمل بصيغة JSON المعيارية في أجزاء من الثانية فور وقوع الحدث المستهدف داخل المتجر أو النظام السحابي.

تعمل لوحة التحكم الخاصة بالويب هوك في منصة Whats360 كطبقة وسيطة متطورة (Intelligent Middleware & Trigger Engine)؛ حيث تتولى فحص حزم البيانات الواردة، والتحقق من مصادقة المصدر وسلامة الترويسات الأمنية، واستخلاص المتغيرات، ثم توجيهها بصورة دقيقة إما إلى أجهزة واتساب الافتراضية للبث الفوري، أو تصديرها إلى منصات المؤسسات الخارجية المتكاملة مثل Toggaar أو خوادم إدارة العمليات البرمجية المخصصة عبر Beincode.

التشريح الفني لصفحة إنشاء ويب هوك جديد في Whats360

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

معمارية إرسال البيانات (Outgoing Webhook) لبث أحداث واتساب

يُمثل مسار إرسال البيانات (Outgoing Webhook) المحور البرمجي المسؤول عن مزامنة عالم واتساب الحي مع أنظمة المؤسسة الرقمية. بدلاً من عزل محادثات الموظفين مع العملاء داخل الهواتف، يستمع هذا المسار إلى كافة الأنشطة الصادرة والواردة ويدفع بها فوراً نحو قواعد بياناتك أو منصات مثل Odoo و Zoho و HubSpot.

أحداث النظام المتاحة للرصد والفلترة

• حدث رسالة واردة (Incoming Message Trigger): يُطلق لحظة استلام رسالة جديدة من أي مستخدم، متضمناً النص الكامل، والوسائط المتعددة المرفقة، وبيانات المتصل، والوقت الزمني. يُستخدم لتشغيل ردود الذكاء الاصطناعي أو فتح تذاكر دعم فني فورية.
• حدث رسالة صادرة (Outgoing Message Trigger): يُطلق فور إرسال رسالة من الحساب (سواء يدوياً عبر موظف أو آلياً عبر روبوت دردشة)، والهدف منه هو عمل مزامنة لحظية لسجلات المحادثة داخل ملف العميل بالـ CRM لمنع تشتت سياق الخدمة.
• حدث فشل الإرسال (Failed Dispatch Event): رصد تقني دقيق يطلق عندما تتعذر محاولة تسليم الرسالة بسبب أرقام غير مسجلة بالخدمة أو مشاكل في الاتصال؛ مما يسمح للنظام بالتحول التلقائي للبدائل الاحتياطية وإرسال تنبيه SMS طارئ عبر بوابة مثل SMS Control.
• حدث انتهاء الاشتراك (Subscription Expiration Event): تنبيه برمجي إداري موجه لمهندسي البنية التحتية لإخطارهم بدنو موعد انتهاء جلسات الأجهزة الافتراضية لمنع انقطاع الخدمات الحيوية في أوقات الذروة.

مصفوفة المتغيرات الديناميكية النشطة المتاحة للاستخدام

توفر المنصة مجموعة من المعرفات والحقول الديناميكية التي يمكن تضمينها داخل الرسائل واستخراجها من كائنات الأحداث الصادرة:

هيكل كائن JSON الصادر من المنصة (Outgoing Payload Example)

{
  "event": "message_received",
  "instance_id": "inst_prd_8849201",
  "data": {
    "message_id": "wamid.HBgLMjAxMjM0NTY3ODkwFQIAEhggM0E2QjY5RERDQTM4",
    "chat_jid": "201234567890@s.whatsapp.net",
    "phone": "201234567890",
    "sender_name": "كريم عبد العزيز",
    "message": "هل يتوفر لديكم مقاس 44 من هذا المنتج؟",
    "media_url": "https://storage.whats360.live/media/uploads/2026/09/item_sample.jpg",
    "timestamp": 1788534800
  },
  "metadata": {
    "source": "Whats360 Engine",
    "version": "vmain.main.544"
  }
}

مقارنة المعمارية: الويب هوك المباشر مقابل تطبيقات التكامل الوسيطة

معمارية استقبال البيانات (Incoming Webhook / HookURL)

في مسار استقبال البيانات (Incoming Webhook / HookURL)، تتحول المنصة إلى خادم استماع نشط يولد لكل جهاز رابط نقطة نهاية فريد ومستقل. تقوم الأنظمة والمتاجر الخارجية بدفع الأحداث نحو هذا الرابط، حيث يقوم محرك مطابقة الحقول (Field Mapping Engine) بالتقاط البيانات واستخلاصها لإعداد رسالة المعاملة المعتمدة وتوجيهها مباشرة إلى الرقم المستهدف.

مثال طلب الاستقبال البرمجي (Incoming HTTP Request)

POST /api/hookurls/in/c22b7e1ff26da5b10ee2d5060de3cd7e HTTP/1.1
Host: whats360.live
Content-Type: application/json
X-Hook-Secret: AppSecretToken_SecureKey_2026

{
  "phone": "+966501234567",
  "name": "سارة الشمري",
  "message": "أهلاً بك سارة! تم استلام طلبك رقم 99120 بنجاح، وجاري تجهيز الشحنة في مستودعاتنا."
}

استجابة السيرفر المرجعية المرتجعة فوراً

{
  "status": "success",
  "message": "Webhook received successfully"
}

تثبت الإحصائيات التشغيلية أن أكثر من 30% من طلبات الدفع عند الاستلام يتم إلغاؤها أو رفض تسلمها بسبب عدم التحقق اللحظي من جدية المشتري وصحة عنوانه. من خلال ربط متجرك عبر HookURL، يمكنك أتمتة إرسال رسالة تفاعلية فورية للعميل بمجرد إتمام الطلب ليؤكد رغبته بضغطة زر واحدة. هذا الإجراء وحده كفيل بخفض المرتجعات بنسبة تفوق 35% وتوفير آلاف الجنيهات المهدرة في تكاليف الشحن.

تفعيل نظام تأكيد الطلبات التلقائي

الدليل التطبيقي لربط متجر Shopify برمجياً وفنياً

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

التحقق من التوقيع الرقمي ومطابقة هيدر X-Shopify-Hmac-SHA256

تستخدم شوبيفاي توقيعاً مشفراً للتحقق من سلامة وأصالة الرسائل المرسلة؛ حيث تقوم بحساب قيمة التجزئة لحمولة الـ JSON باستخدام المفتاح المشترك عبر خوارزمية HMAC-SHA256 وترسل الناتج المشفر داخل الترويسة X-Shopify-Hmac-SHA256. تقوم منصة Whats360 بمطابقة هذه الترويسة تلقائياً عند إدخال المفتاح السري لمتجرك لضمان عدم قبول أي حزم غير صادرة من خوادم Shopify الرسمية.

نموذج حمولة بيانات شوبيفاي المستلمة (Shopify Payload Structure)

{
  "id": 820982911946154508,
  "order_number": 1234,
  "total_price": "199.00",
  "currency": "SAR",
  "financial_status": "paid",
  "customer": {
    "first_name": "أحمد",
    "last_name": "المنصور",
    "phone": "+201234567890",
    "email": "ahmed@example.com"
  },
  "billing_address": {
    "phone": "+201234567890",
    "city": "الرياض"
  }
}

الدليل التطبيقي لربط متجر WooCommerce برمجياً وفنياً

يقدم نظام WooCommerce المعتمد على منصة WordPress حرية برمجية مطلقة، لكنه يتطلب ضبطاً دقيقاً لخيارات الاتصال وتأمين المفاتيح ومراقبة سجلات التسليم لتفادي أي حجب صادر من استضافة الموقع.

نموذج حمولة بيانات ووكومرس المستلمة (WooCommerce Payload)

{
  "id": 727,
  "status": "processing",
  "total": "150.00",
  "currency": "EGP",
  "billing": {
    "first_name": "سارة",
    "last_name": "فهمي",
    "phone": "+201012345678",
    "email": "sara.fahmy@example.com"
  },
  "payment_method_title": "الدفع عند الاستلام (COD)"
}

كتالوج القوالب الجاهزة لمنظومة التكامل في Whats360

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

هندسة الأمان وحل المشكلات البرمجية (Troubleshooting)

قاعدة الـ 5 ثوانٍ وحماية نقاط النهاية من التعطيل الآلي

تشترط خوارزميات كل من Shopify و WooCommerce استلام كود نجاح HTTP 200 OK خلال 5 ثوانٍ كحد أقصى. في حال فشل الخادم في الرد خلال هذه المهلة بسبب بطء قواعد البيانات أو بطء واجهات واتساب، تقطع المنصات الاتصال وتبدأ بمحاولات إعادة الإرسال المتكررة (Retries)، وبمجرد تراكم الفشل تقوم المنصات بتعطيل الويب هوك وإلغائه تلقائياً (Auto-Invalidation). تمنع منصة Whats360 هذه المشكلة جذرياً عبر فصل طبقة تلقي الطلب عن طبقة تنفيذه عبر الطوابير غير المتزامنة.

صياغة الأرقام وفق المعيار الدولي القياسي E.164

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

فحص الترويسة الأمنية برمجياً في خادم العميل (Express.js Example)

إذا كنت تستقبل أحداث مسار Outgoing على خادمك الخاص، يوضح النموذج البرمجي التالي كيفية التحقق من الترويسة الأمنية X-Hook-Secret باستخدام Node.js و Express:

const express = require('express');
const app = express();

app.use(express.json());

app.post('/api/webhook/whatsapp', (req, res) => {
    const incomingSecret = req.headers['x-hook-secret'];
    const systemSecret = process.env.WHATS360_SHARED_SECRET;

    // فحص صحة الترويسة الأمنية
    if (!incomingSecret || incomingSecret !== systemSecret) {
        return res.status(401).json({ status: 'error', message: 'Unauthorized Request' });
    }

    const eventPayload = req.body;
    console.log('Received valid event:', eventPayload.event);

    // إرجاع كود النجاح فوراً لمنع حدوث مهلة اتصال
    res.status(200).json({ status: 'success', received: true });
});

app.listen(3000, () => console.log('Webhook Listener running on port 3000'));

الأسئلة الشائعة حول إعدادات الويب هوك (FAQ)

قائمة التدقيق البرمجي قبل الإطلاق في بيئة الإنتاج (Checklist)