إعداد حلقة ملاحظات Webhook

تحافظ webhooks على اتساق المنتج وفريق العمليات بعد معالجة الأحداث غير المتزامنة. اربط تسليم webhook بإرسال الملاحظات حتى تساعد النتائج المؤكدة في تحسين القواعد.

استقبال Webhook

POST /your/webhook/endpoint

تحقق من توقيع webhook، واحفظ معرف الحدث، وأضف عملًا تشغيليًا إلى الطابور لقرارات REVIEW.

إرسال الملاحظات

POST /api/v1/feedback/event/:id
x-api-key: naiza_api_sk_live_...

{
  "label": "FRAUD",
  "notes": "Customer confirmed unauthorized activity",
  "externalCaseId": "case_12345"
}

النمط التشغيلي

• أعد محاولة معالجة webhook من الطابور، وليس مباشرة داخل HTTP handler.
• اجعل إرسال الملاحظات idempotent باستخدام معرف الحالة لديك.
• راجع الإيجابيات الكاذبة عالية الحجم أسبوعيًا قبل تغيير القواعد.

راجع أمثلة webhooks قبل ربط تنبيهات الإنتاج.