Durchführung einer E-Mail-Zustellbarkeitsprüfung für eine vorbereitete Liste

Ein Schritt-für-Schritt-Workflow für die Bulk-E-Mail-Verifizierung mit EmailCheckPro: Datei vorbereiten, Task starten, Status abfragen und das Ergebnis verarbeiten.

Die Bulk-E-Mail-Verifizierung mit EmailCheckPro ist ein asynchroner Prozess. Sie bereiten eine einfache TXT- oder CSV-Datei mit einer vollständigen Adresse pro Zeile vor, übermitteln diese als Bulk-Task, fragen den Status ab, bis der Task abgeschlossen ist, und laden eine CSV-Datei mit den Ergebnissen herunter. Jede Adresse wird als Zustellbar (sie konnte zum Zeitpunkt der Prüfung E-Mails empfangen) oder Nicht zustellbar gemeldet. Adressen, die nicht abschließend geprüft werden konnten, wie etwa bei Catch-All-Domains, bleiben Unbestimmt und werden separat behandelt. Die Prüfung sendet keine Nachrichten an die Adressen auf der Liste.

Vorbereitung der Liste vor einer Bulk-E-Mail-Verifizierung

Die meisten fehlerhaften oder ineffizienten Durchläufe liegen an der Datei, nicht an der Prüfung. Gehen Sie vor der Übermittlung diese kurze Liste durch:

• Verwenden Sie nur TXT oder CSV. Eine vollständige Adresse pro Zeile, bestehend aus einem lokalen Teil, einem @-Zeichen und einer Domain. Tabellenformate wie XLSX werden nicht akzeptiert; exportieren Sie diese daher zuerst als CSV.
• Entfernen Sie Leerzeichen und offensichtliche Tippfehler. Ein versehentliches Leerzeichen oder eine fehlende Domain macht eine Zeile unbrauchbar.
• Entfernen Sie Duplikate, wo möglich. Ungültige und doppelte Zeilen werden während der Vorbereitung entfernt, aber eine eigene Bereinigung stellt sicher, dass die Anzahl Ihren Erwartungen entspricht.
• Behalten Sie ein Produkt pro Datei bei. Eine Zustellbarkeitsdatei und eine Profilbilddatei sind unterschiedliche Aufgaben. Die Profilbildprüfung für E-Mails akzeptiert nur Gmail-, Yandex- und Mail.ru-Adressen; eine gemischte Liste gehört daher in die Zustellbarkeitsprüfung.
• Beachten Sie die produktspezifischen Limits. Dateigröße und Adressanzahl variieren je nach Produkt; die API-Dokumentation listet die aktuellen Limits auf.

Behalten Sie den ursprünglichen Export unverändert bei. Sie werden die Ergebnisse später wieder mit diesem zusammenführen.

Starten des Tasks und Abfragen des Status

Bulk-Tasks werden über POST /api/v1/bulk-tasks durch Hochladen der vorbereiteten Datei übermittelt. Der Aufruf liefert keine direkten Ergebnisse; er erstellt einen Task, der im Hintergrund läuft. Dies ist der entscheidende Unterschied zur Echtzeitprüfung: Während eine Einzelprüfung und eine synchrone Prüfung mehrerer Adressen direkt antworten, ist ein Bulk-Task ein Vorgang, dessen Ergebnis Sie später abrufen.

Prüfen Sie den Fortschritt mit GET /api/v1/bulk-tasks/{id}. Fragen Sie den Status nicht häufiger als alle 30 Sekunden ab; eine engere Taktung erhöht die Anzahl der Anfragen, ohne den Task schneller abzuschließen. Wenn der Status success meldet, enthält die Antwort einen Download-Link für eine CSV-Datei. Dieser Link bleibt 12 Stunden lang gültig. Ein erneutes Abfragen desselben Tasks aktualisiert den Link, sodass ein verpasstes Zeitfenster nicht zum Verlust der Ergebnisse führt.

Wenn die Vorbereitung fehlschlägt, beispielsweise weil eine Datei nicht unterstützte Inhalte enthält, wird der Task nicht berechnet. Korrigieren Sie die Datei und übermitteln Sie sie erneut.

Lesen der Ergebnis-CSV

Die Zustellbarkeitsprüfung gibt eine CSV-Datei zurück. Sie ordnet jeder Adresse ein Kennzeichen zu, das anzeigt, ob sie Zustellbar war. Die Profilbildprüfung für E-Mails fügt eine Spalte für ein öffentliches Profilbild und einen Link dazu hinzu; der Link kann leer sein, auch wenn ein Profilbild gefunden wurde.

Sortieren Sie die Zeilen in drei Gruppen:

Eine fehlende oder Unbestimmt-Zeile ist kein Urteil für Nicht zustellbar. Nur abgeschlossene Ergebnisse sind kostenpflichtig, daher werden Unbestimmt-Zeilen nicht berechnet.

Ergebnisse in die Praxis umsetzen

Führen Sie die Ergebnis-CSV anhand der Adressspalte wieder mit Ihrem ursprünglichen Export zusammen und schreiben Sie das Urteil in ein Feld in Ihrem CRM oder Versand-Tool, anstatt Zeilen zu löschen. Dies bewahrt einen Prüfpfad und ermöglicht es Ihnen, nur die Datensätze erneut zu prüfen, die sich geändert haben.

Zwei Vorgehensweisen sind hilfreich. Erstens: Führen Sie die Prüfung zeitnah zum Versand oder Import durch, da ein Ergebnis die Adresse zum Zeitpunkt der Prüfung beschreibt und keine Aussage über ihren zukünftigen Status trifft. Es ist ein Baustein für die Listenhygiene, neben Ihren eigenen Unterdrückungs- und Einwilligungslisten.

Für kleinere Nachprüfungen, wie etwa einige hundert neue Anmeldungen, ist ein synchroner Aufruf für mehrere Adressen (1 bis 100 Adressen) einfacher als ein neuer Bulk-Task.

FAQ

Woher wissen Teams, wann ein Bulk-Task abgeschlossen ist?

Fragen Sie den Status-Endpunkt des Tasks in einem Intervall von 30 Sekunden oder länger ab. Wenn der Status success meldet, enthält die Antwort einen Link zur Ergebnis-CSV. Der Link ist 12 Stunden lang gültig und kann durch erneutes Abfragen desselben Tasks aktualisiert werden, sodass kein sofortiger Download erforderlich ist.

Was passiert mit Zeilen, die keine gültigen Adressen sind?

Ungültige und doppelte Zeilen werden während der Dateivorbereitung entfernt. Ein ungültiges Format ist kein Urteil für Nicht zustellbar; es ist schlicht keine prüfbare Adresse. Eine vorherige Bereinigung der Datei hält die Anzahl der vorbereiteten Datensätze nahe an dem, was das Team erwartet.

Kann ein Bulk-Task von einem KI-Client über MCP gestartet werden?

Für den MCP-Endpunkt ist kein Bulk-File-Task-Tool dokumentiert. MCP unterstützt Einzelprüfungen, bis zu 100 Adressen pro Aufruf, Produktauflistungen und Guthabenabfragen. Bulk-File-Tasks verwenden den Web-Workflow oder die REST-API.

Weitere Informationen

Wählen Sie die Produktinformationen, die zum nächsten Schritt in Ihrem Workflow passen.

• Zur Produktdokumentation →
• Kontakt zum Team →