# Das Kontaktformular versendet keine E-Mail? Überprüfen Sie, an welcher Stelle der Vorgang ins Stocken gerät

Analysieren Sie ein Kontaktformular, das zwar eine erfolgreiche Übermittlung anzeigt, jedoch keine E-Mail versendet. Überprüfen Sie die Netzwerkantwort, die gespeicherte Einsendung, die verifizierten Empfänger, den Spam-Filter und Turnstile.

Author: Formgong
Published: 2026-10-01
Language: de
Canonical: https://formgong.com/de/blog/contact-form-not-sending-email/

Falls ein Formular den Erfolg anzeigt, aber keine E-Mail eintrifft, überprüfen Sie drei Schritte: ob die Website eine Anfrage gesendet hat, ob die Einsendungen gespeichert wurden und ob die E-Mail-Benachrichtigungen einen verifizierten Empfänger haben. Überprüfen Sie in Formgong zudem den Spam-Ordner, die E-Mail-Verifizierung und mögliche Turnstile-Fehler. „success: true“ bestätigt die Annahme der Anfrage, nicht den Eingang der E-Mail in Ihrem Postfach.

## 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.

## 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`.

```javascript
// 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 die KI-Bewertung mit Spam-Filter aktiviert ist, überprüfen Sie auch diesen Status. 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](/de/blog/website-form-to-telegram/). Falls das Formular noch nicht verbunden ist, beginnen Sie mit dem [funktionierenden HTML-Beispiel](/de/blog/html-contact-form-without-backend/) oder [der Lovable-Einrichtung](/de/blog/lovable-contact-form-email-telegram/). 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

- [MDN: Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch)
- [Cloudflare: Turnstile token validation](https://developers.cloudflare.com/turnstile/get-started/server-side-validation/)
- [Formgong-Dokumentation](https://formgong.com/de/docs/)

[Formularschlüssel holen](https://formgong.com/de/#top)
