Aller au contenu
Sursa Developers

Événements · Sources et import

import.document_failed

Échec de l’import d’un document

Un document d’une source personnalisée n’a pas été importé ou pas indexé (data.reason est un code neutre).

Type d’objet
source
Livré à
Webhooks dotés du rôle admin

Charge utile

Objet : EventImportDocumentFailed

  • idstringobligatoire

    ID de l’événement (evt_…), également envoyé dans l’en-tête webhook-id. Utilisez-le pour écarter les livraisons en double.

  • typestringobligatoire

    Valeurs autorisées: import.document_failed

  • created_atstring (date-time)obligatoire

    Date de la modification (UTC).

  • org_idintegerobligatoire
  • api_versionstringobligatoire

    Version du contrat du schéma de data.

  • sequenceinteger

    Numéro de séquence de la livraison au sein du webhook (absent pour un événement de test).

  • objectWebhookEventObjectobligatoire
  • payloadstringobligatoire

    thin signifie sans data : lisez l’objet via l’API.

    Valeurs autorisées: fullthin

  • dataobject
    Champs
    • sourceEventSourceobligatoire
    • documentobjectobligatoire

      Document de la source personnalisée ; le résultat du document dans l’API d’envoi (push) indique la même issue.

      Champs
      • external_idstring | nullobligatoire
      • titlestring | null
      • card_idstring | nullobligatoire
    • run_idinteger
    • job_idinteger | null

      Job d’indexation ou d’export.

    • reasonstringobligatoire

      Code de motif neutre (énumération extensible : traitez un code inconnu comme un échec générique). Les valeurs sont des codes de résultat de document : content_invalid, file_rejected, too_large, limit_reached, index_failed.

  • testbooleanobligatoire

    Événement de test envoyé par POST /v1/webhooks/{webhook_id}/test.

Exemple de livraison

{
  "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
}

Recevoir les événements

Chaque livraison est une requête POST envoyée à votre webhook avec ce corps JSON. Vérifiez l’en-tête webhook-signature (Standard Webhooks) avant de vous fier au corps, répondez par un statut 2xx en quelques secondes et faites le traitement ensuite. Les livraisons vers un même webhook respectent l’ordre des événements ; une livraison en échec est relancée avec des pauses de plus en plus longues.

De nouveaux types d’événements et de nouveaux champs peuvent apparaître à tout moment : ignorez les types et les champs que vous ne connaissez pas.

Les mêmes événements restent 30 jours dans le flux d’événements →