> ## 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.

# Liens de désabonnement e-mail et en-têtes

> Apprenez à gérer le comportement de désabonnement e-mail dans OneSignal, incluant les liens de désabonnement, les en-têtes List-Unsubscribe, les règles de suppression et les flux de réabonnement.

La gestion de la façon dont les utilisateurs se désabonnent de vos e-mails est essentielle pour se conformer aux normes e-mail (comme CAN-SPAM), garantir une forte délivrabilité avec les fournisseurs comme Gmail et Yahoo, et établir la confiance avec votre audience.

OneSignal prend en charge à la fois les liens de désabonnement visibles et les en-têtes List-Unsubscribe, garantissant que vos e-mails sont entièrement conformes tout en vous donnant le contrôle sur quand et comment les utilisateurs peuvent se désinscrire.

## États d'abonnement et logique de suppression

Les [Abonnements](./subscriptions) e-mail sont soit :

* **Abonné** – éligible pour recevoir des messages e-mail.
* **Désabonné** – exclu de la plupart des envois d'e-mails sauf s'il est explicitement remplacé.

Pour inclure les Abonnements désabonnés dans votre e-mail (par ex., pour les messages transactionnels) :

* Dans le tableau de bord : Activez **Paramètres avancés > Inclure l'envoi aux utilisateurs désabonnés** lors de l'envoi d'un e-mail.
* Dans l'API : Utilisez la propriété `include_unsubscribed` dans l'[API create email notification](/reference/email).

<Frame caption="Activer l'envoi aux utilisateurs désabonnés">
  <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=5bddf440aae0717dc518b8a43789d3da" width="906" height="616" data-path="images/docs/72d0ed1-f246c05-Screenshot_2023-01-18_at_10.06.54_AM.png" />
</Frame>

***

## Comment les utilisateurs se désabonnent

Le statut d'abonnement e-mail est mis à jour via :

* L'utilisateur cliquant sur un lien de désabonnement ou un en-tête List-Unsubscribe
* Vous [important un CSV d'adresses e-mail](./import) et définissant `subscribed` sur `no`.
* Vous définissant `enabled : false` via les API [Create user](/reference/create-user), [Update user](/reference/update-user), ou [Update subscription](/reference/update-subscription).
* Vous désabonnant manuellement depuis **Audience > Abonnements > Options > Désabonner de l'e-mail**

***

## En-tête de désabonnement vs lien de désabonnement

* **En-tête List-Unsubscribe** : Un en-tête e-mail caché utilisé par les fournisseurs de boîtes de réception pour afficher des boutons "Désabonner" natifs (par ex., Gmail, Yahoo).
* **Lien de désabonnement** : Une URL cliquable visible placée dans votre contenu e-mail utilisant le jeton `[unsubscribe_url]`.

### Comportement de l'en-tête List-Unsubscribe

OneSignal inclut un en-tête `List-Unsubscribe` dans tous les e-mails **sauf lorsque vous activez "Inclure l'envoi aux utilisateurs désabonnés."** Cela aide à :

* Empêcher vos e-mails d'être marqués comme spam
* Se conformer aux [règles Gmail/Yahoo 2024](https://onesignal.com/blog/guide-to-2024-gmail-and-yahoo-requirements-for-email-senders/).

<Warning>
  L'en-tête List-Unsubscribe n'est **pas inclus** si vous activez "Inclure l'envoi aux utilisateurs désabonnés."

  Certains fournisseurs de boîtes de réception peuvent masquer cet en-tête de l'affichage à moins que vous ne répondiez à certains seuils de volume d'envoi. Voir les exigences de [Gmail](https://support.google.com/a/answer/81126?visit_id=638683263663552218-2680312485\&rd=1#requirements-5k\&zippy=%2Crequirements-for-sending-or-more-messages-per-day) et de [Yahoo](https://senders.yahooinc.com/best-practices/).
</Warning>

Si un utilisateur clique dessus, son Abonnement e-mail sera marqué comme désabonné dans votre application OneSignal.

### Ajouter des liens de désabonnement dans les e-mails

OneSignal fournit le jeton `[unsubscribe_url]`, qui insère un lien de désabonnement visible dans le contenu de votre e-mail.

Vous pouvez également créer une expérience de marque avec votre propre page de désabonnement. Voir [Créer une page de désabonnement personnalisée](./create-custom-unsubscribe-page).

#### Éditeur HTML

Si vous utilisez notre éditeur HTML, le modèle par défaut inclut automatiquement un lien de désabonnement :

<Frame caption="Éditeur HTML avec lien de désabonnement par défaut">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/8b10e10-default_code.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=0c996973cd6335a81dd8854c8e0e355d" width="1309" height="562" data-path="images/docs/8b10e10-default_code.png" />
</Frame>

Pour l'ajouter manuellement (par ex. via l'API avec `email_body`) :

```html HTML theme={null}
<a href="[unsubscribe_url]">Unsubscribe</a>
```

#### Éditeur glisser-déposer

Dans un bloc de texte :

1. Cliquez sur **Liens spéciaux > Suppression > Désabonner**
2. Le placeholder `[unsubscribe_url]` est inséré
3. Vous pouvez surligner du texte avant de l'insérer pour le transformer en lien

<Frame caption="Lien de désabonnement dans l'éditeur glisser-déposer">
  <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=46180061304abd272dbcef4c85b3b710" width="1114" height="230" data-path="images/docs/7f78d2e-Screenshot_2023-01-18_at_9.59.12_AM.png" />
</Frame>

<Info> Rendez toujours les liens de désabonnement **hautement visibles** avec des tailles de police lisibles (au moins 12px) et un contraste fort. Les liens cachés ou difficiles à trouver peuvent amener les utilisateurs à marquer vos messages comme spam, nuisant à la délivrabilité future. </Info>

***

## Destinations de liens de désabonnement personnalisés

Vous pouvez remplacer `[unsubscribe_url]` par votre propre page de destination de désabonnement.

Pour ce faire :

* Suivez les étapes dans [Créer une page de désabonnement personnalisée](./create-custom-unsubscribe-page).
* Remplacez `[unsubscribe_url]` dans votre e-mail par l'URL de votre page de désabonnement personnalisée.

<Warning>
  Si vous utilisez un lien personnalisé, OneSignal ne marquera pas automatiquement l'utilisateur comme désabonné. Vous devez gérer cela via l'API ou le comportement de la page.
</Warning>

***

## FAQ

### Pourquoi le lien de désabonnement ne fonctionne-t-il pas dans mon e-mail de test ?

Si votre domaine d'envoi d'e-mail OneSignal n'est pas encore vérifié, les liens de désabonnement dans les e-mails de test ne seront pas fonctionnels. Vous verrez du texte placeholder, mais aucun lien réel.

Une fois votre domaine vérifié, les liens de désabonnement s'afficheront et fonctionneront correctement.

### Comment réabonner une adresse e-mail ?

Les utilisateurs peuvent être réabonnés de trois manières :

1. Tableau de bord : Allez dans **Audience > Abonnements > Options > Réabonner à l'e-mail**
2. API : Définissez `enabled: true` dans les API [Create User](/reference/create-user) ou [Update subscription](/reference/update-subscription)
3. Importation CSV : Définissez `subscribed = yes` lors de l'importation d'adresses e-mail

<Warning> Si vous utilisez un fournisseur d'e-mail tiers (ESP), vérifiez leur liste de suppression et supprimez également l'adresse là-bas. </Warning>

### Pourquoi y a-t-il deux liens de désabonnement dans mon e-mail ?

Si vous utilisez des ESP comme Mailgun ou SendGrid, ils peuvent insérer leur propre lien de désabonnement. Vous pouvez désactiver cela dans les paramètres de votre ESP pour éviter la duplication.

### Les clics sur les désabonnements comptent-ils dans les analyses ?

* Cliquer sur le `[unsubscribe_url]` personnalisé OneSignal ne compte pas dans les analyses de clics.
* Cliquer sur une URL de désabonnement personnalisée sera compté comme un clic. Voir [URL, liens et liens profonds](./links) pour plus de détails.

***

## Articles connexes

* [Créer une page de désabonnement personnalisée](./create-custom-unsubscribe-page)
* [Messagerie e-mail](./email-messaging)
* [API e-mail](/reference/email)
* [URL, liens et liens profonds](./links)

***