تهيئة Webhook

متى تحتاج إلى هذا

تحتاج إلى هذا عندما تريد أن يتفاعل نظامك الخاص مع حدث يقع في Teamspace، مثل تسجيل عملية رفع صورة أو بدء مهمة لاحقة. يجعل Webhook تطبيق Timemark يرسل طلب POST إلى نقطة النهاية الخاصة بك في كل مرة يقع فيها حدث مختار.

ما تحتاجه

الدور

مالك الفريق

المنصة

Web

الخطة

Business

يؤثر على

يُطلَق فقط للأحداث التي تحدث بعد إنشاء webhook

إعداد Webhook

1. اذهب إلى Teamspace → الإعدادات → التكاملات → Webhook.
2. أدخل عنوان URL لنقطة النهاية الخاص بك. يجب أن يكون قابلاً للوصول علنًا وأن يستجيب لطلب POST.
3. تأكد من المُشغّل. يُفعَّل Webhook عند صورة جديدة عندما يتم رفع صورة جديدة.
4. اختر النطاق: جميع الصور، أو مجلد محدد.
5. احفظ.

اختبار التسليم

1. في Webhook الذي حفظته للتو، استخدم وظيفة الاختبار أو بينغ لإرسال حمولة نموذجية.
2. تحقق من سجلات نقطة النهاية للتأكد من وصول الحمولة.
3. تأكد من أن نقطة النهاية أعادت استجابة 2xx.

الحقول التي يمكنك تكوينها

الحقل	ما الذي يفعله	ملاحظات
عنوان URL لنقطة النهاية	المكان الذي يرسل إليه Timemark طلب POST	يجب أن يكون علنيًا وأن يعيد استجابة 2xx خلال المهلة المحددة
المُشغّل	الإجراء الذي يُفعّل عملية التسليم	صورة جديدة (photo.uploaded) هو المُشغّل الوحيد حاليًا. طالع أنواع أحداث Webhook
النطاق	يحصر التفعيل في مجلد واحد، أو في جميع صور الفريق	نطاق المجلد يُفعَّل فقط للصور الموجودة في ذلك المجلد

الأخطاء الشائعة

• لا يوجد تفعيل بأثر رجعي. يُفعَّل Webhook فقط للأحداث التي تقع بعد إنشائه. الصور الموجودة مسبقًا لن تُفعّله.
• يجب أن تعيد نقطة النهاية استجابة 2xx في الوقت المحدد. تُعامَل المهلة المنتهية أو الخطأ كعملية تسليم فاشلة. يعيد Timemark محاولة عمليات التسليم الفاشلة، ثم يتوقف بعد استنفاد المحاولات.
• عدم تطابق النطاق. لن يُفعَّل Webhook محدد النطاق بمجلد واحد للصور الموجودة في مجلدات أخرى. اضبط النطاق على جميع الصور إذا كنت بحاجة إلى كل المجلدات.
• خلف جدار حماية. لا يمكن الوصول إلى نقطة نهاية تقع خلف VPN أو جدار حماية. اجعل عنوان URL متاحًا للعامة.

طالع أيضًا

• أنواع أحداث Webhook
• مرجع حمولة Webhook

آخر تحديث: 28 يونيو 2026