Webhooks
ترسل خدمة webhook الأحداث إلى خادمك لحظة وقوعها: رسالة وصلت أو فشلت، أو رد وصل، أو هاتف انقطع. فبدلًا من أن يسأل خادمك الواجهة البرمجية عن الجديد، يصله طلب POST موقّع خلال ثوانٍ. المحتوى والترويسات وجدول إعادة المحاولة في دليل Webhooks.
إضافة نقطة نهاية
Section titled “إضافة نقطة نهاية”-
افتح Webhooks في الشريط الجانبي تحت المطوّرون.
افتح Webhooks. -
انقر إضافة webhook. إن بلغت باقتك حدها من نقاط webhook، يظهر الزر باهتًا ويذكر السبب؛ راجع الباقة والاستخدام.
انقر إضافة webhook. -
أدخل عنوان نقطة النهاية. يجب أن يكون عنوانًا عامًا يبدأ بـ
https://؛ وتُرفض العناوين الخاصة والمحلية. وتحت الأحداث حدد الأحداث التي تريدها. تكونmessage.deliveredوmessage.failedوmessage.receivedمحددة مسبقًا، ويحدد تحديد الكل كل الأحداث. ثم انقر إضافة نقطة النهاية.أدخل العنوان واختر الأحداث وانقر إضافة نقطة النهاية. -
انسخ سر التوقيع (يبدأ بـ
whsec_) واحفظه مع إعدادات خادمك، ثم انقر حفظته. لا يظهر إلا مرة واحدة. يستخدمه خادمك للتأكد من أن كل طلب أتى فعلًا من SMSFabric.انسخ سر التوقيع.
إرسال حدث تجريبي
Section titled “إرسال حدث تجريبي”-
انقر نقطة النهاية في القائمة.
افتح نقطة النهاية. -
انقر إرسال حدث تجريبي. يخرج تسليم تجريبي موقّع مثل أي تسليم حقيقي، ويظهر تحت أحدث عمليات التسليم بعد لحظة. استخدمه للتأكد من أن نقطة النهاية ترد بـ
2xxوأن فحص التوقيع ينجح. ويوقف مفتاح التسليم مفعّل نقطة النهاية مؤقتًا ويعيد تشغيلها دون حذفها.انقر إرسال حدث تجريبي.
قراءة عمليات التسليم وإعادة إرسال الفاشل منها
Section titled “قراءة عمليات التسليم وإعادة إرسال الفاشل منها”كل صف تحت أحدث عمليات التسليم هو حدث واحد أُرسل إلى نقطة النهاية هذه.
| العمود | يعرض |
|---|---|
| الحدث | نوع الحدث، مثل message.delivered، وتحته وقت وقوعه |
| النتيجة | succeeded أو pending (إعادة محاولة مجدولة) أو failed، مع رمز HTTP الذي ردت به نقطة النهاية، وتحتها عدد المحاولات. يُعاد التسليم مع تباعد متزايد لنحو 24 ساعة، بثماني محاولات إجمالًا. |
-
إن كانت نقطة النهاية متوقفة أو فيها خلل، فأصلحها أولًا، ثم انقر زر إعادة الإرسال في طرف الصف الفاشل.
انقر إعادة الإرسال على التسليم الفاشل. -
يعود التسليم إلى الطابور ويخرج خلال ثوانٍ. ويحمل معرّف الحدث نفسه، فالخادم الذي يزيل التكرار بالمعرّف لن يعالجه مرتين.
عاد التسليم إلى الطابور.
حذف نقطة نهاية
Section titled “حذف نقطة نهاية”افتح نقطة النهاية وانقر حذف نقطة النهاية، ثم اكتب كلمة التأكيد حذف. تُلغى إعادات المحاولة المعلقة ويتوقف سر التوقيع عن العمل. ولإيقاف التسليم مؤقتًا بدلًا من ذلك، أوقف التسليم مفعّل.
قراءة قائمة نقاط النهاية
Section titled “قراءة قائمة نقاط النهاية”| العمود | يعرض |
|---|---|
| نقطة النهاية | العنوان |
| الأحداث | عدد الأحداث التي تستقبلها، أو كل الأحداث. مرّر المؤشر لتراها. |
| الحالة | مفعّلة أو معطّلة |
| آخر تسليم | متى أُرسل إليها آخر حدث |
من يمكنه إدارة webhooks
Section titled “من يمكنه إدارة webhooks”تحتاج إدارة webhooks إلى webhooks:manage، وهي متاحة لأدوار المالك ومسؤول ومطوّر. راجع الفريق.