Formstep

Collecte de documents avec n8n : demandez les fichiers dont chaque dossier a besoin

Collectez des documents dans n8n : le formulaire naît d’une liste dans la demande, chacun ne voit que ce qu’exige son dossier, et chaque fichier est enregistré.

Par , fondateur de Formstep · Publié · Mis à jour

La collecte de documents avec n8n a un problème de formulaire. Une déclaration de dégât des eaux demande des photos et un devis de réparation, une déclaration de vol demande un dépôt de plainte et des justificatifs. Pour collecter des documents auprès de clients comme ceux-là dans n8n, vous construisez soit un long formulaire avec de la logique, soit un formulaire par type de dossier, et dans les deux cas vous entretenez des formulaires alors que vous avez une simple liste.

Ce workflow ne construit pas le formulaire d’abord. La liste vit dans un nœud Code, la demande porte le formulaire, et la personne ne voit que ce que son dossier exige. Les mêmes étapes conviennent à l’intégration de clients, aux prêts, aux locations et aux visas : tous les cas où les pièces dépendent du dossier.

Vous pouvez importer le workflow terminé depuis formstep-claim-documents.json, et il n’a besoin d’aucun formulaire dans Formstep. Je l’ai testé sur n8n 2.44 auto-hébergé avec la version 0.13.0 du nœud.

En bref : gardez la liste dans un nœud Code et envoyez-la avec la demande. Formstep crée le formulaire, la personne ne voit que ce que son dossier exige, et le workflow attend le résultat.

Le workflow n8n terminé après une exécution : un déclencheur manuel, Claim, Build the checklist, Ask for the documents, Wait for the documents et Completed?, puis One item per file, Download each file et Save to the claim folder, avec une branche No answer

Le workflow complet. Il s’arrête à Wait for the documents jusqu’à ce que la personne envoie ses fichiers, puis enregistre chaque fichier. Sélectionnez-la pour l’afficher en grand.

Comment on collecte aujourd’hui des documents auprès de clients dans n8n

Le formulaire du nœud Wait de n8n n’accepte aucun fichier, et son Form Trigger a ses propres limites. Consulté le 5 novembre 2026 ; n8n évolue vite, vérifiez donc si un point pèse dans votre choix.

  • Le Form Trigger a un élément File. Le Form Trigger le range parmi douze types d’éléments, et le nœud Form ajoute des pages avec les options multipleFiles et acceptFileTypes. Il convient à une personne qui lance le workflow.
  • Le formulaire du nœud Wait ne liste aucun champ File. Un workflow en pause attend sur Wait réglé sur On Form Submitted, dont les types documentés sont Date, Dropdown List, Number, Password, Text et Textarea. Un dossier est ouvert par votre système : le workflow tourne donc déjà quand les documents deviennent nécessaires.
  • Les envois se heurtent à des limites de taille. Sur n8n auto-hébergé, N8N_PAYLOAD_SIZE_MAX vaut 16 Mio par défaut et N8N_FORMDATA_FILE_SIZE_MAX 200 Mio, plus la limite éventuelle d’un proxy. Un formulaire a échoué sur un VPS tant que les deux n’avaient pas été relevées, et sur n8n Cloud, des vidéos de 100 à 300 Mo ont reçu une erreur 413 sans correctif enregistré.
  • Il faut déplacer les fichiers quelque part. Les données binaires restent en mémoire sauf si vous réglez N8N_DEFAULT_BINARY_DATA_MODE sur filesystem ou sur S3, et les données d’exécution sont purgées au bout de 336 heures par défaut.

Pour un client qui ouvre un lien pendant que votre workflow est en pause, Formstep héberge l’envoi, accepte des fichiers jusqu’à 1 Gio chacun et remet à votre workflow une URL par fichier à télécharger à la reprise.

Avant de commencer

Il vous faut le nœud Formstep sur un n8n auto-hébergé avec une adresse HTTPS publique, et un identifiant Formstep. Le nœud est réservé à n8n auto-hébergé : n8n Cloud n’installe que les nœuds communautaires vérifiés, et le nôtre ne l’est pas encore. Il vous faut aussi un endroit où ranger les fichiers : l’exemple les écrit sur le disque de n8n.

1. Partir du dossier

L’exemple commence par un nœud Edit Fields nommé Claim : claimId, claimType (water_damage ou theft), claimLabel, firstName et email. Dans votre workflow, c’est une affaire de CRM, une nouvelle ligne ou un webhook de votre système de gestion des dossiers.

2. Transformer la liste en blocs

Un nœud Code nommé Build the checklist cherche les documents du type de dossier et écrit le formulaire sous forme de blocs : un message d’accueil, deux champs masqués que ce message lit, une question de fichier par document et une note.

const checklists = {
  water_damage: [
    { key: 'damage_photos', title: 'Photos of the damage', maxFiles: 10 },
    { key: 'repair_estimate', title: 'Repair estimate from a contractor', maxFiles: 1 },
  ],
  theft: [
    { key: 'police_report', title: 'Police report', maxFiles: 1 },
    { key: 'receipts', title: 'Receipts for the stolen items', maxFiles: 10 },
  ],
}
const documents = checklists[$json.claimType]
if (!documents) throw new Error(`No checklist for claim type ${$json.claimType}`)
const blocks = [
  { type: 'header', content: 'Hi {{first_name}}, a few documents for claim {{claim_id}}' },
  { type: 'paragraph', content: 'Upload each document below. Photos from your phone are fine.' },
  { type: 'hiddenField', key: 'first_name' },
  { type: 'hiddenField', key: 'claim_id' },
  ...documents.map((document) => ({ type: 'file', ...document })),
  { type: 'text', key: 'notes', title: 'Anything we should know?', required: false },
]
return { json: { ...$json, blocks } }

Le throw arrête l’exécution sur un type de dossier inconnu au lieu d’envoyer un formulaire sans questions. {{first_name}} dans un texte affiche la valeur d’un champ masqué, et tous les types de blocs sont décrits dans Créer un formulaire et une demande en un seul appel.

Ajouter un type de dossier, c’est une nouvelle entrée dans l’objet, et il n’y a aucun formulaire à construire.

3. Envoyer la demande avec un nouveau formulaire

Ajoutez un nœud Formstep Create request et réglez Form Source sur New Form :

  • Form Blocks vaut {{ JSON.stringify($json.blocks) }}, issu du nœud Code.
  • Context remplit les champs masqués : {{ JSON.stringify({ first_name: $json.firstName, claim_id: $json.claimId }) }}.
  • Form Options y met votre marque.
  • Recipient Email vient du dossier. Activez Wait for the Outcome.
  • Sous Additional Fields, réglez Delivery, un External ID et Expires At, par exemple {{ $now.plus({ days: 14 }).toISO() }}.

Mettez ce qui change d’une personne à l’autre dans Context ou Prefill, jamais dans les blocs ni dans le nom du formulaire. Formstep crée un formulaire la première fois qu’il voit une définition et le réutilise ensuite : la deuxième déclaration de dégât des eaux reçoit donc le formulaire de la première, et la réponse indique form.reused: true. Mettez le nom de la personne dans les blocs et chaque demande crée un nouveau formulaire, jusqu’à 300 nouveaux formulaires par jour et par espace de travail.

Delivery réglé sur Email the Invitation demande Pro ou Business, hormis les 10 invitations que Free envoie à votre propre adresse pour essayer. En Free, laissez-le sur None et faites envoyer l’url de la demande par un nœud suivant, via votre propre e-mail ou messagerie. Les Reminders fonctionnent de la même façon : Pro et Business envoient des e-mails à la personne selon un calendrier jusqu’à ce qu’elle termine ou que la demande se termine, et en Free, c’est à vous de relancer. Test Mode est activé dans l’exemple : rien n’est donc envoyé par e-mail tant que vous ne le désactivez pas. Voir les tarifs pour les formules.

Le formulaire que la personne ouvre, intitulé Hi Ada, a few documents for claim CLM-3107, avec des envois pour Photos of the damage et Repair estimate from a contractor, et une question pour des notes

Le formulaire construit à partir de la liste dégât des eaux, tel que la personne le voit. Le nom et le numéro de déclaration viennent de Context.

4. Attendre, puis créer un élément par fichier

Ajoutez un nœud Wait réglé sur On Webhook Call, et un nœud If qui vérifie que {{ $json.body.type }} vaut request.completed. L’autre sortie récupère une demande expirée ou annulée, où vous relancez ou clôturez le dossier. Une demande expire au bout de 30 jours sauf si vous fixez une autre date, jusqu’à 365.

La réponse à chaque question de fichier est une liste de fichiers avec un name, une size, un type et une url. Un deuxième nœud Code les transforme en un élément par fichier, pour que les nœuds suivants s’exécutent une fois par envoi :

// One item per uploaded file, named after the question it answers.
const event = $json.body.data
const items = []
for (const [question, answer] of Object.entries(event.answers)) {
  if (!Array.isArray(answer)) continue
  for (const file of answer) {
    if (file.url) items.push({ json: { question, name: `${question} - ${file.name}`, url: file.url } })
  }
}
return items

Il parcourt les réponses au lieu de nommer les questions : il fonctionne donc pour n’importe quel type de dossier.

5. Télécharger et enregistrer chaque fichier

Un nœud HTTP Request télécharge {{ $json.url }} avec Response Format réglé sur File, une fois par élément. L’exemple écrit ensuite chaque fichier avec Read/Write Files from Disk, sous /home/node/.n8n-files/{{ $('Claim').item.json.claimId }} {{ $json.name }}.

Pour utiliser Google Drive, remplacez ce nœud par Google Drive › Upload file : Input Data Field Name data, File Name {{ $json.name }}, et le dossier du dossier client comme Parent Folder. Les nœuds S3, Dropbox et SharePoint prennent le champ binaire de la même façon. Les fichiers sont allés chez Formstep, la limite de charge utile de votre formulaire ne s’est donc jamais appliquée, et chacun peut atteindre 1 Gio dans la limite de votre stockage.

Traitez l’url d’un fichier comme un mot de passe. Quiconque la possède peut télécharger le fichier, et l’URL n’expire pas : téléchargez donc le fichier comme ici et partagez votre propre copie.

Ce qu’un formulaire créé dans la demande ne peut pas faire

Il ne peut pas porter un fichier destiné à cette seule personne, comme sa police d’assurance ou un document à signer, car un tel fichier est envoyé sur un formulaire qui existe déjà. Pour envoyer aussi à la personne quelque chose à lire ou à signer, utilisez un formulaire publié avec un bloc Documents, comme dans Obtenir l’approbation d’un responsable. Le champ data.submission.pdfUrl de l’événement, un PDF de toutes les réponses, n’est renseigné que si le formulaire conserve un PDF : une demande qui ne fait que rappeler, comme celle-ci, n’en a pas.

Quand le formulaire n8n est le meilleur choix

Si tout le monde doit fournir les mêmes fichiers, publiez un seul formulaire avec des questions de fichier. Partez du modèle de collecte de documents, ou du modèle d’intégration de clients quand les fichiers s’accompagnent de quelques questions.

Si la personne qui envoie est un collègue, le Form Trigger de n8n fonctionne sur n8n Cloud et n’ajoute aucun service à votre pile. Formstep vs le formulaire de n8n compare point par point ces deux choix.

Pour la version à formulaire unique de cette boucle, voir mettre un workflow en pause jusqu’à ce que le client confirme ses informations. Quand les fichiers sont des factures, l’IA peut les lire et l’expéditeur confirmer les valeurs. Pour vérifier les documents à mesure qu’ils arrivent, utilisez la validation par IA, disponible à partir de Pro et payée avec des crédits d’IA. La page d’intégration n8n liste ce que fait le nœud, et le guide pas à pas se trouve sur formstep.io/docs.

Questions sur cet article

Autre chose en tête ? La documentation couvre chaque paramètre, et nous répondons aux e-mails.

Lire la documentation

Sa documentation, consultée le 5 novembre 2026, liste six types de champs pour On Form Submitted : Date, Dropdown List, Number, Password, Text et Textarea. Aucun champ File n'y figure. Le Form Trigger a bien un élément File, mais il lance un workflow au lieu d'en suspendre un.

Dans Formstep, jusqu'à 1 Gio par fichier, dans la limite de votre stockage : 100 Mo en Free, 100 Go en Pro et 500 Go en Business. Un formulaire n8n auto-hébergé est limité par N8N_PAYLOAD_SIZE_MAX, 16 Mio par défaut, et N8N_FORMDATA_FILE_SIZE_MAX, 200 Mio par défaut, plus toute limite de votre reverse proxy.

Non. Avec Form Source sur New Form, le nœud Create request reçoit le formulaire sous forme de blocs, et Formstep le crée et le publie dans le même appel. Un formulaire publié reste préférable dès qu'il y a des traductions ou une mise en page faite à la main.

Non. Formstep réutilise un formulaire quand il reconnaît la même définition : la deuxième déclaration de dégât des eaux utilise donc le formulaire de la première. Mettez ce qui change d'une personne à l'autre dans Context ou Prefill, jamais dans les blocs ni dans le nom du formulaire. Un espace de travail crée au plus 300 nouveaux formulaires par jour de cette façon.

Pas depuis un formulaire créé dans la demande : le fichier destiné à un destinataire est envoyé sur un formulaire qui existe déjà. Utilisez plutôt un formulaire publié avec un bloc Documents, et joignez le fichier à la demande.

Pas avec le nœud Formstep, réservé à n8n auto-hébergé. Sur n8n Cloud, appelez l'API REST de Formstep depuis un nœud HTTP Request, ou utilisez le Form Trigger de n8n quand la personne qui envoie les fichiers fait partie de votre équipe.

Collectez des informations auprès de qui vous voulez.

Publiez un exemple de formulaire, répondez-y comme le ferait votre destinataire et regardez les réponses revenir. Aucun compte requis.

Lire la documentation