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 unter Email > Broadcasts im Dashboard, über /v1/email/broadcasts oder mit bird email broadcasts. Die SDKs enthalten keine Broadcast-Methoden. Für eine einmalige Empfängerliste verwenden Sie Batch-Versand oder Einzelversand.

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

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

Öffnen Sie den Einstellungsbereich im Composer-Header für drei weitere Optionen:

Ein Broadcast wird von einer Adresse auf einer verifizierten Versanddomain 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 hin geleitet werden sollen. Bei Auswahl von Review werden Sie gewarnt, 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 Inhalt, den der Broadcast versendet. Die Kontakteigenschaften jedes Empfängers füllen die Variablen des Templates beim Versand aus, sodass ein Broadcast seinen Inhalt pro Empfänger personalisiert. Ein Broadcast kann nur Kontakteigenschaften einsetzen. Eine Template-Variable, die etwas anderes benennt, wird beim Senden abgelehnt, und die Fehlermeldung nennt die Variable.

Schreiben Sie den Inhalt direkt in den 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 Inhalt überschreiben würde. Ein Broadcast versendet die veröffentlichte Version des Templates, daher kann ein Template, das nur einen Entwurf hat, keinen Versand unterstützen.

Das Senden ist eine separate, explizite Aktion, verfügbar über die Schaltfläche Review im Composer oder über die Detailseite des Broadcasts mit Send or reschedule. Beide öffnen einen Dialog, der prüft, ob der Broadcast vollständig ist, Sie vor möglichen Fehlern warnt und Ihnen dann 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 zum tatsächlichen Versandstart umplanen.

Beim Senden wird geprüft, ob die Zielgruppe noch erreichbare Empfänger hat. Eine Zielgruppe, 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. Sobald Sie es aufgebraucht haben, warten Sie entweder auf den nächsten Abrechnungszeitraum oder wechseln zu einem Plan mit höherem 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, Zielgruppe oder einem Datumsbereich. Der Datumsbereich filtert nach dem Erstellungszeitpunkt jedes Broadcasts, nicht nach dem Versandzeitpunkt. 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. Ab 50.000 Zeilen wird der Export abgelehnt, anstatt stillschweigend gekürzt 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 Status-Filter 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. Empfänger, die noch nicht erreicht wurden, werden übersprungen, und eine bereits unterwegs befindliche Nachricht kann nicht zurückgerufen werden. Löschen funktioniert nur bei einem Entwurf und ist dauerhaft.

Ein fehlgeschlagener Broadcast zeigt auf seiner Detailseite den Grund an: die Ursachenkategorie und dann einen Satz, der die genaue Ursache benennt. Über die API sind das die Felder failure_reason und failure_detail. failure_detail sagt Ihnen, welche der möglichen Ursachen einer Kategorie tatsächlich eingetreten ist.

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

Broadcasts und Einzelversand 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 Tab Overview des Broadcasts die Empfänger- und Versandanzahl, dann die Zustellungs-, Öffnungs-, Klick-, Bounce- und Beschwerderaten mit ihren jeweiligen Zahlen. Der Tab Recipients listet jeden Empfänger mit Zustellstatus, dem Grund bei Nichtzustellung, dem Zustellzeitpunkt sowie Öffnungen und Klicks auf. 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, begrenzt auf 200.000 Zeilen mit demselben Verhalten wie beim Broadcast-Listen-Export: Ablehnung statt stilles Abschneiden. Der Tab Events ist der Roh-Event-Feed des Broadcasts und verwendet die in Events und Webhooks beschriebenen Event-Typen.

Fügen Sie eine Sandbox-Adresse in die Zielgruppe ein, und dieser Kontakt wird simuliert statt tatsächlich angeschrieben: 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 deren Events verarbeitet, ohne jemanden tatsächlich anzuschreiben. Eine Zielgruppe kann Sandbox- und echte Kontakte mischen; jeder Kontakt erhält sein eigenes Ergebnis. Ein simulierter Empfänger zählt trotzdem gegen Ihr Versandkontingent, sodass die Probe dasselbe Kontingent verbraucht wie der echte Versand.