v1.33: أعد محاولة كل تسليم فاشل إلى Webhook بضغطة واحدة

حين يكون مستقبل Webhook لديك متوقفاً، لا يستطيع FormFlow تسليم الإرسالات التي تصل في أثناء ذلك. وحتى الإصدار v1.33.0 في 5 أكتوبر 2026، كان تسليمها لاحقاً يعني الضغط على «إعادة المحاولة الآن» على كل إرسال على حدة، واحداً تلو الآخر. ولكل وجهة Webhook الآن زر «إعادة محاولة التسليمات الفاشلة» الذي يفعل ذلك للجميع دفعة واحدة. ويعطي إدخال سجل التغييرات النسخة المختصرة. ويغطي هذا المقال متى تستخدمه، وما لن يفعله.

ماذا يحدث حين يتوقف المستقبل

تُعاد محاولة التسليم الفاشل عدة مرات. وحين تنفد محاولاته يُعدّ فاشلاً، وحين تستمر التسليمات إلى وجهة في الفشل، يتوقف FormFlow عن الإرسال إليها ويراسلك بالبريد الإلكتروني: «تم تعطيل Webhook للنموذج». وتقول تلك الرسالة إن الإرسالات لا تزال تُخزَّن وإن التمرير وحده هو ما توقف. وتذكر أيضاً الخطوة التالية، وهي إصلاح الوجهة وإعادة تفعيلها والضغط على «إعادة محاولة التسليمات الفاشلة» في صفها.

استخدامه

1. أصلح المستقبل أولاً. فإعادة المحاولة تمنح كل تسليم فاشل محاولة إضافية واحدة، فلا جدوى من الضغط عليها والمستقبل لا يزال متوقفاً.

2. افتح النموذج واذهب إلى إعدادات «التسليم». ابحث عن وجهة Webhook. وإذا أطفأها FormFlow، شغّل «جارٍ التسليم» واحفظ النموذج.

3. اضغط «إعادة محاولة التسليمات الفاشلة» في صف تلك الوجهة وأكّد.

4. تخبرك اللوحة كم تسليماً فاشلاً أُعيد إلى قائمة الانتظار.

يعمل الزر على وجهة حُفظت وهي مفعّلة. فعلى صف غير محفوظ يطلب منك حفظ النموذج أولاً، وعلى وجهة مُطفأة يطلب منك تشغيل «جارٍ التسليم» والحفظ.

ما يراه مستقبلك

التسليم الذي يُعاد هو التسليم نفسه، لا تسليم جديد. يخرج بمعرّف تسليمه الأصلي وحمولته الأصلية. يرسل FormFlow هذا المعرّف في ترويسة X-FormFlow-Delivery-Id. وإذا كان مستقبلك قد عالج تسليماً قبل الفشل، فاحتفظ بالمعرّفات التي عالجتها وتجاهل التكرار.

الحدود

• محاولة إضافية واحدة لكل تسليم. إذا ظلت الوجهة تفشل، تُطفَأ مجدداً وتعود إلى حيث بدأت.

• 500 تسليم كحد أقصى في الضغطة الواحدة، الأقدم أولاً. إذا كان هناك أكثر تقول ذلك اللوحة، وتضغط مجدداً للباقي.

• التسليمات التي تمت قبل أن تغيّر عنوان الوجهة أو سرّها أو تنسيقها لا يُعاد إرسالها. وإذا لم يبقَ ما يستوفي الشروط، تقول اللوحة إنه لا توجد تسليمات فاشلة إلى هذه الوجهة يمكن إعادة محاولتها.

• يعمل على وجهة واحدة. النموذج الذي له وجهتا Webhook له زران، وكل منهما يعيد إرسال إخفاقاتها هي فقط.

وفي اليوم نفسه، أصلح v1.33.1 الرسالة التي يراها الطالب حين ينتهي وقته في نموذج مؤقّت.