Dépannage des 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

Ces erreurs signifient que votre compte ou votre ensemble de configuration a atteint une limite d’envoi, une pause ou une suspension — le message lui-même n’a aucun problème.

Erreur	Description	Que faire
AccountDailyQuotaExceeded	Votre compte a atteint son quota d’envoi d’e-mails quotidien.	Attendez que le quota soit réinitialisé, 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

Ces erreurs indiquent un problème avec 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 d’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 d’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 correctement publiés.
InvalidTrackingOptionsException	Le domaine de suivi personnalisé configuré pour le suivi des ouvertures/clics est invalide.	Vérifiez vos paramètres de domaine de suivi personnalisé.

Problèmes d’adresse du destinataire

Ces 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à fait l’objet d’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 contient une valeur invalide.	Vérifiez le format des adresses dans le champ Cci.

Erreurs de livraison SMTP

Ces 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 d’envoyer le message à nouveau plus tard. Si l’erreur persiste, contactez le Support Pushwoosh.
SMTPIsNotConfigured	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 d’envoyer à nouveau le message. Si l’erreur persiste, contactez le Support Pushwoosh.

Erreurs de modèle et de contenu

Ces erreurs se produisent lorsque Pushwoosh construit ou effectue le rendu de 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 variables utilisées dans le modèle d’e-mail.	Vérifiez les variables 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 le rendu du 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 les erreurs dans le contenu HTML du modèle d’e-mail.
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	L’une des valeurs utilisées pour remplir le modèle est invalide, souvent en raison 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 les erreurs dans le modèle d’e-mail et réessayez.
MissingRenderingAttributeException	Une valeur référencée par une variable dans le modèle n’a pas été fournie.	Assurez-vous que toutes les variables utilisées 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 variables 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 balisage malformé dans le HTML du modèle d’e-mail.

Modèles Liquid et Contenu Connecté

Ces erreurs sont spécifiques à la syntaxe Liquid et aux requêtes de Contenu Connecté utilisées pour extraire des données personnalisées.

Erreur	Description	Que faire
ConnectedContentInvalidJSON	Le point de terminaison du 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

Ces 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 par le Support Pushwoosh.

Erreur	Description	Que faire
CannotConnect	Pushwoosh n’a pas pu se connecter à la passerelle d’envoi d’e-mails.	Essayez d’envoyer le message à nouveau 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 d’envoyer le message à nouveau plus tard. Si l’erreur persiste, contactez le Support Pushwoosh.
EmailSESInvalidParameterValue	L’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 d’envoyer à nouveau 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 d’envoyer le message à nouveau plus tard.
SpamDetected	Le message a été signalé comme spam et n’a pas été envoyé.	Révisez 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 d’envoyer le message à nouveau 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 d’Amazon SES

Ces 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 d’Amazon SES ConfigurationSetAlreadyExistsException ConfigurationSetDoesNotExistException EventDestinationAlreadyExistsException EventDestinationDoesNotExistException InvalidCloudWatchDestinationException InvalidConfigurationSetException InvalidDeliveryOptionsException InvalidFirehoseDestinationException InvalidLambdaFunctionException InvalidPolicyException InvalidS3ConfigurationException InvalidSNSDestinationException InvalidSnsTopicException RuleDoesNotExistException RuleSetDoesNotExistException TrackingOptionsAlreadyExistsException TrackingOptionsDoesNotExistException CustomVerificationEmailInvalidContentException CustomVerificationEmailTemplateAlreadyExistsException CustomVerificationEmailTemplateDoesNotExistException LimitExceededException ProductionAccessNotGrantedException AlreadyExistsException CannotDeleteException InvalidSendingPoolName	Une erreur interne dans l’infrastructure d’envoi Amazon SES de Pushwoosh. Elle n’est pas causée 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é.