É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
idstringobligatoireID de l’événement (
evt_…), également envoyé dans l’en-têtewebhook-id. Utilisez-le pour écarter les livraisons en double.typestringobligatoireValeurs autorisées:
import.document_failedcreated_atstring (date-time)obligatoireDate de la modification (UTC).
org_idintegerobligatoireapi_versionstringobligatoireVersion du contrat du schéma de
data.sequenceintegerNuméro de séquence de la livraison au sein du webhook (absent pour un événement de test).
payloadstringobligatoirethinsignifie sansdata: lisez l’objet via l’API.Valeurs autorisées:
fullthindataobjectChamps
documentobjectobligatoireDocument de la source personnalisée ; le résultat du document dans l’API d’envoi (push) indique la même issue.
Champs
external_idstring | nullobligatoiretitlestring | nullcard_idstring | nullobligatoire
run_idintegerjob_idinteger | nullJob d’indexation ou d’export.
reasonstringobligatoireCode 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 →