Campagnes
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.
Une campagne est un e-mail envoyé à de nombreux contacts : tous, un segment ou une thématique. 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
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 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}/sendl’envoie tout de suite ou àscheduled_at.POST /broadcasts/{id}/cancelannule 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 champcanceled_remainingde la réponse indique combien ont été arrêtés, etsent_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,
scheduledetsendingapparaissent tous deux commequeued. Une campagne restequeuedavecsent_atvide 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
unsubscribedpour 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.
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.
- Ce que voit le destinataire. Le lien de désinscription ouvre la page de désinscription 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. - 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 :
{
"id": "8c1f0b8e-…",
"finishes_at": "2026-09-18T13:26:05Z",
"estimated": true,
"warning": { "code": "paced", "days": 3, "message": "…" }
}
finishes_atest l’heure estimée à laquelle le dernier e-mail part. C’est une estimation, et d’autres envois peuvent la décaler.warningapparaît quand l’envoi demande plus d’une vague :pacedquand l’audience dépasse la capacité disponible à ce moment-là,queued_behindquand d’autres envois passent avant.- Pendant l’envoi,
GET /broadcasts/{id}renvoie unfinishes_atet unsent_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.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.
Consultez la référence de l’API pour tous les endpoints de campagne.