Webhooks

Formgong envoie un POST JSON et une signature HMAC-SHA256 du corps brut. Le secret est dans les réglages du formulaire. Jusqu'à 5 tentatives ; les nouvelles tentatives attendent 30 s, 2 min, 10 min et 30 min.

Si la dernière tentative échoue aussi, Formgong envoie un e-mail au propriétaire du formulaire. Le même e-mail part quand, après ces nouvelles tentatives, un webhook Slack ou Discord, un autre webhook, Google Sheets ou Telegram échoue. Au plus un e-mail par jour et par formulaire et canal, sur tous les forfaits, y compris Free. L’e-mail Telegram dit le problème en mots simples (par exemple le bot a été retiré du groupe, le chat est introuvable ou l’utilisateur a bloqué le bot) et comment reconnecter : créez un nouveau code dans les réglages du formulaire, ouvrez le lien du bot, ou ajoutez le bot au groupe et envoyez /connect avec ce code.

{
  "event": "submission.created",
  "form": { "id": "…", "name": "…" },
  "submission": {
    "id": "…",
    "created_at": "2026-09-29T12:00:00.000Z",
    "page_url": "https://example.com/",
    "fields": { "name": "Camille", "email": "camille@example.fr" },
    "is_spam": false
  }
}

Header X-Signature: sha256=…. Header X-Formgong-Event: submission.created.

import { createHmac, timingSafeEqual } from "node:crypto";

function verified(rawBody, signature, secret) {
  const digest = createHmac("sha256", secret).update(rawBody).digest();
  const got = Buffer.from(String(signature).replace(/^sha256=/, ""), "hex");
  return got.length === digest.length && timingSafeEqual(got, digest);
}

Liens vers les fichiers dans les webhooks

Chaque fichier envoyé dans le webhook reçoit un download_url signé qui s'ouvre sans connexion jusqu'à son expiration. Toute personne qui a le lien peut télécharger le fichier : activez-le seulement si le service qui reçoit votre webhook a besoin des fichiers. Le désactiver, renouveler le secret du webhook ou supprimer l'envoi arrête les liens immédiatement.

Pour l'activer, ouvrez les réglages du formulaire, acceptez les pièces jointes, puis dans la section webhooks choisissez 24 heures ou 7 jours dans « Liens vers les fichiers dans les webhooks » et enregistrez. Seuls les webhooks envoyés ensuite portent les liens.

"attachments": [{
  "id": "…", "field": "photo", "filename": "cart.jpg", "size": 182044, "content_type": "image/jpeg",
  "url": "https://formgong.com/dashboard/forms/…/attachments/…",
  "download_url": "https://formgong.com/files/…?exp=…&sig=…",
  "download_expires_at": "2026-11-02T12:00:00.000Z"
}]

Chaque fichier de submission.attachments a alors aussi download_url et download_expires_at. Le service qui reçoit le webhook télécharge le fichier avec une simple requête GET, sans en-têtes ni connexion. Après l'expiration, le lien renvoie 404, et un même fichier peut être téléchargé jusqu'à 60 fois par heure. Les e-mails, Telegram et les messages Slack ou Discord ne reçoivent jamais ces liens.

Slack et Discord

Collez dans le champ webhook une URL de webhook entrant Slack (https://hooks.slack.com/services/…) ou une URL de webhook de salon Discord (https://discord.com/api/webhooks/…). Formgong envoie alors, au lieu du JSON ci-dessus, un court message de chat avec le nom du formulaire, les réponses, la page et un lien vers l’envoi.

Les mentions comme @everyone, @here et @channel sont désamorcées, un visiteur ne peut pas cacher un lien derrière un autre texte, et les envois longs sont coupés aux limites de la plateforme avec un lien vers l’envoi complet. Les fichiers sont listés par leur nom. L’en-tête X-Signature est toujours envoyé, les nouvelles tentatives et le journal de livraison fonctionnent comme pour tout webhook, et « Envoyer un test » montre l’aspect du message.

Les liens de workflow Slack (hooks.slack.com/triggers/…) et toutes les autres URL reçoivent le JSON.

Make, n8n, Zapier

Créez un module webhook (Make), un Webhook node (n8n) ou un Catch Hook (Zapier), puis collez cette URL dans les réglages du formulaire. Associez ensuite submission.fields.

Recettes pas à pas (en anglais): Make, n8n, Zapier, KeyCRM.

Google Sheets

// Webhook URL: the web app URL + "?key=" + the same SECRET (Apps Script cannot read headers).
const SECRET = "change-me";

function doPost(e) {
  if (e.parameter.key !== SECRET) return reply();
  const body = JSON.parse(e.postData.contents);
  if (body.event !== "submission.created") return reply(); // the dashboard test sends "webhook.test"
  const lock = LockService.getScriptLock();
  lock.waitLock(20000);
  try {
    const sheet = SpreadsheetApp.getActive().getSheetByName("Leads");
    const id = body.submission.id;
    // A retry after a timeout carries the same id: skip rows that are already there.
    if (!sheet.getRange("A:A").createTextFinder(id).matchEntireCell(true).findNext()) {
      const fields = body.submission.fields;
      sheet.appendRow([id, body.submission.created_at, fields.name, fields.email, fields.message]);
    }
  } finally {
    lock.releaseLock();
  }
  return reply();
}

// HtmlService, not ContentService: ContentService answers with a redirect, and a webhook counts a redirect as a failure.
function reply() {
  return HtmlService.createHtmlOutput("ok");
}

KeyCRM

Il n'y a pas de connecteur natif. Dans n8n ou Make, recevez le webhook Formgong et appelez l'API KeyCRM avec votre propre clé. Les champs sont dans submission.fields.

KeyCRM: Recettes pas à pas (en anglais)