# Tester et programmer une campagne

> Envoyez des e-mails de test, prévisualisez une campagne avec les données d’un vrai contact, envoyez-la immédiatement ou programmez-la, annulez une programmation et suivez ce qui se passe pendant l’envoi.

Avant d’envoyer une campagne, vérifiez-la dans votre propre boîte de réception et avec les données de vrais contacts. Envoyez-la ensuite immédiatement ou choisissez une heure. Cette page traite des tests, de la programmation, de l’annulation d’une programmation et de ce qui se passe pendant l’envoi de la campagne, dans le tableau de bord et avec l’API.

## Envoyer un test

Les envois de test partent vers vos propres adresses, pour que vous puissiez vérifier l’e-mail dans de vraies boîtes de réception et de vrais clients de messagerie.

1. **Ouvrez l’étape de test.** Dans l’assistant de campagne, accédez à **Preview and test**.

2. **Saisissez les adresses.** Sous **Send test**, tapez 5 adresses au maximum, séparées par des virgules, des espaces ou des points-virgules, par exemple `me@acme.com, colleague@acme.com`.

3. **Envoyez.** Sélectionnez **Send test**. La confirmation indique « Test email is being sent. »

Les envois de test diffèrent de la vraie campagne :

- **Les balises de fusion utilisent des données fictives.** `{{email}}` devient l’adresse de test. Le prénom, le nom et les champs personnalisés sont vides. Pour vérifier les vraies valeurs, utilisez [Preview as contact](#preview-as-a-contact).
- **Le lien de désinscription ne désinscrit personne.**
- **Les chargements et les clics ne sont pas suivis**, et les tests ne comptent pas dans le rapport de la campagne.
- **Limites :** 5 adresses au maximum par test et 3 tests par minute. La campagne doit d’abord avoir un **From email**.
- **Les espaces de travail en mode bac à sable** ne peuvent envoyer des tests qu’aux adresses des comptes des membres de l’espace de travail. Consultez [Accès production](/fr/docs/workspaces/production-access/).

Les e-mails de test apparaissent dans **Email API → Emails** comme les autres e-mails sortants.

## Prévisualiser en tant que contact

À la même étape, **Preview as contact** effectue le rendu de la campagne avec les données d’un contact. Recherchez un contact par nom ou par adresse e-mail : l’aperçu affiche l’objet et le contenu tels que cette personne les verra, avec « Previewing as » et son nom au-dessus. Passez de **Desktop** à **Mobile** pour vérifier les deux largeurs.

Utilisez-le pour repérer les noms vides, les clés de champs personnalisés erronées et les balises qui n’ont pas été remplacées. Consultez [Balises de fusion](/fr/docs/campaigns/merge-tags/).

## Envoyer maintenant ou programmer

À l’étape **Send**, sélectionnez **Send campaign** et choisissez quand :

| Option | Ce qui se passe |
| --- | --- |
| **Immediately** | Sélectionnez **Send now**. La campagne passe à **In process** et l’envoi commence immédiatement. |
| **Schedule** | Choisissez une date et une heure sous **Schedule for** et sélectionnez **Schedule**. La campagne passe à **Scheduled**. |

Lorsque vous programmez :

- **L’heure est dans le fuseau horaire de votre ordinateur.** Par défaut, le champ propose l’heure pleine suivante. Emailit enregistre l’heure en UTC.
- **Elle doit être dans le futur.** Sinon, la boîte de dialogue affiche « Pick a time in the future. »
- **L’envoi commence dans la minute qui suit l’heure choisie.** Emailit recherche toutes les minutes les campagnes à envoyer.
- **Les destinataires sont déterminés au début de l’envoi** : les personnes qui rejoignent ou quittent vos listes entre-temps sont donc correctement comptées.
- **La campagne est verrouillée.** Seuls les brouillons peuvent être modifiés. Pour modifier une campagne programmée, annulez d’abord la programmation.

## Annuler une programmation

1. **Trouvez la campagne.** Dans **Email Marketing → Campaigns**, ouvrez l’onglet **Scheduled**.

2. **Annulez.** Dans le menu de la ligne, ou en haut de la page de la campagne, sélectionnez **Cancel Schedule** et confirmez.

La campagne repasse en **Draft** sans heure d’envoi : vous pouvez donc la modifier, puis l’envoyer ou la programmer de nouveau. Vous ne pouvez pas annuler dans les 5 dernières minutes avant l’heure programmée. Le tableau de bord affiche alors « Campaign cannot be canceled less than 5 minutes before scheduled time. »

## Pendant l’envoi de la campagne

Au début de l’envoi, Emailit sélectionne les destinataires, écarte les adresses désinscrites et bloquées, et crée un e-mail par destinataire, par lots. Pendant ce temps, la page de la campagne affiche :

- Une carte **In process** : « This campaign is still sending. Counts update as messages move through delivery. »
- **Send progress** : la part des e-mails créés qui ont quitté la file d’attente, par exemple « 1,200 of 5,000 created messages have left the unprocessed queue. »
- Les nombres en direct pour **Sent**, **Delivered**, **Attempted**, **Not processed**, **Bounced**, **Suppressed** et **Complained**. Consultez [Rapports de campagne](/fr/docs/campaigns/reports/#metrics).

Une fois l’e-mail de chaque destinataire créé, le statut passe à **Sent**. La livraison se poursuit ensuite : Emailit réessaie pendant environ 21 heures au maximum les e-mails destinés à des serveurs temporairement indisponibles, et les chargements et les clics continuent d’arriver. Le rapport se met à jour en conséquence.

Une campagne dont l’envoi a commencé ne peut pas être arrêtée depuis le tableau de bord : testez-la donc avant de l’envoyer.

## Utiliser l’API

Envoyez immédiatement un brouillon avec [Envoyer ou programmer une campagne](/fr/docs/api-reference/campaigns/send/) :

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

```json
{
  "object": "campaign",
  "id": "cmp_4Tq9Xv2kLm8Rw",
  "name": "October newsletter",
  "status": "sending",
  "message": "Campaign send initiated"
}
```

Pour la programmer, transmettez `scheduled_at` sous forme de date et d’heure ISO 8601 dans le futur. Un horodatage Unix fonctionne aussi. Seuls les brouillons peuvent être programmés :

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scheduled_at": "2026-10-15T09:00:00Z" }'
```

```json
{
  "object": "campaign",
  "id": "cmp_4Tq9Xv2kLm8Rw",
  "name": "October newsletter",
  "status": "scheduled",
  "scheduled_at": "2026-10-15T09:00:00Z",
  "message": "Campaign is scheduled"
}
```

| Erreur | Cause |
| --- | --- |
| `403` | L’espace de travail n’a pas encore l’accès production. |
| `422` « Invalid scheduled_at » | `scheduled_at` n’est pas une date valide dans le futur. |
| `422` « Campaign cannot be scheduled » | La campagne n’est pas un brouillon. |

[Annuler une campagne](/fr/docs/api-reference/campaigns/cancel/) passe une campagne `draft` ou `sending` à `canceled`. Les e-mails déjà créés pour des destinataires partent quand même. Pour repasser une campagne programmée en brouillon, utilisez **Cancel Schedule** dans le tableau de bord.

Suivez la progression avec les [événements webhook](/fr/docs/webhooks/event-types/) `campaign.scheduled`, `campaign.queued`, `campaign.sending`, `campaign.sent` et `campaign.canceled`.

## Voir aussi

  - [Rapports de campagne](/fr/docs/campaigns/reports/): La signification de chaque métrique.
  - [Créer une campagne](/fr/docs/campaigns/create/): L’assistant complet.

---
Source: https://emailit.com/fr/docs/campaigns/test-and-schedule/