import.document_failed

الحمولة

الكائن: EventImportDocumentFailed

• idstringمطلوب

  معرّف الحدث (evt_…)، ويُرسَل أيضًا في الترويسة webhook-id. استخدمه لإسقاط التسليمات المكررة.

• typestringمطلوب

  القيم المسموح بها: import.document_failed

• created_atstring (date-time)مطلوب

  وقت حدوث التغيير (UTC).

• org_idintegerمطلوب
• api_versionstringمطلوب

  إصدار العقد لمخطط data.

• sequenceinteger

  الرقم التسلسلي للتسليم ضمن خطاف الويب (يغيب في الحدث التجريبي).

• objectWebhookEventObjectمطلوب
• payloadstringمطلوب

  القيمة thin تعني بلا data: اقرأ الكائن عبر API.

  القيم المسموح بها: fullthin

• dataobject
  الحقول

  • sourceEventSourceمطلوب
  • documentobjectمطلوب

    مستند المصدر المخصص؛ وتُبلغ نتيجة المستند في API الإرسال عن النتيجة نفسها.

    الحقول

    • external_idstring | nullمطلوب
    • titlestring | null
    • card_idstring | nullمطلوب
  • run_idinteger
  • job_idinteger | null

    مهمة الفهرسة أو التصدير.

  • reasonstringمطلوب

    رمز سبب محايد (تعداد قابل للتوسيع: تعامل مع الرمز غير المعروف بوصفه إخفاقًا عامًا). القيم هي رموز نتائج المستندات: content_invalid، وfile_rejected، وtoo_large، وlimit_reached، وindex_failed.

• testbooleanمطلوب

  حدث تجريبي أرسلته العملية POST /v1/webhooks/{webhook_id}/test.

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "import.document_failed",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "source",
    "id": "5"
  },
  "payload": "full",
  "data": {
    "source": {
      "id": 5,
      "name": "Help center",
      "kind": "custom",
      "collection_id": 3
    },
    "document": {
      "external_id": "kb-article-118",
      "title": "Shipping rates",
      "card_id": null
    },
    "run_id": 902,
    "reason": "content_invalid"
  },
  "test": false
}