Fehlerbehebung bei Transaktions-E-Mails

Dieser Artikel behandelt die häufigsten Probleme mit Flexmail Transaktions-E-Mails – Authentifizierungsfehler, Zustellbarkeitsprobleme sowie API- oder SMTP-Fehler – und was dagegen zu tun ist.

Authentifizierungs- und Einrichtungsfehler

API gibt einen 401 Unauthorized-Fehler zurück

Ihre Konto-ID oder Ihr persönliches Zugriffstoken ist falsch. Prüfen Sie beides sorgfältig:

  • Der Benutzername ist Ihre numerische Konto-ID, nicht Ihre E-Mail-Adresse.
  • Das Passwort ist ein persönliches Zugriffstoken, das unter Einstellungen > API > Persönliche Zugriffstoken erstellt wurde – nicht Ihr Flexmail-Anmeldekennwort.
  • Stellen Sie sicher, dass das Token vollständig kopiert wurde, ohne nachfolgende Leerzeichen oder Zeilenumbrüche.
  • Im Zweifelsfall erstellen Sie ein neues Token und versuchen Sie es erneut.

SMTP-Verbindung schlägt fehl oder läuft ab

Prüfen Sie Folgendes:

  • Sie verwenden Host submission.flexmail.eu, Port 587, mit STARTTLS.
  • Ihr Server oder Ihre Hosting-Umgebung erlaubt ausgehende Verbindungen auf Port 587. Einige Shared-Hosting-Anbieter blockieren diesen Port – wenden Sie sich an Ihren Host, um dies zu bestätigen.
  • Ihre SMTP-Zugangsdaten sind der Benutzername und das Passwort, die Flexmail bei der Aktivierung Ihres SMTP-Zugangs bereitgestellt hat. Diese sind getrennt von Ihrer Konto-ID und Ihrem persönlichen Zugriffstoken, die nur für die HTTP API verwendet werden.
  • Ihre Absenderadresse ist in Flexmail verifiziert.

Absenderadresse nicht verifiziert

Wenn Sie versuchen, von einer in Flexmail nicht verifizierten Adresse zu senden, wird der Sendevorgang abgelehnt. Gehen Sie zu Einstellungen > Absender hinzufügen oder entfernen, fügen Sie die Adresse hinzu und klicken Sie auf den Verifizierungslink in der E-Mail, die Flexmail sendet.

Zustellbarkeitsprobleme

E-Mails landen im Spam

Spam-Platzierung bei Transaktions-E-Mails wird fast immer durch eine von drei Ursachen verursacht:

  • E-Mail-Authentifizierung ist nicht konfiguriert oder fehlerhaft. Prüfen Sie, ob SPF-, DKIM- und DMARC-Einträge für Ihre Versanddomain vorhanden sind. Selbst ein fehlender oder fehlkonfigurierter Eintrag kann zur Spam-Platzierung führen. Konfigurationsanweisungen finden Sie in der API-Dokumentation unter email-api.flexmail.eu/documentation unter E-Mail-Authentifizierung.
  • Die Absenderreputation ist niedrig. Wenn Ihre Domain oder IP eine Geschichte mit Spam-Beschwerden oder hohen Bounce-Raten hat – von jeder Versandplattform, nicht nur Flexmail – können Postfachanbieter Ihre E-Mail in den Spam weiterleiten. Lesen Sie „Absenderreputation verstehen" für Informationen zur Bewertung und Verbesserung der Reputation.
  • Inhalte lösen Spam-Filter aus. Bestimmte Betreffzeilen-Muster, übermäßig viele Links oder bildlastige E-Mails mit wenig Text können Spam-Filter auslösen. Testen Sie Ihre Transaktions-E-Mails mit einem Tool wie Mail-Tester (mail-tester.com), um Probleme auf Inhaltsebene zu identifizieren.

E-Mails kommen gar nicht an

Wenn die API eine Erfolgsmeldung zurückgibt, aber die E-Mail nicht ankommt:

  • Prüfen Sie Ihre Webhook-Ereignisse (falls konfiguriert) – ein Bounce-Ereignis kurz nach dem Senden deutet auf einen Zustellungsfehler hin.
  • Verifizieren Sie, dass die Empfängeradresse existiert und korrekt geschrieben ist.
  • Bitten Sie den Empfänger, seinen Spam-Ordner zu prüfen.
  • Prüfen Sie, ob die Domain des Empfängers eine strenge DMARC-Richtlinie hat – ohne korrekt konfiguriertes DKIM können Ihre E-Mails still abgelehnt werden.
  • Einige Unternehmens-E-Mail-Systeme lehnen E-Mails von neuen oder schlechten Absendern ab. Versuchen Sie, an eine persönliche Gmail- oder Outlook-Adresse zu senden, um empfängerseitige Filterung auszuschließen.

Hohe Bounce-Rate

Eine hohe Bounce-Rate bei Transaktions-E-Mails bedeutet in der Regel, dass Sie an Adressen senden, die nicht existieren oder nicht mehr aktiv sind. Prüfen Sie Ihren Adresserfassungsprozess:

  • Validieren Sie das E-Mail-Adressformat beim Eingabepunkt?
  • Senden Sie eine Bestätigungs- oder Verifizierungs-E-Mail, bevor Sie einer neuen Adresse vertrauen?
  • Entfernen Sie Hard-Bounce-Adressen umgehend aus Ihrem System?

Wichtig

Das weitere Senden an Hard-Bounce-Adressen schädigt mit jeder Sendung Ihre Absenderreputation. Richten Sie Webhook-Verarbeitung für Bounce-Ereignisse ein und unterdrücken Sie diese Adressen sofort in Ihrem System.

API- und Integrationsfehler

API gibt einen 422- oder 400-Fehler zurück

Diese Fehler weisen auf ein Problem mit Ihrer Anfrage hin – ein fehlendes Pflichtfeld, ein ungültiger Parameterwert oder ein fehlerhafter Anfrage-Body. Prüfen Sie die Fehlermeldung im Antwort-Body für Details. Die API-Dokumentation unter email-api.flexmail.eu/documentation listet alle erforderlichen und optionalen Parameter für jeden Endpunkt auf.

API gibt einen 429 Too Many Requests-Fehler zurück

Sie haben ein Rate-Limit erreicht. Die API-Dokumentation gibt die Rate-Limits für Ihre Abonnementstufe an. Fügen Sie Ihrer Integration Wiederholungslogik mit exponentiellem Backoff hinzu, um damit elegant umzugehen.

Template-Variablen werden nicht ersetzt

Wenn Platzhaltertext buchstäblich in der zugestellten E-Mail erscheint:

  • Prüfen Sie, ob Sie die Variablenwerte korrekt in der API-Anfrage übergeben. Lesen Sie den Abschnitt Templates in der API-Dokumentation für die genaue Parameterstruktur.
  • Prüfen Sie, ob die Platzhalter-Syntax in Ihrer Vorlage exakt dem entspricht, was die API erwartet.
  • Stellen Sie sicher, dass Sie in Ihrem API-Aufruf auf die richtige Template-ID verweisen.

Webhooks kommen nicht an

Wenn Ihr Webhook-Endpunkt keine Ereignisse erhält:

  • Bestätigen Sie, dass Ihr Endpunkt über HTTPS öffentlich zugänglich ist.
  • Prüfen Sie, dass Ihr Endpunkt schnell eine 2xx-Antwort zurückgibt – ein langsamer oder nicht reagierender Endpunkt veranlasst Flexmail, die Zustellung als fehlgeschlagen zu betrachten.
  • Prüfen Sie Ihre Server-Logs auf eingehende POST-Anfragen, um ein Routing- oder Firewall-Problem auszuschließen.
  • Verifizieren Sie, dass Ihre Webhook-Endpunkt-URL korrekt in der API registriert ist.

Hilfe erhalten

Wenn Sie die oben genannten Schritte durchgeführt haben und das Problem weiterhin besteht, wenden Sie sich an das Flexmail-Support-Team unter support@flexmail.eu. Fügen Sie folgendes in Ihre Nachricht ein, um die Diagnose zu beschleunigen:

  • Die Nachrichten-ID einer fehlgeschlagenen Sendung (aus der API-Antwort oder Ihren Logs).
  • Die Empfänger-E-Mail-Adresse, mit der Sie getestet haben.
  • Die Fehlermeldung oder den Antwort-Body der API, falls zutreffend.
  • Das Ergebnis eines E-Mail-Authentifizierungsprüftools wie MXToolbox oder Mail-Tester.

Nächste Schritte

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.