إدارة Webhooks
🔗 إدارة Webhooks
📌 نبذة سريعة
| المعلومة | القيمة |
|---|---|
| 👥 الجمهور | مشرف نظام، مطور |
| 🔗 المسار | بوابة المشترك ← الإعدادات ← Webhooks |
| 🎯 الهدف | ربط النظام مع خدمات خارجية عبر Webhooks |
🎯 ما هي Webhooks؟
Webhooks تسمح للنظام بإرسال إشعارات فورية لخدمات خارجية عند حدوث أحداث معينة (مثل: طلب جديد، دفع، تحديث حالة).
🚀 دليل الاستخدام
إضافة Webhook جديد
🔗 إضافة Webhook
────────────────────
📝 الاسم: [إشعار الطلبات الجديدة]
🌐 URL: [https://myapp.com/webhook]
📋 الأحداث:
☑ طلب جديد
☐ تحديث حالة
☐ دفع
☐ إلغاء طلب
[💾 حفظ]� دليل الاستخدام
إضافة Webhook جديد
اذهب إلى بوابة المشترك ← الإعدادات ← Webhooks
اضغط ➕ إضافة Webhook
- أدخل البيانات:
📝 الاسم: اسم وصفي (مثال:
إشعار الطلبات الجديدة)🌐 URL: رابط الخدمة الخارجية التي ستستقبل الإشعار
📋 الأحداث: اختر الأحداث التي تريد الإشعار بها
اضغط 💾 حفظ ✅
اختبار Webhook
بعد الحفظ، اضغط 🔍 اختبار لإرسال حدث تجريبي
- تحقق من استلام الخدمة الخارجية للإشعار
❓ الأسئلة الشائعة
ما الفرق بين Webhook و API؟
Webhook يرسل الإشعارات تلقائياً عند حدوث حدث. API يتطلب طلباً من الخدمة الخارجية لجلب البيانات.
ما الأحداث التي يمكن الاشتراك بها؟
🔄 طلب جديد: عند إنشاء طلب
🔄 تحديث حالة: عند تغير حالة الطلب
💳 دفع: عند إتمام عملية دفع
❌ إلغاء طلب: عند إلغاء طلب
هل يمكن إضافة أكثر من Webhook؟
نعم، يمكنك إضافة عدة Webhooks لأحداث مختلفة أو لنفس الحدث لخدمات مختلفة.
ماذا يحدث إذا فشل إرسال Webhook؟
النظام يحاول إعادة الإرسال 3 مرات. إذا فشل، يُسجل الخطأ في سجل النشاطات.
🔧 استكشاف المشاكل
| المشكلة | السبب المحتمل | الحل |
|---|---|---|
| ❌ الـ Webhook لا يرسل | الرابط (URL) غير صحيح أو الخدمة الخارجية معطلة | تحقق من صحة الرابط وأعد الاختبار |
| ❌ حدث خطأ في الإرسال | مهلة الاتصال انتهت أو الخدمة لا تستجيب | تأكد من أن الخدمة الخارجية متاحة وتستقبل POST requests |
| ❌ لا أستطيع إضافة Webhook | صلاحية إدارة Webhooks غير ممنوحة | تحقق من صلاحيات حسابك |
| ❌ يتم إرسال إشعارات متكررة | الإعدادات ترسل لكل حدث وليس لأنواع محددة | راجع الأحداث المختارة وحدد بدقة |