Formgong + Make: Formular-Einsendungen im Szenario

Bevor Sie starten

• Formgong: jeder Tarif. Ein Formular im Free-Tarif kann einen Webhook haben, in Pro und Business fünf.
• Make: der Free-Tarif reicht. Er hat 1.000 Credits im Monat und zwei aktive Szenarien. Auch das Lesen von Webhook-Daten verbraucht Credits.
• Datenschutz: Make nennt AWS in der EU oder Nordamerika als Hosting. Prüfen Sie, wo Ihre Make-Organisation liegt, bevor Sie personenbezogene Daten senden.
• Zeit: etwa zehn Minuten und eine Test-Einsendung.

Die Oberfläche von Make ist englisch, deshalb stehen die Button-Namen unten auf Englisch.

Schritt für Schritt

1. Legen Sie in Make ein Szenario an. Suchen Sie Webhooks und wählen Sie Custom webhook.
2. Klicken Sie neben Webhook auf Add. Geben Sie einen Namen ein, etwa „Formgong – Kontakt“. Lassen Sie API Key authentication leer: Formgong kann den Header x-make-apikey nicht senden. Klicken Sie auf Save und kopieren Sie die URL.
3. Öffnen Sie in Formgong Meine Formulare → Ihr Formular → Formulareinstellungen → Webhook. Fügen Sie die URL ein und klicken Sie auf „Webhook hinzufügen“.
4. Klicken Sie in Make auf Run once. Das Modul wartet jetzt auf Daten.
5. Senden Sie eine echte Einsendung von Ihrer Website. Sie ist besser als „Test senden“, denn der Test hat nur das Feld message.
6. Make zeigt die erkannte Datenstruktur. Fügen Sie das nächste Modul hinzu, etwa Google Sheets → Add a row, und ordnen Sie die Felder zu.
7. Speichern Sie das Szenario und schalten Sie es ein. Webhook-Szenarien laufen, sobald Daten ankommen.

Was Make empfängt

Jede echte Einsendung kommt als ein JSON-Paket. Ihre Formularfelder stehen unter submission.fields, mit den Namen aus Ihrem HTML. Alle Werte sind Text.

{
  "event": "submission.created",
  "form": {
    "id": "6f1c2a9e-4b7d-4e0a-9c3f-2d8b5e7a1f40",
    "name": "Kontakt"
  },
  "submission": {
    "id": "b3e04c51-8a2f-4d6e-9f17-0c5a3b8d2e96",
    "created_at": "2026-10-03T09:15:00.000Z",
    "page_url": "https://example.com/contact",
    "fields": {
      "name": "Jonas Weber",
      "email": "jonas@example.com",
      "phone": "+4915112345678",
      "message": "Bitte ein Angebot für 20 Stück",
      "utm_source": "google"
    },
    "is_spam": false
  }
}

Steuerfelder wie access_key, _redirect und botcheck werden entfernt. Nimmt das Formular Dateien an, kommt eine Liste attachments mit Namen, Größen und Links dazu. Die Links öffnet nur der angemeldete Formularinhaber, Make kann die Dateien also nicht laden.

POST <your webhook URL>
Content-Type: application/json
User-Agent: Formgong-Webhook
X-Formgong-Event: submission.created
X-Signature: sha256=<64 hex characters>

Feldzuordnung

In Make ist Modul 1 der Custom webhook. Klicken Sie ein Feld im Zuordnungsfenster an oder tippen Sie den Pfad.

Kommt später ein Feld dazu, öffnen Sie das Webhook-Modul, klicken Sie auf Detect new values und senden Sie eine weitere Einsendung.

Optional: Signatur prüfen

Wer die Webhook-URL kennt, könnte gefälschte Daten schicken. Die Signatur verhindert das. Formgong signiert den Roh-Body mit HMAC-SHA256 und dem „Signatur-Secret“ aus dem Webhook-Tab.

1. Bearbeiten Sie den Webhook in Make: Get request headers auf Yes, JSON pass-through einschalten.
2. Fügen Sie nach dem Webhook einen Filter mit der Bedingung unten ein. Die Make-Funktion sha256 liefert ein HMAC, wenn Sie einen Schlüssel angeben.
3. Fügen Sie nach dem Filter JSON → Parse JSON ein, damit Sie die Felder wieder zuordnen können.

Filter condition (Text operators: Equal to)

  sha256(<raw JSON text from module 1>; "hex"; "<your signing secret>")

  equals

  replace(first(map(1.headers; "value"; "name"; "x-signature")); "sha256="; "")

Prüfen Sie die Namen im ersten Paket: Header-Namen kommen meist kleingeschrieben an. Testen Sie mit einer echten Einsendung, bevor Sie sich darauf verlassen. Das Secret sieht jeder, der das Szenario bearbeiten darf. Wenn Sie in Formgong „Secret erneuern“ klicken, passen Sie auch den Filter an.

Tests und Wiederholungen

• Make antwortet mit 200 Accepted, sobald das Paket in der Warteschlange liegt. Formgong markiert die Zustellung als erfolgreich.
• Unter „Letzte Zustellungen“ zeigt Formgong jeden Versuch mit Statuscode. Dort beginnen Sie, wenn Daten fehlen.
• Antwortet Make mit einem Fehler oder braucht über 10 Sekunden, wiederholt Formgong nach 30 Sekunden, 2, 10 und 30 Minuten.
• Eine Wiederholung nach langsamer Antwort kann dieselbe Einsendung doppelt bringen. Filtern Sie Dubletten über submission.id.

Fehlerbehebung

• 410 Gone: Make deaktiviert einen Webhook, der 5 Tage keinem Szenario zugeordnet war. Ordnen Sie ihn neu zu oder legen Sie einen neuen an und ändern Sie die URL in Formgong.
• 400 Queue is full: Das Szenario ist aus oder hat keine Credits mehr, und die Warteschlange ist voll. Schalten Sie es ein oder kaufen Sie Credits nach; Formgong versucht es etwa 42 Minuten lang.
• 429: Make nimmt pro Webhook bis zu 300 Requests in 10 Sekunden an. Ein Formular erreicht das selten.
• Felder fehlen: Klicken Sie auf Detect new values und senden Sie eine neue Einsendung.
• Checkbox-Gruppe in einem Feld: Angehakte Boxen mit gleichem Namen kommen als ein Text an, zum Beispiel E-Mail, Telefon. Ein Array erhalten Sie mit {{split(1.submission.fields.contact; ", ")}}.
• „Letzte Zustellungen“ leer: Die Einsendung wurde als Spam markiert oder zurückgehalten. Sehen Sie im Posteingang des Formulars nach.