Validation de l’e-mail

Le présent article de référence couvre les règles de validation des pièces locales et hôtes pour les adresses e-mail. La validation est utilisée pour les adresses e-mail du tableau de bord, les adresses e-mail des utilisateurs finaux (vos clients) et les adresses de départ et de réponse d’un message e-mail.

Fonctionnement

Braze valide une adresse e-mail lorsqu’elle est mise à jour, importée par API, téléchargement CSV, SDK, ou modifiée dans le tableau de bord. Les adresses e-mail ne peuvent pas contenir d’espace. Si vous utilisez l’API, les espaces blancs renvoient une erreur 400.

Braze rejette certains caractères et marque l’adresse comme invalide. Si un e-mail est rejeté, Braze marque l’adresse comme invalide et ne modifie pas le statut de l’abonnement. Si le corps de l’e-mail contient des caractères ASCII non standard, Braze n’envoie pas l’e-mail.

Cette validation est un contrôle syntaxique et non un service de validation. L’un des objectifs de ce processus est de prendre en charge les caractères internationaux (tels que UTF-8) dans la partie locale de l’adresse e-mail.

Braze valide la syntaxe des parties locale et hôte d’une adresse e-mail. La partie locale est tout ce qui se trouve avant l’astérisque (@) ; la partie hôte est tout ce qui se trouve après. La partie locale peut commencer et se terminer par n’importe quel caractère autorisé, à l’exception d’un point (.). Ce processus ne tient pas compte du fait que le domaine dispose d’un serveur MX valide ou qu’un utilisateur existe sur ce domaine.

Si Braze reçoit une demande d’ajout d’un utilisateur dont l’adresse e-mail n’est pas valide, l’API renvoie une erreur. Pour un téléchargement CSV, Braze crée l’utilisateur mais omet l’adresse e-mail invalide.

Règles de validation des parties locales

Validation générale des e-mails

Pour la plupart des domaines, la partie locale doit suivre ces paramètres :

• Peut contenir n’importe quelle lettre, n’importe quel chiffre, y compris les lettres et les chiffres Unicode ainsi que les caractères suivants : (+) (&) (#) (_) (-) (^) ou (/)
• Peut contenir mais ne peut pas commencer ou se terminer par le caractère suivant : (.)
• Ne peut pas contenir de guillemets doubles (“)
• Doit comporter entre 1 et 64 caractères

L’expression régulière suivante peut être utilisée pour vérifier si une adresse e-mail sera considérée comme valide :

1
/\A([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}])(([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~\.]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}])*([a-zA-Z0-9_\-\^+$'\&#\/!%\*=\?`\|~]|[[^\p{ASCII}\p{Space}]&&\p{Alnum}\p{Punct}\p{S}]))?\z/

Adresses Gmail

Si la partie domaine est Gmail, la partie locale doit comporter au moins deux caractères et respecter la validation par expression régulière indiquée ci-dessus.

Domaines Microsoft

Si le domaine de l’hôte comprend “msn”, “hotmail”, “outlook” ou “en ligne/en production/instantané”, Braze utilise l’expression régulière suivante pour valider la partie locale : /\A\w[\-\w]*(?:\.[\-\w]+)*\z/i

La partie locale de Microsoft doit suivre ces paramètres :

• Peut commencer par un caractère (a-z), un trait de soulignement (_), ou un chiffre (0-9).
• Peut contenir n’importe quel caractère alphanumérique (a-z ou 0-9) ou un trait de soulignement. (_)
• Peut contenir les caractères suivants : (.) ou (-)
• Ne peut pas commencer par un point (.)
• Ne peut pas contenir deux points consécutifs ou plus (.)
• Impossible de terminer par un point (.)

Le test de validation vérifie si la partie locale précédant le “+” correspond à l’expression régulière.

Règles de validation de la partie hôte

La partie hôte ne peut pas être une adresse IPv4 ou IPv6. Le domaine de premier niveau (tel que .com, .org, .net) ne peut pas être entièrement numérique.

L’expression régulière suivante est utilisée pour valider le domaine :
/^[a-z\d](?:[a-z\d-]{0,61}[a-z\d])?(?:\.[a-z\d](?:[a-z\d-]{0,61}[a-z\d])?)+$/i

Le nom de domaine doit répondre à ces paramètres :

• Se compose de deux étiquettes séparées par un point ou plus
  • Chaque partie d’un nom de domaine est appelée un « label ». Par exemple, le nom de domaine « example.com » se compose du libellé « exemple » et du libellé « com ».
• Doit contenir au moins un point (.)
• Ne peut pas contenir deux points consécutifs ou plus
• Chaque étiquette séparée par un point doit :
  • Ne contenir que des caractères alphanumériques (a-z ou 0-9) et le trait d’union (-).
  • Commencer par un caractère alphanumérique (a-z ou 0-9)
  • Se terminer par un caractère alphanumérique (a-z ou 0-9)
  • Contenir 1 à 63 caractères

Validation supplémentaire requise

L’étiquette finale du domaine doit être un domaine de premier niveau (TLD) valide, déterminé par tout ce qui se trouve après le point final (.). Ce TLD devrait figurer dans la liste des TLD de l’ICANN. Le validateur de Braze ne vérifie que la syntaxe. Il ne détecte pas les fautes de frappe ou les adresses inexistantes.