Broadcasts

Ein Broadcast sendet eine einzelne E-Mail an eine gesamte Zielgruppe: einen Newsletter, eine Ankündigung oder jeden anderen einzelnen Inhalt, der gleichzeitig an viele Empfänger geht. Die Mitglieder der Zielgruppe werden beim Start des Versands in die Empfängerliste aufgelöst, sodass ein Broadcast alle erreicht, die zu diesem Zeitpunkt Mitglied der Zielgruppe sind.

Erstellen Sie Broadcasts im Dashboard unter Email > Broadcasts, über die Broadcasts-API, mit bird email broadcasts oder über den MCP-Server. Die SDKs für TypeScript, Python, Go und PHP stellen eine broadcasts-Ressource für den gesamten Lebenszyklus bereit: einen Entwurf erstellen, ihn noch im Entwurfsstatus ändern, ihn sofort oder später senden, die Broadcasts des Workspaces auflisten, einen Broadcast mit seinen Zählern abrufen, einen geplanten oder laufenden Versand abbrechen, einen Entwurf löschen sowie Empfänger, Ereignisse, angeklickte Links, das für einen Versand benötigte Sendekontingent und die beim Versand berücksichtigten Zielgruppenzahlen abrufen. Für eine einmalige Empfängerliste nutzen Sie den Batch-Versand oder Einzelversand.

Starten Sie in der Broadcasts-Liste mit New broadcast. Der Composer ist eine einzelne Seite: oben eine Leiste für Audience und Absender, darunter der E-Mail-Inhalt und ein Einstellungs-Steuerelement für Kategorie, Tracking und Tags. Es gibt keinen separaten Speicherschritt. Jede Änderung wird automatisch gespeichert, sobald der Broadcast eine Audience und einen Absender hat. Ein Entwurf existiert also, sobald diese beiden gesetzt sind, und das Senden ist eine separate, explizite Aktion.

Verwenden Sie das Feld To, um eine Audience auszuwählen, oder wählen Sie New, um eine neue zu erstellen, ohne den Composer zu verlassen.

Öffnen Sie das Einstellungs-Steuerelement im Header des Composers für drei weitere Optionen:

Ein Broadcast wird von einer Adresse auf einer verifizierten Sendedomain gesendet. Kombinieren Sie einen lokalen Teil mit einer Ihrer verifizierten Domains und fügen Sie optional einen Anzeigenamen hinzu. Fügen Sie eine Reply-To-Adresse hinzu, wenn Antworten woanders hingeleitet werden sollen. Review warnt Sie, wenn die Domain nicht verifiziert ist.

Ein Broadcast verweist auf eines der E-Mail-Templates Ihres Workspace, und das Template enthält die Betreffzeile und den Body, den der Broadcast sendet. Die Kontakteigenschaften jedes Empfängers füllen die Variablen des Templates beim Senden aus, sodass ein Broadcast seinen Inhalt pro Empfänger personalisiert. Ein Broadcast kann nur Kontakteigenschaften einsetzen. Eine Template-Variable, die auf etwas anderes verweist, wird beim Senden abgelehnt, und die Fehlermeldung benennt die Variable.

Schreiben Sie den Inhalt direkt in der Canvas unterhalb der Betreffzeile, oder wählen Sie Choose a template, um mit einem vorhandenen Template zu beginnen. Diese Option ist nur verfügbar, solange der Broadcast leer ist, da die Auswahl eines Templates einen bereits geschriebenen Betreff oder Body überschreiben würde. Ein Broadcast sendet die veröffentlichte Version des Templates, daher kann ein Template, das nur einen Entwurf hat, keinen Versand stützen.

Ein Template mit mehreren Sprachen sendet eine davon an die gesamte Audience. Geben Sie die Sprache beim Erstellen oder Aktualisieren des Broadcasts als template.language an, oder lassen Sie sie weg, um die Standardsprache des Templates zu senden. Wenn Sie nur die Sprache ändern, bleibt der Broadcast auf der Version, auf die er festgelegt ist, sobald er eine hat. Ein Broadcast wird auf eine Version festgelegt, wenn er für den Versand vorbereitet wird. Ein geplanter Broadcast sendet also die Version, die zu diesem Zeitpunkt veröffentlicht ist, unabhängig davon, ob Sie vorher die Sprache ändern.

Der Versand ist eine separate, explizite Aktion, verfügbar über die Review-Schaltfläche im Composer oder über die Detailseite des Broadcasts unter Send or reschedule. Beide öffnen einen Dialog, der prüft, ob der Broadcast vollständig ist, Sie vor möglichen Fehlerquellen warnt und Ihnen die Wahl zwischen Send now oder einem Zeitpunkt bis zu einem Jahr in der Zukunft lässt. Ein geplanter Broadcast bleibt bearbeitbar, und Sie können ihn bis unmittelbar vor dem tatsächlichen Versandstart umplanen.

Beim Senden wird geprüft, ob die Audience noch erreichbare Empfänger enthält. Eine Audience, in der niemand eine E-Mail-Adresse hat oder in der jede Adresse unterdrückt ist, wird an dieser Stelle abgelehnt, anstatt später fehlzuschlagen.

Beim Senden werden zwei Limits auf Organisationsebene geprüft.

Das erste begrenzt, wie viele Broadcasts Sie in einem Abrechnungszeitraum senden können. Ihr Plan legt die Anzahl fest. Gespeicherte Entwürfe zählen nicht dazu, und das Abbrechen eines Broadcasts gibt das Kontingent nicht zurück. Wenn Sie es aufgebraucht haben, warten Sie entweder auf den nächsten Abrechnungszeitraum oder wechseln zu einem Plan mit einem höheren Limit.

Das zweite begrenzt gleichzeitige Broadcasts. Wenn Sie Send now wählen, während das Limit erreicht ist, wird die Anfrage abgelehnt. Ein geplanter Broadcast wartet auf einen freien Platz.

Durchsuchen Sie die Liste nach Tag oder Template-Name, oder filtern Sie nach Status, Audience oder einem Datumsbereich. Der Datumsbereich filtert nach dem Erstellungsdatum jedes Broadcasts, nicht nach dem Sendezeitpunkt. Ein Broadcast, den Sie letzte Woche für einen Versand nächsten Monat geplant haben, erscheint also unter "Last 7 days."

Exportieren Sie die aktuelle Ansicht als CSV über die Schaltfläche oberhalb der Tabelle, oder rufen Sie Broadcasts als CSV exportieren auf, das die gleichen Filter akzeptiert. Ab 50.000 Zeilen wird der Export abgelehnt, anstatt stillschweigend abgeschnitten zu werden. Schränken Sie die Filter ein und versuchen Sie es erneut.

Ein Broadcast befindet sich immer in einer von vier Phasen, und der Statusfilter in der Liste verwendet diese vier:

Das Badge jeder Zeile zeigt den genauen Status innerhalb der Phase. Denselben Wert gibt das Feld status der API zurück.

Brechen Sie einen geplanten oder laufenden Broadcast über seine Detailseite ab, mit bird email broadcasts cancel, oder mit Broadcast abbrechen und der broadcasts.cancel-Methode SDK. Empfänger, die noch nicht erreicht wurden, werden übersprungen, und bereits unterwegs befindliche Nachrichten können nicht zurückgerufen werden. Löschen funktioniert nur bei Entwürfen und ist dauerhaft, über dieselben drei Wege: die Detailseite, bird email broadcasts delete, oder Broadcast löschen.

Ein fehlgeschlagener Broadcast zeigt den Grund auf seiner Detailseite: den Grund und dann einen Satz, der die genaue Ursache benennt. Über die API sind das die Felder failure_reason und failure_detail. failure_detail verrät Ihnen, welche der verschiedenen Ursachen eines Grundes tatsächlich aufgetreten ist.

Die Versandkonfiguration eines Broadcasts wird erst beim Versandstart geprüft. Wenn die Sendedomain bei der Planung verifiziert war, aber vor dem Versand die Verifizierung verloren hat, schlägt der Broadcast an dieser Stelle fehl. Verifizieren Sie die Domain und senden Sie den Broadcast erneut.

Broadcasts und Einzelsendungen nutzen dasselbe E-Mail-Kontingent. Die Plan-Karte in der Abrechnungsübersicht Ihrer Organisation zeigt, wie viel davon verbraucht ist. Pläne und Preise beschreibt, was jeder Plan enthält.

Sobald der Versand beginnt, zeigt der Overview-Tab des Broadcasts die Empfänger- und Versandzahlen, dann die Zustellungs-, Öffnungs-, Klick-, Bounce- und Beschwerderaten mit ihren Zählern. Der Recipients-Tab listet jeden Empfänger mit seinem Zustellstatus, dem Grund bei Nichtzustellung, dem Zustellzeitpunkt sowie seinen Öffnungen und Klicks. Das Suchfeld erfordert eine vollständige, gültige E-Mail-Adresse; eine unvollständige Adresse oder eine Domain besteht die Validierung nicht, markiert das Feld als ungültig und lässt die Tabelle unverändert. Eine Schaltfläche oberhalb der Tabelle exportiert den Tab als CSV, und Broadcast-Empfänger als CSV exportieren liefert dieselbe Datei an einen API-Key. Beide sind auf 500.000 Zeilen begrenzt, mit demselben Verhalten wie beim Broadcast-Listen-Export: Ablehnung statt stillschweigendem Abschneiden. Der Events-Tab ist der Roh-Event-Feed des Broadcasts und verwendet die in Events und Webhooks beschriebenen Eventtypen.

Fügen Sie eine Sandbox-Adresse in die Audience ein, und dieser Kontakt wird simuliert statt tatsächlich gesendet: delivered@messagebird.dev meldet zugestellt, bounce@messagebird.dev meldet Bounce, und beide erzeugen dieselben Events und Webhooks wie ein echter Empfänger. So testen Sie eine Kampagne und den Handler, der ihre Events verarbeitet, ohne jemanden anzuschreiben. Eine Audience kann Sandbox- und echte Kontakte mischen; jeder Kontakt erhält sein eigenes Ergebnis. Ein simulierter Empfänger zählt trotzdem gegen Ihr Sendekontingent, sodass die Probe dasselbe Kontingent verbraucht wie der echte Versand.