Aller au contenu principal

Double opt-in

Le double opt-in est une pratique qui consiste à demander à un contact de confirmer son abonnement via un email de validation, en plus de son ajout à une liste.

Pourquoi activer le double opt-in ?

Bien que non obligatoire en France pour les contacts B2B, le double opt-in constitue une preuve de consentement plus solide — l'article 7 du RGPD exige que vous puissiez démontrer que le consentement a été donné.

Configurer le double opt-in

Sur une liste, activez Double opt-in requis (PATCH /api/v1/lists/:id/double-optin). Vous pouvez y personnaliser :

| Champ | Effet | |---|---| | optin_email_subject | Objet de l'email de confirmation. Par défaut : "Confirmez votre inscription". | | optin_email_template_id | Un template UETL existant pour le contenu de l'email, à la place du contenu par défaut. | | optin_redirect_url | URL vers laquelle rediriger le contact après confirmation, à la place de la page de succès par défaut. |

Le template personnalisé peut être écrit à la main (balises <ue-*>, voir UETL) ou construit avec l'éditeur visuel drag-and-drop. La variable {{optin_url}} y insère le lien de confirmation. Si le template référencé est introuvable ou ne compile pas, l'email par défaut est envoyé à la place — l'inscription du contact n'est jamais bloquée par un template cassé.

La durée de validité du lien de confirmation est fixe : 48 heures, non configurable par liste.

Flux complet

Contact ajouté à une liste avec double opt-in requis
        ↓
Contact passe en statut "En attente" (pending_optin)
        ↓
Email de confirmation envoyé (pool transactionnel)
        ↓
Contact clique sur le lien (GET /optin/:token)
        ↓
Contact passe en statut "Inscrit" (subscribed)
        ↓
Redirection vers optin_redirect_url, ou la page de succès par défaut

Les contacts en statut "En attente" ne reçoivent aucun email de campagne. Seul l'email de confirmation est envoyé, via le pool transactionnel.

Confirmer un token déclenche aussi le déclencheur d'automatisation double_optin_confirmed, si un workflow l'utilise sur cette liste — il n'existe pas de mécanisme de webhook sortant séparé pour cet évènement.

Expiration du lien

Un nettoyage quotidien supprime les tokens expirés depuis plus de 48h. Un contact qui n'a pas confirmé à ce moment-là passe au statut "Désabonné" (unsubscribed), pas "En attente" indéfiniment.

Pour renvoyer l'email avant expiration :

POST /api/v1/lists/:id/members/:contact_id/resend-optin
Authorization: Bearer <token>

Cette route envoie toujours un nouvel email, y compris si un envoi précédent est toujours valide (contrairement à l'ajout initial à la liste, qui n'envoie jamais deux fois pour le même contact tant que le premier email n'a pas expiré).

Intégration via API

Le double opt-in se déclenche en ajoutant un contact existant à une liste qui le requiert — il n'y a pas de paramètre à passer à la création du contact :

POST /api/v1/contacts
Authorization: Bearer <token>

{ "email": "nouveau@example.com", "first_name": "Nouveau" }
POST /api/v1/lists/:id/members/:contact_id
Authorization: Bearer <token>

Si la liste a requires_double_optin: true, cette seconde requête met le contact en attente et envoie l'email de confirmation ; sinon, il est simplement ajouté à la liste.