Drei verschiedene Ergebnisse, die getrennt behandelt werden müssen
Eine Erfolgsmeldung auf einer Website, ein gespeicherter Datensatz und eine E-Mail in Ihrem Posteingang sind separate Ereignisse. JavaScript zeigt möglicherweise eine Dankesmeldung an, bevor der Server antwortet. Der Server nimmt eine Anfrage möglicherweise an, während eine Benachrichtigung auf die Adressüberprüfung wartet oder vom E-Mail-Postfach gefiltert wird.
Befolgen Sie den Ablauf in der angegebenen Reihenfolge: Browseranfrage, gespeicherte Einsendung, dann Benachrichtigungskanal. Senden Sie eine eindeutige Test-Einsendung von der veröffentlichten Website, damit Sie dieselbe Nachricht in jeder Phase identifizieren können.
Die folgenden Schritte beziehen sich speziell auf Formgong. Der Ansatz gilt auch für andere Dienste; überprüfen Sie jedoch deren Dokumentation hinsichtlich der jeweiligen Fehlercodes und Einstellungen.
Schnelle Lösungen nach Symptom
Suchen Sie die Zeile, die zu dem passt, was Sie sehen, beheben Sie die Ursache und senden Sie einen Test von der veröffentlichten Website.
- Im Tab „Netzwerk“ gibt es keine Anfrage. Der Button zeigt nur eine Meldung. Verbinden Sie den Submit-Handler mit einer echten POST-Anfrage.
- Die Anfrage liefert einen Fehler. Lesen Sie den Fehlercode in der Antwort und korrigieren Sie den Schlüssel, die erlaubte Domain oder den Turnstile-Token. Die Codes stehen weiter unten.
- Die Einsendung ist gespeichert, aber keine E-Mail kommt an. Prüfen Sie den Spam-Ordner, ob E-Mail-Benachrichtigungen für dieses Formular aktiv sind und ob die Empfängeradresse bestätigt ist.
- Ihr eigener Code verschickt die E-Mail. E-Mail-APIs wie Resend senden nur von einer verifizierten Domain. Eine Gmail-Adresse als Absender scheitert deshalb. Senden Sie von Ihrer eigenen Domain und tragen Sie die Adresse des Besuchers als Reply-To ein.
- Das Formular gehört zu einem Website-Baukasten. Wix verschickt die E-Mail über eine Automation mit eigenen Empfängern. Shopify schickt jede Nachricht an die Absender-E-Mail des Shops.
1. Prüfen Sie, ob die Website eine Anfrage sendet
Öffnen Sie die Entwicklertools Ihres Browsers, wählen Sie „Netzwerk“ aus und senden Sie das Formular ab. Suchen Sie den POST-Request an https://formgong.com/submit. Überprüfen Sie dessen URL, access_key, die übermittelten Felder und die Antwort.
Falls keine Anfrage vorliegt, überprüfen Sie den Absende-Handler oder die Schaltfläche: Eine Dankesseite allein sendet keine Daten. Falls die URL abweicht, stellen Sie fest, welcher Dienst das Formular tatsächlich verarbeitet. Bei reinem HTML überprüfen Sie action und method; bei JavaScript die URL im fetch-Aufruf.
Für eine JSON-Antwort senden Sie Accept: application/json. Ein natives HTML-Formular erhält nach der Übermittlung eine Weiterleitung, nicht JSON. Behandeln Sie diese beiden Modi nicht so, als handele es sich um dieselbe Antwort.
2. Überprüfen Sie die Antwort, bevor Sie den Erfolg anzeigen
Überprüfen Sie bei JavaScript den HTTP-Status und result.success === true. Auch ein abgeschlossenes fetch kann eine Fehlerantwort liefern. Diese Funktion ist für den Submit-Handler Ihres Formulars vorgesehen; ersetzen Sie den Schlüssel und umschließen Sie den Aufruf mit try/catch.
// Call from your form's submit handler inside try/catch.
// Keep the entered fields when the request fails.
async function sendContactForm(form) {
const response = await fetch("https://formgong.com/submit", {
method: "POST",
headers: {
"Content-Type": "application/json",
Accept: "application/json",
},
body: JSON.stringify({
...Object.fromEntries(new FormData(form)),
access_key: "fk_your_access_key",
}),
});
const result = await response.json();
if (!response.ok || result.success !== true) {
throw new Error(result.message || "Submission failed");
}
// Accepted by Formgong; this is not email-delivery confirmation.
return result.id;
}Zu beachtende Fehlercodes
- unknown_access_key
- Der Schlüssel stimmt nicht mit einem Formular überein. Kopieren Sie ihn erneut unter „Website einbinden“.
- origin_not_allowed
- Die Domain stimmt nicht mit der konfigurierten Zulassungsliste überein. Überprüfen Sie sowohl die eigentliche als auch die Vorschau-Domain.
- turnstile_missing / turnstile_failed
- Das Turnstile-Token fehlt oder ist ungültig. Aktualisieren Sie den Widget-Code und rufen Sie ein neues Token ab.
- rate_limited / limit_exceeded
- Ein kurzfristiges Anforderungslimit oder das monatliche Kontingent wurde überschritten. Wiederholte, schnelle Neuversuche beheben das Problem nicht.
Halten Sie die Felder ausgefüllt und zeigen Sie eine verständliche Meldung an, wenn die Einsendung fehlschlägt. Deaktivieren Sie die Schaltfläche, solange die Anfrage aussteht, und aktivieren Sie sie wieder, sobald der Versuch abgeschlossen ist.
3. Überprüfen Sie den gespeicherten Datensatz und den Spam-Status
Öffnen Sie in Formgong den Bereich „Einsendungen“ des entsprechenden Formulars und suchen Sie Ihre Testnachricht. Überprüfen Sie auch den Spam-Ordner. Falls das versteckte Feld botcheck versehentlich ausgefüllt wurde, kann die Anfrage erfolgreich erscheinen, während die Nachricht als Spam eingestuft und nicht zugestellt wird.
Vergewissern Sie sich, dass der Schlüssel der Website zu dem von Ihnen geöffneten Formular gehört. Falls das Formular wahrscheinlichen Spam zurückhält, prüfen Sie auch den Spam-Tab. Die Annahme einer Anfrage garantiert nicht die Zustellung einer Benachrichtigung für jede Nachricht, unabhängig vom Schutz.
4. Überprüfen Sie die Verifizierung, Benachrichtigungen und Empfänger
- Überprüfen Sie die E-Mail-Adresse des Kontoinhabers. Normale Einsendungen können vor der Überprüfung zurückgehalten werden.
- Stellen Sie sicher, dass E-Mail-Benachrichtigungen für dieses Formular aktiviert sind.
- Überprüfen Sie die Adresse des vorgesehenen Empfängers und deren Verifizierung. Eine hinzugefügte, aber noch nicht verifizierte Adresse ist noch kein Zustellziel.
- Überprüfen Sie den Spam-Ordner, den Ordner „Alle E-Mails“, E-Mail-Filter und Weiterleitungsregeln.
Eine im Posteingang und in Telegram erscheinende Einsendung hilft dabei, die Untersuchung auf den E-Mail-Kanal einzugrenzen. Sie beweist jedoch nicht, dass eine E-Mail das Postfach des Empfängers erreicht hat. Eine automatische Antwort an den Besucher ist zudem eine separate Nachricht mit eigenen Einstellungen.
Falls das Problem nach der Aktivierung von Turnstile aufgetreten ist
Ihr Formular muss cf-turnstile-response mitsenden, und der Dienst muss es prüfen. Das Widget allein reicht nicht aus. Turnstile-Token verfallen und sind nur einmal verwendbar; ein erneuter Versuch erfordert möglicherweise das Aktualisieren des Widgets.
Kopieren Sie das aktuelle Beispiel unter „Website einbinden“, nachdem Sie die Schutzeinstellungen geändert haben. Testen Sie die veröffentlichte Domain. Bewahren Sie den Turnstile-Secret außerhalb des Browsers auf; der Frontend-Code verwendet den Site-Key.
Welche Daten sollten erfasst werden, wenn die Ursache unklar bleibt?
Behalten Sie die URL der Formularseite, den Testzeitpunkt, den HTTP-Status und den Antwortfehlercode bei. Falls die Antwort eine ID für Einsendungen enthält, behalten Sie diese ebenfalls bei. Veröffentlichen Sie in einer Supportanfrage keine echten Kundendaten, Tokens oder geheimen Schlüssel.
Für einen anderen Kanal befolgen Sie bitte die Telegram-Anleitung. Falls das Formular noch nicht verbunden ist, beginnen Sie mit dem funktionierenden HTML-Beispiel oder der Lovable-Einrichtung. Wiederholen Sie nach der Korrektur den Test und überprüfen Sie den gesamten Ablauf bis zur Benachrichtigung.
Häufig gestellte Fragen
Bedeutet „success: true“, dass die E-Mail zugestellt wurde?
Nein. Dies bestätigt lediglich, dass Formgong die Anfrage entgegengenommen hat. Die Zustellung der Benachrichtigung erfolgt separat; auch eine Spam-Einstufung oder eine Zurückhaltung bis zur E-Mail-Verifizierung können dies beeinflussen.
Warum kommt die Einsendung in Telegram an, aber nicht per E-Mail?
Es handelt sich hierbei um separate Kanäle. Stellen Sie sicher, dass E-Mail-Benachrichtigungen aktiviert sind, der vorgesehene Empfänger verifiziert ist und die E-Mail nicht im Spam-Ordner gelandet ist.
Warum zeigt ein ausgefülltes botcheck-Feld keinen Fehler an?
Es handelt sich um einen Honeypot für Bots. Eine Anfrage kann erfolgreich erscheinen, während sie ohne Benachrichtigung als Spam gespeichert wird. Eine Person sollte dieses versteckte Feld leer lassen.
Was soll ich nach einem Turnstile-Fehler tun?
Überprüfen Sie den aktuellen Website-Schlüssel und das Feld cf-turnstile-response. Beziehen Sie für den erneuten Versuch ein neues Token: Tokens sind nur einmal verwendbar und verfallen.
Quellen und Dokumentation
Offizielle Quellen zu dieser Anleitung: MDN: Fetch API, Cloudflare: Turnstile token validation. Formgong-Dokumentation, wo die Daten gespeichert werden.
Verwandte Anleitungen
- Lovable-Formular an E-Mail und Telegram senden
- HTML-Kontaktformular ohne Backend: ein funktionierendes Beispiel
- So senden Sie Website-Einsendungen an Telegram
- Website-Leads in Telegram verwalten – ohne CRM
- Formular-Backend für KI-Websites: Lovable, Bolt, v0, Cursor
- Telegram-Bot fürs Kontaktformular: selbst bauen?
- Formular-Backend und DSGVO: 7 Prüfpunkte
- Kontaktformular-Spamschutz ohne Captcha
- Mailto-Formular in HTML: warum es scheitert
- HTML-Formular in Google Sheets: 2 kostenlose Wege
- Webflow-Formular-Limit: was tun nach 50?
- Turnstile vs. reCAPTCHA vs. hCaptcha im Vergleich
- Contact Form 7 und Elementor an Telegram senden
- Squarespace-Formular sendet keine E-Mail?
- Shopify-Kontaktformular: Wohin gehen Mails?
- Google Formular an Telegram: kostenlos
- Wix-Kontaktformular sendet keine E-Mail?
- EU-/DSGVO-Formspree-Alternativen im Vergleich
- WordPress-Kontaktformular ohne Plugin
- Kontaktformulare, die nichts senden: 793 KI-Websites im Test
- Formspree „Form not found“ und andere Fehler: Lösungen
- Web3Forms-Fehler: „Invalid access key“ und 403 erklärt
- Kundenbewertungen kostenlos auf der Website einbinden
- Kontaktformular „Failed to fetch“: Ursachen und Lösungen
- WooCommerce-Produktanfrageformular
- Contact Form 7 oder WPForms
- Gravity Forms Alternative kostenlos
- WordPress Kontaktformular kostenlos
- Formular-Mails landen im Spam: die Lösung
- HTML-Formular sendet nicht ab: die fünf Schalter
- Kontaktformular funktioniert nicht: Fehler finden