> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Validation d'adresse e-mail

> Validez les adresses e-mail lors de l'importation CSV et en masse pour réduire les rebonds et protéger votre réputation d'expéditeur.

La validation d'adresse e-mail détecte les problèmes courants dans les adresses e-mail avant qu'elles n'atteignent votre audience. Elle signale les fautes de frappe, les domaines invalides, les adresses basées sur un rôle et les services d'e-mail jetables qui pourraient augmenter votre taux de rebond ou nuire à votre réputation d'expéditeur.

Elle s'exécute automatiquement lors de l'importation CSV et est également disponible comme outil de validation en masse pour votre audience existante.

<Note>
  La validation d'adresse e-mail vérifie les adresses selon les critères de validation de OneSignal. Ce n'est pas une vérification de rebond en temps réel et ne garantit pas la délivrabilité.
</Note>

## Vérifications de validation

La validation d'adresse e-mail évalue chaque adresse selon les vérifications suivantes :

| Vérification                         | Ce qu'elle détecte                                                                                             |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| **Validation de syntaxe**            | Adresses malformées avec des composants obligatoires manquants (ex. : `@` absent, TLD invalide)                |
| **Détection de fautes de frappe**    | Erreurs d'orthographe courantes de domaine comme `gnail.com` ou `gmail.con`                                    |
| **Vérification d'enregistrement MX** | Domaines sans enregistrement d'échange de courrier valide ; les e-mails envoyés ici ne peuvent pas être livrés |
| **Adresse basée sur un rôle**        | Adresses comme `sales@`, `info@`, `admin@` qui n'appartiennent probablement pas à un individu                  |
| **E-mail jetable**                   | Domaines associés à des services d'e-mail temporaires ou jetables                                              |

<Note>
  **Les forfaits gratuits** incluent la validation de syntaxe et la détection de fautes de frappe. **Les forfaits payants** incluent tout ce qui précède ainsi que la vérification des enregistrements MX, la détection des adresses basées sur un rôle et le filtrage des e-mails jetables.
</Note>

Si une adresse échoue à une vérification, la validation d'adresse e-mail renvoie une erreur lisible expliquant le problème spécifique. Si une adresse échoue à plusieurs vérifications, tous les motifs d'échec sont renvoyés ensemble.

***

## Valider les adresses lors de l'importation CSV

Lors de l'importation d'un CSV, vous pouvez configurer les paramètres de validation d'adresse e-mail à l'étape de **Révision** avant de confirmer l'importation.

<Steps>
  <Step title="Démarrer une importation CSV">
    Allez dans **Audience > Import** et téléchargez votre fichier. Complétez les étapes **Upload** et **Map Fields**. Si des adresses e-mail invalides sont détectées, un avertissement apparaîtra à l'étape **Map Fields**.

    <Frame caption="Avertissement d'e-mails invalides détectés à l'étape Map Fields">
      <img src="https://mintcdn.com/onesignal/BtlAtFOavkYyZTGB/images/email/import_csv_invalid_email_detection.png?fit=max&auto=format&n=BtlAtFOavkYyZTGB&q=85&s=148ddc3343cca3ffddc8d6f3458a740a" alt="Étape Map Fields d'importation CSV affichant un avertissement d'e-mails invalides détectés" width="1866" height="914" data-path="images/email/import_csv_invalid_email_detection.png" />
    </Frame>
  </Step>

  <Step title="Configurer les paramètres de validation à l'étape de Révision">
    À l'étape de **Révision**, développez **Paramètres de validation d'adresse e-mail**. Les options suivantes sont disponibles :

    <Frame caption="Paramètres de validation d'adresse e-mail à l'étape de Révision">
      <img src="https://mintcdn.com/onesignal/BtlAtFOavkYyZTGB/images/email/import_csv_validation_check.png?fit=max&auto=format&n=BtlAtFOavkYyZTGB&q=85&s=580a816aea94d087613178d392eee234" alt="Étape de Révision d'importation CSV avec les Paramètres de validation d'adresse e-mail développés" width="1814" height="1382" data-path="images/email/import_csv_validation_check.png" />
    </Frame>

    * **Valider les domaines d'e-mail (enregistrements MX)** : confirmer que le domaine peut recevoir des e-mails
    * **Exclure les adresses e-mail jetables** : empêcher les adresses temporaires ou à usage unique susceptibles de réduire l'engagement
    * **Exclure les adresses e-mail basées sur un rôle** : empêcher les adresses partagées comme `info@` ou `support@` qui ont généralement un engagement plus faible

    Les trois sont activés par défaut. Décochez ceux que vous ne souhaitez pas appliquer à cette importation.

    <Note>
      Si vous devez importer des adresses e-mail invalides (par exemple, pour mettre à jour le statut de suppression ou d'abonnement), cochez **Autoriser les adresses e-mail invalides**. Cela contourne la validation et accepte toute chaîne comme adresse e-mail.
    </Note>
  </Step>

  <Step title="Confirmer et importer">
    Cliquez sur **Confirmer et importer**. Une fois l'importation terminée, vous recevrez un e-mail récapitulant les résultats :

    * Abonnements ajoutés
    * Abonnements modifiés
    * Lignes non importées, avec un lien pour télécharger les lignes rejetées
  </Step>
</Steps>

#### Résultat

Les adresses valides sont ajoutées à votre audience. Vous recevez un e-mail lorsque l'importation est terminée. Les adresses qui ont échoué à la validation sont exclues et disponibles au téléchargement via le lien dans l'e-mail de résultats.

***

## Valider votre audience existante en masse

Utilisez la validation en masse pour vérifier les adresses e-mail déjà présentes dans votre audience OneSignal. Vous recevez les résultats par e-mail sous forme d'export CSV.

<Steps>
  <Step title="Ouvrir l'outil Valider les adresses e-mail">
    Allez dans **Audience > Subscriptions** (ou **Audience > Users**), cliquez sur **Update/Import Users**, puis sélectionnez **Validate Email Addresses**.

    <Frame caption="Option Validate Email Addresses dans le menu Update/Import Users">
      <img src="https://mintcdn.com/onesignal/BtlAtFOavkYyZTGB/images/email/validate_emails_sub_page.png?fit=max&auto=format&n=BtlAtFOavkYyZTGB&q=85&s=13700c5faffd0a46acdff1b3d687805f" alt="Menu déroulant Update/Import Users avec l'option Validate Email Addresses mise en évidence" width="560" height="254" data-path="images/email/validate_emails_sub_page.png" />
    </Frame>
  </Step>

  <Step title="Démarrer la validation">
    Dans le modal, cliquez sur **Start validation**. La validation d'adresse e-mail s'exécute sur toutes les adresses e-mail de votre application.

    <Frame caption="Modal de confirmation Valider les adresses e-mail">
      <img src="https://mintcdn.com/onesignal/YsI3AV6UZEH5Saz0/images/email/bulk_validation_modal.png?fit=max&auto=format&n=YsI3AV6UZEH5Saz0&q=85&s=ac498afd710057320ec00644f4e27d30" alt="Modal Validate Email Addresses affichant le bouton Start validation" width="1144" height="560" data-path="images/email/bulk_validation_modal.png" />
    </Frame>
  </Step>

  <Step title="Recevoir vos résultats par e-mail">
    Lorsque la validation est terminée, vous recevrez un e-mail de OneSignal avec un lien **Télécharger l'export CSV**. Le lien est actif pendant 72 heures. L'e-mail résume le nombre d'adresses ayant échoué, ventilé par :

    <Frame caption="E-mail de résultats de validation OneSignal avec résumé et lien Télécharger l'export CSV">
      <img src="https://mintcdn.com/onesignal/BtlAtFOavkYyZTGB/images/email/errors%20email.png?fit=max&auto=format&n=BtlAtFOavkYyZTGB&q=85&s=8655e75c51f2d96dbdcb911a528f4e89" alt="E-mail de résultats OneSignal affichant le résumé de validation et le bouton Télécharger l'export CSV" width="1510" height="1182" data-path="images/email/errors email.png" />
    </Frame>

    * Fautes de frappe
    * Adresses basées sur un rôle
    * Domaines jetables
    * Enregistrements MX invalides
  </Step>

  <Step title="Examiner et réimporter">
    Téléchargez le CSV et examinez les adresses signalées.

    <Frame caption="Export CSV des résultats de validation d'e-mail">
      <img src="https://mintcdn.com/onesignal/q67Fo0fbZTTYBU0c/images/email/csv-export-email-validation.png?fit=max&auto=format&n=q67Fo0fbZTTYBU0c&q=85&s=8db9d159b9da06d7f26f3d4097455f37" alt="Export CSV affichant les colonnes email, reason, suggested_email, created_at, last_opened et last_clicked" width="868" height="74" data-path="images/email/csv-export-email-validation.png" />
    </Frame>

    Pour nettoyer votre audience, créez un nouveau CSV avec les adresses corrigées ou traitées et réimportez-le en utilisant l'un des formats de colonnes suivants :

    | Objectif                          | Colonnes requises     | Valeur                |
    | --------------------------------- | --------------------- | --------------------- |
    | Réabonner les adresses corrigées  | `email`, `subscribed` | `subscribed` = `yes`  |
    | Désabonner les adresses signalées | `email`, `subscribed` | `subscribed` = `no`   |
    | Supprimer les adresses signalées  | `email`, `suppressed` | `suppressed` = `true` |
  </Step>
</Steps>

#### Résultat

Vous recevez un e-mail avec un export CSV des adresses signalées et un résumé des résultats de validation ventilés par type d'erreur.

***

## Référence des erreurs de validation

Les erreurs suivantes peuvent apparaître dans les résultats de validation :

| Erreur                                    | Signification                                                                                                                                                         | Que faire                                                                                           |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| **Entrée invalide**                       | L'adresse est malformée et ne répond pas aux exigences syntaxiques de base (ex. : `@` absent, TLD invalide).                                                          | Corrigez ou supprimez l'adresse.                                                                    |
| **Faute de frappe dans l'adresse e-mail** | Une probable faute d'orthographe a été détectée dans le domaine. Une correction suggérée apparaît dans la colonne adjacente.                                          | Appliquez la correction suggérée ou supprimez l'adresse.                                            |
| **Enregistrement MX introuvable**         | Le domaine n'a pas d'enregistrement d'échange de courrier valide. L'e-mail ne peut pas être livré à cette adresse.                                                    | Supprimez ou retirez l'adresse.                                                                     |
| **Adresse e-mail basée sur un rôle**      | La partie locale (avant `@`) correspond à un modèle basé sur un rôle connu comme `sales@` ou `support@`. Ces adresses n'appartiennent probablement pas à un individu. | Vérifiez si l'adresse est appropriée pour votre cas d'utilisation, puis supprimez-la ou retirez-la. |
| **Adresse e-mail jetable**                | Le domaine est associé à un service d'e-mail temporaire ou jetable.                                                                                                   | Supprimez ou retirez l'adresse.                                                                     |

***

## Réponses d'erreur de l'API

La validation d'adresse e-mail s'applique également aux adresses soumises via l'API. Les sections ci-dessous décrivent les réponses d'erreur que vous pouvez rencontrer.

<Note>
  La validation de l'API vérifie uniquement que l'adresse e-mail est correctement formatée. Elle ne vérifie pas les fautes de frappe, les enregistrements MX, les adresses basées sur un rôle ou les domaines jetables. Ces vérifications ne sont disponibles que lors de l'importation CSV et de la validation en masse.
</Note>

### Envoyer un e-mail : Créer un message

Lorsque vous envoyez à une ou plusieurs adresses invalides via le [point de terminaison Créer un message](/reference/create-message), les adresses invalides sont exclues de la livraison et renvoyées sous `invalid_email_tokens`.

```json theme={null}
{
  "id": "",
  "errors": {
    "invalid_email_tokens": ["invalid@email"]
  }
}
```

### Ajouter un utilisateur ou un abonnement : API Modèle Utilisateur

Lorsque vous créez un utilisateur ou un abonnement avec un e-mail invalide via le point de terminaison [Créer un utilisateur](/reference/create-user) ou [Créer un abonnement](/reference/create-subscription) :

```json theme={null}
{
  "errors": [
    {
      "title": "Invalid `token` format for device type email"
    }
  ]
}
```

### Ajouter un appareil : API Players héritée

Lorsque vous ajoutez ou modifiez un enregistrement de player avec un e-mail invalide via l'[API Players héritée](/reference/add-a-device) :

```json theme={null}
{
  "success": false,
  "errors": ["[\"Identifier invalid format.\"]"]
}
```

<Warning>
  L'API Players héritée est obsolète. Migrez vers l'[API Modèle Utilisateur](/reference/create-user) pour recevoir des erreurs de validation plus descriptives et accéder aux fonctionnalités actuelles.
</Warning>
