Envoyer les données d'un formulaire vers Google Sheets via webhook
Deux approches complémentaires : relayer le formulaire avec Webhooky et un appel HTTP sortant, ou recevoir le JSON dans Apps Script pour appendRow dans une feuille.
Emmanuel Sauvage 5 min de lecture
Un formulaire web qui alimente directement une feuille Google évite les exports manuels et les copier-coller. L’enjeu n’est pas seulement d’« envoyer vers Sheets » : il faut un point d’entrée HTTP fiable, un format de données stable et une écriture idempotente ou au moins traçable.
Pourquoi passer par un webhook plutôt qu’un lien « Répondre »
Le lien intégré de Google Forms écrit déjà dans une feuille, mais dès que le formulaire est sur votre site, un CRM ou un outil métier, vous devez brancher une intégration. Un webhook — une URL qui reçoit un POST à chaque soumission — centralise cette étape. Vous pouvez ensuite notifier une équipe, appeler une API ou, comme ici, pousser une ligne dans une feuille.
Deux schémas cohabitent bien en pratique :
- Formulaire → Webhooky → HTTP sortant → Apps Script (doPost) → Sheets
- Formulaire → URL de déploiement Apps Script (sans intermédiaire, si vous maîtrisez la sécurité)
Le premier isole les secrets et permet d’enchaîner e-mail ou Slack en parallèle de l’écriture dans la feuille. Le second minimise les composants.
Étape 1 : préparer la feuille cible
Créez une feuille avec une ligne d’en-têtes figée, par exemple horodatage, nom, email, message. Laissez la ligne 1 protégée si plusieurs personnes éditent le classeur : seules les lignes de données doivent être remplies par le script.
Notez l’identifiant du classeur dans l’URL (/d/IDENTIFIANT/) ; vous en aurez besoin si le script ouvre le bon fichier par ID plutôt que par nom.
Étape 2 : déploiement Web App avec doPost
Dans Extensions → Apps Script, collez un gestionnaire qui parse le JSON et ajoute une ligne :
const SHEET_ID = "REMPLACER_PAR_ID_CLASSEUR";
const SHEET_NAME = "Réponses";
const SHARED_SECRET = PropertiesService.getScriptProperties().getProperty("WEBHOOK_SECRET");
function doPost(e) {
try {
if (!e.postData || !e.postData.contents) {
return jsonResponse({ ok: false, error: "Corps JSON attendu" }, 400);
}
const body = JSON.parse(e.postData.contents);
if (SHARED_SECRET && body.secret !== SHARED_SECRET) {
return jsonResponse({ ok: false, error: "Non autorisé" }, 401);
}
const ss = SpreadsheetApp.openById(SHEET_ID);
const sheet = ss.getSheetByName(SHEET_NAME);
if (!sheet) {
return jsonResponse({ ok: false, error: "Feuille introuvable" }, 500);
}
const row = [
new Date(),
body.nom || "",
body.email || "",
body.message || "",
];
sheet.appendRow(row);
return jsonResponse({ ok: true });
} catch (err) {
return jsonResponse({ ok: false, error: String(err) }, 500);
}
}
function jsonResponse(obj, statusCode) {
const output = ContentService.createTextOutput(JSON.stringify(obj));
output.setMimeType(ContentService.MimeType.JSON);
// Apps Script ne permet pas de définir un vrai code HTTP ; le client doit lire le JSON.
return output;
}
Définissez WEBHOOK_SECRET dans Paramètres du projet → Propriétés du script. Déployez en Application web : exécuter en tant que vous-même, accès Toute personne disposant du lien (ou restreint selon votre politique). Copiez l’URL de déploiement /exec.
Tester avec curl
curl -X POST "https://script.google.com/macros/s/VOTRE_DEPLOIEMENT/exec" \
-H "Content-Type: application/json" \
-d '{"secret":"VOTRE_SECRET","nom":"Test","email":"test@example.com","message":"Bonjour"}'
Vérifiez qu’une nouvelle ligne apparaît et que le JSON renvoyé contient "ok": true.
Étape 3 : faire transiter le formulaire par Webhooky
Sur webhooky.fr, créez un webhook entrant. L’URL publique reçoit le POST du formulaire (champs HTML, JSON ou payload d’un autre outil). Dans le constructeur sur webhooky.builders, ajoutez une action HTTP sortant vers l’URL /exec du déploiement Apps Script.
Mappez les variables dynamiques issues du payload : par exemple {{body.nom}}, {{body.email}} selon la structure réelle de votre soumission. Le corps de l’appel sortant peut être un JSON construit dans l’interface, en y incluant le secret stocké dans les secrets d’organisation plutôt que dans le formulaire public.
Enchaînez si besoin une notification Mailjet ou Slack pour prévenir l’équipe sans ouvrir la feuille. Les journaux d’exécution et les relances automatiques (jusqu’à 3 tentatives) aident quand Google renvoie une erreur temporaire ou quand le déploiement a été mis à jour.
Côté formulaire HTML
Votre formulaire ne doit pas appeler directement l’URL Apps Script si le secret doit rester caché. Pointez l’action POST vers l’URL Webhooky, ou envoyez en JavaScript fetch vers cette URL avec les champs métier uniquement. Webhooky complète le secret et normalise le JSON vers doPost.
Exemple minimal côté client (sans secret) :
await fetch("https://hooks.webhooky.builders/...", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
nom: form.nom.value,
email: form.email.value,
message: form.message.value,
}),
});
Adaptez l’URL à celle affichée dans votre espace Webhooky.
Bonnes pratiques
- Valider e-mail et champs obligatoires avant l’appel réseau ; la feuille ne doit pas devenir une poubelle.
- Horodater côté serveur (Apps Script) plutôt que de faire confiance à l’heure du navigateur.
- Ne pas dupliquer les lignes : si le formulaire peut être soumis deux fois, envoyez un identifiant de soumission et vérifiez-le dans une colonne dédiée avant
appendRow. - Surveiller les quotas Apps Script (temps d’exécution, appels URL) si le volume augmente.
Quand aller plus loin
Si la feuille devient un tableau de bord partagé par des dizaines d’utilisateurs simultanés, ou si vous avez besoin d’audit fin et de droits granulaires, le couple formulaire + Sheets atteint vite ses limites. Dans ce cas, gardez le webhook comme porte d’entrée et orientez les données vers une application métier — tout en conservant éventuellement une exportation vers Sheets pour la lecture seule.
En attendant ce palier, Webhooky + HTTP sortant + doPost offre un chemin rapide, observable et réversible pour centraliser les réponses de formulaire dans Google Sheets.
Questions fréquentes
- Faut-il obligatoirement coder en Apps Script pour alimenter une feuille ?
- Non. Vous pouvez faire transiter le formulaire par Webhooky et appeler une URL de déploiement Apps Script en HTTP sortant, ou utiliser un connecteur dédié si votre stack le propose. Apps Script reste la voie la plus directe quand la feuille est déjà votre base de vérité.
- Quel format envoyer vers doPost ?
- Privilégiez du JSON en POST avec Content-Type application/json. Le corps est lu via e.postData.contents ; évitez de mélanger champs query string et corps JSON sans convention claire.
- Comment sécuriser l'URL de déploiement exposée au formulaire ?
- Ne placez pas de secret dans l'URL visible côté navigateur. Passez par un webhook entrant (Webhooky ou déploiement serveur) qui ajoute un jeton en en-tête ou en corps, puis vérifiez ce jeton dans doPost.
- Que faire si deux soumissions arrivent en même temps ?
- SpreadsheetApp n'est pas une base transactionnelle. Pour des volumes modestes, appendRow suffit souvent ; au-delà, sérialisez côté intermédiaire ou envisagez une file d'attente avant écriture.