دليل الأحداث
كل حدث يمكن لخطاف الويب أن يطلبه، والمؤسسة التي يُرسَل إليها، والمعرّفات الموجودة في data الخاص به. وتُقدَّم القائمة أيضًا بصيغة JSON: GET /v1/webhook-events. قد تُضاف أنواع جديدة؛ ولا يتلقى خطاف الويب إلا الأنواع التي يسردها.
| الحدث | يُرسَل إلى | معرّفات data | متى |
|---|---|---|---|
match.published | المورد الذي يدير الشركة | need_id، company_ids | طوبق احتياج مع شركات تديرها |
match.interest | المشتري | need_id، match_id، company_id | مورد مطابَق مهتم باحتياجك |
match.outcome_due | الطرفان | need_id، match_id | بعد ثلاثة أسابيع من إبداء الاهتمام: كيف سارت الأمور؟ |
conversation.started | المورد | conversation_id | بدأ مشترٍ محادثة |
message.posted | الطرف الآخر | conversation_id | رسالة جديدة (اقرأها في لوحة التحكم) |
quote.sent | المشتري | conversation_id، quote_id | أرسل مورد عرض سعر |
counter.sent | المورد | conversation_id، quote_id | ردّ المشتري بعرض مقابل |
quote.decided | من قدّم العرض | conversation_id، quote_id | قُبل عرض سعر أو عرض مقابل أو رُفض |
review.published | المورد | conversation_id، review_id، company_id | نُشر تقييم مشترٍ لشركتك |
review.reply_published | كاتب التقييم | conversation_id، review_id، company_id | ردّ المورد على تقييمك |
review.taken_down | المورد | conversation_id، review_id، company_id | أُزيل تقييم بعد بلاغ |
escrow.funded | المورد | escrow_id، deal_id | دفعة المشتري محفوظة في حساب الضمان |
escrow.delivered | المشتري | escrow_id، deal_id | أبلغ المورد عن التسليم؛ ويلي ذلك الإفراج عن المبلغ ما لم تعترض |
escrow.released | المورد | escrow_id، deal_id | أُفرج عن المبلغ لصالحك |
escrow.refunded | المشتري | escrow_id، deal_id | أُعيد المبلغ إليك |
dispute.opened | الطرف الآخر | escrow_id، deal_id، dispute_id | فُتح نزاع على حساب الضمان |
dispute.withdrawn | الطرف الآخر | escrow_id، deal_id، dispute_id | سُحب النزاع |
dispute.settled | الطرفان | escrow_id، deal_id، dispute_id | قررت Birlesa كيفية تقسيم المبلغ المحفوظ |
credit.offered | المشتري | escrow_id، deal_id | قدّم شريك تمويل عرضًا |
credit.declined | المشتري | escrow_id، deal_id | رفض شريك التمويل |
credit.accepted | المورد | escrow_id، deal_id | قبل المشتري عرض التمويل |
service.requested | كل مقدّم خدمة طُلب منه | request_id | طُلب منك عرض لفحص أو اختبار أو اعتماد أو خدمات لوجستية |
service.offered | مقدّم الطلب | request_id | قدّم مقدّم خدمة عرضًا |
service.accepted | مقدّم الخدمة | request_id | قُبل عرضك |
service.reported | مقدّم الطلب | request_id | رفع مقدّم الخدمة التقرير |
shipment.milestone | كل الأطراف | shipment_id | بلغت شحنة مرحلة رئيسية |
federation.proposed | المشتري | need_id | اقتُرحت شركات في الخارج لاحتياج شاركته مع الخارج |
federation.interest | مدير الشركة | company_id | مشترٍ في الخارج مهتم بشركتك (دون ذكر هويته) |
لا يُرسَل webhook.test إلا من زر الاختبار، ولا يحمل أي معرّفات.