E-Mail-Adressen aus Typeform ohne Plugin verifizieren

Typeform ist hervorragend darin, E-Mail-Adressen zu sammeln, und klammheimlich schlecht darin, Ihnen zu sagen, welche davon echt sind. Sein E-Mail-Feld prüft, ob das Eingetippte wie eine Adresse aussieht – es kann nicht bestätigen, dass das Postfach existiert, nicht wegwerfbar ist oder Ihre allererste Nachfrage nicht hart abweist. Dieser Leitfaden zeigt zwei praktische Wege, um E-Mail-Adressen aus Typeform mit Qualisend zu verifizieren: in Echtzeit, mit einem Webhook, der in dem Moment auslöst, in dem eine Antwort eingeht, und im Massenbetrieb, indem Sie die Antworten als CSV exportieren. Keiner davon braucht ein natives Plugin – ein solches gibt es noch nicht – nur die eingebauten Webhooks von Typeform oder dessen Export-Schaltfläche.

Die kurze Antwort#

Wählen Sie den Weg, der dazu passt, wann Sie die Antwort brauchen:

• Echtzeit – richten Sie einen Typeform-Webhook auf eine kleine Serverless-Funktion. Bei jeder Einsendung sendet Typeform die Antwort per POST an Ihren Endpunkt; die Funktion holt die E-Mail-Adresse, ruft die Qualisend-API auf und handelt auf Basis des Verdikts – markiert den Kontakt, leitet ihn an die richtige Liste weiter oder hält die Willkommens-E-Mail bei einer schlechten Adresse zurück.
• Massenbetrieb – exportieren Sie Ihre bestehenden Antworten als CSV, lassen Sie sie durch die Massenverifizierung von Qualisend laufen und unterdrücken Sie die unzustellbaren Adressen vor Ihrem nächsten Versand.

Warum das E-Mail-Feld von Typeform nicht ausreicht#

Der email-Fragetyp von Typeform führt eine Formatprüfung im Browser durch – er stellt sicher, dass es ein @, eine Domain und keinen offensichtlichen Unsinn gibt. Das ist dieselbe Art Prüfung, die ein Regex vornimmt, und sie scheitert aus denselben Gründen: Format ist nicht Zustellbarkeit. jane@gmial.com besteht die Formatprüfung. throwaway@mailinator.com ebenso, und auch eine echt aussehende Adresse bei einer Domain, die letztes Jahr abgeschaltet wurde.

Nichts davon wird erkannt, bis Sie senden – und dann ist eine tote Adresse ein Hardbounce, der an Ihrer Bounce-Rate und Ihrer Absender-Reputation nagt. Echte Verifizierung ergänzt die Ebenen, die Typeform nicht leisten kann: eine DNS-/MX-Abfrage und eine SMTP-Postfachprüfung, dazu Kennzeichnungen für Wegwerf-, Rollen- und Catch-all-Adressen. Falls dieser Ablauf neu für Sie ist, ist was E-Mail-Verifizierung tatsächlich prüft die passende Einführung.

Zwei Wege, E-Mail-Adressen aus Typeform zu verifizieren#

Zuerst die wichtige Einschränkung: Typeform kann eine schlechte E-Mail-Adresse nicht mitten im Formular blockieren. Es gibt keine unterstützte Möglichkeit, zwischen den Fragen eine externe API aufzurufen und einen Teilnehmer am Abschließen zu hindern. Deshalb geschieht die Echtzeit-Verifizierung unmittelbar nach dem Absenden, in einem Webhook – nicht als vorgeschaltete Sperre. Das prägt beide Wege.

Weg 1: Echtzeit mit einem Typeform-Webhook#

Typeform kann jede Antwort an eine von Ihnen kontrollierte URL senden. Fügen Sie im Connect-Bereich des Formulars einen Webhook hinzu und richten Sie ihn auf Ihren Endpunkt. Webhooks sind bei Typeform eine Funktion der kostenpflichtigen Tarife, prüfen Sie also Ihren Tarif, bevor Sie bauen. Wenn eine Antwort abgesendet wird, sendet Typeform per POST eine JSON-Nutzlast, deren form_response.answers-Array jede Antwort enthält – die E-Mail-Adresse steht in der Antwort vom Typ email.

Ihr Endpunkt ist eine Serverless-Funktion, die den API-Schlüssel hält und das Verdikt in eine Aktion überführt. Das Muster ist dasselbe wie im Leitfaden zur Verifizierung bei der Anmeldung: Der Schlüssel bleibt serverseitig, und Sie handeln auf Basis des Ergebnisses. Hier als Next.js Route Handler (in der Entwicklerdokumentation finden Sie den genauen Endpunktpfad und das Anfrageformat):

// app/api/typeform-webhook/route.ts
import { NextResponse } from "next/server";

// Placeholder — confirm the real path in /developers.
const QUALISEND_ENDPOINT = "https://api.qualisend.com/v1/verify";

export async function POST(req: Request) {
  const payload = await req.json();

  // The email lives in the answer whose type is "email".
  const answers = payload.form_response?.answers ?? [];
  const email = answers.find((a) => a.type === "email")?.email;
  if (!email) return NextResponse.json({ ok: true }); // nothing to verify

  const res = await fetch(QUALISEND_ENDPOINT, {
    method: "POST",
    headers: {
      // Store YOUR_API_KEY server-side, never in the browser.
      Authorization: `Bearer ${process.env.QUALISEND_API_KEY!}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ email }),
    signal: AbortSignal.timeout(4000),
  });

  if (!res.ok) return NextResponse.json({ ok: true, degraded: true }); // fail open
  const { result } = await res.json();

  // The submit already happened — route on the verdict instead of blocking.
  if (result.status === "undeliverable" || result.sub_flags?.disposable) {
    // Skip the welcome email, tag the contact for review, keep it off the main list.
  }

  return NextResponse.json({ ok: true, status: result.status });
}

Drei Dinge machen das robust. Antworten Sie schnell: Typeform erwartet zügig ein 2xx, halten Sie den Handler also schlank und geben Sie prompt zurück. Fail open: Wenn die API in ein Timeout läuft oder einen Fehler wirft, verlieren Sie den Lead nicht – nehmen Sie ihn an und prüfen Sie später erneut, weshalb der !res.ok-Zweig weiterhin ok: true zurückgibt. Und verifizieren Sie die Signatur, die Typeform sendet, damit ein Fremder keine gefälschten Antworten per POST an Ihren Endpunkt schicken kann – der Connect-Bereich stellt Ihnen dafür ein Geheimnis bereit.

Eine Tücke in der Nutzlast: Wenn Ihr Formular mehr als eine E-Mail-Frage hat oder Sie robust gegen Umsortierungen sein wollen, gleichen Sie über das field.ref der Antwort ab, statt einfach die erste Antwort mit type === "email" zu greifen. Legen Sie im Typeform-Builder ein stabiles Ref auf die E-Mail-Frage fest und lesen Sie a.field?.ref === "your_ref", damit die richtige Adresse immer die ist, die Sie verifizieren.

Weiter unten im Ablauf ist das Verdikt nur eine Verzweigung. Ein deliverable- Ergebnis fließt direkt in Ihr CRM oder E-Mail-Tool; ein undeliverable- oder disposable-Ergebnis wird markiert, aus der Willkommenssequenz herausgehalten oder in eine Prüf-Warteschlange gelegt – ganz wie Ihr Prozess es erfordert. Der Webhook ist die Verrohrung; die Weiterleitung ist Ihre Sache.

Die Verifizierungslogik selbst ist sprachunabhängig; derselbe Aufruf funktioniert aus einer Python- oder PHP-Funktion, falls das Ihr Stack ist. Der Endpunkt-Code in der Node.js-Anleitung oder der Python-Anleitung lässt sich direkt in einen Webhook-Handler übernehmen – nur das Parsen der Nutzlast oben ist Typeform-spezifisch.

Weg 2: einen CSV-Export im Massenbetrieb verifizieren#

Wenn Sie bereits einen Stapel Antworten haben oder lieber nach Zeitplan bereinigen, als einen Webhook zu verdrahten, gehen Sie in Stapeln vor. Öffnen Sie in Typeform Results → Responses und laden Sie die Daten als CSV (oder XLSX) herunter. Sie erhalten eine Zeile pro Einsendung mit der E-Mail-Adresse in einer eigenen Spalte.

Dann:

1. Laden Sie die CSV in die Massenverifizierung von Qualisend hoch und lassen Sie über jede Zeile den vollständigen Ablauf laufen – MX, SMTP sowie die Kennzeichnungen für Wegwerf/Rolle/Catch-all.
2. Laden Sie die annotierte Datei herunter. Jede Adresse kommt mit einem Status, einem Grund-Code und einer Bewertung von 0 bis 100 zurück.
3. Unterdrücken Sie die unzustellbaren Adressen in dem Tool, aus dem Sie tatsächlich versenden, und behandeln Sie die riskanten Zeilen mit Bedacht. Die durchgängige Routine, inklusive wo welcher Status hingehört, steht in wie man eine E-Mail-Liste bereinigt.

Der Massenbetrieb ist das richtige Werkzeug für einen Rückstau, aber er ist Bereinigung, nicht Prävention: Eine Adresse, die Sie hier abfangen, sitzt meist schon eine Weile in Ihrer Liste. Kombinieren Sie einen regelmäßigen Massendurchlauf mit dem Echtzeit-Webhook, damit neue schlechte Adressen in dem Moment gekennzeichnet werden, in dem sie eintreffen.

Auf das Verdikt reagieren#

Welcher Weg das Ergebnis auch liefert, die Form ist dieselbe – ein status, ein reason, ein score und die Sub-Flags. Ordnen Sie jedem eine Aktion zu:

Häufig gestellte Fragen#

Kann Typeform E-Mail-Adressen eigenständig verifizieren?#

Nur das Format. Der email-Fragetyp von Typeform bestätigt, dass eine Adresse wohlgeformt ist – sie hat ein @ und eine Domain –, aber er löst keine MX-Records auf und prüft das Postfach nicht. Deshalb kommt eine vertippte oder Wegwerf-Adresse, die gültig aussieht, trotzdem durch. Echte Verifizierung braucht die DNS- und SMTP-Ebenen, die ein Dienst wie Qualisend obendrauf ergänzt.

Brauche ich einen kostenpflichtigen Typeform-Tarif, um E-Mail-Adressen in Echtzeit zu verifizieren?#

Für den Webhook-Weg ja – ausgehende Webhooks liegen im Connect-Bereich von Typeform in den kostenpflichtigen Tarifen. Prüfen Sie also Ihren Tarif, bevor Sie den Endpunkt bauen. Wenn Sie in einem Tarif ohne Webhooks sind, nutzen Sie stattdessen den Massen-Weg: Exportieren Sie die Antworten als CSV und verifizieren Sie sie in Stapeln – das funktioniert in jedem Tarif, der den Download der Ergebnisse erlaubt.

Kann ich eine schlechte E-Mail-Adresse blockieren, bevor der Teilnehmer das Formular abschließt?#

Nicht zuverlässig. Typeform bietet keine unterstützte Möglichkeit, mitten im Formular eine externe API aufzurufen und jemanden am Absenden zu hindern. Deshalb läuft die Echtzeit-Verifizierung unmittelbar nach dem Absenden, im Webhook. In der Praxis ist das kein Problem: Sie verifizieren innerhalb von Sekunden und handeln, bevor die Adresse jemals eine Nachricht erhält – Sie halten die Willkommens-E-Mail zurück, markieren den Kontakt oder leiten ihn zur Prüfung weiter, statt das Formular selbst zu blockieren.

Sollte ich den Echtzeit-Webhook oder den CSV-Massenexport verwenden?#

Nutzen Sie den Webhook, wenn das Timing zählt – wenn Sie je Einsendung begrüßen, weiterleiten oder unterdrücken möchten, sobald Antworten eingehen. Nutzen Sie den Massen-Weg, wenn Sie einen Rückstau bereinigen oder eine regelmäßige Pflege durchführen. Die meisten Teams tun beides: Der Webhook hält neue Anmeldungen sauber, und ein gelegentlicher Massendurchlauf fängt alles ab, was durchgerutscht oder mit der Zeit ungültig geworden ist.

Bereit, es zu verdrahten? Holen Sie sich einen scoped Schlüssel und das genaue Anfrageformat in der Entwicklerdokumentation, prüfen Sie eine einzelne Adresse auf die Schnelle im kostenlosen E-Mail-Checker oder starten Sie mit den 100 kostenlosen Credits in jedem Tarif, um den Ablauf durchgängig zu testen.