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 dans le tableau de bord, via /v1/email/broadcasts, ou avec bird email broadcasts. Les SDK n'incluent pas de méthodes broadcast. Pour une liste de destinataires ponctuelle, utilisez l'envoi par lot ou les envois individuels.

Commencez depuis la liste Broadcasts avec New broadcast. Le composeur est une page unique : une barre audience et 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 composeur.

Ouvrez le contrôle de paramètres dans l'en-tête du composeur 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 dirigées ailleurs. Sélectionner Review vous avertit si le domaine n'est pas vérifié.

Un broadcast pointe vers l'un des modèles d'e-mail de votre espace de travail, et le modèle contient l'objet et le corps que le broadcast envoie. Les propriétés de contact de chaque destinataire remplissent les variables du modèle 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 modèle nommant autre chose est refusée lors de 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 modèle existant. Cette option n'est disponible que tant que le broadcast est vierge, car choisir un modèle après avoir rédigé un objet ou un corps l'écraserait. Un broadcast envoie la version publiée du modèle, de sorte qu'un modèle qui n'a qu'un brouillon ne peut pas servir d'envoi.

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 élément susceptible de faire échouer l'envoi, puis vous permet de choisir Send now ou de sélectionner une date jusqu'à un an à l'avance. Un broadcast planifié reste modifiable, et vous pouvez le replanifier jusqu'au moment où l'envoi démarre effectivement.

L'envoi vérifie que l'audience contient encore des destinataires à atteindre. Une audience dont personne n'a d'adresse e-mail, ou dont toutes les adresses sont supprimées, est refusée à ce moment-là 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 au cours d'une période de facturation. Votre plan fixe ce nombre. Les brouillons enregistrés ne comptent pas, et annuler un broadcast ne rend pas le quota. Une fois celui-ci épuisé, 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 planifié attend qu'un emplacement se libère.

Recherchez dans la liste par tag ou nom de modèle, 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, de sorte qu'un broadcast planifié la semaine dernière pour un envoi le mois prochain apparaît toujours sous "Last 7 days."

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

Un broadcast est toujours dans l'une des 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. Cette même valeur est ce que le champ status de API renvoie.

Annulez un broadcast planifié ou en cours d'envoi depuis sa page de détail. Les destinataires non 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.

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 effectivement 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 planification mais a perdu sa vérification avant l'envoi, le broadcast échoue à ce moment-là. Vérifiez le domaine et renvoyez le broadcast.

Les broadcasts et les envois individuels puisent dans le même quota d'e-mails. La carte du plan dans l'aperçu de facturation de votre organisation indique la part utilisée. Plans et tarifs détaille ce que chaque plan inclut.

Une fois l'envoi lancé, l'onglet Overview du broadcast affiche le nombre de destinataires et d'envois, puis les taux et les compteurs de livraison, d'ouverture, de clic, de rebond et de 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 échoue à la validation, marque le champ comme invalide et laisse le tableau afficher ce qu'il affichait précédemment. Un bouton au-dessus du tableau exporte l'onglet en CSV, limité à 200 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 et ce contact est simulé au lieu d'être réellement envoyé : delivered@messagebird.dev signale une livraison, bounce@messagebird.dev un rebond, et chacun produit les mêmes événements et webhooks qu'un vrai destinataire. C'est ainsi que vous testez une campagne, et le gestionnaire qui lit ses événements, sans envoyer de message à quiconque. Une audience peut mélanger contacts sandbox et contacts réels ; chaque contact obtient son propre résultat. Un destinataire simulé compte tout de même dans votre quota d'envoi, de sorte que la répétition couvre le même quota que l'envoi réel.