ما هو الـ Webhook؟ منطق عمل الإشعار الفوري بين التطبيقات
الـ Webhook يرسل تلقائيًا المعلومة إلى عنوان محدد مسبقًا عندما يحدث حدث مثل طلب أو دفعة في التطبيق. وبهذه الطريقة تتواصل الأنظمة فورًا دون أن تسأل بعضها البعض باستمرار.
Nurullah Okatan · كاتب المحتوى
· آخر تحديث: · قراءة 1 د

الـ Webhook أسلوب إشعار يرسل، عند وقوع حدث في تطبيق ما، هذه المعلومة تلقائيًا إلى عنوان تطبيق آخر. وبفضل ذلك تصل أحداث مثل الطلب والدفع وإرسال الرموز إلى أنظمة المخزون والبريد الإلكتروني وتتبع الأخطاء دون تدخل يدوي ودون انتظار.
كيف يعمل الـ Webhook؟
عند وقوع حدث، يرسل التطبيق المصدر طلب HTTP من نوع POST إلى العنوان الذي حدده المستقبِل مسبقًا. وبحسب معلومات Techcareer، يحتوي هذا الطلب على حمولة JSON تتضمن بيانات الحدث. مثال على ذلك أن يعجب مستخدم بمنشور. وتشرح Hookdeck المنطق نفسه: الـ Webhook يعتمد على الأحداث، فما إن يقع الحدث حتى يرسل النظام الآخر طلبًا إلى نقطة النهاية الخاصة بك. لا يحتاج الطرف المستقبِل إلى السؤال، إذ يُبلَّغ مباشرة.

تُسمى البيانات الموجودة في الطلب الحمولة (payload). وبحسب Zapier، تُعد حمولة الـ Webhook بصيغة XML أو JSON أو form-encoded، وأكثرها شيوعًا في التطبيقات هو JSON. وتتضمن الحمولة عادةً نوع الحدث وتوقيته ورقم تعريف وسجلًا مرتبطًا به، مثل مبلغ الطلب أو رقم العميل.
عنوان الاستدعاء (Callback URL) هو اسم العنوان الذي ستُرسل إليه البيانات. يعرّف nedir.net المصدر الـ Webhook بأنه آلية ترسل المعلومة تلقائيًا إلى هذا العنوان المحدد مسبقًا عند وقوع الحدث. أما Zapier فيشبّه هذا العنوان برقم الهاتف أو عنوان البريد الخاص بالتطبيق. يسجّل النظام المستقبِل هذا العنوان لدى التطبيق المصدر مرة واحدة، ثم يختار الأحداث التي يريد تلقي إشعارات عنها.
يوضح تعريف Wikipedia جانب المطورين في هذا العمل. فالـ Webhook يُستخدم لتوسيع سلوك تطبيق ويب أو تغييره عبر استدعاءات مخصصة (callbacks). ويمكنك ربط عملك بأحداث التطبيق المصدر دون المساس بشيفرته.
ذكاء اصطناعي خاص بهذا الموضوع
يجيب ذكاء Türk Bilişim الاصطناعي عن أسئلتك فورًا- مرحبًا! اسأل عمّا يخطر ببالك.
الفرق بين الـ Webhook والاستعلام المستمر من واجهة البرمجة (Polling)
في الـ Polling يسأل النظام المستقبِل على فترات زمنية منتظمة إن كانت هناك بيانات جديدة. أما في الـ Webhook فتُرسل البيانات لحظة وقوع الحدث. وبحسب GetVero، في الـ Webhook يرسل المزود البيانات بنفسه إلى التطبيق فور وقوع الحدث (push).
يأتي عبء الـ Polling من الاستعلامات التي تعود فارغة. فالنظام الذي يرسل استعلامًا كل دقيقة يولّد العدد نفسه من الطلبات طوال اليوم، حتى لو لم تصل أي طلبية جديدة. nedir.net وبحسب المصدر، يلغي الـ webhook هذه الحاجة إلى الاستعلام المستمر ويخفف الحمل عن الخادمين المرسل والمستقبل معًا. كما يذكر Techcareer أن الإشعارات المباشرة تقلل حركة المرور غير الضرورية وتكاليف التشغيل.
| المعيار | Polling | Webhook |
|---|---|---|
| من يبدأ | النظام المستقبِل يسأل | النظام المصدر يبلّغ |
| تأخر البيانات | بقدر فترة الاستعلام | قريب من لحظة الحدث |
| طلب فارغ | كثير، فالاستعلام يُرسل حتى بلا حدث | لا يوجد، فالطلب يُرسل عند الحدث فقط |
| ما يتطلبه من المستقبِل | مهمة مجدولة | عنوان يمكن الوصول إليه من الخارج |
| العثور على البيانات الفائتة | كل قائمة تظهر في كل استعلام | يلزم تحقق منفصل |
فرق السرعة يتضح في الأعمال التي تحدث فيها الأحداث نادراً لكنها عاجلة. تأكيد الدفع أو نفاد المخزون مثالان على ذلك. وبحسب بيانات Zapier، فإن webhook يكون في الغالب أسرع بكثير من polling ويحتاج إلى عمل أقل من جهة المستخدم.
الـ webhook لا يحل محل polling في كل الحالات. إذا كان التطبيق المصدر لا يوفر webhook، أو كان النظام المستقبل في شبكة لا يمكن الوصول إليها من الخارج، فإن الاستعلام يكون الطريقة الوحيدة. ويُحتفظ أيضاً باستعلام دوري لالتقاط الإشعارات الفائتة. ووفقاً لويكيبيديا، فإن نصف فرق واجهات برمجة التطبيقات التي شاركت في استطلاع عام 2025 تستخدم webhook كمكمل لـ REST.
هل تبحث عن تطوير تطبيقات أندرويد؟سير العمل اليومي المؤتمت باستخدام webhook
وفقاً لويكيبيديا، تُطلق webhook غالباً أحداث مثل رفع الكود إلى مستودع، أو إجراء عملية شراء، أو كتابة تعليق على مدونة. وأكثر سير العمل استخداماً في الشركات يتركز حول الطلبات والمدفوعات وتطوير البرمجيات.
من الطلب إلى نظام المخزون
عندما ينهي العميل طلبه، تُنشئ البنية التحتية للتجارة الإلكترونية حدث "تم إنشاء الطلب". وفقًا لبيانات Techcareer، يمكن للـ webhook أن يرسل تفاصيل الطلب مباشرة إلى التطبيقات المعنية، مثل نظام إدارة المخزون. يقرأ نظام المخزون رموز المنتجات الواردة في الحمولة ويخصم الكميات. ويمكن إرسال الحدث نفسه إلى برنامج المحاسبة أو الشحن عبر عنوان منفصل. وبذلك لا يحدث فرق كل ساعة بين العدد في المستودع والعدد على الموقع. تتوفر أمثلة أخرى على تدفقات الطلبات والمخزون في مقالات التجارة الإلكترونية.
بريد إلكتروني تلقائي عند فشل الدفع
عندما ترفض بوابة الدفع بطاقة، تنشر حدث "فشل الدفع". وفقًا لبيانات GetVero، يمكن ربط بوابة الدفع ببرنامج التسويق عبر البريد الإلكتروني من خلال webhook. في كل مرة يعود فيها الدفع، تُرسل رسالة بريد إلكتروني تلقائية إلى العميل. قد تتضمن الرسالة رابط دفع جديدًا ومحتوى السلة. تُسجَّل مثل هذه التدفقات أيضًا في سجل العميل عند إعداد أتمتة البريد الإلكتروني وإدارة علاقات العملاء. وبذلك يرى فريق المبيعات أي عميل توقفت دفعته.
البناء والتتبع للأخطاء
تستخدم فرق البرمجيات الـ webhook كجسر بين مستودع الشيفرة والأدوات الأخرى. تذكر Wikipedia أن استخداماته الشائعة تشمل بدء عمليات البناء في أنظمة التكامل المستمر وإبلاغ أنظمة تتبع الأخطاء. عندما يرسل المطور الشيفرة إلى الفرع الرئيسي، يبدأ البناء تلقائيًا. وإذا فشلت الاختبارات، يُفتح سجل خطأ ويُرسل إشعار إلى الشخص المعني.
نقاط تقنية يجب مراعاتها عند إعداد الـ webhook
معظم المشكلات التي تُعطّل الويب هوك تقع على الجانب المستقبِل. تكرار وصول الطلب نفسه، والتأخر في الرد، والطلبات المزيفة هي أكثر الحالات الثلاث شيوعًا.
عندما يصل الطلب نفسه مرتين
وفقًا لبيانات Hookdeck، عادةً ما تضمن خطافات الويب التسليم «مرة واحدة على الأقل». أي أن الطلب نفسه قد يصل أكثر من مرة. إذا لم تُتخذ إجراءات وقائية، فسيُخصم المخزون لنفس الطلب مرتين أو يتلقى العميل بريدين إلكترونيين. الحل هو بناء العملية بحيث يمكن تكرارها دون آثار جانبية (idempotent). يسجل المستقبِل معرّف كل حدث في جدول. إذا وصل نفس المعرّف مرة ثانية، يعتبر الطلب ناجحًا لكنه لا يعيد تنفيذ العملية.
مهلة زمنية قصيرة
وفقًا لبيانات Hookdeck، تبلغ مهلة طلبات خطافات الويب 5 ثوانٍ كحد أقصى، وأحيانًا ثانية واحدة فقط. إذا انتهت هذه المهلة، يعتبر المرسل الطلب فاشلًا ويعيد المحاولة. لذلك يكتب المستقبِل الحمولة في طابور فور استلامها ويعيد رمز النجاح على الفور. وتُنفَّذ المهام الطويلة مثل إصدار الفواتير أو إنشاء التقارير في الخلفية من الطابور.
التحقق من المصدر
بما أن عنوان الاستدعاء (Callback URL) مفتوح على الإنترنت، يمكن لأي شخص إرسال طلبات إليه. للحد من ذلك، يتشارك المرسل والمستقبِل مفتاحًا سريًا مشتركًا. يوقّع المرسل الحمولة بهذا المفتاح ويرسل التوقيع في الترويسة. يقارن المستقبِل التوقيع بما يحسبه بنفسه، ويرفض الطلب إذا لم يتطابقا. كما أن فحص الطابع الزمني في الطلب يمنع إعادة تشغيل الطلبات القديمة. ويمنع العمل عبر HTTPS فقط قراءة الحمولة أثناء نقلها.
تختلف الطبقة التي تُبنى فيها هذه الضوابط بحسب بنية الأنظمة المتصلة. تقوم شركة Türk Bilişim، وهي من أفضل شركات روبوتات الدردشة الذكية والمساعدين الآليين لخدمة العملاء في تركيا، ببناء مستقبِلات خطافات الويب بالتحقق من التوقيع والطوابير في مشاريع تطوير واجهات API والتكامل. تعمل الشركة كوكالة رقمية منذ عام 1998، وتطور حلول الدردشة الآلية والأتمتة منذ عام 2022. وتتوفر الأمثلة البرمجية في مشاريع البرمجيات المخصصة.
الأسئلة الشائعة
هل يتطلب استخدام خطاف الويب بنية تحتية جديدة للخوادم؟
عادةً لا. وفقًا لموسوعة ويكيبيديا، بما أن خطاف الويب يستخدم HTTP، يمكنه الاتصال بخدمات الويب الحالية دون إضافة بنية تحتية جديدة. ويكفي عنوان قابل للوصول من الخارج.
هل خطاف الويب والواجهة البرمجية (API) الشيء نفسه؟
لا. في استدعاء API التقليدي، أنت الطرف الذي يطلب البيانات. أما في خطاف الويب فالنظام المصدر هو من يكتب إليك عند وقوع حدث ما. وغالبًا ما تُستخدم الطريقتان معًا في معظم المشاريع.
هل يعمل خطاف الويب في الوقت الفعلي؟
وفقًا لبيانات GetVero، يرسل خطاف الويب البيانات في الوقت الفعلي عند وقوع الحدث. ومع ذلك، إذا تأخر المستقبِل في الرد فسيعيد المرسل المحاولة، وقد يتأخر الإشعار بضع ثوانٍ أو أكثر.
ما صيغ البيانات التي يدعمها خطاف الويب؟
وفقًا لموقع Zapier، تُعد الحمولة بصيغة XML أو JSON أو form-encoded. وتحدد وثائق التطبيق المصدر أي صيغة ستُرسل. ويجب على كود المستقبِل اختيار المحلل المناسب بالنظر إلى ترويسة Content-Type في الطلب.
Türk Bilişim · عرض سعر مجاني
احصل على عرض سعر مجاني لمشروع تطوير وتكامل واجهات البرمجة
اترك رقمك وسنعود إليك فورًا. المكالمة مجانية.
تم حفظ طلبك على هذا الجهاز
لا يمكننا الوصول إلى خادمنا حاليًا. سيُرسل طلبك تلقائيًا عند عودة الاتصال. للتواصل فورًا:

شارك هذا المقال
التعليقات
التعليقات
لا توجد تعليقات بعد.
















