Webhooks
اشترك في أحداث المنصة — رسالة جديدة، فوز صفقة، إنشاء جهة اتصال، دفع فاتورة — تُدفع لرابطك لحظياً.
إضافة webhook
المطوّرون → Webhooks → «جديد». الصق رابط الـ endpoint، اختر الأحداث للاشتراك (أو «الكل»)، واحفظ. المنصة ترسل ping تحقق يجب أن تردّه.
تنسيق الـ payload
كل webhook هو POST بـ JSON: { event, teamId, timestamp, data }. مُوقَّع بـ HMAC-SHA256 بسرّ الـ webhook في X-Signature header.
سياسة المحاولات
التسليمات الفاشلة (غير 2xx، timeout > 10 ثوان) تُعاد 5 مرات بـ exponential backoff. بعد 5 فشلات يُعطَّل الـ webhook تلقائياً وتُبلَّغ.
إعادة التشغيل
من صفحة تفاصيل الـ webhook اضغط «إعادة تشغيل» على أي تسليم سابق لإعادة الإرسال — مفيد بعد إصلاح خطأ في معالجك.
أفضل الممارسات
ردّ دائماً 200 خلال 5 ثوان. إذا احتاجت المعالجة وقتاً، ضع المهمة في طابور وردّ فوراً. تحقّق من HMAC في كل طلب.