خطافات الويب

تدفع Webhooks رسالة صغيرة إلى URL تتحكّم به كلما حدث شيء في PeekHire — حتى تتمكّن من التفاعل في الوقت الفعلي بدلًا من استطلاع API.

كيفية عمل Webhooks

1. تنشئ نقطة نهاية (URL على خادمك أو أداة أتمتة) ضمن أدوات المطوّرين → Webhooks.
2. تختار الأحداث التي يجب أن تستقبلها.
3. عند وقوع حدث، يرسل PeekHire طلب HTTP POST مع حمولة JSON إلى نقطة النهاية لديك.

تكون الحمولات صغيرة عن قصد — فهي تحدد ما حدث والكائن الذي يتعلق به، حتى تتمكّن من جلب التفاصيل الكاملة من REST API إذا احتجت إليها.

الأحداث المتاحة

تغطي الأحداث دورة حياة التوظيف، بما في ذلك:

• طلبات التقديم — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• تعليقات طلبات التقديم — application.comment.created, application.comment.updated, application.comment.deleted.
• الحملات — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

التحقق من عمليات التسليم

يتم توقيع كل عملية تسليم حتى تتمكّن من التأكد من أنها جاءت فعلًا من PeekHire. تحقّق من التوقيع على نقطة النهاية لديك قبل الوثوق بالحمولة، وأجب بحالة 2xx لتأكيد الاستلام.

فحص عمليات التسليم

يعرض عرض عمليات التسليم محاولات Webhook الأخيرة ونتائجها، حتى تتمكّن من التأكد من وصول الأحداث واستكشاف أخطاء نقطة نهاية لا تستجيب وإصلاحها.

نصائح

• استجب بسرعة بحالة 2xx ونفّذ الأعمال الثقيلة بشكل غير متزامن.
• اجعل المعالج لديك idempotent — قد يتم أحيانًا تسليم الحدث نفسه أكثر من مرة.
• ابدأ بأداة مثل Make أو Zapier أو n8n إذا كنت تفضّل عدم تشغيل خادم.