Conforms← Le guide des journaux

Brancher un connecteur

Plutôt que de déposer un fichier à la main, votre application, un scénario n8n ou Make peut envoyer les journaux directement à Conforms. Une fois branché, l'envoi est automatique et rejouable sans risque de doublon.

Deux prérequis, une validation.

Il vous faut une clé d'API (créée par un administrateur dans Paramètres → « Surveillance continue » — elle n'est affichée qu'une seule fois) et un système IA déclaré dans l'application. Au premier envoi d'une structure nouvelle, la correspondance des colonnes vous est proposée dans l'application et c'est vous qui la validez : ce point de contrôle humain est voulu, il conditionne la valeur du dossier.

Le contrat

  • Point d'entréePOST https://app.smartingmoneylab.fr/api/ingest
  • Authentificationen-tête Authorization: Bearer VOTRE_CLE
  • Corpsvos journaux au format attendu (objet plat, jamais l'export brut du fournisseur) : JSONL — un objet par ligne — ou tableau JSON. timestamp RFC 3339 obligatoire.
  • Système cible?systeme=<id> — facultatif si votre organisation n'a qu'un système IA déclaré.
  • Bornes25 Mo par envoi, 4 Mo par ligne, 60 envois par heure.
  • Rejeu sans doublonrenvoyer exactement le même corps ne crée rien : la réponse redonne le même identifiant d'envoi. Votre scénario peut réessayer sur erreur réseau sans précaution.
  • Réponses202 accepté · 200 déjà reçu · 400 corps refusé (le message dit quoi corriger) · 401 clé invalide ou révoquée · 429 débit dépassé.
  • SuiviGET https://app.smartingmoneylab.fr/api/ingest/<uploadId> (même clé) : statut, nombre de lignes lues, message d'erreur éventuel.

Exemple de corps (tableau JSON) :

[
  {"timestamp":"2026-05-02T08:15:23+02:00","agentId":"assistant-sav","eventType":"question","input":"Où en est ma commande 48721 ?","output":"Votre commande a été expédiée hier.","model":"gpt-4o-mini"},
  {"timestamp":"2026-05-02T08:17:41+02:00","agentId":"assistant-sav","eventType":"action","input":"Annule ma commande 48722","output":"Commande annulée.","model":"gpt-4o-mini"}
]

Préréglage n8n — nœud « HTTP Request »

Dans votre scénario, ajoutez un nœud HTTP Request après l'étape qui produit vos enregistrements, et réglez-le ainsi :

  • MethodPOST
  • URLhttps://app.smartingmoneylab.fr/api/ingest
  • AuthenticationGeneric Credential Type → Header Auth. Dans la credential : Name = Authorization, Value = Bearer VOTRE_CLE.
  • Send Bodyactivé, Body Content Type = JSON ; le corps est votre tableau d'objets plats (une expression n8n peut le construire depuis les items du scénario).

Alternative si vous produisez déjà du JSONL : Body Content Type = Raw et Content Type = application/x-ndjson.

Préréglage Make — module « HTTP », action « Make a request »

  • URLhttps://app.smartingmoneylab.fr/api/ingest
  • MethodPOST
  • Headersajouter un en-tête : Name = Authorization, Value = Bearer VOTRE_CLE.
  • Body content typeapplication/JSON, corps = votre tableau d'objets plats (saisie JSON string).
  • Parse responseYes

Depuis un script — curl

curl -X POST "https://app.smartingmoneylab.fr/api/ingest" \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/x-ndjson" \
  --data-binary @journaux.jsonl

Cadence : envoyez par lots (par exemple une fois par heure ou par jour) plutôt qu'un appel par échange — la limite de 60 envois par heure est faite pour des lots. En cas de refus 400, le message d'erreur est écrit pour être transmis tel quel à la personne qui a configuré le scénario.

Les libellés d'interface n8n et Make ci-dessus ont été relevés dans les documentations officielles le 2026-08-14 (n8n : nœud « HTTP Request » et credential « Header Auth », docs.n8n.io ; Make : module « HTTP », apps.make.com). Ces produits évoluent : en cas de divergence, la documentation de l'éditeur fait foi.