نستقطب شركاء تصميم للقطاعات الجديدة — افتح مجالًا جديدًا، واحصل على المنصة بنصف السعر
Nexevo.AI
تسجيل الدخول

Webhooks

اشترك مُنفّذ HTTPS في أحداث مساحة العمل (مثلًا، عند اكتمال تشغيل agent). التسليمات دائمة — تُعاد عند الفشل وتُسجَّل — لذا لا تحتاج للاستطلاع.

تسجيل webhook

POST/v1/workspaces/{workspace_id}/webhooks —

الجسم: url (مطلوب، مستقبِل HTTPS الخاص بك)، events (الأحداث التي ستُرسَل)، وdescription.

bash
curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/webhooks \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/hooks/nexevo", "events": ["agent.completed"]}'

الإدارة وتصحيح الأخطاء

GET/v1/workspaces/{workspace_id}/webhooks —

/

PATCH/v1/workspaces/{workspace_id}/webhooks/{webhook_id} —

/

DELETE/v1/workspaces/{workspace_id}/webhooks/{webhook_id} —

سرد، تحديث (تدوير URL، تغيير الأحداث، enabled)، حذف.

POST/v1/workspaces/{workspace_id}/webhooks/{webhook_id}/test —

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

GET/v1/workspaces/{workspace_id}/webhooks/{webhook_id}/deliveries —

التسليمات الحديثة + حالتها، لتصحيح الأخطاء.

تُستمر التسليمات وتُعاد المحاولة (تنجو من إعادة التشغيل)، لذا لن يُسقط الانقطاع المؤقت من جانبك حدثًا. تحقّق من التوقيع على كل تسليم واستجب 2xx بسرعة؛ افعل العمل البطيء بعيدًا عن الطلب.