Relier un formulaire à un tableur, et comprendre webhooks et API

1. À la fin de cette leçon, tu sauras

Expliquer avec tes mots ce qu’est une API et ce qu’est un webhook.
Relier un formulaire à un tableur avec n8n, sans recopier une seule ligne à la main.
Ranger les identifiants au seul bon endroit : dans l’outil.
Tester avec des données fictives avant de brancher le vrai formulaire.

2. Pourquoi ça t’intéresse

Benoît coordonne les bénévoles d’une banque alimentaire. Les inscriptions arrivent par un formulaire en ligne ; chaque dimanche, il les recopie dans le tableur de planning. Une heure par semaine, et des erreurs de frappe dans les numéros de créneau. Il a entendu parler de « webhook » et d’« API » et s’est dit que ce n’était pas pour lui. En réalité, l’idée est aussi simple qu’une sonnette et un guichet. Une fois comprise, chaque inscription arrive toute seule dans le tableur, à la bonne colonne.

3. Avant de commencer


Il te faut	n8n et les garde-fous des leçons 2 à 4, un compte de tableur en ligne, un formulaire existant ou l’envie d’en créer un
Coût	Rien de plus ; vérifie les conditions du jour des services utilisés sur leur site
Durée	1 h à 1 h 30

4. Comprendre en 3 minutes

Une API, c’est un guichet. Un webhook, c’est une sonnette. n8n sait utiliser les deux, pour que tes outils se parlent sans toi.

Image mentale :

L’API est le guichet d’une administration. Tu viens avec une demande dans le format attendu (« ajoute cette ligne au tableau »), tu montres ta carte (tes identifiants), le guichet exécute et te répond. Les nœuds de n8n savent remplir ces demandes pour toi.
Le webhook est une sonnette. Au lieu d’aller voir toutes les cinq minutes si un formulaire est arrivé, tu donnes au service une adresse ; il « sonne » à cette adresse dès qu’une réponse est envoyée, avec le contenu de la réponse.

Mot	Ce que ça veut dire
API	Une porte prévue pour les programmes, avec des règles précises
Webhook	Une adresse que tu fournis à un service pour qu’il te prévienne d’un événement
Identifiants	Ta carte pour passer au guichet, enregistrée une fois dans n8n
Correspondance des champs	Quel champ du formulaire va dans quelle colonne du tableur

Le workflow de cette leçon tient en deux briques :

Le déclencheur : un formulaire. Soit un formulaire créé directement dans n8n, soit le webhook d’un service de formulaires que tu utilises déjà.
Le nœud tableur : ajoute une ligne avec les réponses.

Un détail utile : pour un webhook, n8n distingue une adresse de test et une adresse de production. La documentation (docs.n8n.io) explique laquelle utiliser et quand : lis-la avant de donner l’adresse à un autre service.

5. Faire ensemble

Étape 1 · Dessiner la correspondance

Lance claude dans ton dossier de travail :

Je veux relier un formulaire à un tableur avec n8n.
Le formulaire sert à : [son usage, par exemple inscription des bénévoles].
Ses champs sont : [la liste des champs].
Propose-moi dans relier-formulaire.md : les colonnes du tableur, la correspondance champ par champ, les champs inutiles à supprimer, et le workflow en deux nœuds. Ne me donne pas de noms de menus précis.

Supprime tout champ dont tu n’as pas réellement besoin : moins de données, moins de risques.

Étape 2 · Préparer un tableur de test

Crée un nouveau tableur nommé « TEST inscriptions ».
Écris sur la première ligne les noms de colonnes prévus.
Ne touche pas encore au vrai tableur.

Étape 3 · Poser les deux nœuds

En suivant docs.n8n.io :

Ajoute le déclencheur formulaire (formulaire n8n ou webhook de ton service de formulaires).
Enregistre les identifiants du tableur dans l’espace prévu par n8n, avec l’accès le plus restreint proposé.
Ajoute le nœud qui ajoute une ligne au tableur « TEST inscriptions », et fais la correspondance des champs.

Étape 4 · Tester avec des données fictives

Remplis le formulaire trois fois avec des données inventées : « Test Martin », « Test Durand », une adresse à toi.
Ajoute un cas tordu : un champ vide, un nom avec accent et apostrophe (« Test Élodie d’Arc »).
Vérifie le tableur : trois lignes, chaque valeur dans la bonne colonne, accents intacts.
Ouvre les exécutions dans n8n et regarde ce que chaque nœud a reçu.

Étape 5 · Passer au réel

Quand tout est juste : remplace le tableur de test par le vrai, utilise l’adresse de production si tu passes par un webhook, active le workflow, puis envoie une dernière réponse fictive que tu supprimeras du vrai tableur.

6. Faire toi-même

Relie un formulaire réel de ta vie à un tableur : inscriptions à un atelier, demandes de prêt de matériel, réservations d’un repas associatif, suivi de tes candidatures.

Consigne : correspondance écrite dans relier-formulaire.md, champs inutiles supprimés, tests sur au moins quatre réponses fictives dont un cas tordu, identifiants dans n8n uniquement. Complète ta fiche d’automatisation (leçon 4) avec ce nouveau workflow.

Résultat attendu : une réponse au formulaire apparaît toute seule, correctement rangée, dans ton tableur.

Piège fréquent : tester sur le vrai tableur « juste une fois ». Les lignes de test se mélangent aux vraies, quelqu’un les traite comme de vraies inscriptions, et une colonne mal reliée peut écraser des données. Tableur de test d’abord, toujours.

7. Vérifier

Je sais expliquer la différence entre une API et un webhook avec une image simple.
Mon formulaire ne demande que les champs réellement utiles.
Tous mes tests ont utilisé des données fictives, dans un tableur de test.
Chaque valeur arrive dans la bonne colonne, y compris avec accents et champs vides.
Mes identifiants sont enregistrés dans n8n, et nulle part ailleurs.
La fiche de l’automatisation dit ce qu’elle lit, où elle écrit et comment l’arrêter.

8. Ce que tu gardes

Dans ton carnet de bord : « API = guichet, webhook = sonnette. Tableur de test, données fictives, identifiants dans l’outil. » Ajoute ce workflow à ta liste « Mes automatisations », avec son interrupteur.

9. Pour aller plus loin

Le module 10 te montre comment ajouter un formulaire à ta propre page web : tu pourras le relier au même tableur.
Parcours dans docs.n8n.io la page du nœud de ton tableur, pour voir les autres actions possibles (mettre à jour une ligne, en chercher une).