الويب هوك (الجديد)

ما هو الويب هوك؟

الويب هوك هي طريقة تُمكّن تطبيقًا من إرسال بيانات في الوقت الحقيقي تلقائيًا إلى تطبيق آخر عند حدوث حدث معين. وهي تعمل عن طريق إجراء طلب HTTP POST إلى عنوان URL مُعرف مسبقًا (يسمى نقطة نهاية الويب هوك). يتيح هذا للأنظمة البقاء محدثة دون الحاجة إلى فحص يدوي. تُستخدم الويب هوكات عادةً لإرسال تحديثات حالة تسليم الرسائل.



في MSG91، يمكنك إضافة عنوان URL الخاص بالويب هوك واستقبال تقارير التسليم الفورية لرسائلك من نوع SMS وWhatsApp وRCS، وكذلك البريد الإلكتروني والمكالمات الصوتية.


يجب أن يستجيب رد الاستدعاء (callback) الخاص بعنوان URL للويب هوك إلى MSG91 خلال 8000 مللي ثانية (8 ثوانٍ). إذا لم يستجب عنوان URL خلال هذه الفترة، سنقوم بإعادة المحاولة من جانبنا، وسيكون الحد الأقصى لإعادة المحاولة حتى 4 مرات.

يرجى الملاحظة: بسبب آلية إعادة المحاولة هذه، قد تستقبل استدعاءات متعددة (callbacks) على الويب هوك الخاص بك.

لماذا تختار الويب هوك (الجديد) بدلاً من الويب هوك (القديم)؟

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

  1. معلمات قابلة للتخصيص: اختر فقط المعلمات المحددة التي تريد استلامها، مما يقلل حجم الحمولة ويقضي على البيانات غير الضرورية.

  2. تصفية نوع الحدث: حدد أنواع الأحداث المحددة التي تود مراقبتها، ولا مزيد من الفوضى الناجمة عن الأحداث غير ذات الصلة.

  3. إدارة موحدة: إدارة الويب هوكات لجميع الخدمات (SMS وWhatsApp وRCS والبريد الإلكتروني والمكالمات الصوتية) من واجهة واحدة، مما يبسط التكوين والصيانة.

كيفية إعداد الويب هوك على MSG91

  1. اذهب إلى لوحة تحكم MSG91.

  2. افتح الميكروسيرفيس (SMS/البريد الإلكتروني/WhatsApp/المكالمات الصوتية/RCS).

  3. اذهب إلى الويب هوك (الجديد) من الشريط الجانبي الأيسر.



راجع المقالات التالية لإعداد الويب هوك للخدمة التي تريدها.


لـ SMS: https://msg91.com/help/webhook-new/how-to-receive-sms-delivery-reports-via-webhook-new

لـ WhatsApp: https://msg91.com/help/webhook-new/how-to-receive-whatsapp-delivery-reports-via-webhook-new


للمكالمات الصوتية: https://msg91.com/help/webhook-new/how-to-receive-voice-call-reports-via-webhook


لـ RCS: https://msg91.com/help/webhook-new/how-to-receive-rcs-delivery-reports-via-webhook-new


لـ SendOTP: https://msg91.com/help/webhook-new/how-to-receive-otp-delivery-reports-via-webhook


لـ البريد الإلكتروني: https://msg91.com/help/webhook-new/how-to-receive-email-delivery-reports-via-webhook-new


لإشعارات الدفع: https://msg91.com/help/webhook-new/how-to-receive-push-notifications-reports-via-webhook


ميزة الإيقاف التلقائي:


لدينا ميزة الإيقاف التلقائي في الويب هوك. إذا أعاد عنوان URL للويب هوك المُكوَّن استجابة برمز 4XX أو 5XX، فسيتم إيقاف الويب هوك تلقائيًا.


لمعرفة المزيد عن ميزة الإيقاف التلقائي، يرجى مراجعة هذا الرابط: https://msg91.com/help/webhooks/webhook-auto-pause-simple-explanation