Aller au contenu
Esc
↑↓naviguer↵ouvrir⌘Japerçu
Sur cette page

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}/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.

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_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.
  • 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.

Cette page vous a-t-elle été utile ?