Broadcasts

Un broadcast envoie un e-mail à une audience entière : une newsletter, une annonce ou tout contenu unique destiné à de nombreux destinataires à la fois. Les membres de l'audience sont résolus en liste de destinataires au moment du lancement de l'envoi, de sorte qu'un broadcast atteint toute personne membre de l'audience à cet instant.

Créez des broadcasts dans Email > Broadcasts depuis le tableau de bord, via l'API broadcasts, avec bird email broadcasts, ou via le serveur MCP. Les SDK TypeScript, Python, Go et PHP exposent une ressource broadcasts pour tout le cycle de vie : en créer un en brouillon, le modifier tant qu'il est encore à l'état de brouillon, l'envoyer immédiatement ou à une date ultérieure, lister les broadcasts de l'espace de travail, en consulter un avec ses compteurs, annuler un broadcast planifié ou en cours d'envoi, supprimer un broadcast encore à l'état de brouillon, et consulter ses destinataires, événements, liens cliqués, le quota d'envoi sur lequel un envoi serait imputé, et les compteurs d'audience sur lesquels un envoi est résolu. Pour une liste de destinataires ponctuelle, utilisez l'envoi par lot ou les envois individuels.

Commencez depuis la liste Broadcasts avec New broadcast. Le compositeur tient sur une seule page : une barre d'audience et d'expéditeur en haut, le contenu de l'e-mail en dessous, et un contrôle de paramètres pour la catégorie, le suivi et les tags. Il n'y a pas d'étape d'enregistrement séparée. Chaque modification est enregistrée automatiquement dès que le broadcast a une audience et un expéditeur, de sorte qu'un brouillon existe dès que ces deux éléments sont définis, et l'envoi ultérieur est une action distincte et explicite.

Utilisez le champ To pour choisir une audience, ou sélectionnez New pour en créer une sans quitter le compositeur.

Ouvrez le contrôle de paramètres dans l'en-tête du compositeur pour trois éléments supplémentaires :

Un broadcast est envoyé depuis une adresse sur un domaine d'envoi vérifié. Associez une partie locale à l'un de vos domaines vérifiés et ajoutez un nom d'affichage si vous le souhaitez. Ajoutez une adresse Reply-To si vous voulez que les réponses soient acheminées ailleurs. Sélectionner Review vous avertit si le domaine n'est pas vérifié.

Un broadcast pointe vers l'un des templates d'e-mail de votre espace de travail, et le template contient l'objet et le corps que le broadcast envoie. Les propriétés de contact de chaque destinataire remplissent les variables du template au moment de l'envoi, de sorte qu'un broadcast personnalise son contenu par destinataire. Un broadcast ne peut remplir que des propriétés de contact : toute variable de template faisant référence à autre chose est refusée à l'envoi, et l'erreur nomme la variable.

Rédigez le contenu directement dans le canevas sous la ligne d'objet, ou sélectionnez Choose a template pour partir d'un template existant. Cette option n'est disponible que tant que le broadcast est vierge, car choisir un template après avoir rédigé un objet ou un corps l'écraserait. Un broadcast envoie la version publiée du template, donc un template qui n'existe qu'en brouillon ne peut pas servir de base à un envoi.

Un template qui possède plusieurs langues en envoie une seule à toute l'audience. Indiquez-la dans template.language lorsque vous créez ou mettez à jour le broadcast, et omettez-la pour envoyer la langue par défaut du template. Changer uniquement la langue conserve le broadcast sur la version à laquelle il est fixé, une fois qu'il en a une. Un broadcast est fixé à une version lorsqu'il est préparé pour l'envoi : un broadcast programmé envoie donc la version publiée à ce moment-là, que vous changiez ou non sa langue entre-temps.

L'envoi est une action distincte et explicite, accessible depuis le bouton Review du composeur ou depuis la page de détail du broadcast via Send or reschedule. Chacun ouvre une boîte de dialogue qui vérifie que le broadcast est complet, vous avertit de tout ce qui risque de faire échouer l'envoi, puis vous laisse choisir Send now ou sélectionner une date jusqu'à un an à l'avance. Un broadcast programmé reste modifiable, et vous pouvez le reprogrammer jusqu'au moment où l'envoi démarre effectivement.

L'envoi vérifie que l'audience contient encore quelqu'un à atteindre. Une audience dans laquelle personne n'a d'adresse e-mail, ou dans laquelle chaque adresse est supprimée, est refusée à ce stade au lieu d'échouer plus tard.

Deux limites au niveau de l'organisation sont vérifiées lors de l'envoi.

La première est le nombre de broadcasts que vous pouvez envoyer sur une période de facturation. Votre plan fixe ce nombre. Les brouillons enregistrés ne comptent pas, et annuler un broadcast ne restitue pas l'allocation. Une fois celle-ci épuisée, vous attendez la prochaine période de facturation ou passez à un plan avec une limite plus élevée.

La seconde limite les broadcasts simultanés. Si vous sélectionnez Send now alors que la limite est atteinte, la requête est rejetée. Un broadcast programmé attend qu'un créneau se libère.

Recherchez dans la liste par tag ou nom de template, ou filtrez par statut, audience ou plage de dates. La plage de dates filtre sur la date de création de chaque broadcast, pas sur la date d'envoi : un broadcast programmé la semaine dernière pour un envoi le mois prochain apparaît donc sous "Last 7 days."

Exportez la vue actuelle en CSV depuis le bouton au-dessus du tableau, ou appelez Exporter les broadcasts en CSV, qui accepte les mêmes filtres. Au-delà de 50 000 lignes, l'export est refusé plutôt que tronqué silencieusement. Affinez les filtres et réessayez.

Un broadcast se trouve toujours dans l'une de quatre étapes, et le filtre Status de la liste utilise ces quatre étapes :

Le badge de chaque ligne affiche le statut exact au sein de son étape. C'est la même valeur que renvoie le champ status de API.

Annulez un broadcast programmé ou en cours d'envoi depuis sa page de détail, avec bird email broadcasts cancel, ou avec Annuler un broadcast et la méthode broadcasts.cancel SDK. Les destinataires pas encore atteints sont ignorés, et tout message déjà en transit ne peut pas être rappelé. La suppression ne fonctionne que sur un brouillon et elle est définitive, via les trois mêmes voies : la page de détail, bird email broadcasts delete, ou Supprimer un broadcast.

Un broadcast en échec affiche la raison sur sa page de détail : le motif, puis une phrase nommant la cause exacte. Via API, ces deux éléments sont les champs failure_reason et failure_detail. failure_detail vous indique laquelle des différentes causes d'un motif vous avez réellement rencontrée.

La configuration d'envoi d'un broadcast n'est vérifiée qu'au moment où l'envoi démarre. Si le domaine d'envoi était vérifié lors de la programmation mais a perdu sa vérification avant l'envoi, le broadcast échoue à ce moment-là. Vérifiez le domaine et relancez le broadcast.

Les broadcasts et les envois unitaires puisent dans la même allocation d'e-mails. La carte du plan sur la page de facturation de votre organisation indique la part que vous avez consommée. Plans et tarifs détaille ce que chaque plan inclut.

Dès que l'envoi démarre, l'onglet Overview du broadcast affiche le nombre de destinataires et d'envois, puis les taux et compteurs de livraison, ouverture, clic, rebond et plainte. L'onglet Recipients liste chaque destinataire avec son statut de livraison, la raison en cas de non-livraison, la date de livraison, et ses ouvertures et clics. Son champ de recherche exige une adresse e-mail complète et valide ; une adresse partielle ou un domaine seul échoue à la validation, marque le champ comme invalide et laisse le tableau afficher ce qu'il affichait avant. Un bouton au-dessus du tableau exporte l'onglet en CSV, et Exporter les destinataires d'un broadcast en CSV renvoie le même fichier vers une clé API ; les deux sont limités à 500 000 lignes avec le même comportement de refus plutôt que de troncature que l'export de la liste des broadcasts. L'onglet Events est le flux brut d'événements du broadcast, utilisant les types d'événements décrits dans événements et webhooks.

Ajoutez une adresse sandbox dans l'audience : ce contact est simulé au lieu de recevoir un vrai envoi. delivered@messagebird.dev signale une livraison, bounce@messagebird.dev signale un rebond, et chacun produit les mêmes événements et webhooks qu'un destinataire réel. C'est ainsi que vous testez une campagne, et le handler qui traite ses événements, sans envoyer de mail à qui que ce soit. Une audience peut mélanger contacts sandbox et contacts réels ; chaque contact obtient son propre résultat. Un destinataire simulé compte dans votre allocation d'envoi, de sorte que la répétition couvre le même quota que l'envoi réel.