---
title: Thématiques
description: "Catégories d'abonnement : le destinataire quitte un type d'e-mail et reste abonné aux autres. Une thématique peut être liée à un domaine d'envoi."
seo:
  title: Thématiques email
ai:
  exclude: true
---

Une thématique est une catégorie d'e-mails, comme « Product updates », « Newsletter » ou « Promotions ». Les destinataires peuvent quitter une thématique et rester abonnés aux autres. Gérez les thématiques dans le tableau de bord sous **Contacts → Thématiques**, ou par l'API.

Chaque thématique a un `default_subscription`, défini à sa création et non modifiable ensuite :

- `opt_in` : chaque contact est abonné sauf s'il se désinscrit.
- `opt_out` : un contact n'est abonné qu'après avoir donné son accord.

Une thématique a aussi une `visibility`. Une thématique `public` est listée sur la page de désinscription, et une thématique `private` n'apparaît que par son propre lien.

## Comment les thématiques s'appliquent

- **Campagnes.** Une campagne peut cibler une thématique. Elle part aux contacts abonnés à cette thématique (par leur propre choix ou par la valeur par défaut de la thématique). Les contacts désinscrits pour toute l'équipe, ou qui ont quitté le domaine d'envoi, sont toujours exclus.
- **E-mails individuels.** Envoyez un e-mail avec un `topic_id` et il respecte cette thématique. Si chaque adresse de `to` s'est désinscrite, l'envoi renvoie `422 all_recipients_suppressed`.
- **Page de désinscription.** La page liste les thématiques publiques, pour qu'un destinataire puisse en désactiver une ou quitter tous les e-mails marketing de ce domaine. Les e-mails envoyés sans `topic_id` et hors campagne ne sont jamais concernés. Voir [Désinscriptions](/docs/fr/concepts/unsubscribes).

Une thématique utilisée par une campagne, ou par un e-mail encore en attente d'envoi, ne peut pas être supprimée : l'appel renvoie `409 conflict` tant que ces envois ne sont pas partis ou annulés.

```sh
curl -X POST "https://api.billionsend.com/topics" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Product updates", "default_subscription": "opt_in" }'
```

Vous définissez les choix d'un contact avec `PATCH /contacts/{id}/topics`, en passant des entrées comme `{ "id": "<topic-id>", "subscription": "opt_in" }`. `GET /contacts/{id}/topics` liste toutes les thématiques avec le `subscription` du contact et un indicateur `explicit` (false quand c'est la valeur par défaut de la thématique).

## Une thématique par marque

Si chacun de vos domaines est une marque à part, liez une thématique au domaine auquel elle appartient en définissant `domain_id`, à la création ou plus tard avec `PATCH /topics/{id}`, ou en choisissant le domaine dans le tableau de bord.

- Une thématique liée n'est listée que sur la page de désinscription de ce domaine. La page d'aucun autre domaine n'en affiche le nom.
- Un envoi avec ce `topic_id` doit partir de ce domaine. Depuis tout autre domaine, `POST /emails` et les appels de campagne renvoient `422`.
- Une thématique sans domaine est listée sur la page de chaque domaine et peut être envoyée depuis n'importe quel domaine. `"domain_id": null` rend à une thématique liée sa portée d'équipe.
- Un domaine ne peut pas être supprimé tant que des thématiques lui sont liées (`409`).

Les [segments](/docs/fr/concepts/segments) peuvent être liés de la même façon.

## Clés API limitées à un domaine

Une clé API limitée à un domaine ne peut créer que des thématiques liées à ce domaine, et ne peut pas en créer une pour toute l'équipe.
