E-Mail-Adressen in WordPress-Formularen verifizieren

Jedes WordPress-Formular-Plugin sammelt bereitwillig asdf@asdf und hundert vertippte Gmail-Adressen ein und übergibt sie dann direkt an Ihre Verteilerliste. Um E-Mail-Adressen in WordPress-Formularen zu verifizieren, brauchen Sie kein neues Plugin — Sie müssen im Moment der Übermittlung eine Verifizierungs-API aufrufen oder die Einträge exportieren und im Stapel bereinigen. Dieser Leitfaden zeigt beide Wege für die großen drei Formular-Plugins (Contact Form 7, WPForms, Gravity Forms) anhand von Mustern, die unabhängig davon funktionieren, welches Sie einsetzen.

Die kurze Antwort#

Zwei unterstützte Muster, und welches Sie wählen, hängt von Ihrem Plugin und dessen Tarif ab:

1. Echtzeit — klinken Sie sich in das Submit- oder Validierungsereignis des Plugins ein und rufen Sie die Qualisend-API auf, bevor der Eintrag bestätigt wird. Bei den meisten Plugins ist das ein kleines PHP-Snippet an einem Validierungsfilter (die einzige Stelle, an der Sie eine Adresse direkt ablehnen können) oder ein Webhook-Schritt bei den Pro-Tarifen für asynchrones Tagging.
2. Stapel — exportieren Sie die gespeicherten Einträge des Plugins als CSV und lassen Sie sie regelmäßig durch den Stapel-Verifizierer von Qualisend laufen. Kein Code, funktioniert bei jedem Tarif, der Einträge speichert.

E-Mail-Adressen in WordPress-Formularen beim Absenden verifizieren#

Nahezu jedes Formular-Plugin löst ein serverseitiges Ereignis aus, sobald eine Übermittlung eingeht, und dieses Ereignis ist Ihr Integrationspunkt. Der entscheidende Unterschied liegt darin, wann der Hook ausgelöst wird, denn das bestimmt, ob Sie eine fehlerhafte Adresse blockieren können oder nur darauf reagieren:

Wenn der Besucher „diese Adresse scheint nicht zustellbar zu sein" sehen und sie korrigieren soll, benötigen Sie den Validierungsfilter, und das bedeutet ein wenig PHP. Wenn Sie nur tote Adressen aus Ihrem nachgelagerten Tool heraushalten möchten, genügt ein Webhook und Sie brauchen keinen Code.

Hier ist der Validierungsfilter-Ansatz am E-Mail-Validierungsfilter von Contact Form 7. Dieselbe Struktur lässt sich auf Gravity Forms und WPForms übertragen — nur der Hook-Name (gform_field_validation bei Gravity Forms, wpforms_process bei WPForms) und die Art, wie Sie den Fehler anhängen, ändern sich. Wenn Gravity Forms Ihr Plugin ist, führt Sie der Leitfaden zur E-Mail-Verifizierung aus Gravity Forms Schritt für Schritt durch den Hook gform_field_validation mit der exakten GF-spezifischen Verdrahtung. Der API-Schlüssel liegt in einer Konstante in der wp-config.php, niemals in einem Shortcode, einer Theme-Datei oder in Frontend-JavaScript:

// In a snippet plugin, or your theme's functions.php.
// In wp-config.php:  define( 'QUALISEND_API_KEY', 'YOUR_API_KEY' );

add_filter( 'wpcf7_validate_email*', 'qs_verify_email', 20, 2 );
add_filter( 'wpcf7_validate_email',  'qs_verify_email', 20, 2 );

function qs_verify_email( $result, $tag ) {
    $field = $tag->name;
    $email = isset( $_POST[ $field ] ) ? trim( wp_unslash( $_POST[ $field ] ) ) : '';
    if ( $email === '' ) {
        return $result; // let the plugin's own required-field check handle it
    }

    // Check /developers for the exact endpoint and request body.
    $response = wp_remote_post( 'https://api.qualisend.com/v1/verify', array(
        'timeout' => 4, // don't let a slow probe stall the form
        'headers' => array(
            'Authorization' => 'Bearer ' . QUALISEND_API_KEY,
            'Content-Type'  => 'application/json',
        ),
        'body' => wp_json_encode( array( 'email' => $email ) ),
    ) );

    // Fail open: never block a real visitor because our API had a bad moment.
    if ( is_wp_error( $response ) || wp_remote_retrieve_response_code( $response ) !== 200 ) {
        return $result;
    }

    $data    = json_decode( wp_remote_retrieve_body( $response ), true );
    $verdict = $data['result'] ?? array();

    if ( ( $verdict['status'] ?? '' ) === 'undeliverable' ) {
        $result->invalidate( $tag, "That address doesn't look deliverable — please check it." );
    } elseif ( ! empty( $verdict['sub_flags']['disposable'] ) ) {
        $result->invalidate( $tag, 'Please use a permanent email address.' );
    }

    return $result;
}

Drei Dinge tragen dieses Snippet, und es sind in jeder Sprache dieselben drei: Halten Sie den Schlüssel serverseitig, begrenzen Sie die Anfrage mit einem kurzen Timeout und schlagen Sie offen fehl — wenn der Aufruf einen Fehler liefert, in ein Timeout läuft oder etwas anderes als 200 zurückgibt, lassen Sie die Übermittlung durch. Eine Verifizierungs-API ist ein Qualitätsfilter, kein Türsteher, und einen echten Lead durch einen vorübergehenden Ausfall zu verlieren, ist das schlechtere Ergebnis. Für die Mechanik des API-Aufrufs selbst — Header, Fehlerbehandlung, Antwortstruktur — führt Sie der Leitfaden zur E-Mail-Validierung in PHP Schritt für Schritt durch dieselbe Anfrage.

Wenn eigenes PHP keine Option ist, ist die No-Code-Alternative ein Webhook. Wenn Ihr Plugin Webhooks anbietet — Gravity Forms über sein Webhooks-Add-on, WPForms über das Webhooks-Addon, beide in höherwertigen Lizenzen — richten Sie den Webhook auf eine kleine Serverless-Funktion, die Ihren Schlüssel verwahrt und die API aufruft. Der Haken, wie aus der Tabelle oben hervorgeht: Diese Webhooks werden ausgelöst, nachdem der Eintrag gespeichert wurde, sie können also keinen direkten Fehler anzeigen. Was sie aber können, ist asynchron zu verifizieren und auf das Ergebnis zu reagieren — ein Tag hinzufügen, den Autoresponder überspringen oder unzustellbare Adressen aussortieren, bevor sie überhaupt Ihr E-Mail-Tool erreichen. Ein No-Code-Webhook-Schritt (wie ihn Zapier oder Make bereitstellen) funktioniert auf die gleiche Weise: Formularübermittlung rein, API-Aufruf, Ergebnis raus.

Ob ein bestimmtes Plugin Webhooks bereitstellt oder Ihnen erlaubt, eigenes PHP auszuführen, hängt vollständig vom Plugin und dessen Tarif ab — das kostenlose Contact Form 7 gibt Ihnen den Validierungsfilter, aber keine Webhook-Oberfläche; Gravity Forms und WPForms sperren Webhooks hinter kostenpflichtigen Add-ons. Prüfen Sie, was Ihr Tarif umfasst, bevor Sie sich auf einen Weg festlegen.

Auf das Ergebnis reagieren#

Die API gibt ein result-Objekt zurück, das einen status von deliverable, risky, undeliverable oder unknown enthält, dazu einen score von 0 bis 100, einen reason-Code und Sub-Flags für disposable, role, free und catch_all — dasselbe $data['result'], das das Snippet oben ausliest. Ordnen Sie diese einer Formularaktion zu:

Das unmittelbare lokale Ergebnis — Syntax, Domain, Wegwerf, Rolle — ist genau das, was Sie auf einem aktiven Formular haben möchten: Es kommt schnell zurück und fängt den Großteil der fehlerhaften Übermittlungen ab. Die aufwendigere SMTP-Postfachprüfung eignet sich besser für den Stapelweg weiter unten, wo ein paar Sekunden Latenz keine Rolle spielen. Wenn Sie abwägen, warum jede Prüfung dort sitzt, wo sie sitzt, schlüsselt wie E-Mail-Verifizierung funktioniert die Pipeline auf.

Oder Einträge im Stapel aus einem CSV-Export verifizieren#

Nicht jedes Formular braucht ein Echtzeit-Gate, und bei manchen Plugins ist eigener Code umständlich. Die Alternative ganz ohne Code besteht darin, Übermittlungen ansammeln zu lassen und sie regelmäßig zu bereinigen.

1. Einträge als CSV exportieren. Gravity Forms hat Import/Export → Einträge exportieren; WPForms bietet einen Eintragsexport in der Pro-Version; Contact Form 7 speichert standardmäßig nichts, kombinieren Sie es also mit dem kostenlosen Flamingo-Plugin, um Übermittlungen zuerst zu erfassen.
2. Die CSV im Stapel verifizieren. Laden Sie sie in den Stapel-Verifizierer von Qualisend hoch, der die vollständige Pipeline — einschließlich der SMTP-Prüfung — auf jede Zeile anwendet und eine bewertete Datei zurückgibt.
3. Filtern und synchronisieren. Behalten Sie deliverable, prüfen Sie risky und entfernen Sie undeliverable, bevor Sie die verbliebenen Adressen in Ihre E-Mail-Plattform importieren.

Das ist derselbe Ablauf wie bei jeder Listenbereinigung, nur aus der Eintragstabelle Ihres Formulars gespeist — der Leitfaden zum Bereinigen einer E-Mail-Liste behandelt die Schleife aus Exportieren, Verifizieren und Reimportieren vollständig. Die Stapelverifizierung ist auch das richtige Werkzeug für die Adressen, die Sie bereits gesammelt haben, bevor Sie eine Echtzeitprüfung hinzugefügt haben: Lassen Sie den Altbestand einmal durchlaufen und lassen Sie danach den Hook beim Absenden die Liste von hier an sauber halten.

Echtzeit, Stapel oder beides#

Sie lösen unterschiedliche Probleme, daher wollen die meisten Websites am Ende beides:

• Echtzeit ist Vorbeugung. Ein beim Absenden abgefangener Tippfehler ist ein geretteter Lead mit einer einzeiligen Korrektur; eine dort abgelehnte tote Domain wird nie zu einem Hard Bounce, der Ihre Bounce-Rate belastet.
• Stapel ist Aufräumen. Adressen verfallen — Menschen wechseln den Job, Domains laufen aus —, sodass selbst eine perfekt geschützte Liste eine regelmäßige erneute Verifizierung braucht.

Einen Hook beim Absenden mit einem monatlichen Stapeldurchlauf zu kombinieren, folgt derselben Logik wie das Verbinden der Verifizierung mit einem Double-Opt-in-Ablauf: Stoppen Sie den offensichtlichen Müll an der Tür und kehren Sie den Rest regelmäßig zusammen.

Häufig gestellte Fragen#

Kann ich E-Mail-Adressen in Contact Form 7 ohne kostenpflichtiges Add-on verifizieren?#

Ja. Contact Form 7 stellt den Filter wpcf7_validate_email in seiner kostenlosen Version bereit, sodass ein kleines PHP-Snippet wie das oben die API aufrufen und unzustellbare oder Wegwerf-Adressen direkt ablehnen kann — ganz ohne Add-on. Sie müssen allerdings in der Lage sein, Code hinzuzufügen (über die functions.php Ihres Themes oder ein Code-Snippet-Plugin) und Ihren API-Schlüssel in der wp-config.php zu hinterlegen.

Kann ein Webhook von Gravity Forms oder WPForms eine fehlerhafte Adresse direkt ablehnen?#

In der Regel nicht. Diese Webhooks werden ausgelöst, nachdem der Eintrag gespeichert wurde, laufen also asynchron und können dem Besucher keine Validierungsfehlermeldung anzeigen. Sie eignen sich ideal, um unzustellbare Adressen zu markieren, weiterzuleiten oder zu unterdrücken, bevor sie Ihr E-Mail-Tool erreichen. Für eine direkt sichtbare Ablehnung, die der Besucher sieht, verwenden Sie stattdessen den Validierungsfilter des Plugins mit eigenem PHP-Code.

Gibt es ein natives Qualisend-Plugin für WordPress?#

Derzeit nicht — unsere nativen Plattform-Integrationen werden gerade neu aufgebaut, und ein WordPress-Connector ist in Planung. Bis er verfügbar ist, sind die unterstützten Ansätze die beiden aus diesem Leitfaden: die REST-API aus einem Formular-Hook, einem Webhook oder einer Serverless-Funktion aufrufen oder Einträge als CSV exportieren und im Stapel verifizieren. Beide nutzen die dokumentierte API direkt.

Sollte ich beim Absenden verifizieren oder Einträge im Stapel bereinigen?#

Beides, aus unterschiedlichen Gründen. Die Verifizierung beim Absenden verhindert, dass Tippfehler und Wegwerf-Adressen überhaupt erst auf Ihre Liste gelangen, mit sofortigem Feedback an den Besucher. Die Stapelverifizierung erfasst Adressen, die nach dem Erfassen verfallen sind, und bereinigt den Altbestand, den Sie gesammelt haben, bevor Sie eine Echtzeitprüfung hinzugefügt haben. Ein Hook beim Absenden plus ein regelmäßiger Stapeldurchlauf deckt beides ab.

Bereit, es einzurichten? Der kostenlose Tarif enthält Credits, um beide Wege zu testen, die API-Referenz hat die genaue /verify-Anfrage für Ihren Hook oder Ihre Serverless-Funktion, und der kostenlose E-Mail-Checker lässt Sie eine einzelne Adresse stichprobenartig prüfen, bevor Sie eine einzige Zeile Code schreiben.