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 d’expéditeur et de réponse d’un message électronique.
Fonctionnement
Braze valide une adresse e-mail lorsqu’elle est mise à jour, importée par API, téléchargée au format CSV, SDK ou modifiée dans le tableau de bord de Braze. Les adresses de e-mail ne doivent pas contenir d’espaces. Si vous utilisez l’API, les espaces blancs renvoient une400erreur.
Braze rejette certains caractères et marque l’adresse comme non valide. Si un e-mail est renvoyé, Braze marque l’adresse comme non valide 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.
Accepted characters
- Lettres (A-Z)
- Nombres (0-9)
- Symboles
- -
- +
- $
- ’
- &
- #
- /
- %
- *
- =
- `
- |
- ~
- !
- ?
- (seulement entre les lettres ou d’autres caractères)
Unaccepted characters
- Espaces blancs (ASCII et Unicode)
Cette validation est une vérification 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 locales et hôtes d’une adresse e-mail. La partie locale correspond à tout ce qui précède le signe @ ; la partie hôte correspond à tout ce qui suit. 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 de la validité du serveur MX du domaine ni de l’existence d’un utilisateur sur ce domaine.
Si la partie du domaine contient des caractères ASCII non standard, elle devra être encodée en Punycode avant d’être fournie à Braze.
Si Braze reçoit une demande d’ajout d’un utilisateur avec une adresse e-mail non valide, l’API renvoie une erreur. Lors d’un téléchargement CSV, Braze crée l’utilisateur mais ignore l’adresse e-mail non valide.
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 ou chiffre, y compris les lettres et 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 du 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 hôte comprend « msn », « hotmail », « outlook » ou « live », 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 une lettre (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 signe « + » 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 domaine doit respecter les paramètres suivants :
- 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 :
- Veuillez noter que le nom de domaine ne doit contenir que des caractères alphanumériques (a-z ou 0-9) et le tiret (-).
- 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
Le dernier élément du domaine doit être un domaine de premier niveau (TLD) valide, déterminé par tout ce qui suit le point final (.). Ce TLD devrait apparaître dans la liste des TLD de l’ICANN. Le validateur Braze vérifie uniquement la syntaxe. Il ne détecte pas les fautes de frappe ni les adresses inexistantes.
L’unicode est accepté uniquement pour la partie locale de l’adresse e-mail. L’unicode n’est pas accepté pour la partie domaine, mais il peut être encodé en Punycode.
Modifier cette page sur GitHub