Erreurs d'e-mail
Cette page répertorie les codes d’erreur que Pushwoosh peut renvoyer lors de l’envoi d’un e-mail, regroupés par cause. Chaque entrée explique la signification de l’erreur et comment la résoudre.
Limites de compte et d’envoi
Anchor link toCes erreurs signifient que votre compte ou votre ensemble de configuration a atteint un plafond d’envoi, une pause ou une suspension — il n’y a aucun problème avec le message lui-même.
| Erreur | Description | Que faire |
|---|---|---|
| AccountDailyQuotaExceeded | Votre compte a atteint son quota d’envoi d’e-mails quotidien. | Attendez que le quota se réinitialise, ou contactez le Support Pushwoosh pour demander un quota plus élevé. |
| AccountSendingPaused / AccountSendingPausedException / ConfigurationSetSendingPaused / ConfigurationSetSendingPausedException | L’envoi d’e-mails a été mis en pause pour votre compte ou votre ensemble de configuration, généralement en raison d’un taux de rebond ou de plainte élevé. | Examinez vos taux de rebond et de plainte et contactez le Support Pushwoosh pour reprendre l’envoi. |
| AccountSuspended | La capacité de votre compte à envoyer des e-mails a été suspendue. | Contactez le Support Pushwoosh pour savoir pourquoi et comment restaurer l’envoi. |
| AccountThrottled | Trop d’e-mails ont été envoyés dans un court laps de temps, et la limite du taux d’envoi a été dépassée. | Réduisez votre taux d’envoi, ou contactez le Support Pushwoosh pour demander une limite de taux plus élevée. |
Configuration de l’expéditeur et du domaine
Anchor link toCes erreurs indiquent un problème dans la configuration et la vérification de votre domaine d’envoi ou de votre adresse « De ».
| Erreur | Description | Que faire |
|---|---|---|
| CannotGetCredentials | Pushwoosh n’a pas pu obtenir les informations d’identification nécessaires pour envoyer l’e-mail. | Vérifiez que votre domaine d’expéditeur est vérifié et actif. |
| FromEmailAddressNotVerifiedException | L’adresse de l’expéditeur n’est pas vérifiée et ne peut pas être utilisée pour envoyer cet e-mail. | Vérifiez le domaine et l’adresse e-mail de l’expéditeur et réessayez. |
| FromEmailMissing | L’adresse e-mail « De » est manquante ou invalide. | Définissez une adresse e-mail « De » valide et vérifiée dans la configuration de la plateforme e-mail ou dans les paramètres du message. |
| FromNameMissing | Le « Nom de l’expéditeur » pour l’e-mail est manquant ou invalide. | Définissez un « Nom de l’expéditeur » valide dans la configuration de la plateforme e-mail ou dans les paramètres du message. |
| MailFromDomainNotVerified / MailFromDomainNotVerifiedException | Le message n’a pas pu être envoyé car Pushwoosh n’a pas trouvé l’enregistrement MX requis pour le domaine d’envoi. | Vérifiez les enregistrements DNS/DKIM de votre domaine d’envoi et assurez-vous qu’ils sont publiés correctement. |
| InvalidTrackingOptionsException | Le domaine de suivi personnalisé configuré pour le suivi des ouvertures/clics est invalide. | Vérifiez les paramètres de votre domaine de suivi personnalisé. |
Problèmes d’adresse du destinataire
Anchor link toCes erreurs sont causées par l’adresse e-mail du destinataire elle-même — son format, ou son historique de rebonds et de plaintes — et non par votre compte ou votre modèle.
| Erreur | Description | Que faire |
|---|---|---|
| AddressContainsControlOrWhitespace | L’adresse e-mail contient des caractères de contrôle ou des espaces superflus. | Supprimez tout caractère caché ou espace de l’adresse e-mail et réessayez. |
| EmailComplaint | Le destinataire a précédemment marqué un de vos messages comme spam. | Retirez ce destinataire des envois futurs pour protéger votre réputation d’expéditeur. |
| EmailIsBounced | Le message n’a pas été envoyé car cette adresse e-mail a déjà généré un rebond. | Utilisez une adresse e-mail valide et active, ou retirez ce destinataire de votre liste de diffusion. |
| IllegalEmailAddress | L’adresse e-mail du destinataire a un format invalide. | Vérifiez l’adresse e-mail du destinataire et corrigez-la. |
| UnableToParseEmailBCC | Le champ Cci (copie carbone invisible) contient une valeur invalide. | Vérifiez le format des adresses dans le champ Cci. |
Erreurs de livraison SMTP
Anchor link toCes erreurs se produisent lorsque Pushwoosh livre le message via SMTP, allant d’une configuration manquante à une connexion échouée.
| Erreur | Description | Que faire |
|---|---|---|
| SMTPCannotProcessData | Pushwoosh n’a pas pu construire l’e-mail pour la livraison SMTP. | Vérifiez les paramètres du modèle d’e-mail. |
| SMTPCannotProcessFrom | Le champ « FROM » SMTP est vide. | Définissez une adresse e-mail « De » valide pour le message. |
| SMTPCannotProcessRcpt | Le champ « RCPT » (destinataire) SMTP est vide. | Vérifiez que l’adresse e-mail du destinataire est correctement définie. |
| SMTPCannotProcessSending | Une erreur interne s’est produite lors de l’envoi du message via SMTP. | Essayez de renvoyer le message plus tard. Si l’erreur persiste, contactez le Support Pushwoosh. |
| SMTPIsNotConfigured | Le SMTP n’a pas été configuré pour ce compte. | Contactez le Support Pushwoosh pour configurer l’envoi SMTP. |
| SMTPUnableToCreateConnection | Pushwoosh n’a pas pu établir de connexion SMTP. | Vérifiez les paramètres et les informations d’identification de votre serveur SMTP, puis réessayez. |
| SMTPUnableToSignDKIM | Pushwoosh n’a pas pu signer le message avec DKIM. | Vérifiez la configuration DKIM de votre domaine d’envoi. |
| SMTPUnknownError | Une erreur SMTP non spécifiée s’est produite. | Essayez de renvoyer le message. Si l’erreur persiste, contactez le Support Pushwoosh. |
Erreurs de modèle et de contenu
Anchor link toCes erreurs se produisent lorsque Pushwoosh construit ou rend l’e-mail — un modèle manquant, des données de remplacement invalides ou du HTML malformé.
| Erreur | Description | Que faire |
|---|---|---|
| CannotGetEmailPlaceholders | Pushwoosh n’a pas pu récupérer les placeholders utilisés dans le modèle d’e-mail. | Vérifiez les placeholders de Contenu Dynamique dans le modèle d’e-mail. |
| CannotGetTemplateBindings | Pushwoosh n’a pas pu récupérer les liaisons de données requises pour rendre le modèle. | Vérifiez les paramètres de Contenu Dynamique et de Modèles Liquid utilisés dans le modèle. |
| CannotNormalizeHTML | Le contenu de l’e-mail n’a pas pu être préparé pour l’envoi. | Vérifiez le contenu HTML du modèle d’e-mail pour y déceler des erreurs. |
| CannotProcessEmailTemplateFromRepo | Le modèle d’e-mail n’a pas pu être chargé et traité. | Vérifiez les paramètres du modèle d’e-mail et réessayez. |
| EmailCannotGetEmailTemplateCode | Échec de l’obtention de email_template_code ou celui-ci est vide. | Vérifiez que la plateforme est correctement configurée et réessayez. |
| EmailCannotGetEmailTemplateFromRepo | Échec de l’obtention du modèle d’e-mail par email_template_code. | Vérifiez que la plateforme est correctement configurée et réessayez. |
| InvalidRenderingParameterException | Une des valeurs utilisées pour remplir le modèle est invalide, souvent à cause d’un JSON malformé. | Vérifiez les données de Contenu Dynamique passées au modèle. |
| InvalidTemplateException | Le modèle d’e-mail spécifié n’a pas pu être rendu. | Vérifiez le modèle d’e-mail pour y déceler des erreurs et réessayez. |
| MissingRenderingAttributeException | Une valeur référencée par un placeholder dans le modèle n’a pas été fournie. | Assurez-vous que tous les placeholders utilisés dans le modèle ont des valeurs correspondantes. |
| TemplateDoesNotExistException | Le modèle d’e-mail spécifié n’existe pas. | Vérifiez que le modèle d’e-mail est correctement configuré et n’a pas été supprimé. |
| TooDeepTemplateInsertion | Les modèles sont imbriqués trop profondément les uns dans les autres. | Réduisez le nombre d’insertions de modèles imbriqués dans le contenu de l’e-mail. |
| UnableToBuildEmailAttachments | Une ou plusieurs pièces jointes n’ont pas pu être construites. | Vérifiez les pièces jointes ajoutées à l’e-mail et réessayez. |
| UnableToBuildHTML | Échec de la compilation du modèle d’e-mail. Très probablement, le modèle contient une erreur liée aux placeholders de Contenu Dynamique ou aux Modèles Liquid. | Vérifiez les paramètres du modèle d’e-mail. |
| UnableToCreateHTML | Pushwoosh n’a pas pu générer le HTML final pour l’e-mail. | Vérifiez les paramètres du modèle d’e-mail. |
| UnableToInsertTemplate | Pushwoosh n’a pas pu insérer un modèle référencé dans l’e-mail. | Vérifiez la référence du modèle inséré/imbriqué dans le contenu de l’e-mail. |
| UnableToMinifyHTML | Pushwoosh n’a pas pu minifier le contenu HTML de l’e-mail. | Vérifiez le HTML du modèle d’e-mail pour y déceler un balisage malformé. |
Modèles Liquid et Contenu Connecté
Anchor link toCes erreurs sont spécifiques à la syntaxe Liquid et aux requêtes de Contenu Connecté utilisées pour récupérer des données personnalisées.
| Erreur | Description | Que faire |
|---|---|---|
| ConnectedContentInvalidJSON | Le point de terminaison de Contenu Connecté a renvoyé un JSON invalide. | Vérifiez que votre backend renvoie un JSON valide pour la requête de Contenu Connecté. |
| ConnectedContentInvalidParameters | Le nombre de paramètres passés au Contenu Connecté ne correspond pas au modèle. | Vérifiez les paramètres passés dans la balise de Contenu Connecté par rapport à votre modèle. |
| ConnectedContentInvalidTemplate | La balise de Contenu Connecté contient un modèle Liquid invalide. | Vérifiez la syntaxe Liquid utilisée à l’intérieur de la balise de Contenu Connecté. |
| ConnectedContentInvalidURL | Pushwoosh n’a pas pu récupérer l’URL spécifiée dans le Contenu Connecté. | Vérifiez que l’URL du Contenu Connecté est correcte et accessible. |
| ConnectedContentInvalidVarExpression | L’expression ${} utilisée dans le Contenu Connecté est invalide. | Vérifiez la syntaxe ${} utilisée dans la balise de Contenu Connecté. |
| InvalidLiquidTemplate | L’e-mail contient un modèle Liquid invalide. | Vérifiez la syntaxe des Modèles Liquid utilisée dans l’e-mail. |
| LiquidTemplateInvalidParsing | Le modèle Liquid n’a pas pu être analysé en raison d’une erreur de syntaxe. | Vérifiez la syntaxe des Modèles Liquid utilisée dans l’e-mail. |
| LiquidTemplateInvalidRendering | Le modèle Liquid n’a pas pu être rendu avec les données disponibles. | Vérifiez que les variables utilisées dans les Modèles Liquid correspondent aux données disponibles pour le destinataire. |
| LiquidTemplateInvalidTimezone | Un fuseau horaire invalide a été utilisé avec un filtre de date dans le modèle Liquid. | Vérifiez la valeur du fuseau horaire utilisée avec le filtre de date dans vos Modèles Liquid. |
Erreurs de livraison et d’infrastructure
Anchor link toCes erreurs proviennent de l’infrastructure d’envoi d’e-mails elle-même. La plupart sont transitoires ou internes, et plusieurs nécessitent une investigation du Support Pushwoosh.
| Erreur | Description | Que faire |
|---|---|---|
| CannotConnect | Pushwoosh n’a pas pu se connecter à la passerelle d’envoi d’e-mails. | Essayez de renvoyer le message plus tard. Si l’erreur persiste, contactez le Support Pushwoosh. |
| CannotGetDeviceAPIURL | Pushwoosh n’a pas pu déterminer l’URL de l’API requise pour envoyer l’e-mail. | Contactez le Support Pushwoosh. |
| CannotSend | L’e-mail n’a pas pu être envoyé. | Essayez de renvoyer le message plus tard. Si l’erreur persiste, contactez le Support Pushwoosh. |
| EmailSESInvalidParameterValue | Un des paramètres passés à Amazon est incorrect. | Vérifiez les paramètres passés et réessayez. |
| Failed | Le message n’a pas pu être envoyé pour une raison interne. | Essayez de renvoyer le message. Si l’erreur persiste, contactez le Support Pushwoosh. |
| MessageRejected | Amazon a rejeté le message, et il n’a pas été envoyé. | Vérifiez le contenu du message et l’adresse du destinataire, puis réessayez. |
| RequestTimeout | La requête au service d’envoi d’e-mails a expiré. | Essayez de renvoyer le message plus tard. |
| SpamDetected | Le message a été signalé comme spam et n’a pas été envoyé. | Examinez votre contenu pour y déceler des caractéristiques de spam et contactez le Support Pushwoosh si vous pensez qu’il s’agit d’une erreur. |
| TransientFailure | Une défaillance temporaire s’est produite du côté d’Amazon lors de l’envoi du message. | Essayez de renvoyer le message plus tard. |
| UnableToUnmarshalMetaData | Pushwoosh n’a pas pu traiter les métadonnées jointes à l’e-mail. | Contactez le Support Pushwoosh avec l’ID du message. |
| UnknownError | Une erreur d’envoi non spécifiée s’est produite. | Contactez le Support Pushwoosh avec l’ID du message pour investigation. |
Erreurs de configuration Amazon SES
Anchor link toCes erreurs proviennent de l’infrastructure d’envoi interne Amazon SES de Pushwoosh, et non du contenu de votre message ou des paramètres de votre compte.
| Erreur | Description | Que faire |
|---|---|---|
Erreurs de configuration Amazon SES
| Une erreur interne dans l’infrastructure d’envoi Amazon SES de Pushwoosh. Ceci n’est pas causé par le contenu de votre message ou les paramètres de votre compte. | Contactez le Support Pushwoosh avec le nom exact de l’erreur et l’heure à laquelle le message a été envoyé. |