Fehlerbehebung bei E-Mail-Fehlern
Diese Seite listet die Fehlercodes auf, die Pushwoosh beim Senden einer E-Mail zurückgeben kann, gruppiert nach deren Ursache. Jeder Eintrag erklärt, was der Fehler bedeutet und wie er behoben werden kann.
Konto- und Sendelimits
Anchor link toDiese Fehler bedeuten, dass Ihr Konto oder Ihr Konfigurationssatz eine Sendebegrenzung, eine Pause oder eine Sperrung erreicht hat – mit der Nachricht selbst ist alles in Ordnung.
| Fehler | Beschreibung | Was zu tun ist |
|---|---|---|
| AccountDailyQuotaExceeded | Ihr Konto hat sein tägliches E-Mail-Sendekontingent erreicht. | Warten Sie, bis das Kontingent zurückgesetzt wird, oder kontaktieren Sie den Pushwoosh-Support, um ein höheres Kontingent anzufordern. |
| AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException | Der E-Mail-Versand für Ihr Konto oder Ihren Konfigurationssatz wurde angehalten, normalerweise aufgrund einer hohen Bounce- oder Beschwerderate. | Überprüfen Sie Ihre Bounce- und Beschwerderaten und kontaktieren Sie den Pushwoosh-Support, um den Versand wieder aufzunehmen. |
| AccountSuspended | Die Fähigkeit Ihres Kontos, E-Mails zu senden, wurde ausgesetzt. | Kontaktieren Sie den Pushwoosh-Support, um herauszufinden, warum und wie Sie den Versand wiederherstellen können. |
| AccountThrottled | Es wurden zu viele E-Mails in kurzer Zeit gesendet, und das Sendelimit wurde überschritten. | Reduzieren Sie Ihre Senderate oder kontaktieren Sie den Pushwoosh-Support, um ein höheres Ratenlimit anzufordern. |
Absender- und Domain-Konfiguration
Anchor link toDiese Fehler weisen auf ein Problem bei der Einrichtung und Verifizierung Ihrer Sendedomäne oder „Von“-Adresse hin.
| Fehler | Beschreibung | Was zu tun ist |
|---|---|---|
| CannotGetCredentials | Pushwoosh konnte die für den E-Mail-Versand erforderlichen Anmeldeinformationen nicht abrufen. | Überprüfen Sie, ob Ihre Absenderdomäne verifiziert und aktiv ist. |
| FromEmailAddressNotVerifiedException | Die Absenderadresse ist nicht verifiziert und kann nicht zum Senden dieser E-Mail verwendet werden. | Verifizieren Sie die Domäne und E-Mail-Adresse des Absenders und versuchen Sie es erneut. |
| FromEmailMissing | Die „Von“-E-Mail-Adresse fehlt oder ist ungültig. | Legen Sie eine gültige, verifizierte „Von“-E-Mail-Adresse in der E-Mail-Plattformkonfiguration oder in den Nachrichteneinstellungen fest. |
| FromNameMissing | Der „Absendername“ für die E-Mail fehlt oder ist ungültig. | Legen Sie einen gültigen „Absendernamen“ in der E-Mail-Plattformkonfiguration oder in den Nachrichteneinstellungen fest. |
| MailFromDomainNotVerified / MailFromDomainNotVerifiedException | Die Nachricht konnte nicht gesendet werden, da Pushwoosh den erforderlichen MX-Eintrag für die Sendedomäne nicht finden konnte. | Überprüfen Sie die DNS/DKIM-Einträge für Ihre Sendedomäne und stellen Sie sicher, dass sie korrekt veröffentlicht sind. |
| InvalidTrackingOptionsException | Die für das Öffnungs-/Klick-Tracking konfigurierte benutzerdefinierte Tracking-Domäne ist ungültig. | Überprüfen Sie Ihre Einstellungen für die benutzerdefinierte Tracking-Domäne. |
Probleme mit der Empfängeradresse
Anchor link toDiese Fehler werden durch die E-Mail-Adresse des Empfängers selbst verursacht – ihr Format oder ihre Bounce- und Beschwerdehistorie – nicht durch Ihr Konto oder Ihre Vorlage.
| Fehler | Beschreibung | Was zu tun ist |
|---|---|---|
| AddressContainsControlOrWhitespace | Die E-Mail-Adresse enthält Steuerzeichen oder zusätzliche Leerzeichen. | Entfernen Sie alle versteckten Zeichen oder Leerzeichen aus der E-Mail-Adresse und versuchen Sie es erneut. |
| EmailComplaint | Der Empfänger hat zuvor eine Nachricht von Ihnen als Spam markiert. | Entfernen Sie diesen Empfänger von zukünftigen Sendungen, um Ihre Absenderreputation zu schützen. |
| EmailIsBounced | Die Nachricht wurde nicht gesendet, da diese E-Mail-Adresse bereits gebounced wurde. | Verwenden Sie eine gültige, aktive E-Mail-Adresse oder entfernen Sie diesen Empfänger aus Ihrer Mailingliste. |
| IllegalEmailAddress | Die E-Mail-Adresse des Empfängers hat ein ungültiges Format. | Überprüfen Sie die E-Mail-Adresse des Empfängers und korrigieren Sie sie. |
| UnableToParseEmailBCC | Das BCC-Feld enthält einen ungültigen Wert. | Überprüfen Sie das Format der Adressen im BCC-Feld. |
SMTP-Zustellungsfehler
Anchor link toDiese Fehler treten auf, während Pushwoosh die Nachricht über SMTP zustellt, von einer fehlenden Konfiguration bis zu einer fehlgeschlagenen Verbindung.
| Fehler | Beschreibung | Was zu tun ist |
|---|---|---|
| SMTPCannotProcessData | Pushwoosh konnte die E-Mail für die SMTP-Zustellung nicht erstellen. | Überprüfen Sie die Einstellungen der E-Mail-Vorlage. |
| SMTPCannotProcessFrom | Das SMTP-Feld „FROM“ ist leer. | Legen Sie eine gültige „Von“-E-Mail-Adresse für die Nachricht fest. |
| SMTPCannotProcessRcpt | Das SMTP-Feld „RCPT“ (Empfänger) ist leer. | Überprüfen Sie, ob die E-Mail-Adresse des Empfängers korrekt eingestellt ist. |
| SMTPCannotProcessSending | Beim Senden der Nachricht über SMTP ist ein interner Fehler aufgetreten. | Versuchen Sie, die Nachricht später erneut zu senden. Wenn der Fehler weiterhin besteht, kontaktieren Sie den Pushwoosh-Support. |
| SMTPIsNotConfigured | SMTP wurde für dieses Konto nicht eingerichtet. | Kontaktieren Sie den Pushwoosh-Support, um den SMTP-Versand zu konfigurieren. |
| SMTPUnableToCreateConnection | Pushwoosh konnte keine SMTP-Verbindung herstellen. | Überprüfen Sie Ihre SMTP-Servereinstellungen und Anmeldeinformationen und versuchen Sie es dann erneut. |
| SMTPUnableToSignDKIM | Pushwoosh konnte die Nachricht nicht mit DKIM signieren. | Überprüfen Sie die DKIM-Konfiguration für Ihre Sendedomäne. |
| SMTPUnknownError | Ein nicht spezifizierter SMTP-Fehler ist aufgetreten. | Versuchen Sie, die Nachricht erneut zu senden. Wenn der Fehler weiterhin besteht, kontaktieren Sie den Pushwoosh-Support. |
Vorlagen- und Inhaltsfehler
Anchor link toDiese Fehler treten auf, während Pushwoosh die E-Mail erstellt oder rendert – eine fehlende Vorlage, ungültige Platzhalterdaten oder fehlerhaftes HTML.
| Fehler | Beschreibung | Was zu tun ist |
|---|---|---|
| CannotGetEmailPlaceholders | Pushwoosh konnte die in der E-Mail-Vorlage verwendeten Platzhalter nicht abrufen. | Überprüfen Sie die Platzhalter für Dynamische Inhalte in der E-Mail-Vorlage. |
| CannotGetTemplateBindings | Pushwoosh konnte die zum Rendern der Vorlage erforderlichen Datenbindungen nicht abrufen. | Überprüfen Sie die in der Vorlage verwendeten Einstellungen für Dynamische Inhalte und Liquid Templates. |
| CannotNormalizeHTML | Der E-Mail-Inhalt konnte nicht für den Versand vorbereitet werden. | Überprüfen Sie den HTML-Inhalt der E-Mail-Vorlage auf Fehler. |
| CannotProcessEmailTemplateFromRepo | Die E-Mail-Vorlage konnte nicht geladen und verarbeitet werden. | Überprüfen Sie die Einstellungen der E-Mail-Vorlage und versuchen Sie es erneut. |
| EmailCannotGetEmailTemplateCode | email_template_code konnte nicht abgerufen werden oder ist leer. | Überprüfen Sie, ob die Plattform korrekt konfiguriert ist, und versuchen Sie es erneut. |
| EmailCannotGetEmailTemplateFromRepo | Die E-Mail-Vorlage konnte nicht über email_template_code abgerufen werden. | Überprüfen Sie, ob die Plattform korrekt konfiguriert ist, und versuchen Sie es erneut. |
| InvalidRenderingParameterException | Einer der zum Füllen der Vorlage verwendeten Werte ist ungültig, oft aufgrund von fehlerhaftem JSON. | Überprüfen Sie die an die Vorlage übergebenen Daten für Dynamische Inhalte. |
| InvalidTemplateException | Die angegebene E-Mail-Vorlage konnte nicht gerendert werden. | Überprüfen Sie die E-Mail-Vorlage auf Fehler und versuchen Sie es erneut. |
| MissingRenderingAttributeException | Ein Wert, auf den ein Platzhalter in der Vorlage verweist, wurde nicht bereitgestellt. | Stellen Sie sicher, dass alle in der Vorlage verwendeten Platzhalter übereinstimmende Werte haben. |
| TemplateDoesNotExistException | Die angegebene E-Mail-Vorlage existiert nicht. | Überprüfen Sie, ob die E-Mail-Vorlage korrekt konfiguriert und nicht gelöscht wurde. |
| TooDeepTemplateInsertion | Vorlagen sind zu tief ineinander verschachtelt. | Reduzieren Sie die Anzahl der verschachtelten Vorlageneinfügungen im E-Mail-Inhalt. |
| UnableToBuildEmailAttachments | Ein oder mehrere Anhänge konnten nicht erstellt werden. | Überprüfen Sie die an die E-Mail angehängten Anhänge und versuchen Sie es erneut. |
| UnableToBuildHTML | Die E-Mail-Vorlage konnte nicht kompiliert werden. Höchstwahrscheinlich enthält die Vorlage einen Fehler im Zusammenhang mit Platzhaltern für dynamische Inhalte oder Liquid Templates. | Überprüfen Sie die Einstellungen der E-Mail-Vorlage. |
| UnableToCreateHTML | Pushwoosh konnte das endgültige HTML für die E-Mail nicht generieren. | Überprüfen Sie die Einstellungen der E-Mail-Vorlage. |
| UnableToInsertTemplate | Pushwoosh konnte eine referenzierte Vorlage nicht in die E-Mail einfügen. | Überprüfen Sie den Verweis auf die eingefügte/verschachtelte Vorlage im E-Mail-Inhalt. |
| UnableToMinifyHTML | Pushwoosh konnte den HTML-Inhalt der E-Mail nicht minimieren. | Überprüfen Sie das HTML der E-Mail-Vorlage auf fehlerhaftes Markup. |
Liquid Templates und Connected Content
Anchor link toDiese Fehler sind spezifisch für die Liquid-Syntax und für Connected Content-Anfragen, die zum Abrufen personalisierter Daten verwendet werden.
| Fehler | Beschreibung | Was zu tun ist |
|---|---|---|
| ConnectedContentInvalidJSON | Der Endpunkt für Connected Content hat ungültiges JSON zurückgegeben. | Überprüfen Sie, ob Ihr Backend für die Connected Content-Anfrage gültiges JSON zurückgibt. |
| ConnectedContentInvalidParameters | Die Anzahl der an Connected Content übergebenen Parameter stimmt nicht mit der Vorlage überein. | Überprüfen Sie die im Connected Content-Tag übergebenen Parameter mit Ihrer Vorlage. |
| ConnectedContentInvalidTemplate | Das Connected Content-Tag enthält eine ungültige Liquid-Vorlage. | Überprüfen Sie die im Connected Content-Tag verwendete Liquid-Syntax. |
| ConnectedContentInvalidURL | Pushwoosh konnte die in Connected Content angegebene URL nicht abrufen. | Überprüfen Sie, ob die Connected Content-URL korrekt und erreichbar ist. |
| ConnectedContentInvalidVarExpression | Der in Connected Content verwendete Ausdruck ${} ist ungültig. | Überprüfen Sie die im Connected Content-Tag verwendete ${}-Syntax. |
| InvalidLiquidTemplate | Die E-Mail enthält eine ungültige Liquid-Vorlage. | Überprüfen Sie die in der E-Mail verwendete Syntax von Liquid Templates. |
| LiquidTemplateInvalidParsing | Die Liquid-Vorlage konnte aufgrund eines Syntaxfehlers nicht geparst werden. | Überprüfen Sie die in der E-Mail verwendete Syntax von Liquid Templates. |
| LiquidTemplateInvalidRendering | Die Liquid-Vorlage konnte mit den verfügbaren Daten nicht gerendert werden. | Überprüfen Sie, ob die in den Liquid Templates verwendeten Variablen mit den für den Empfänger verfügbaren Daten übereinstimmen. |
| LiquidTemplateInvalidTimezone | In der Liquid-Vorlage wurde eine ungültige Zeitzone mit einem Datumsfilter verwendet. | Überprüfen Sie den Zeitzonenwert, der mit dem Datumsfilter in Ihren Liquid Templates verwendet wird. |
Zustellungs- und Infrastrukturfehler
Anchor link toDiese Fehler stammen von der E-Mail-Versandinfrastruktur selbst. Die meisten sind vorübergehend oder intern, und einige erfordern eine Untersuchung durch den Pushwoosh-Support.
| Fehler | Beschreibung | Was zu tun ist |
|---|---|---|
| CannotConnect | Pushwoosh konnte keine Verbindung zum E-Mail-Versand-Gateway herstellen. | Versuchen Sie, die Nachricht später erneut zu senden. Wenn der Fehler weiterhin besteht, kontaktieren Sie den Pushwoosh-Support. |
| CannotGetDeviceAPIURL | Pushwoosh konnte die zum Senden der E-Mail erforderliche API-URL nicht ermitteln. | Kontaktieren Sie den Pushwoosh-Support. |
| CannotSend | Die E-Mail konnte nicht gesendet werden. | Versuchen Sie, die Nachricht später erneut zu senden. Wenn der Fehler weiterhin besteht, kontaktieren Sie den Pushwoosh-Support. |
| EmailSESInvalidParameterValue | Einer der an Amazon übergebenen Parameter ist falsch. | Überprüfen Sie die übergebenen Parameter und versuchen Sie es erneut. |
| Failed | Die Nachricht konnte aus einem internen Grund nicht gesendet werden. | Versuchen Sie, die Nachricht erneut zu senden. Wenn der Fehler weiterhin besteht, kontaktieren Sie den Pushwoosh-Support. |
| MessageRejected | Amazon hat die Nachricht abgelehnt und sie wurde nicht gesendet. | Überprüfen Sie den Nachrichteninhalt und die Empfängeradresse und versuchen Sie es dann erneut. |
| RequestTimeout | Die Anfrage an den E-Mail-Versanddienst ist abgelaufen. | Versuchen Sie, die Nachricht später erneut zu senden. |
| SpamDetected | Die Nachricht wurde als Spam markiert und nicht gesendet. | Überprüfen Sie Ihren Inhalt auf spamähnliche Merkmale und kontaktieren Sie den Pushwoosh-Support, wenn Sie glauben, dass dies ein Fehler ist. |
| TransientFailure | Beim Senden der Nachricht ist auf der Seite von Amazon ein vorübergehender Fehler aufgetreten. | Versuchen Sie, die Nachricht später erneut zu senden. |
| UnableToUnmarshalMetaData | Pushwoosh konnte die an die E-Mail angehängten Metadaten nicht verarbeiten. | Kontaktieren Sie den Pushwoosh-Support mit der Nachrichten-ID. |
| UnknownError | Ein nicht spezifizierter Sendefehler ist aufgetreten. | Kontaktieren Sie den Pushwoosh-Support mit der Nachrichten-ID zur Untersuchung. |
Amazon SES-Konfigurationsfehler
Anchor link toDiese Fehler stammen von der internen Amazon SES-Versandinfrastruktur von Pushwoosh, nicht von Ihrem Nachrichteninhalt oder Ihren Kontoeinstellungen.
| Fehler | Beschreibung | Was zu tun ist |
|---|---|---|
Amazon SES-Konfigurationsfehler
| Ein interner Fehler in der Amazon SES-Versandinfrastruktur von Pushwoosh. Dies wird nicht durch Ihren Nachrichteninhalt oder Ihre Kontoeinstellungen verursacht. | Kontaktieren Sie den Pushwoosh-Support mit dem genauen Fehlernamen und der Uhrzeit, zu der die Nachricht gesendet wurde. |