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.

Créer un brouillon

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 :

• Les interrupteurs de suivi des ouvertures et des clics.
• Jusqu'à 20 tags, chacun composé d'un nom et d'une valeur, pour filtrer ce broadcast par la suite.
• La catégorie, qui vaut par défaut marketing.

L'adresse d'expéditeur

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é.

Le template

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.

Envoyer ou programmer

Bientôt disponible : L’attente de fonds et les commandes de reprise décrites ci-dessous ne sont pas encore disponibles. Actuellement, un broadcast qui manque de fonds échoue avec quota_exceeded. Utilisez Get a broadcast pour vérifier failure_detail et ajoutez des fonds si un solde insuffisant est indiqué. Un rechargement ne relance pas un broadcast en échec ; vérifiez à quels destinataires le message n’a pas été envoyé avant de créer un nouvel envoi. Un message accepté pour livraison mais encore différé est déjà envoyé ; excluez ce destinataire du nouveau broadcast.

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.

Lors de l'envoi, Bird 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 sur la liste de suppression, 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, lorsque 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.

Avant l'envoi, vérifiez dans la boîte de dialogue d'envoi le coût estimé pour les destinataires qui peuvent recevoir le broadcast, ainsi que tout avertissement sur le quota. Les membres disposant d'un accès à la facturation voient aussi le solde du portefeuille et l'état du rechargement automatique. Le coût inclut les taxes lorsqu'un prix est disponible ; les prix et l'utilisation peuvent changer avant l'envoi. Si votre plan ne propose pas d'estimation pour les broadcasts, la boîte de dialogue l'indique au lieu d'afficher un coût nul. Le quota est une estimation partagée avec les autres envois d'e-mails. Programmer un broadcast ne réserve pas son solde, et un autre broadcast peut consommer des fonds avant que celui-ci ne se termine.

Si le rechargement automatique est activé, vos paramètres existants peuvent débiter votre moyen de paiement enregistré plusieurs fois pendant l'envoi du broadcast. Lancer un broadcast n'augmente pas votre montant de rechargement et n'autorise pas de paiement distinct pour toute l'audience.

Si le solde est épuisé, le broadcast affiche Waiting for funds pendant un maximum de 20 minutes, que le rechargement automatique soit activé ou non. Il vérifie une fois par minute si des fonds sont disponibles. Un ajout de fonds manuel ou par rechargement automatique peut relancer l’envoi pendant cette période. Un rechargement qui laisse votre compte bloqué pour insuffisance de fonds ne relance pas l’envoi. Les recharges partielles ne prolongent pas l’attente en cours. Une fois l’envoi repris, une interruption ultérieure déclenche une nouvelle attente de 20 minutes.

Si l'attente se termine avant que l'envoi puisse reprendre, le broadcast passe à Paused et les contacts de facturation de votre organisation reçoivent un e-mail. Vérifiez le solde et ajoutez des fonds si nécessaire. Les broadcasts en attente conservent leur créneau d'envoi simultané ; les broadcasts en pause le libèrent.

Ouvrez le broadcast et sélectionnez Resume broadcast. Vérifiez que ses dates, offres et échéances sont toujours valables : les destinataires restants recevront le message plus tard que prévu.

Dans la boîte de dialogue Resume broadcast, développez Preview email pour vérifier un template enregistré de l’espace de travail. L'aperçu nécessite email_management:read ; si vous n'avez pas cette autorisation, demandez à un collègue autorisé de le vérifier. Les templates intégrés et le contenu enregistré manquant ne peuvent pas être prévisualisés ici. Si l'aperçu n'est pas disponible, suivez les vérifications du template ci-dessous et laissez le broadcast en pause tant que vous ne pouvez pas vérifier ce que les destinataires restants recevront. L'aperçu est facultatif et n'empêche pas la reprise.

Pour un broadcast lancé il y a au moins 24 heures, la confirmation indique son ancienneté en heures et un avertissement sur la livraison tardive. Ajouter des fonds ne reprend pas automatiquement un broadcast en pause.

Pour vérifier le message avant de reprendre l'envoi via API, récupérez le broadcast et lisez ses références started_at et template fixées. Récupérez le template avec template.id ; scope: system identifie un template intégré. Si la lecture du template renvoie 404, essayez sa version fixée par ID, car les versions publiées de l'espace de travail restent lisibles après leur suppression. Pour un template de l'espace de travail, récupérez cette version du template avec template.id comme template_ref et template.version_id comme version_id. Vérifiez l'objet et le corps dans template.language, ou dans le default_language de la version si aucune langue n'a été sélectionnée. La lecture de ce contenu nécessite email_management:read ; si vous n'avez pas cette autorisation, demandez à un collègue autorisé de le vérifier. Les consultations de templates intégrés affichent le contenu actuel du catalogue. Les broadcasts dont le contenu est figé le conservent, mais les broadcasts plus anciens peuvent relire le catalogue lors de la reprise. Ni une consultation actuelle ni un message antérieur ne prouvent à eux seuls ce que recevront les destinataires restants. Laissez le broadcast en pause tant que vous ne pouvez pas vérifier ce contenu.

L'API de reprise et les SDK exigent confirm: true pour un broadcast aussi ancien. Avec la CLI, vérifiez d'abord le broadcast, puis passez --yes à bird email broadcasts resume pour accepter la livraison tardive. Sans cette option, la CLI renvoie un avertissement et ne pose aucune question interactive. L'outil de reprise MCP utilise aussi confirm: true ; demandez à la personne qui a demandé l'envoi de confirmer que le message est toujours d'actualité.

Les appels programmatiques peuvent toujours passer confirm: true, y compris avant le seuil de 24 heures, si leur application a déjà décidé de poursuivre la livraison. Cela ne contourne pas les vérifications de solde, de quota d'envoi, d'autorisation ou de broadcasts simultanés.

La reprise conserve les références de template enregistrées et la liste de destinataires. Les destinataires auxquels le message a déjà été envoyé ne le reçoivent pas à nouveau. Les suppressions et préférences de consentement actuelles s'appliquent selon la catégorie du broadcast : les désabonnements marketing ne bloquent pas les broadcasts transactionnels. La reprise ne consomme pas un autre broadcast de votre quota mensuel. Votre compte ne doit plus être bloqué pour solde insuffisant, son quota d'envoi doit couvrir le lot suivant, et un créneau d'envoi simultané doit être disponible. Si une limite d'envoi quotidienne ou mensuelle bloque encore le lot, la reprise renvoie 429 et le broadcast reste en pause. Relancez le même broadcast une fois le quota réinitialisé ou sa limite modifiée. Un espace de travail actuellement suspendu renvoie 403 avec E08024. Après la réactivation, un broadcast autorisé avant la suspension ne peut toujours pas reprendre : API renvoie 403 avec E04102. Annulez ce broadcast au lieu de réessayer. Ne renvoyez pas le message à toute l'audience sans exclure les destinataires auxquels le message a déjà été envoyé. La reprise ne réserve pas de fonds et ne garantit pas que tous les messages restants pourront être envoyés. Si le solde est épuisé après une reprise explicite, une nouvelle attente de 20 minutes commence. Vous pouvez plutôt annuler le broadcast si son message n'est plus utile.

Trouver un broadcast

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.

Statut du broadcast

Bientôt disponible : Les statuts waiting_for_funds et paused ci-dessous ne sont pas encore disponibles. Actuellement, un broadcast qui manque de fonds échoue et ne reprend pas après un rechargement.

L'étape d'un broadcast apparaît dans le filtre Status :

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.

Annuler ou supprimer

Annulez un broadcast programmé, en cours d'envoi, en attente ou en pause 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.

Quand un broadcast échoue

Le tableau de bord explique l'échec et indique quoi vérifier ensuite. Pour quota_exceeded, il affiche le motif enregistré et des conseils sur les limites d'envoi et les fonds. Vous pouvez aussi utiliser Get a broadcast et lire failure_reason et failure_detail.

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 individuels partagent l'allocation d'e-mails de l'organisation. Ajouter des fonds ne relance pas un broadcast en échec. Vérifiez à quels destinataires le message n'a pas été envoyé avant de créer un nouveau broadcast. Excluez les destinataires dont les messages ont été acceptés pour livraison, y compris les messages encore différés par le serveur de réception. Le comportement d'attente et de pause sera bientôt disponible. Les limites d'envoi strictes et les restrictions de paiement continuent de s'appliquer. Plans et tarifs détaille ce que chaque plan inclut.

Suivre la livraison

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.

Tester un broadcast

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 quand même dans votre quota d'envoi, de sorte que le test couvre le même quota que l'envoi réel.

Étapes suivantes

• Audiences : les listes de destinataires vers lesquelles un broadcast envoie
• Templates e-mail : le sujet et le corps vers lesquels un broadcast pointe
• Métriques e-mail : la vue globale de l'espace de travail alimentée par les broadcasts
• bird email broadcasts : une commande CLI par opération de broadcast
• Créer un broadcast : la référence API, avec les schémas complets de requête et de réponse et un exemple de code par SDK
• Diffusions e-mail : un seul e-mail pour toute votre audience : une vidéo qui envoie un broadcast et consulte ses résultats