Webhooks

Formgong sendet JSON per POST und eine HMAC-SHA256-Signatur des Roh-Bodys. Das Secret finden Sie in den Formulareinstellungen. Bis zu 5 Versuche; Wiederholungen nach 30 s, 2 min, 10 min und 30 min.

Schlägt auch der letzte Versuch fehl, schreibt Formgong dem Formularinhaber eine E-Mail. Dieselbe E-Mail geht hinaus, wenn nach denselben Wiederholungen ein Slack- oder Discord-Webhook, ein anderer Webhook, Google Sheets oder Telegram fehlschlägt. Höchstens eine E-Mail am Tag pro Formular und Kanal, in jedem Tarif einschließlich Free. Eine Telegram-E-Mail nennt das Problem in klaren Worten (zum Beispiel der Bot wurde aus der Gruppe entfernt, der Chat wurde nicht gefunden oder der Nutzer hat den Bot blockiert) und wie Sie neu verbinden: einen neuen Code in den Formulareinstellungen erstellen, den Bot-Link öffnen oder den Bot der Gruppe hinzufügen und /connect mit diesem Code senden.

{
  "event": "submission.created",
  "form": { "id": "…", "name": "…" },
  "submission": {
    "id": "…",
    "created_at": "2026-09-29T12:00:00.000Z",
    "page_url": "https://example.com/",
    "fields": { "name": "Anna", "email": "anna@example.de" },
    "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);
}

Dateilinks in Webhooks

Jede hochgeladene Datei im Webhook bekommt eine signierte download_url, die sich bis zum Ablauf ohne Anmeldung öffnen lässt. Wer den Link hat, kann die Datei herunterladen. Schalten Sie das also nur ein, wenn der Dienst, der Ihren Webhook empfängt, die Dateien braucht. Ausschalten, das Webhook-Secret erneuern oder die Einsendung löschen stoppt die Links sofort.

Zum Einschalten öffnen Sie die Einstellungen des Formulars, erlauben Dateianhänge und wählen dann im Webhook-Bereich unter „Dateilinks in Webhooks“ 24 Stunden oder 7 Tage und speichern. Nur danach gesendete Webhooks enthalten die Links.

"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"
}]

Danach hat jede Datei in submission.attachments zusätzlich download_url und download_expires_at. Der empfangende Dienst lädt die Datei mit einer einfachen GET-Anfrage herunter, ohne Header und ohne Anmeldung. Nach Ablauf liefert der Link 404, und eine Datei lässt sich bis zu 60-mal pro Stunde herunterladen. E-Mails, Telegram sowie Slack- oder Discord-Nachrichten bekommen diese Links nie.

Slack und Discord

Fügen Sie eine Slack-Incoming-Webhook-URL (https://hooks.slack.com/services/…) oder eine Discord-Kanal-Webhook-URL (https://discord.com/api/webhooks/…) in das Webhook-Feld ein. Formgong sendet dann statt des JSON oben eine kurze Chat-Nachricht mit dem Formularnamen, den Antworten, der Seite und einem Link zur Einsendung.

Erwähnungen wie @everyone, @here und @channel werden entschärft, Besucher können keinen Link hinter anderem Text verstecken, und lange Einsendungen werden auf die Grenzen der Plattform gekürzt, mit einem Link zur vollständigen Einsendung. Dateien erscheinen mit ihrem Namen. Der Header X-Signature wird weiter gesendet, Wiederholungen und das Zustellprotokoll funktionieren wie bei jedem Webhook, und „Test senden“ zeigt, wie die Nachricht aussieht.

Slack-Workflow-Links (hooks.slack.com/triggers/…) und alle anderen URLs erhalten das JSON.

Make, n8n, Zapier

Erstellen Sie ein Webhook-Modul (Make), einen Webhook-Knoten (n8n) oder einen Catch Hook (Zapier) und fügen Sie die entsprechende URL in die Formulareinstellungen ein. Ordnen Sie von dort aus submission.fields zu.

Schritt-für-Schritt-Anleitungen: 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");
}

HTML-Formular in Google Sheets: 2 kostenlose Wege →

KeyCRM

Es gibt keinen nativen Konnektor. Empfangen Sie in n8n oder Make den Formgong-Webhook und rufen Sie die KeyCRM-API mit Ihrem eigenen Schlüssel auf. Lesen Sie die Felder aus submission.fields aus.

KeyCRM: Schritt-für-Schritt-Anleitungen