---
title: Campagnes
description: Rédigez, programmez et envoyez un e-mail à de nombreux contacts, avec champs de fusion, rythme d'envoi et lien de désinscription par domaine.
seo:
  title: Campagnes d'emailing
ai:
  exclude: true
---

Une campagne est un e-mail envoyé à de nombreux contacts : tous, un [segment](/docs/fr/concepts/segments) ou une [thématique](/docs/fr/concepts/topics). Rédigez-la dans le tableau de bord sous **Campagnes**, avec des champs de fusion propres à chaque contact, ou créez-la avec l'API.

## Envoyer une campagne

```ts
import { BillionSend } from "@billionsend/node";

const bs = new BillionSend(); // reads BILLIONSEND_API_KEY

const { data, error } = await bs.broadcasts.create({
  name: "November news",
  segment_id: "SEGMENT_ID",
  from: "Acme <news@mail.example.com>",
  subject: "What's new",
  html: "<p>Hi {{{FIRST_NAME|there}}},</p><p>...</p><p><a href=\"{{{UNSUBSCRIBE_URL}}}\">Unsubscribe</a></p>",
});

if (error) throw error;

await bs.broadcasts.send(data.id, { scheduled_at: "in 1 hour" });
```

Omettez `scheduled_at` pour envoyer tout de suite. Une campagne exige un domaine d'envoi vérifié dans `from`. Dans l'éditeur, vous pouvez partir d'un [template](/docs/fr/concepts/templates) enregistré.

## Cycle de vie

```
draft → scheduled → sending → sent
              ↘ canceled
              ↘ failed
```

- Une nouvelle campagne est un **brouillon** (`draft`), et seul un brouillon peut être modifié.
- `POST /broadcasts/{id}/send` l'envoie tout de suite ou à `scheduled_at`.
- `POST /broadcasts/{id}/cancel` annule une campagne programmée, ou une campagne déjà en cours d'envoi. Les e-mails déjà envoyés ne sont pas rappelés. Le champ `canceled_remaining` de la réponse indique combien ont été arrêtés, et `sent_count` à la lecture indique combien sont partis.
- Les brouillons, et les campagnes en échec qui n'ont rien envoyé, peuvent être supprimés.
- Côté API, `scheduled` et `sending` apparaissent tous deux comme `queued`. Une campagne reste `queued` avec `sent_at` vide jusqu'à l'envoi de son dernier e-mail.

## Qui la reçoit

Chaque destinataire est vérifié au moment où la campagne part. Sont exclus :

- les contacts `unsubscribed` pour toute l'équipe, et les contacts désinscrits du domaine d'envoi de la campagne ;
- les contacts qui se sont retirés de la thématique de la campagne ;
- les adresses de la [liste de suppression](/docs/fr/concepts/suppressions).

Le nombre de destinataires affiché par le tableau de bord avant l'envoi exclut déjà ces contacts.

## Le domaine d'envoi

Le domaine d'envoi de la campagne est celui de son adresse `from`, renvoyé sous `domain_id`. Il détermine :

- **Quelles désinscriptions s'appliquent.** Les personnes désinscrites de ce domaine sont ignorées. Voir [Désinscriptions](/docs/fr/concepts/unsubscribes).
- **Ce que voit le destinataire.** Le lien de désinscription ouvre la [page de désinscription](/docs/fr/concepts/unsubscribes) propre à ce domaine, sur son propre sous-domaine s'il en a un.
- **Quelle audience est autorisée.** Une thématique ou un segment lié à un autre domaine est refusé avec `422` : une marque n'envoie donc jamais à l'audience d'une autre marque.

Un domaine ne peut pas être supprimé tant qu'une campagne programmée ou en cours d'envoi l'utilise (`409`).

## Champs de fusion et liens de désinscription

- Les valeurs propres à chaque contact, comme `{{{FIRST_NAME|there}}}`, sont renseignées pour chaque destinataire. Voir [Templates](/docs/fr/concepts/templates).
- Chaque e-mail de campagne reçoit les en-têtes `List-Unsubscribe` à un clic et un lien de désinscription hébergé. Pour placer le lien dans le corps du message, écrivez `{{{UNSUBSCRIBE_URL}}}`.

## Rythme d'envoi

Une campagne qui tient dans la capacité disponible part immédiatement. Une campagne plus grande part par vagues, sur les jours suivants. Un e-mail transactionnel n'est jamais retenu derrière une campagne : il est envoyé avant les destinataires restants d'une campagne.

L'appel d'envoi indique à quoi vous attendre :

```json
{
  "id": "8c1f0b8e-…",
  "finishes_at": "2026-09-18T13:26:05Z",
  "estimated": true,
  "warning": { "code": "paced", "days": 3, "message": "…" }
}
```

- `finishes_at` est l'heure estimée à laquelle le dernier e-mail part. C'est une estimation, et d'autres envois peuvent la décaler.
- `warning` apparaît quand l'envoi demande plus d'une vague : `paced` quand l'audience dépasse la capacité disponible à ce moment-là, `queued_behind` quand d'autres envois passent avant.
- Pendant l'envoi, `GET /broadcasts/{id}` renvoie un `finishes_at` et un `sent_count` à jour.
- Une audience qui exigerait plus de 24 jours de capacité est refusée avec `422 broadcast_too_large`. Découpez-la en segments plus petits.

## Dupliquer une campagne

`POST /broadcasts/{id}/duplicate` copie n'importe quelle campagne, même envoyée ou en échec, dans un nouveau brouillon. Dans le tableau de bord, utilisez **Dupliquer** dans le menu de la campagne.

- **Copiés :** segment, thématique, expéditeur, objet, `reply_to`, texte d'aperçu et contenu.
- **Non copiés :** la programmation, les compteurs et la progression de l'envoi. La copie est un brouillon ordinaire.
- Le nom est celui de l'original suivi de ` (copy)`.

## Quand une campagne échoue

Une campagne se termine en `failed` quand elle a été acceptée mais ne peut pas partir, ou quand l'envoi a échoué à répétition. `GET /broadcasts/{id}` renvoie alors `failure_reason` et `failed_at`. Les e-mails déjà remis restent envoyés, et les propriétaires de l'équipe reçoivent un e-mail une seule fois.

| `failure_reason` | Signification |
| --- | --- |
| `domain_missing` | Le domaine d'envoi a été supprimé. |
| `sender_domain_mismatch` | `from` n'est plus sur le domaine avec lequel la campagne a été programmée. |
| `topic_other_domain` | La thématique est liée à un autre domaine. |
| `segment_other_domain` | Le segment est lié à un autre domaine. |
| `domain_unverified` | Le domaine d'envoi est resté non vérifié pendant quelques heures de nouvelles tentatives. |
| `retries_exhausted` | Une autre erreur a persisté jusqu'à épuisement des nouvelles tentatives. |

Pour atteindre l'audience, dupliquez la campagne, corrigez la cause dans le nouveau brouillon, puis envoyez-la.

## Quand une campagne est refusée

- `403 sending_paused` : votre taux de rebonds ou de plaintes est trop élevé. Voir [Limites d'envoi](/docs/fr/concepts/sending-limits).
- `403 broadcasts_paused` : les campagnes sont suspendues, soit pour toute la plateforme le temps que les taux se rétablissent, soit pour votre équipe par BillionSend. Les e-mails transactionnels ne sont pas touchés.
- `403 inbox_send_policy` : l'expéditeur est sur votre domaine de boîtes de réception partagé, qui ne peut pas envoyer de campagnes.

Quand une campagne atteint le volume de votre forfait, le reste de son audience attend et part dès qu'il y a de la place. Voir [Forfaits et limites](/docs/fr/billing).

Consultez la [référence de l'API](/docs/fr/api-reference) pour tous les endpoints de campagne.
