---
title: Désinscriptions et marques
description: Les désinscriptions sont conservées par domaine d'envoi, donc chaque marque a sa propre liste, sa propre page de désinscription et son propre hôte de liens.
seo:
  title: Désinscription en un clic par domaine
ai:
  exclude: true
---

Une désinscription signifie « plus d'e-mails marketing ». BillionSend l'enregistre pour le domaine d'envoi dont l'e-mail contenait le lien, si bien qu'une équipe avec plusieurs marques ne mélange jamais leurs listes. Quelqu'un qui quitte une marque continue de recevoir les e-mails des autres.

Les e-mails transactionnels (envoyés sans [thématique](/docs/fr/concepts/topics) et hors [campagne](/docs/fr/concepts/broadcasts)) ne sont jamais touchés par une désinscription.

## Trois portées

| Portée | Qui la définit | Ce qu'elle arrête |
| --- | --- | --- |
| Domaine | Le destinataire, avec le lien de désinscription ou le bouton en un clic de son client de messagerie | Les e-mails marketing du domaine qui a envoyé cet e-mail |
| Toute l'équipe | Vous, en mettant `unsubscribed` d'un contact à `true` (API, tableau de bord ou import CSV) | Les e-mails marketing de tous les domaines de votre équipe |
| Thématique | Le destinataire, sur la page de désinscription | Les e-mails envoyés avec cette [thématique](/docs/fr/concepts/topics) |

La désinscription d'un destinataire ne modifie jamais l'indicateur `unsubscribed` du contact. Elle est enregistrée comme une entrée pour le domaine, identifiée par l'adresse e-mail, et elle survit donc à la suppression puis à la réimportation du contact.

Les campagnes et les envois par thématique ignorent un destinataire qui s'est désinscrit du domaine d'envoi, de toute l'équipe ou de la thématique. Un e-mail individuel arrêté de cette façon se termine en `suppressed` avec la raison `domain_unsubscribed`, `contact_unsubscribed` ou `topic_unsubscribed`.

Les désinscriptions ne sont pas des [suppressions](/docs/fr/concepts/suppressions). La liste de suppression contient les adresses qui ont rebondi, qui ont fait une plainte ou que vous avez bloquées, et elle arrête tous les e-mails, y compris les transactionnels. Une désinscription n'arrête que les e-mails marketing.

## La page de désinscription

Chaque campagne et chaque e-mail par thématique porte les en-têtes `List-Unsubscribe` en un clic (RFC 8058) et un lien vers une page de désinscription hébergée. Placez `{{{UNSUBSCRIBE_URL}}}` dans un corps de message et il devient le lien correspondant à chaque destinataire. La page s'ouvre dans la langue du navigateur du destinataire (quatorze langues, l'anglais par défaut). En plus de quitter tous les e-mails marketing du domaine, le destinataire peut activer et désactiver chaque thématique.

Un destinataire qui a cliqué par erreur peut appuyer sur **Réabonner** sur la page de confirmation. Cela n'annule que ce dont ce lien l'avait désinscrit. Un analyseur d'e-mails qui ouvre le lien ne réabonne jamais personne. Quand vous définissez vous-même `unsubscribed: true`, la page n'a pas de bouton Se réabonner.

### Chaque domaine a son propre aspect

La page ressemble au domaine qui a envoyé l'e-mail. Chaque domaine peut définir :

- un nom de marque, un logo et l'arrondi des coins du logo,
- les couleurs de fond, de texte et d'accent,
- le texte au-dessus du bouton et le texte affiché une fois le choix enregistré,
- une URL de redirection à ouvrir après la désinscription, à la place du message de la page.

Dans le tableau de bord, ouvrez le domaine et utilisez l'onglet **Marque**, qui affiche un aperçu du résultat. Un champ laissé vide reprend les **Valeurs par défaut de la marque** de l'équipe (Paramètres), puis l'aspect sobre de BillionSend. La page n'affiche que ce qui appartient à ce domaine : elle ne nomme jamais un autre domaine de votre équipe, et elle ne liste que les thématiques liées à ce domaine et celles qui n'ont pas de domaine.

Avec l'API, envoyez les champs dans `unsubscribe_page` sur `PATCH /domains/{id}`. Un `null` efface un champ. Le logo se téléverse dans le tableau de bord et n'est qu'en lecture dans l'API.

```sh
curl -X PATCH "https://api.billionsend.com/domains/$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "unsubscribe_page": {
      "brand_name": "Acme",
      "message": "Sorry to see you go. Unsubscribe from Acme emails?",
      "success_message": "You are unsubscribed from Acme.",
      "accent_color": "#0a7d5a",
      "logo_radius": "rounded"
    }
  }'
```

Un lien créé hors d'un e-mail, comme celui de `POST /contacts/{id}/preferences-link`, ouvre la page par défaut de l'équipe, et s'y désinscrire désinscrit le contact de tous les domaines.

### Votre propre sous-domaine de désinscription

Par défaut, les liens s'ouvrent sur un hôte BillionSend. Pour les ouvrir sur votre propre domaine, donnez au domaine un sous-domaine de désinscription dans son onglet **Liens**, ou avec `unsubscribe_subdomain` sur `POST /domains` ou `PATCH /domains/{id}` (un libellé comme `unsubscribe` pour `unsubscribe.yourdomain.com` ; `null` l'efface). Il fonctionne comme le sous-domaine de suivi, voir [Domaines](/docs/fr/concepts/domains).

1. Ajoutez le CNAME que l'onglet **DNS** du domaine affiche, pointant vers `cname.billiondns.com`, en DNS uniquement (nuage gris sur Cloudflare).
2. Le certificat est émis automatiquement dès que le CNAME se résout, en général en quelques minutes. `unsubscribe_status` passe de `pending` à `active`, et `unsubscribe_error` en donne la raison quand ce n'est pas le cas.
3. Les nouveaux e-mails utilisent alors votre hôte dans le lien et dans l'en-tête `List-Unsubscribe`. Tant qu'il n'est pas actif, et après un résultat `failed` (72 heures sans activation), l'hôte partagé est utilisé.

Un lien déjà envoyé garde l'hôte avec lequel il est parti, il cesse donc de fonctionner si vous supprimez ensuite le CNAME. Un sous-domaine à vous n'ouvre que les liens de son propre domaine ; tout autre lien répond `404`.

Vous pouvez utiliser un même libellé pour le suivi et la désinscription, mais des noms séparés sont plus sûrs : les bloqueurs de publicités bloquent les hôtes de suivi, et un nom partagé entraînerait le lien de désinscription avec eux.

## Lire et modifier les désinscriptions

`GET /contacts/{id}` renvoie `unsubscribed` (l'indicateur pour toute l'équipe) et `unsubscribed_domains`. Dans le tableau de bord, la page d'un contact liste les deux et vous permet de retirer la désinscription d'un domaine. L'onglet **Désinscriptions** sous Contacts liste chaque entrée.

```sh
# List, newest first. domain_id narrows to one domain.
curl "https://api.billionsend.com/unsubscribes?domain_id=$DOMAIN_ID" \
  -H "Authorization: Bearer bs_..."

# Record an opt-out from one domain (leave domain_id out for every domain)
curl -X POST "https://api.billionsend.com/unsubscribes" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.org", "domain_id": "'"$DOMAIN_ID"'" }'

# Remove one record
curl -X DELETE "https://api.billionsend.com/unsubscribes/$UNSUBSCRIBE_ID" \
  -H "Authorization: Bearer bs_..."
```

Une entrée dont `domain_id` et `domain` valent tous deux `null` désinscrit l'adresse de tous les domaines. Le `POST` est idempotent : une entrée existante est renvoyée telle quelle. Les mêmes appels existent sous la forme des outils MCP `list_unsubscribes`, `add_unsubscribe` et `delete_unsubscribe`.

Ce qui lève quoi :

- `PATCH /contacts/{id}` avec `unsubscribed: false` ne lève que la désinscription pour toute l'équipe. Les désinscriptions de domaines précis restent.
- `DELETE /unsubscribes/{id}` retire cette entrée-là.

Si vous supprimez un domaine puis le recréez sous le même nom, les désinscriptions de ses destinataires s'appliquent de nouveau.

### Qui peut les modifier

Les propriétaires, les administrateurs, les membres marketing et les clés API à accès complet peuvent enregistrer des désinscriptions. Seuls les propriétaires et les administrateurs peuvent en annuler une. Voir [Rôles d'équipe](/docs/fr/team-roles).

Une clé API limitée à un domaine ne gère que les désinscriptions de ce domaine : les autres domaines renvoient `403 restricted_api_key`.

## Importer une liste depuis un CSV

Pour reprendre une liste de désinscriptions d'un autre fournisseur, ouvrez **Contacts → Désinscriptions** dans le tableau de bord et choisissez **Importer un CSV**.

```csv
email,domain
ada@example.com,
grace@example.com,news.example.org
alan@example.com,*
```

- `email` est obligatoire. `domain` est facultatif. La ligne d'en-tête l'est aussi.
- `domain` est l'un de vos domaines et limite la désinscription aux e-mails qui en partent. `*` signifie tous les domaines. Une cellule vide utilise le **Domaine par défaut** que vous choisissez dans la boîte de dialogue.
- Une ligne avec un domaine inconnu ou une adresse invalide est ignorée.

La boîte de dialogue indique combien de désinscriptions ont été ajoutées, combien existaient déjà et pourquoi des lignes ont été ignorées. Importer deux fois le même fichier ne pose aucun problème.

## Événements

La désinscription d'un destinataire déclenche `contact.unsubscribed` avec `source` valant `hosted_page` ou `one_click`, plus `domain_id` et `domain_name` (tous deux `null` pour une désinscription de toute l'équipe). L'annuler déclenche `contact.resubscribed`. Voir [Webhooks](/docs/fr/concepts/webhooks).

## Limites

| | Free | Starter, Pro, Scale |
| --- | --- | --- |
| Aspect de la page de désinscription (logo, couleurs, police, arrondi du logo) | Aspect par défaut | Votre propre aspect par domaine |
| Sous-domaine de désinscription propre | Non (hôte partagé) | Oui |
| « Powered by BillionSend » sur la page | Affiché | Masqué |

Sur Free, définir un sous-domaine renvoie `403 plan_limit_reached`. Vous pouvez enregistrer l'aspect d'une page, mais les destinataires voient l'aspect par défaut jusqu'à ce que vous changiez de forfait. Après un retour à un forfait inférieur, les aspects enregistrés sont conservés et s'appliquent de nouveau quand vous repassez à un forfait payant, et les sous-domaines déjà définis continuent de fonctionner.
