# Double opt-in et e-mails de confirmation

> Demandez aux personnes de confirmer leur adresse avant de rejoindre une liste de contacts, et accueillez-les avec un e-mail de confirmation. Définissez l’expéditeur, les textes ou un design MJML personnalisé, et testez les deux e-mails.

Chaque liste de contacts peut envoyer deux e-mails qui lui sont propres :

- **Double opt-in** : un e-mail contenant un lien de confirmation. Les personnes qui s’inscrivent ne rejoignent la liste qu’après avoir cliqué dessus : chaque adresse de la liste appartient donc à quelqu’un qui a demandé à y figurer.
- **E-mail de confirmation** : un court e-mail « votre inscription est confirmée » envoyé juste après l’arrivée d’une personne dans la liste, ou après sa confirmation lorsque le double opt-in est activé.

Les deux sont désactivés tant que vous ne les activez pas, et les deux partent de votre propre domaine d’envoi vérifié.

## Avant de commencer

- Vérifiez un domaine d’envoi. Les deux e-mails nécessitent une adresse **From** sur l’un de vos [domaines vérifiés](/fr/docs/domains/).
- Chaque e-mail coûte un crédit, comme n’importe quel autre e-mail.
- Un espace de travail qui n’est pas encore vérifié ne peut envoyer des e-mails qu’à ses propres membres : les e-mails de double opt-in adressés à d’autres personnes échouent donc tant que l’espace de travail n’est pas vérifié.

## Activer le double opt-in

1. **Ouvrez les paramètres.** Accédez à **Email Marketing → Audiences**, ouvrez la liste et sélectionnez l’onglet **Settings**.

2. **Définissez l’expéditeur.** Dans **Double opt-in**, saisissez une adresse **From** sur un domaine vérifié, comme `News <news@example.com>`, et, si vous le souhaitez, une adresse **Reply-to**.

3. **Ajustez l’e-mail.** Modifiez **Subject**, **Heading**, **Text**, **Button text** et **Footer**, ou conservez les valeurs par défaut. L’aperçu à droite se met à jour pendant la saisie.

4. **Choisissez la page d’arrivée.** Si vous le souhaitez, saisissez une page dans **After confirming, go to**. Sans elle, les personnes voient une page de confirmation avec un lien pour [gérer leurs abonnements](/fr/docs/audiences/manage-subscriptions/). Elle reprend le design de votre [page de désinscription](/fr/docs/audiences/unsubscribe-page/#other-pages-with-this-design) et s’ouvre dans la langue du navigateur de la personne.

5. **Activez-le.** Activez **Require confirmation** et sélectionnez **Save**.

L’enregistrement échoue avec « Use an address on a verified sending domain of this workspace. » lorsque le domaine de l’adresse **From** n’est pas vérifié.

### Inscriptions qui demandent une confirmation

| Mode d’inscription | Avec le double opt-in activé |
| --- | --- |
| L’[URL d’inscription](/fr/docs/audiences/subscribe-url/) de la liste | La personne reçoit l’e-mail de double opt-in et rejoint la liste après avoir cliqué sur son lien. L’URL renvoie `202`. |
| Un [formulaire](/fr/docs/forms/) qui ajoute des personnes à la liste | Idem, sauf si le formulaire applique son propre double opt-in. La confirmation du formulaire suffit alors. Si l’e-mail de double opt-in ne peut pas être envoyé, le formulaire ajoute la personne immédiatement. |
| **Add subscriber** dans le tableau de bord | **Ask them to confirm by email first (double opt-in)** est coché. Décochez la case pour ajouter la personne immédiatement. |
| [Ajouter un abonné](/fr/docs/api-reference/audiences/subscribers/add/) via l’API | Uniquement avec `"double_opt_in": true`. Sans ce paramètre, la personne est ajoutée immédiatement. |
| Imports, fusions et actions en masse sur les contacts | Ajout immédiat. |
| La [page de gestion des abonnements](/fr/docs/audiences/manage-subscriptions/) | Ajout immédiat. Le lien a été envoyé par e-mail à la personne, ce qui prouve déjà l’adresse. |

### Ce qui se passe après une inscription

1. Emailit crée le contact s’il est nouveau, sans modifier un contact existant, et envoie l’e-mail de double opt-in. La personne ne figure pas encore dans la liste. Les personnes déjà abonnées ne reçoivent pas d’e-mail, mais l’URL d’inscription renvoie quand même `202` : elle ne révèle donc pas qui figure dans la liste.
2. Lorsqu’elle ouvre le lien, elle rejoint la liste avec **Subscribed** activé. Un événement `subscriber.created` est envoyé et les automatisations **Added to audience** démarrent. L’e-mail de confirmation suit s’il est activé.
3. Ouvrir le lien une nouvelle fois n’a plus d’effet. Les liens expirent au bout de 30 jours. Les personnes qui n’ont pas confirmé peuvent s’inscrire à nouveau pour recevoir un nouveau lien. Les liens précédents restent valides jusqu’à leur expiration, et confirmer l’un d’eux suffit. Une nouvelle inscription juste après la première n’envoie pas de second e-mail, ce qui empêche d’utiliser l’URL d’inscription pour inonder la boîte de réception de quelqu’un ; le premier lien continue de fonctionner.

L’onglet **Settings** indique combien de personnes n’ont pas encore confirmé. Si l’e-mail ne peut pas être envoyé, par exemple parce que le domaine n’est plus vérifié ou que l’espace de travail n’a plus de crédits, la personne n’est pas ajoutée et l’URL d’inscription renvoie `503`. Un formulaire, lui, ajoute la personne immédiatement, pour que l’inscription ne soit pas perdue, et la réponse enregistre l’erreur.

## Envoyer un e-mail de confirmation

1. **Ouvrez les paramètres.** Dans l’onglet **Settings** de la liste, accédez à **Confirmation email**.

2. **Rédigez l’e-mail.** Saisissez une adresse **From** sur un domaine vérifié, puis ajustez les textes. Ajoutez un **Button text** et un **Button link** pour diriger les personnes vers votre site, ou laissez-les vides pour un e-mail sans bouton.

3. **Activez-le.** Activez **Send it** et sélectionnez **Save**.

L’e-mail de confirmation est envoyé aux personnes qui s’inscrivent via l’URL d’inscription, un formulaire, un lien de double opt-in ou la page de gestion des abonnements. Lorsque vous ajoutez vous-même des personnes, il n’est envoyé que si vous le demandez : cochez **Send the confirmation email** dans **Add subscriber**, ou transmettez `"send_confirmation_email": true` à l’API. Les imports et les fusions ne l’envoient jamais.

Un e-mail de confirmation dont l’envoi échoue n’annule pas l’inscription.

## Variables

L’objet, les textes et les designs personnalisés peuvent utiliser des variables [Temple](/fr/docs/templates/temple/). Les valeurs du contact sont échappées avant d’être insérées dans l’e-mail.

| Variable | Valeur |
| --- | --- |
| `{{confirm_url}}` | Le lien de confirmation. Double opt-in uniquement. |
| `{{manage_subscriptions_url}}` | Le lien de la personne vers la [page de gestion des abonnements](/fr/docs/audiences/manage-subscriptions/). E-mail de confirmation uniquement. |
| `{{audience_name}}` | Le nom public de la liste, ou son nom si elle n’en a pas. |
| `{{email}}`, `{{first_name}}`, `{{last_name}}` | Les informations du contact. Prévoyez une valeur par défaut pour les valeurs vides, comme `{{first_name\|"there"}}`. |

**Text** et **Footer** conservent les sauts de ligne et acceptent du HTML en ligne comme `<a>` et `**`. **Heading** et **Button text** sont en texte brut. Le bouton du double opt-in pointe toujours vers `{{confirm_url}}`.

## Concevoir l’e-mail en MJML

> **MJML est en alpha:** L’éditeur visuel MJML est réservé à l’équipe Emailit pendant que nous le testons. Tous les autres utilisent le design par défaut, avec tous les textes ci-dessus. Consultez [Éditeurs et API MJML](/fr/docs/templates/mjml/).

Pour modifier la mise en page, sélectionnez **Customize in the MJML visual editor**. L’éditeur s’ouvre avec le design par défaut et vos textes actuels. L’enregistrement fait passer l’e-mail à **Custom design (MJML)**. Remettez **Design** sur **Default design** pour utiliser à nouveau les textes ; le design personnalisé est conservé.

Un e-mail de double opt-in personnalisé doit contenir un lien vers `{{confirm_url}}`. L’enregistrer sans ce lien échoue avec « The double opt-in email must link to `{{confirm_url}}`. »

## Tester les e-mails

Sous chaque aperçu, saisissez une adresse dans **Send a test to** et sélectionnez **Send test**. Le test utilise la version enregistrée : enregistrez donc d’abord vos modifications. Les e-mails de test utilisent des valeurs de contact d’exemple, et leurs liens n’inscrivent personne.

## Utiliser l’API

[Mettre à jour une liste de contacts](/fr/docs/api-reference/audiences/update/) configure les deux e-mails. N’envoyez que les champs à modifier :

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "double_opt_in": {
      "enabled": true,
      "redirect_url": "https://example.com/welcome",
      "email": { "from": "News <news@example.com>", "subject": "Confirm your subscription to {{audience_name}}" }
    },
    "confirmation_email": {
      "enabled": true,
      "email": { "from": "News <news@example.com>", "button_label": "Read the latest issue", "button_url": "https://example.com/blog" }
    }
  }'
```

Demandez ensuite une confirmation lorsque vous ajoutez une personne :

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "double_opt_in": true }'
```

La réponse est `202` avec `"status": "pending"`. La définition d’un design personnalisé (`email.source`) via l’API fait partie de l’alpha MJML.

## Voir aussi

  - [Page de gestion des abonnements](/fr/docs/audiences/manage-subscriptions/): Laissez les personnes choisir leurs listes.
  - [URL d’inscription](/fr/docs/audiences/subscribe-url/): Collectez des inscriptions depuis votre propre site.

---
Source: https://emailit.com/fr/docs/audiences/double-opt-in/