# Segments

> Les segments sont des filtres enregistrés sur vos contacts. Créez-les à partir de tous les contacts ou de listes choisies, envoyez-leur des campagnes ou excluez-les, et vérifiez la limite de segments de votre forfait. Alpha : réservé à l’équipe Emailit.

Un segment est un filtre enregistré sur les contacts de votre espace de travail, comme « Clients du forfait Pro » ou « Inscrits au cours des 30 derniers jours ». Vous n’ajoutez personne à un segment : toutes les personnes qui correspondent à ses règles en font partie, et personne d’autre. Utilisez les segments pour envoyer une [campagne](/fr/docs/campaigns/) à une partie de vos contacts, ou pour écarter des personnes d’une campagne.

> **Les segments sont en alpha:** Les segments sont réservés à l’équipe Emailit pendant que nous les testons. Consultez [Qui peut utiliser les segments](#who-can-use-segments).

## Qui peut utiliser les segments

Pendant l’alpha, les segments sont disponibles uniquement pour les administrateurs de la plateforme Emailit. Le rôle Admin d’un espace de travail ne suffit pas.

| Où | Équipe Emailit | Tous les autres |
| --- | --- | --- |
| Tableau de bord | **Email Marketing → Segments**, sélecteurs de segments dans les campagnes, déclencheurs de segment dans les automatisations et événements de segment dans les webhooks | **Segments** dans le menu affiche **Soon** et ne peut pas être ouvert. Les sélecteurs sont masqués, mais une campagne ou une automatisation qui utilise déjà un segment l’affiche toujours. |
| API et MCP | L’API des segments, les segments comme destinataires et comme déclencheurs, et les outils MCP de segments | `403` avec `error: "segments_alpha"` |
| Clés API | Aucune. Les clés API appartiennent à un espace de travail, pas à une personne. | `403` avec `error: "segments_alpha"` |

Les campagnes et les automatisations qui utilisent déjà un segment continuent de fonctionner pour toutes les personnes de l’espace de travail, et les segments avec suivi continuent d’être mis à jour.

## Fonctionnement des segments

Un segment se compose de deux parties :

- **Source.** Tous les contacts de l’espace de travail, ou uniquement les abonnés des listes de contacts que vous choisissez.
- **Filtres.** Des groupes de règles portant sur les champs du contact, les [champs personnalisés](/fr/docs/contacts/custom-fields/), l’appartenance aux listes, les [tags et le score de lead](/fr/docs/contacts/tags-and-score/), par exemple **Email domain** est `acme.com`, **plan** est l’une des valeurs `pro`, `enterprise`, ou **Tags** contient l’une des valeurs `vip`. Chaque groupe exige toutes ses règles ou au moins l’une d’elles, et le segment exige tous ses groupes ou au moins l’un d’eux. Sans filtre, toutes les personnes de la source font partie du segment.

Emailit évalue un segment chaque fois qu’il est compté, listé ou utilisé pour un envoi : il est donc toujours à jour. Une campagne programmée pour la semaine prochaine atteint les personnes qui correspondent au moment de l’envoi, et les règles comme « créé au cours des 30 derniers jours » avancent avec la date.

### Contacts que les campagnes peuvent atteindre

Chaque segment affiche deux nombres : **Contacts**, toutes les personnes qui correspondent, et **Subscribed**, la partie à laquelle les campagnes peuvent envoyer. Un contact est abonné lorsqu’il n’est pas désinscrit de toutes les listes et qu’il est abonné à au moins une liste, quelle qu’elle soit. Les contacts qui n’ont jamais rejoint de liste correspondent aux segments mais ne reçoivent pas de campagnes. Les adresses bloquées sont tout de même comptées, puis ignorées à l’envoi de la campagne.

Le champ **Subscription status** applique la même règle : la condition **Subscription status** est `subscribed` restreint donc un segment aux contacts que les campagnes peuvent atteindre.

## Créer un segment

1. Accédez à **Email Marketing → Segments** et sélectionnez **Create segment**.
2. Sous **Details**, saisissez un **Name** et, si vous le souhaitez, une **Description** pour votre équipe.
3. Sous **Type**, choisissez **Segment** ou **Tracked segment**. Vous ne pourrez pas changer le type par la suite. Consultez [Segments simples et segments avec suivi](#plain-and-tracked-segments).
4. Sous **Contacts from**, choisissez **All contacts** ou **Subscribers of specific audiences** et sélectionnez les **Audiences**.
5. Sous **Filters**, sélectionnez **Add condition** et choisissez un champ, un opérateur et une valeur. Utilisez **Add group** pour ajouter un autre groupe de conditions, et basculez entre **all** et **any** pour décider comment les conditions et les groupes se combinent.
6. Vérifiez la section **Preview** : le nombre de **Matching contacts**, combien sont abonnés et les **First matches**. Elle se met à jour pendant que vous modifiez le segment.
7. Sélectionnez **Save segment**.

Vous pouvez aussi créer un segment depuis d’autres pages :

- **Save as segment** dans la liste des contacts transforme les filtres actuels de la liste en segment. Les filtres que les segments ne prennent pas en charge sont laissés de côté, et l’éditeur les liste.
- **Create segment** dans le menu de la page d’une liste crée un segment avec cette liste comme source.
- **Duplicate** dans le menu de la ligne d’un segment le copie sous forme de nouveau segment.

Pour la liste complète des champs, des opérateurs et des valeurs, consultez [Créer un segment](/fr/docs/api-reference/segments/create/#conditions) dans la référence de l’API.

## La page d’un segment

Sélectionnez un segment dans **Email Marketing → Segments** pour l’ouvrir. La page affiche les chiffres **Contacts**, **Subscribed** et **Updated**, la **Definition** du segment et les contacts qui correspondent en ce moment, avec une recherche et des filtres. Les contacts sont listés en direct : la liste évolue donc à mesure que les contacts changent.

Depuis l’en-tête, vous pouvez modifier le segment (**Edit**), créer une campagne qui lui est envoyée (**Create campaign**) ou le supprimer depuis le menu (**Delete**).

## Envoyer une campagne à un segment

À l’étape **Recipients** de la campagne, choisissez un ou plusieurs **Segments**, seuls ou avec des **Audiences**. Pour écarter des personnes, utilisez **Exclude audiences** et **Exclude segments**. Consultez [Créer une campagne](/fr/docs/campaigns/create/#step-1-recipients).

- **Évaluation au moment de l’envoi.** Emailit détermine les destinataires au début de l’envoi : les contacts qui correspondent à ce moment-là sont inclus, et ceux qui ne correspondent plus sont écartés.
- **Une copie par adresse.** Un contact présent dans plusieurs listes et segments sélectionnés reçoit la campagne une seule fois.
- **Les exclusions l’emportent.** Un contact présent dans une liste ou un segment exclu est ignoré, même s’il figure aussi dans un élément sélectionné.
- **Les exclusions supprimées bloquent l’envoi.** Si une campagne exclut une liste ou un segment qui n’existe plus, Emailit ne l’envoie pas : l’envoi renvoie une erreur, et une campagne programmée repasse à **Draft**. Mettez à jour ses destinataires, puis envoyez-la de nouveau.

Vous ne pouvez pas supprimer un segment tant qu’une campagne programmée ou en cours d’envoi l’utilise. La suppression d’un segment le retire des campagnes en brouillon qui lui sont envoyées. Les brouillons qui l’excluent conservent l’exclusion et ne peuvent pas être envoyés tant que vous ne l’avez pas remplacée : les personnes que vous vouliez écarter ne les reçoivent donc jamais.

## Segments simples et segments avec suivi

Lorsque vous créez un segment, vous choisissez son type :

| | **Segment** | **Tracked segment** |
| --- | --- | --- |
| Nombres, liste de contacts et campagnes | En direct | En direct |
| Enregistre qui entre et qui sort, et quand | Non | Oui |
| Démarre des automatisations lors des entrées et des sorties | Non | Oui |
| Envoie les webhooks `segment.contact_added` et `segment.contact_removed` | Non | Oui |
| Graphique **Growth** et colonne **Joined** | Non | Oui |
| Forfaits | Tous | Pro, Business et Custom |

Le type est fixé une fois le segment créé. Pour en changer, créez un nouveau segment avec les mêmes règles. Consultez [Segments avec suivi](/fr/docs/segments/tracked/).

Les automatisations peuvent aussi vérifier n’importe quel segment, avec ou sans suivi, dans une **Condition** If/Else, un objectif, une étape **Wait until** ou une condition de sortie : **Segment** is in **VIP customers**. Consultez [Condition (If/Else)](/fr/docs/automations/steps/#condition-ifelse). Un segment qu’une automatisation utilise ne peut pas être supprimé tant que vous n’avez pas modifié l’automatisation.

## Limites

Chaque forfait inclut un nombre de segments par espace de travail. Les segments avec suivi et les segments simples comptent dans la même limite.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Segments | 3 | 10 | 100 | Flexible |
| Segments avec suivi | — | Inclus | Inclus | Inclus |

La liste **Segments** affiche le nombre de segments utilisés, par exemple `3/10 used`. Lorsque vous atteignez la limite, **Create segment** et **Duplicate** sont désactivés jusqu’à ce que vous supprimiez un segment ou [passiez à un forfait supérieur](/fr/docs/billing/plans/). L’API renvoie `422` avec l’objet `usage` actuel :

```json
{
  "error": "Pay as you go includes 3 segments.",
  "message": "Pay as you go includes 3 segments.",
  "usage": { "used": 3, "limit": 3 }
}
```

Si vous passez à un forfait inférieur, vos segments continuent de fonctionner, mais vous ne pouvez plus en ajouter tant que vous n’êtes pas repassé sous la nouvelle limite. Sur Pay as you go, les segments avec suivi sont mis en pause. Consultez [Quand le suivi est mis en pause](/fr/docs/segments/tracked/#when-tracking-pauses).

Un segment peut avoir jusqu’à 10 groupes et 50 règles, et puiser dans 100 listes de contacts au maximum.

## Utiliser l’API et le serveur MCP

L’[API des segments](/fr/docs/api-reference/segments/) permet de [créer](/fr/docs/api-reference/segments/create/), [récupérer](/fr/docs/api-reference/segments/get/), [mettre à jour](/fr/docs/api-reference/segments/update/), [lister](/fr/docs/api-reference/segments/list/) et [supprimer](/fr/docs/api-reference/segments/delete/) des segments, de [lister leurs contacts](/fr/docs/api-reference/segments/contacts/), de [prévisualiser](/fr/docs/api-reference/segments/preview/) une définition avant de l’enregistrer et de [lister les champs](/fr/docs/api-reference/segments/fields/) utilisables dans les règles. L’API nécessite une clé API **Full Access**.

```bash
curl https://api.emailit.com/v2/segments \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme team",
    "conditions": { "rules": [{ "field": "email_domain", "operator": "equals", "value": "acme.com" }] }
  }'
```

Pour envoyer une campagne à un segment, ajoutez `{ "segment_id": "seg_…" }` à ses `recipients` avec [Mettre à jour une campagne](/fr/docs/api-reference/campaigns/update/), ou `{ "segment_id": "seg_…", "exclude": true }` pour l’exclure.

Sur le [serveur MCP](/fr/docs/mcp/), le groupe d’outils `segments` propose les mêmes opérations : un assistant IA peut donc créer et vérifier des segments pour vous. Consultez [Groupes d’outils](/fr/docs/mcp/toolsets/).

## Étapes suivantes

  - [Segments avec suivi](/fr/docs/segments/tracked/): Enregistrez les entrées et les sorties et démarrez des automatisations.
  - [Créer une campagne](/fr/docs/campaigns/create/): Envoyez à des segments et excluez-en d’autres.
  - [Champs personnalisés](/fr/docs/contacts/custom-fields/): Stockez les données sur lesquelles vos règles filtrent.
  - [API des segments](/fr/docs/api-reference/segments/): Tous les endpoints des segments.

---
Source: https://emailit.com/fr/docs/segments/